Twins - DigitalTwins DeleteRelationship

  • Referencia
Service:
Azure Digital Twins
API Version:
2023-10-31

Elimina una relación entre dos gemelos digitales. Códigos de estado:

  • 204 No Content
  • 400 - Solicitud incorrecta
    • InvalidArgument: el identificador de gemelo digital o el identificador de relación no es válido.
  • 404 No encontrado
    • DigitalTwinNotFound: no se encontró el gemelo digital.
    • RelationshipNotFound: no se encontró la relación.
  • 412 Error de condición previa
    • Condición previaFailed: error en la comprobación de condición previa (If-Match o If-None-Match).
DELETE https://digitaltwins-hostname/digitaltwins/{id}/relationships/{relationshipId}?api-version=2023-10-31

Parámetros de identificador URI

Nombre En Requerido Tipo Description
id
 path True

string

Identificador del gemelo digital. El identificador es único dentro del servicio y distingue mayúsculas de minúsculas.
relationshipId
 path True

string

Identificador de la relación. El identificador es único dentro del gemelo digital y distingue mayúsculas de minúsculas.
api-version
 query True

string

La versión de API solicitada.

Encabezado de la solicitud

Nombre Requerido Tipo Description
If-Match

string

Realice solo la operación si la etag de la entidad coincide con una de las etag proporcionadas o * .
traceparent

string

Identifica la solicitud en un sistema de seguimiento distribuido.
tracestate

string

Proporciona información de identificación de seguimiento específica del proveedor y es un compañero de seguimiento primario.

Respuestas

Nombre Tipo Description
204 No Content

Correcto
Other Status Codes

ErrorResponse

Respuesta predeterminada.

Headers

x-ms-error-code: string

Seguridad

oauth2

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

Ejemplos

Delete a relationship

Sample Request

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

Sample Response

Status code:
204

Definiciones

Nombre Description
Error

Definición de error.
ErrorResponse

Respuesta de error.
InnerError

Una descripción de error más específica de la proporcionada por el error contenedor.

Error

Definición de error.

Nombre Tipo Description
code

string

Código de error específico del servicio que actúa como subestado para el código de error HTTP.
details

Error[]

Detalles internos del error.
innererror

InnerError

Objeto que contiene información más específica que el objeto actual sobre el error.
message

string

Representación legible del error.

ErrorResponse

Respuesta de error.

Nombre Tipo Description
error

Error

Los detalles del error.

InnerError

Una descripción de error más específica de la proporcionada por el error contenedor.

Nombre Tipo Description
code

string

Código de error más específico del proporcionado por el error contenedor.
innererror

InnerError

Objeto que contiene información más específica que el objeto actual sobre el error.