Twins - DigitalTwins SendTelemetry
デジタル ツインに代わってテレメトリを送信します。 状態コード:
- 204 No Content
- 400 Bad Request
- InvalidArgument - デジタル ツイン ID またはメッセージ ID が無効です。
- ValidationFailed - テレメトリ コンテンツが無効です。
- 404 見つかりません
- DigitalTwinNotFound - デジタル ツインが見つかりませんでした。
POST https://digitaltwins-hostname/digitaltwins/{id}/telemetry?api-version=2023-10-31
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
id
|
path | True |
string |
デジタル ツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。 |
api-version
|
query | True |
string |
要求された API バージョン。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
Message-Id | True |
string |
メッセージの重複除去に一般的に使用される一意のメッセージ識別子 (デジタル ツイン ID のスコープ内)。 |
Telemetry-Source-Time |
string |
テレメトリが測定された時刻を識別する RFC 3339 タイムスタンプ。 |
|
traceparent |
string |
分散トレース システム内の要求を識別します。 |
|
tracestate |
string |
ベンダー固有のトレース識別情報を提供し、traceparent に対応しています。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
telemetry |
object |
デジタル ツインから送信するテレメトリの測定値。 |
応答
名前 | 型 | 説明 |
---|---|---|
204 No Content |
Success |
|
Other Status Codes |
既定の応答。 Headers x-ms-error-code: string |
セキュリティ
oauth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0
例
Send telemetry
Sample Request
POST https://digitaltwins-hostname/digitaltwins/myTwinId/telemetry?api-version=2023-10-31
{
"temperature": 1
}
Sample Response
定義
名前 | 説明 |
---|---|
Error |
エラー定義。 |
Error |
エラー応答。 |
Inner |
含まれているエラーによって提供されたよりも具体的なエラーの説明。 |
Error
エラー定義。
名前 | 型 | 説明 |
---|---|---|
code |
string |
HTTP エラー コードのサブステータスとして機能するサービス固有のエラー コード。 |
details |
Error[] |
内部エラーの詳細。 |
innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
|
message |
string |
エラーの人間が判読できる表現。 |
ErrorResponse
エラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラーの詳細です。 |
InnerError
含まれているエラーによって提供されたよりも具体的なエラーの説明。
名前 | 型 | 説明 |
---|---|---|
code |
string |
含まれているエラーによって提供されたよりも具体的なエラー コード。 |
innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示