---
title: "POST /GetTelemetryEvaluationStatus"
method: POST
path: "/GetTelemetryEvaluationStatus"
---

# POST /GetTelemetryEvaluationStatus

`POST /GetTelemetryEvaluationStatus`

Returns the current onboarding status of the telemetry config feature, including the status of the feature and reason the feature failed to start or stop.

## Response `200`

Success

- GetTelemetryEvaluationStatusOutput
  - `Status` 'NOT_STARTED' | 'STARTING' | 'FAILED_START' | 'RUNNING' | 'STOPPING' | 'FAILED_STOP' | 'STOPPED' — The onboarding status of the telemetry config feature.
  - `FailureReason` string — Describes the reason for the failure status. The field will only be populated if <code>Status</code> is <code>FAILED_START</code> or <code>FAILED_STOP</code>.
  - `HomeRegion` string — The Amazon Web Services Region that is designated as the home region for multi-region telemetry evaluation. The home region is the single management point for all multi-region operations on this account. This field is only present when multi-region telemetry evaluation is active.
  - `RegionStatuses` RegionStatus[] — A list of per-region telemetry evaluation statuses. Each entry indicates the evaluation status for a specific spoke region included in the multi-region configuration. This field is only present when multi-region telemetry evaluation is active.
    - `Region` string — The Amazon Web Services Region code (for example, <code>eu-west-1</code> or <code>us-west-2</code>) that this status applies to.
    - `Status` string — The status of the operation in this region. For telemetry evaluation, valid values include <code>STARTING</code>, <code>RUNNING</code>, and <code>FAILED_START</code>. For telemetry rules, valid values include <code>PENDING</code>, <code>ACTIVE</code>, and <code>FAILED</code>.
    - `FailureReason` string — The reason for a failure status in this region. This field is only populated when <code>Status</code> indicates a failure.
    - `RuleArn` string — The Amazon Resource Name (ARN) of the telemetry rule in this spoke region. This field is only present for telemetry rule region statuses and is populated when the rule has been successfully created in the spoke region (status is <code>ACTIVE</code>).

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerException
- `482` — TooManyRequestsException

---

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