Twins - DigitalTwins SendTelemetry

Service:

Azure Digital Twins

API Version:

2023-10-31

代表數位對應項傳送遙測。 狀態碼：

• 204 沒有內容
• 400 不正確的要求
  • InvalidArgument - 數位對應項識別碼或訊息識別碼無效。
  • ValidationFailed - 遙測內容無效。
• 404 找不到
  • DigitalTwinNotFound - 找不到數位對應項。

POST https://digitaltwins-hostname/digitaltwins/{id}/telemetry?api-version=2023-10-31

URI 參數

名稱	位於	必要	類型	Description
id	path	True	string	數位對應項的識別碼。 識別碼在服務內是唯一的，而且區分大小寫。
api-version	query	True	string	要求的 API 版本。

要求標頭

名稱	必要	類型	Description
Message-Id	True	string	數位對應項識別碼範圍 (的唯一訊息識別碼，) 通常用於取消複製訊息。
Telemetry-Source-Time		string	RFC 3339 時間戳記，可識別測量遙測的時間。
traceparent		string	識別分散式追蹤系統中的要求。
tracestate		string	提供廠商特定的追蹤識別資訊，而且是追蹤親和項的隨附專案。

要求本文

名稱	類型	Description
telemetry	object	要從數位對應項傳送的遙測量值。

回應

名稱	類型	Description
204 No Content		Success
Other Status Codes	ErrorResponse	預設回應。 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

HTTP

POST https://digitaltwins-hostname/digitaltwins/myTwinId/telemetry?api-version=2023-10-31



{
  "temperature": 1
}

Sample Response

Status code:

204

定義

名稱	Description
Error	錯誤定義。
ErrorResponse	錯誤回應。
InnerError	比包含的錯誤所提供更明確的錯誤描述。

Error

錯誤定義。

名稱	類型	Description
code	string	服務特定的錯誤碼，可作為 HTTP 錯誤碼的子狀態。
details	Error[]	內部錯誤詳細資料。
innererror	InnerError	物件，包含比目前物件有關錯誤更具體的資訊。
message	string	人類可讀取的錯誤標記法。

ErrorResponse

錯誤回應。

名稱	類型	Description
error	Error	錯誤詳細資料。

InnerError

比包含的錯誤所提供更明確的錯誤描述。

名稱	類型	Description
code	string	比包含的錯誤所提供更明確的錯誤碼。
innererror	InnerError	物件，包含比目前物件有關錯誤更具體的資訊。