Share via

Twins - DigitalTwins Delete

  • Référence
Service:
Azure Digital Twins
API Version:
2023-10-31

Supprime un jumeau numérique. Toutes les relations référençant le jumeau numérique doivent déjà être supprimées. Codes d’état :

  • 204 Pas de contenu
  • 400 Demande incorrecte
    • InvalidArgument : l’ID de jumeau numérique n’est pas valide.
    • RelationsNotDeleted : le jumeau numérique contient des relations.
  • 404 Introuvable
    • DigitalTwinNotFound : le jumeau numérique est introuvable.
  • 412 Échec de la condition préalable
    • Condition préalable Échec : la vérification des conditions préalables (If-Match ou If-None-Match) a échoué.
DELETE https://digitaltwins-hostname/digitaltwins/{id}?api-version=2023-10-31

Paramètres URI

Nom Dans Obligatoire Type Description
id
 path True

string

ID du jumeau numérique. L’ID est unique dans le service et respecte la casse.
api-version
 query True

string

Version de l’API demandée.

En-tête de la demande

Nom Obligatoire Type Description
If-Match

string

Effectuez l’opération uniquement si l’etag de l’entité correspond à l’un des etags fournis ou si * est fourni.
traceparent

string

Identifie la demande dans un système de suivi distribué.
tracestate

string

Fournit des informations d’identification de trace spécifiques au fournisseur et est un complément à traceparent.

Réponses

Nom Type Description
204 No Content

Succès
Other Status Codes

ErrorResponse

Réponse par défaut.

Headers

x-ms-error-code: string

Sécurité

oauth2

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

Exemples

Delete a digital twin

Sample Request

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

Sample Response

Status code:
204

Définitions

Nom Description
Error

Définition de l’erreur.
ErrorResponse

Réponse d’erreur.
InnerError

Une description de l’erreur plus spécifique que celle fournie par l’erreur contenante.

Error

Définition de l’erreur.

Nom Type Description
code

string

Code d’erreur spécifique au service qui sert de sous-état pour le code d’erreur HTTP.
details

Error[]

Détails de l’erreur interne.
innererror

InnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message

string

Représentation lisible par l’homme de l’erreur.

ErrorResponse

Réponse d’erreur.

Nom Type Description
error

Error

Détails de l’erreur.

InnerError

Une description de l’erreur plus spécifique que celle fournie par l’erreur contenante.

Nom Type Description
code

string

Un code d’erreur plus spécifique que celui fourni par l’erreur contenante.
innererror

InnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.