---
title: "POST /v1/{+instance}:reportStatus"
method: POST
path: "/v1/{+instance}:reportStatus"
tags: ["organizations"]
---

# POST /v1/{+instance}:reportStatus

`POST /v1/{+instance}:reportStatus`

Reports the latest status for a runtime instance.

## Path parameters

- `instance` string, required

## Request body

- GoogleCloudApigeeV1ReportInstanceStatusRequest — Request for ReportInstanceStatus.
  - `instanceUid` string — A unique ID for the instance which is guaranteed to be unique in case the user installs multiple hybrid runtimes with the same instance ID.
  - `reportTime` string, google-datetime — The time the report was generated in the runtime. Used to prevent an old status from overwriting a newer one. An instance should space out it's status reports so that clock skew does not play a factor.
  - `resources` GoogleCloudApigeeV1ResourceStatus[] — Status for config resources
    - `resource` string — The resource name. Currently only two resources are supported: EnvironmentGroup - organizations/{org}/envgroups/{envgroup} EnvironmentConfig - organizations/{org}/environments/{environment}/deployedConfig
    - `uid` string — The uid of the resource. In the unexpected case that the instance has multiple uids for the same name, they should be reported under separate ResourceStatuses.
    - `totalReplicas` integer — The total number of replicas that should have this resource.
    - `revisions` GoogleCloudApigeeV1RevisionStatus[] — Revisions of the resource currently deployed in the instance.
      - `errors` GoogleCloudApigeeV1UpdateError[] — Errors reported when attempting to load this revision.
        - `code` 'OK' | 'CANCELLED' | 'UNKNOWN' | 'INVALID_ARGUMENT' | 'DEADLINE_EXCEEDED' | 'NOT_FOUND' | 'ALREADY_EXISTS' | 'PERMISSION_DENIED' | 'UNAUTHENTICATED' | 'RESOURCE_EXHAUSTED' | 'FAILED_PRECONDITION' | 'ABORTED' | 'OUT_OF_RANGE' | 'UNIMPLEMENTED' | 'INTERNAL' | 'UNAVAILABLE' | 'DATA_LOSS' — Status code.
        - `message` string — User-friendly error message.
        - `type` string — A string that uniquely identifies the type of error. This provides a more reliable means to deduplicate errors across revisions and instances.
        - `resource` string — The sub resource specific to this error (e.g. a proxy deployed within the EnvironmentConfig). If empty the error refers to the top level resource.
      - `jsonSpec` string — The json content of the resource revision. Large specs should be sent individually via the spec field to avoid hitting request size limits.
      - `revisionId` string — The revision of the resource.
      - `replicas` integer — The number of replicas that have successfully loaded this revision.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/apigee.md) · [All operations](https://skmtc.net/google/apis/apigee/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/apigee/versions/6e272fa448a7/schema)