Compartir a través de

DigitalTwinsClient.CreateOrReplaceRelationship<T> Método

  • Referencia

Definición

Espacio de nombres:
Azure.DigitalTwins.Core
Ensamblado:
Azure.DigitalTwins.Core.dll
Paquete:
Azure.DigitalTwins.Core v1.4.0
Source:
DigitalTwinsClient.cs

Crea una relación en un gemelo digital de forma sincrónica. Si el identificador de relación proporcionado ya está en uso, se intentará reemplazar la relación existente por la relación proporcionada.

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)

Parámetros de tipo

T

Tipo al que se va a deserializar la relación.

Parámetros

digitalTwinId
String

Identificador del gemelo digital de origen.

relationshipId
String

Identificador de la relación que se va a eliminar.

relationship
T

Relación application/json que se va a crear.

ifNoneMatch
Nullable<ETag>

Encabezado If-None-Match que hace que el método de solicitud esté 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, vea 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. ETag opcional para realizar la solicitud solo si el valor no coincide con el servicio.

cancellationToken
CancellationToken

Token de cancelación.

Devoluciones

Response<T>

Respuesta HTTP Response<T>.

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 relationshipId es null.

Comentarios

Las relaciones son un vínculo unidireccional desde un gemelo digital de origen a otro, como se describe en el momento de creación del modelo asignado del gemelo digital.

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

Se aplica a

Consulte también