Twins - DigitalTwins GetRelationshipById

Service:

Azure Digital Twins

API Version:

2023-10-31

İki dijital ikiz arasındaki ilişkiyi alır. Durum kodları:

• 200 Tamam
• 400 Hatalı İstek
  • InvalidArgument - Dijital ikiz kimliği veya ilişki kimliği geçersiz.
• 404 Bulunamadı
  • DigitalTwinNotFound - Dijital ikiz bulunamadı.
  • RelationshipNotFound - İlişki bulunamadı.

GET https://digitaltwins-hostname/digitaltwins/{id}/relationships/{relationshipId}?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.
relationshipId	path	True	string	İlişkinin kimliği. Kimlik, dijital ikiz 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
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.

Yanıtlar

Name	Tür	Description
200 OK	Relationship	Başarılı Headers ETag: string
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

Get a relationship by id

Sample Request

HTTP

GET https://digitaltwins-hostname/digitaltwins/mySourceTwin/relationships/myRelationshipId?api-version=2023-10-31

Sample Response

Status code:

200

{
  "$relationshipId": "myRelationshipId",
  "$sourceId": "mySourceTwin",
  "$targetId": "myTargetTwin",
  "$relationshipName": "myRelationship",
  "$etag": "W/\"1553dbf5-0052-4be8-bea8-46269075b503\"",
  "relationshipProperty": "some value"
}

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.