Partager via

DigitalTwinsClient.CreateOrReplaceRelationship<T> Méthode

  • Référence

Définition

Espace de noms:
Azure.DigitalTwins.Core
Assembly:
Azure.DigitalTwins.Core.dll
Paquet:
Azure.DigitalTwins.Core v1.4.0
Source:
DigitalTwinsClient.cs

Crée une relation sur un jumeau numérique de manière synchrone. Si l’ID de relation fourni est déjà utilisé, cela tente de remplacer la relation existante par la relation fournie.

public virtual Azure.Response<T> CreateOrReplaceRelationship<T> (string digitalTwinId, string relationshipId, T relationship, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrReplaceRelationship : string * string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.Response<'T>
override this.CreateOrReplaceRelationship : string * string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.Response<'T>
Public Overridable Function CreateOrReplaceRelationship(Of T) (digitalTwinId As String, relationshipId As String, relationship As T, Optional ifNoneMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of T)

Paramètres de type

T

Type auquel désérialiser la relation.

Paramètres

digitalTwinId
String

ID du jumeau numérique source.

relationshipId
String

ID de la relation à supprimer.

relationship
T

Relation application/json à créer.

ifNoneMatch
Nullable<ETag>

En-tête If-None-Match qui rend la méthode de requête conditionnelle à un cache de destinataire ou un serveur d’origine n’ayant aucune représentation actuelle de la ressource cible. Pour plus d’informations sur cette propriété, consultez RFC 7232. Les valeurs acceptables sont null ou "". Si l’option ifNonMatch a la valeur Null, le service remplace l’entité existante par la nouvelle entité. Si l’option ifNoneMatch est « » (ou All), le service rejette la demande si l’entité existe déjà. ETag facultatif pour effectuer la demande uniquement si la valeur ne correspond pas sur le service.

cancellationToken
CancellationToken

Jeton d'annulation.

Retours

Response<T>

Réponse HTTP Response<T>.

Exceptions

RequestFailedException

Exception qui capture les erreurs du service. Pour plus d’informations, consultez les ErrorCode propriétés et Status .

ArgumentNullException

L’exception est levée lorsque digitalTwinId ou relationshipId est null.

Remarques

Les relations sont un lien unidirectionnel entre un jumeau numérique source et un autre, comme décrit au moment de la création du modèle attribué du jumeau numérique.

Pour plus d’exemples, consultez nos exemples de référentiels.

S’applique à

Voir aussi