Twins - DigitalTwins DeleteRelationship

Service:

Azure Digital Twins

API Version:

2023-10-31

Elimina uma relação entre dois duplos digitais. Códigos de estado:

• 204 Sem Conteúdo
• 400 Pedido Incorreto
  • InvalidArgument – o ID de duplo digital ou o ID de relação é inválido.
• 404 Não Encontrado
  • DigitalTwinNotFound - O duplo digital não foi encontrado.
  • RelationshipNotFound - A relação não foi encontrada.
• Falha na Pré-condição 412
  • PreconditionFailed - A verificação de pré-condição (If-Match ou If-None-Match) falhou.

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

Parâmetros do URI

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

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match		string	Execute apenas a operação se o etag da entidade corresponder a um dos etags fornecidos ou * for fornecido.
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.

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

Delete a relationship

Sample Request

HTTP

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

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.