Models - DigitalTwinModels Update

Service:

Azure Digital Twins

API Version:

2023-10-31

Aktualizace metadata modelu. Stavové kódy:

• 204 Žádný obsah
• 400 – Chybný požadavek
  • InvalidArgument – ID modelu je neplatné.
  • JsonPatchInvalid – zadaná oprava JSON je neplatná.
  • MissingArgument – ID modelu nebylo zadané.
• 404 Nenalezeno
  • ModelNotFound – model nebyl nalezen.
• 409 – Konflikt
  • ModelReferencesNotDecommissioned – model odkazuje na modely, které nejsou vyřazeny z provozu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
id	path	True	string	ID modelu. ID je globálně jedinečné a rozlišuje malá a velká písmena.
api-version	query	True	string	Požadovaná verze rozhraní API

Hlavička požadavku

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

Name	Vyžadováno	Typ	Description
traceparent		string	Identifikuje požadavek v distribuovaném trasovacím systému.
tracestate		string	Poskytuje identifikační informace o trasování specifické pro dodavatele a je doprovodnou osobou k trasování.

Text požadavku

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

Name	Typ	Description
updateModel	object[]	Specifikace aktualizace popsaná opravou JSON. Nahradit lze pouze vyřazenou vlastnost.

Odpovědi

Name	Typ	Description
204 No Content		Success
Other Status Codes	ErrorResponse	Výchozí odpověď Headers x-ms-error-code: string

Zabezpečení

oauth2

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

Příklady

Decommission a model

Sample Request

HTTP

PATCH https://digitaltwins-hostname/models/dtmi:com:example:Sample;1?api-version=2023-10-31

[
  {
    "op": "replace",
    "path": "/decommissioned",
    "value": true
  }
]

Sample Response

Status code:

204

Definice

Name	Description
Error	Definice chyby
ErrorResponse	Odpověď na chybu.
InnerError	Konkrétnější popis chyby, než poskytla chyba obsahující chybu.

Error

Definice chyby

Name	Typ	Description
code	string	Kód chyby specifický pro službu, který slouží jako dílčí stav pro kód chyby HTTP.
details	Error[]	Podrobnosti o vnitřní chybě.
innererror	InnerError	Objekt obsahující konkrétnější informace o chybě než aktuální objekt.
message	string	Lidsky čitelná reprezentace chyby.

ErrorResponse

Odpověď na chybu.

Name	Typ	Description
error	Error	Podrobnosti o chybě

InnerError

Konkrétnější popis chyby, než poskytla chyba obsahující chybu.

Name	Typ	Description
code	string	Konkrétnější kód chyby, než byl poskytnut chybou obsahující chybu.
innererror	InnerError	Objekt obsahující konkrétnější informace o chybě než aktuální objekt.