DigitalTwinsClient.CreateOrReplaceDigitalTwin<T> Methode

Definition

Namespace:

Azure.DigitalTwins.Core

Assembly:

Azure.DigitalTwins.Core.dll

Paket:

Azure.DigitalTwins.Core v1.4.0

Source:

DigitalTwinsClient.cs

Erstellt synchron einen digitalen Zwilling. Wenn die bereitgestellte digitale Zwillings-ID bereits verwendet wird, wird versucht, den vorhandenen digitalen Zwilling durch den bereitgestellten digitalen Zwilling zu ersetzen.

public virtual Azure.Response<T> CreateOrReplaceDigitalTwin<T> (string digitalTwinId, T digitalTwin, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrReplaceDigitalTwin : string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.Response<'T>
override this.CreateOrReplaceDigitalTwin : string * 'T * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.Response<'T>

Public Overridable Function CreateOrReplaceDigitalTwin(Of T) (digitalTwinId As String, digitalTwin As T, Optional ifNoneMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of T)

Typparameter

T

Der Typ, in den der digitale Zwilling deserialisiert werden soll.

Parameter

digitalTwinId

String

Die ID des digitalen Zwillings.

digitalTwin

T

Der zu erstellende digitale Zwilling der Anwendung/JSON.

ifNoneMatch

Nullable<ETag>

If-None-Match-Header, der die Anforderungsmethode für einen Empfängercache oder Ursprungsserver abhängig macht, der keine aktuelle Darstellung der Zielressource aufweist. Weitere Informationen zu dieser Eigenschaft finden Sie unter RFC 7232. Zulässige Werte sind NULL oder "". Wenn die Option ifNonMatch null ist, ersetzt der Dienst die vorhandene Entität durch die neue Entität. Wenn die Option ifNoneMatch auf "" (oder All) festgelegt ist, lehnt der Dienst die Anforderung ab, wenn die Entität bereits vorhanden ist. Ein optionales ETag, um die Anforderung nur dann zu stellen, wenn der Wert nicht mit dem Dienst übereinstimmt.

cancellationToken

CancellationToken

Das Abbruchtoken.

Gibt zurück

Response<T>

Der erstellte digitale Anwendungs-/JSON-Zwilling und die HTTP-Antwort Response<T>.

Ausnahmen

RequestFailedException

Die Ausnahme, die die Fehler des Diensts erfasst. Weitere Details finden Sie in den ErrorCode Eigenschaften und Status .

Hinweise

Weitere Beispiele finden Sie in unseren Repositorybeispielen.