次の方法で共有


Iot Hub Resource - Get Endpoint Health

ルーティング エンドポイントの正常性を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routingEndpointsHealth?api-version=2023-06-30

URI パラメーター

名前 / 必須 説明
iotHubName
path True

string

resourceGroupName
path True

string

subscriptionId
path True

string

サブスクリプション識別子。

api-version
query True

string

API のバージョン。

応答

名前 説明
200 OK

EndpointHealthDataListResult

わかりました

Other Status Codes

ErrorDetails

DefaultErrorResponse

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

IotHubResource_GetEndpointHealth

要求のサンプル

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/routingEndpointsHealth?api-version=2023-06-30

応答のサンプル

{
  "value": [
    {
      "endpointId": "id1",
      "healthStatus": "healthy",
      "lastSuccessfulSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT",
      "lastSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT"
    },
    {
      "endpointId": "id2",
      "healthStatus": "unknown"
    },
    {
      "endpointId": "id3",
      "healthStatus": "unhealthy",
      "lastKnownError": "NotFound",
      "lastKnownErrorTime": "Wed, 13 Sep 2022 18:04:32 GMT",
      "lastSuccessfulSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT",
      "lastSendAttemptTime": "Wed, 13 Sep 2022 18:04:32 GMT"
    }
  ]
}

定義

名前 説明
EndpointHealthData

エンドポイントの正常性データ

EndpointHealthDataListResult

次のリンクを含む EndpointHealthData オブジェクトの JSON シリアル化された配列。

EndpointHealthStatus

正常性状態には、次の意味があります。 "正常" 状態は、エンドポイントが想定どおりにメッセージを受け入れることを示しています。 "異常" 状態は、エンドポイントが想定どおりにメッセージを受け入れていないことを示し、IoT Hub はこのエンドポイントへのデータ送信を再試行しています。 IoT Hub が最終的に一貫性のある正常性状態を確立すると、異常なエンドポイントの状態が正常に更新されます。 "デッド" 状態は、IoT Hub が再審期間中にメッセージの送信を再試行した後に、エンドポイントがメッセージを受け入れないことを示しています。 IoT Hub メトリックを参照してエラーを特定し、エンドポイントに関する問題を監視します。 "不明" 状態は、IoT Hub がエンドポイントとの接続を確立していないことを示しています。 このエンドポイントにメッセージが配信されていないか、このエンドポイントから拒否されていない

ErrorDetails

エラーの詳細。

EndpointHealthData

エンドポイントの正常性データ

名前 説明
endpointId

string

エンドポイントの ID

healthStatus

EndpointHealthStatus

正常性状態には、次の意味があります。 "正常" 状態は、エンドポイントが想定どおりにメッセージを受け入れることを示しています。 "異常" 状態は、エンドポイントが想定どおりにメッセージを受け入れていないことを示し、IoT Hub はこのエンドポイントへのデータ送信を再試行しています。 IoT Hub が最終的に一貫性のある正常性状態を確立すると、異常なエンドポイントの状態が正常に更新されます。 "デッド" 状態は、IoT Hub が再審期間中にメッセージの送信を再試行した後に、エンドポイントがメッセージを受け入れないことを示しています。 IoT Hub メトリックを参照してエラーを特定し、エンドポイントに関する問題を監視します。 "不明" 状態は、IoT Hub がエンドポイントとの接続を確立していないことを示しています。 このエンドポイントにメッセージが配信されていないか、このエンドポイントから拒否されていない

lastKnownError

string

メッセージを IoT ハブに配信できなかったときに最後に取得されたエラー

lastKnownErrorTime

string (date-time-rfc1123)

最後の既知のエラーが発生した時刻

lastSendAttemptTime

string (date-time-rfc1123)

IoT ハブがエンドポイントにメッセージを送信しようとした最後の時刻

lastSuccessfulSendAttemptTime

string (date-time-rfc1123)

IoT ハブがエンドポイントにメッセージを正常に送信した最後の時刻

EndpointHealthDataListResult

次のリンクを含む EndpointHealthData オブジェクトの JSON シリアル化された配列。

名前 説明
nextLink

string

その他の結果へのリンク

value

EndpointHealthData[]

エンドポイント正常性データの JSON シリアル化配列

EndpointHealthStatus

正常性状態には、次の意味があります。 "正常" 状態は、エンドポイントが想定どおりにメッセージを受け入れることを示しています。 "異常" 状態は、エンドポイントが想定どおりにメッセージを受け入れていないことを示し、IoT Hub はこのエンドポイントへのデータ送信を再試行しています。 IoT Hub が最終的に一貫性のある正常性状態を確立すると、異常なエンドポイントの状態が正常に更新されます。 "デッド" 状態は、IoT Hub が再審期間中にメッセージの送信を再試行した後に、エンドポイントがメッセージを受け入れないことを示しています。 IoT Hub メトリックを参照してエラーを特定し、エンドポイントに関する問題を監視します。 "不明" 状態は、IoT Hub がエンドポイントとの接続を確立していないことを示しています。 このエンドポイントにメッセージが配信されていないか、このエンドポイントから拒否されていない

説明
dead
degraded
healthy
unhealthy
unknown

ErrorDetails

エラーの詳細。

名前 説明
code

string

エラー コード。

details

string

エラーの詳細。

httpStatusCode

string

HTTP 状態コード。

message

string

エラー メッセージ。