DigitalTwinsClient.CreateOrReplaceDigitalTwinAsync<T> Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un jumeau numérique de manière asynchrone. Si l’ID de jumeau numérique fourni est déjà en cours d’utilisation, cela tentera de remplacer le jumeau numérique existant par le jumeau numérique fourni.
public virtual System.Threading.Tasks.Task<Azure.Response<T>> CreateOrReplaceDigitalTwinAsync<T> (string digitalTwinId, T digitalTwin, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrReplaceDigitalTwinAsync : string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<'T>>
override this.CreateOrReplaceDigitalTwinAsync : string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<'T>>
Public Overridable Function CreateOrReplaceDigitalTwinAsync(Of T) (digitalTwinId As String, digitalTwin As T, Optional ifNoneMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of T))
Paramètres de type
- T
Type auquel désérialiser le jumeau numérique.
Paramètres
- digitalTwinId
- String
ID du jumeau numérique.
- digitalTwin
- T
Jumeau numérique application/json à créer.
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
Le jumeau numérique application/json créé et la réponse Response<T>HTTP .
Exceptions
Exception qui capture les erreurs du service. Pour plus d’informations, consultez les ErrorCode propriétés et Status .
L’exception est levée lorsque digitalTwinId
ou digitalTwin
est null
.
Exemples
var customTwin = new CustomDigitalTwin
{
Id = customDtId,
Metadata = { ModelId = modelId },
Prop1 = "Prop1 val",
Prop2 = 987,
Component1 = new MyCustomComponent
{
ComponentProp1 = "Component prop1 val",
ComponentProp2 = 123,
},
};
Response<CustomDigitalTwin> createCustomDigitalTwinResponse = await client.CreateOrReplaceDigitalTwinAsync(customDtId, customTwin);
Console.WriteLine($"Created digital twin '{createCustomDigitalTwinResponse.Value.Id}'.");
Remarques
Pour plus d’exemples, consultez nos exemples de référentiels.
S’applique à
Azure SDK for .NET
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour