Models - DigitalTwinModels Update

Service:

Azure Digital Twins

API Version:

2023-10-31

Atualizações os metadados de um modelo. Códigos de estado:

• 204 Sem Conteúdo
• 400 Pedido Incorreto
  • InvalidArgument - O ID do modelo é inválido.
  • JsonPatchInvalid - O Patch JSON fornecido é inválido.
  • MissingArgument - O ID do modelo não foi fornecido.
• 404 Não Encontrado
  • ModelNotFound - O modelo não foi encontrado.
• 409 Conflito
  • ModelReferencesNotDecommissioned – o modelo refere-se a modelos que não estão desativados.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
id	path	True	string	O ID do modelo. O ID é globalmente exclusivo e sensível às maiúsculas e minúsculas.
api-version	query	True	string	A versão da API pedida.

Cabeçalho do Pedido

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

Name	Necessário	Tipo	Description
traceparent		string	Identifica o pedido num sistema de rastreio distribuído.
tracestate		string	Fornece informações de identificação de rastreio específicas do fornecedor e é um complemento para o traceparent.

Corpo do Pedido

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

Name	Tipo	Description
updateModel	object[]	Uma especificação de atualização descrita por JSON Patch. Apenas a propriedade desativada pode ser substituída.

Respostas

Name	Tipo	Description
204 No Content		Com êxito
Other Status Codes	ErrorResponse	Resposta predefinida. Headers x-ms-error-code: string

Segurança

oauth2

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

Exemplos

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

Definições

Name	Description
Error	Definição de erro.
ErrorResponse	Resposta de erro.
InnerError	Uma descrição de erro mais específica do que a fornecida pelo erro que contém.

Error

Definição de erro.

Name	Tipo	Description
code	string	Código de erro específico do serviço que serve como o subtatus para o código de erro HTTP.
details	Error[]	Detalhes de erro internos.
innererror	InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível por humanos do erro.

ErrorResponse

Resposta de erro.

Name	Tipo	Description
error	Error	Os detalhes do erro.

InnerError

Uma descrição de erro mais específica do que a fornecida pelo erro que contém.

Name	Tipo	Description
code	string	Um código de erro mais específico do que o fornecido pelo erro que contém.
innererror	InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.