Models - DigitalTwinModels Update

Updates metadata untuk model. Kode status:

  • 204 Tidak Ada Konten
  • 400 Permintaan Buruk
    • InvalidArgument - Id model tidak valid.
    • JsonPatchInvalid - Patch JSON yang disediakan tidak valid.
    • MissingArgument - Id model tidak disediakan.
  • 404 Tidak Ditemukan
    • ModelNotFound - Model tidak ditemukan.
  • 409 Konflik
    • ModelReferencesNotDecommissioned - Model mengacu pada model yang tidak dinonaktifkan.
PATCH https://digitaltwins-hostname/models/{id}?api-version=2023-10-31

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
id
path True

string

Id untuk model. Id unik secara global dan peka huruf besar/kecil.

api-version
query True

string

Versi API yang diminta.

Header Permintaan

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

Nama Diperlukan Jenis Deskripsi
traceparent

string

Mengidentifikasi permintaan dalam sistem pelacakan terdistribusi.

tracestate

string

Menyediakan informasi identifikasi jejak khusus vendor dan merupakan pendamping untuk melacak.

Isi Permintaan

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

Nama Jenis Deskripsi
updateModel

object[]

Spesifikasi pembaruan yang dijelaskan oleh JSON Patch. Hanya properti yang dinonaktifkan yang dapat diganti.

Respons

Nama Jenis Deskripsi
204 No Content

Berhasil

Other Status Codes

ErrorResponse

Respons default.

Headers

x-ms-error-code: string

Keamanan

oauth2

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

Contoh

Decommission a model

Sample Request

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

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

Sample Response

Definisi

Nama Deskripsi
Error

Definisi kesalahan.

ErrorResponse

Respons kesalahan.

InnerError

Deskripsi kesalahan yang lebih spesifik daripada yang disediakan oleh kesalahan yang berisi.

Error

Definisi kesalahan.

Nama Jenis Deskripsi
code

string

Kode kesalahan khusus layanan yang berfungsi sebagai substatus untuk kode kesalahan HTTP.

details

Error[]

Detail kesalahan internal.

innererror

InnerError

Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.

message

string

Representasi kesalahan yang dapat dibaca manusia.

ErrorResponse

Respons kesalahan.

Nama Jenis Deskripsi
error

Error

Detail kesalahan.

InnerError

Deskripsi kesalahan yang lebih spesifik daripada yang disediakan oleh kesalahan yang berisi.

Nama Jenis Deskripsi
code

string

Kode kesalahan yang lebih spesifik daripada yang disediakan oleh kesalahan yang berisi.

innererror

InnerError

Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.