Aracılığıyla paylaş

Twins - DigitalTwins SendComponentTelemetry

  • Başvuru
Service:
Azure Digital Twins
API Version:
2023-10-31

Dijital ikizdeki bir bileşen adına telemetri gönderir. Durum kodları:

  • 204 İçerik Yok
  • 400 Hatalı İstek
    • InvalidArgument - Dijital ikiz kimliği, ileti kimliği veya bileşen yolu geçersiz.
    • ValidationFailed - Telemetri içeriği geçersiz.
  • 404 Bulunamadı
    • DigitalTwinNotFound - Dijital ikiz bulunamadı.
    • ComponentNotFound - Bileşen yolu bulunamadı.
POST https://digitaltwins-hostname/digitaltwins/{id}/components/{componentPath}/telemetry?api-version=2023-10-31

URI Parametreleri

Name İçinde Gerekli Tür Description
componentPath
 path True

string

DTDL bileşeninin adı.
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 yinelemek için 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 sistemindeki isteği tanımlar.
tracestate

string

Satıcıya özgü izleme tanımlama bilgilerini sağlar ve izlemeparent için yardımcıdır.

İstek Gövdesi

Name Tür Description
telemetry

object

Dijital ikizin bileşeninden 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 in a component

Sample Request

POST https://digitaltwins-hostname/digitaltwins/myTwinId/components/myComponent/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 olarak hizmet veren hizmete özgü hata kodu.
details

Error[]

İç hata ayrıntıları.
innererror

InnerError

Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.
message

string

Hatanın insan tarafından okunabilen 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 özel bilgiler içeren bir nesne.