Twins - DigitalTwins UpdateRelationship

Service:

Azure Digital Twins

API Version:

2023-10-31

Aktualizacje właściwości relacji między dwiema bliźniaczymi reprezentacjami cyfrowymi. Kody stanu:

• 204 Brak zawartości
• 400 Nieprawidłowe żądanie
  • InvalidArgument — identyfikator cyfrowej reprezentacji bliźniaczej lub identyfikator relacji jest nieprawidłowy.
  • InvalidRelationship — relacja jest nieprawidłowa.
  • JsonPatchInvalid — podana poprawka JSON jest nieprawidłowa.
  • ValidationFailed — zawartość relacji jest nieprawidłowa.
• 404 — Nie znaleziono
  • DigitalTwinNotFound — nie odnaleziono cyfrowej reprezentacji bliźniaczej.
  • RelationshipNotFound — nie znaleziono relacji.
• 409 Konflikt
  • RelationshipAlreadyExists — relacja już istnieje.
• 412 Warunek wstępny nie powiodło się
  • Warunek wstępny — sprawdzanie warunków wstępnych (If-Match lub If-None-Match) nie powiodło się.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
id	path	True	string	Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
relationshipId	path	True	string	Identyfikator relacji. Identyfikator jest unikatowy w cyfrowej reprezentacji bliźniaczej i uwzględnia wielkość liter.
api-version	query	True	string	Żądana wersja interfejsu API.

Nagłówek żądania

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

Nazwa	Wymagane	Typ	Opis
If-Match		string	Wykonaj operację tylko wtedy, gdy element etag jednostki pasuje do jednego z podanych tagów lub *.
traceparent		string	Identyfikuje żądanie w rozproszonym systemie śledzenia.
tracestate		string	Udostępnia informacje dotyczące identyfikacji śledzenia specyficzne dla dostawcy i jest towarzyszem śledzenia.

Treść żądania

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

Nazwa	Typ	Opis
patchDocument	object[]	Opis poprawki JSON dla właściwości relacji.

Odpowiedzi

Nazwa	Typ	Opis
204 No Content		Powodzenie Headers ETag: string
Other Status Codes	ErrorResponse	Domyślna odpowiedź. Headers x-ms-error-code: string

Zabezpieczenia

oauth2

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

Przykłady

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

Definicje

Nazwa	Opis
Error	Definicja błędu.
ErrorResponse	Odpowiedź na błąd.
InnerError	Bardziej szczegółowy opis błędu niż został podany przez błąd zawierający.

Error

Definicja błędu.

Nazwa	Typ	Opis
code	string	Kod błędu specyficzny dla usługi, który służy jako podstatu dla kodu błędu HTTP.
details	Error[]	Szczegóły błędu wewnętrznego.
innererror	InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.

ErrorResponse

Odpowiedź na błąd.

Nazwa	Typ	Opis
error	Error	Szczegóły błędu.

InnerError

Bardziej szczegółowy opis błędu niż został podany przez błąd zawierający.

Nazwa	Typ	Opis
code	string	Bardziej szczegółowy kod błędu niż został dostarczony przez błąd zawierający.
innererror	InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.