Twins - DigitalTwins SendTelemetry

Service:

Azure Digital Twins

API Version:

2023-10-31

Bir dijital ikiz adına telemetri gönderir. Durum kodları:

• 204 İçerik Yok
• 400 Hatalı İstek
  • InvalidArgument - Dijital ikiz kimliği veya ileti kimliği geçersiz.
  • ValidationFailed - Telemetri içeriği geçersiz.
• 404 Bulunamadı
  • DigitalTwinNotFound - Dijital ikiz bulunamadı.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
id	path	True	string	Dijital ikizin kimliği. Kimlik, hizmet içinde benzersizdir ve büyük/küçük harfe duyarlıdır.
api-version	query	True	string	İstenen API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
Message-Id	True	string	İletileri yinelemeyi kaldırmada yaygın olarak kullanılan benzersiz bir ileti tanımlayıcısı (dijital ikiz kimliği kapsamında).
Telemetry-Source-Time		string	Telemetrinin ölçülme zamanını tanımlayan bir RFC 3339 zaman damgası.
traceparent		string	Dağıtılmış izleme sisteminde isteği tanımlar.
tracestate		string	Satıcıya özgü izleme tanımlama bilgilerini sağlar ve izleme aracına eşlik eder.

İstek Gövdesi

Name	Tür	Description
telemetry	object	Dijital ikizden gönderilecek telemetri ölçümleri.

Yanıtlar

Name	Tür	Description
204 No Content		Başarılı
Other Status Codes	ErrorResponse	Varsayılan yanıt. Headers x-ms-error-code: string

Güvenlik

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

Örnekler

Send telemetry

Sample Request

HTTP

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



{
  "temperature": 1
}

Sample Response

Status code:

204

Tanımlar

Name	Description
Error	Hata tanımı.
ErrorResponse	Hata yanıtı.
InnerError	İçeren hata tarafından sağlanandan daha belirgin bir hata açıklaması.

Error

Hata tanımı.

Name	Tür	Description
code	string	HTTP hata kodu için alt durum görevi gören hizmete özgü hata kodu.
details	Error[]	İç hata ayrıntıları.
innererror	InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insanlar tarafından okunabilir bir gösterimi.

ErrorResponse

Hata yanıtı.

Name	Tür	Description
error	Error	Hata ayrıntıları.

InnerError

İçeren hata tarafından sağlanandan daha belirgin bir hata açıklaması.

Name	Tür	Description
code	string	İçeren hata tarafından sağlanandan daha özel bir hata kodu.
innererror	InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.