Twins - DigitalTwins UpdateRelationship

Service:

Azure Digital Twins

API Version:

2023-10-31

Frissítések két digitális ikerpéldány közötti kapcsolat tulajdonságait. Állapotkódok:

• 204 Nincs tartalom
• 400 – Hibás kérés
  • InvalidArgument – A digitális ikerpéldány azonosítója vagy kapcsolatazonosítója érvénytelen.
  • InvalidRelationship – A kapcsolat érvénytelen.
  • JsonPatchInvalid – A megadott JSON-javítás érvénytelen.
  • ValidationFailed – A kapcsolat tartalma érvénytelen.
• 404 Nem található
  • DigitalTwinNotFound – A digitális ikerpéldány nem található.
  • RelationshipNotFound – A kapcsolat nem található.
• 409 Ütközés
  • RelationshipAlreadyExists – A kapcsolat már létezik.
• 412 Az előfeltétel meghiúsult
  • PreconditionFailed – Az előfeltételek ellenőrzése (If-Match vagy If-None-Match) sikertelen volt.

PATCH https://digitaltwins-hostname/digitaltwins/{id}/relationships/{relationshipId}?api-version=2023-10-31

URI-paraméterek

Name	In	Kötelező	Típus	Description
id	path	True	string	A digitális ikerpéldány azonosítója. Az azonosító egyedi a szolgáltatáson belül, és megkülönbözteti a kis- és nagybetűt.
relationshipId	path	True	string	A kapcsolat azonosítója. Az azonosító egyedi a digitális ikerpéldányon belül, és megkülönbözteti a kis- és nagybetűt.
api-version	query	True	string	A kért API-verzió.

Kérelem fejléce

Media Types: "application/json-patch+json"

Name	Kötelező	Típus	Description
If-Match		string	Csak akkor hajtsa végre a műveletet, ha az entitás etagje megegyezik a megadott etagek egyikével, vagy * van megadva.
traceparent		string	Azonosítja a kérést egy elosztott nyomkövetési rendszerben.
tracestate		string	Szállítóspecifikus nyomkövetési azonosítási információkat biztosít, és a nyomkövetési adatok kiegészítője.

Kérelem törzse

Media Types: "application/json-patch+json"

Name	Típus	Description
patchDocument	object[]	JSON-javítás leírása a kapcsolat tulajdonságainak frissítéséhez.

Válaszok

Name	Típus	Description
204 No Content		Siker Headers ETag: string
Other Status Codes	ErrorResponse	Alapértelmezett válasz. Headers x-ms-error-code: string

Biztonság

oauth2

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

Példák

Update relationship properties

Update relationship properties (multiple updates)

Update relationship properties

Sample Request

HTTP

PATCH https://digitaltwins-hostname/digitaltwins/myTwinId/relationships/myRelationshipId?api-version=2023-10-31

[
  {
    "op": "add",
    "path": "/property",
    "value": 1
  }
]

Sample Response

Status code:

204

Update relationship properties (multiple updates)

Sample Request

HTTP

PATCH https://digitaltwins-hostname/digitaltwins/myTwinId/relationships/myRelationshipId?api-version=2023-10-31

[
  {
    "op": "add",
    "path": "/property1",
    "value": 1
  },
  {
    "op": "remove",
    "path": "/property2"
  },
  {
    "op": "replace",
    "path": "/property3/subProperty1",
    "value": "new value"
  }
]

Sample Response

Status code:

204

Definíciók

Name	Description
Error	Hibadefiníció.
ErrorResponse	Hibaválasz.
InnerError	Pontosabb hibaleírás, mint amelyet a hiba tartalmazott.

Error

Hibadefiníció.

Name	Típus	Description
code	string	Szolgáltatásspecifikus hibakód, amely a HTTP-hibakód alállapotaként szolgál.
details	Error[]	Belső hiba részletei.
innererror	InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba emberi olvasásra alkalmas ábrázolása.

ErrorResponse

Hibaválasz.

Name	Típus	Description
error	Error	A hiba részletei.

InnerError

Pontosabb hibaleírás, mint amelyet a hiba tartalmazott.

Name	Típus	Description
code	string	Pontosabb hibakód, mint amit a tartalmazó hiba adott meg.
innererror	InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.