DigitalTwinsClient.CreateOrReplaceDigitalTwinAsync<T> Método

Definición

Espacio de nombres:

Azure.DigitalTwins.Core

Ensamblado:

Azure.DigitalTwins.Core.dll

Paquete:

Azure.DigitalTwins.Core v1.4.0

Source:

DigitalTwinsClient.cs

Crea un gemelo digital de forma asincrónica. Si el identificador de gemelo digital proporcionado ya está en uso, intentará reemplazar el gemelo digital existente por el gemelo digital proporcionado.

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))

Parámetros de tipo

T

Tipo al que se va a deserializar el gemelo digital.

Parámetros

digitalTwinId

String

Identificador del gemelo digital.

digitalTwin

T

Gemelo digital application/json que se va a crear.

ifNoneMatch

Nullable<ETag>

Encabezado If-None-Match que hace que el método de solicitud sea condicional en una caché de destinatarios o en un servidor de origen, ya sea que no tenga ninguna representación actual del recurso de destino. Para obtener más información sobre esta propiedad, consulte RFC 7232. Los valores aceptables son null o "". Si la opción ifNonMatch es null, el servicio reemplazará la entidad existente por la nueva entidad. Si la opción ifNoneMatch es "" (o All) el servicio rechazará la solicitud si la entidad ya existe. Una ETag opcional para realizar solo la solicitud si el valor no coincide con el servicio.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<Response<T>>

El gemelo digital de application/json creado y la respuesta Response<T>HTTP .

Excepciones

RequestFailedException

Excepción que captura los errores del servicio. Consulte las ErrorCode propiedades y Status para obtener más detalles.

ArgumentNullException

La excepción se produce cuando digitalTwinId o digitalTwin es null.

Ejemplos

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}'.");

Comentarios

Para obtener más ejemplos, consulte nuestros ejemplos de repositorio.