DigitalTwinsClient.CreateOrReplaceRelationship<T> Método

Referência

Definição

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Pacote:: Azure.DigitalTwins.Core v1.4.0

Origem:: DigitalTwinsClient.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma relação em um gêmeo digital de forma síncrona. Se a ID de relação fornecida já estiver em uso, isso tentará substituir a relação existente pela relação fornecida.

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

O tipo para o qual desserializar a relação.

Parâmetros

digitalTwinId: String

A ID do gêmeo digital de origem.

relationshipId: String

A ID da relação a ser excluída.

relationship: T

A relação aplicativo/json a ser criada.

ifNoneMatch: Nullable<ETag>

O cabeçalho If-None-Match que torna o método de solicitação condicional em um cache de destinatário ou servidor de origem não tem nenhuma representação atual do recurso de destino. Para obter mais informações sobre essa propriedade, consulte RFC 7232. Os valores aceitáveis são nulos ou "". Se a opção ifNonMatch for nula, o serviço substituirá a entidade existente pela nova entidade. Se a opção ifNoneMatch for "" (ou All), o serviço rejeitará a solicitação se a entidade já existir. Uma ETag opcional só fará a solicitação se o valor não corresponder ao serviço.

cancellationToken: CancellationToken

O token de cancelamento.

Retornos

Response<T>

A resposta Response<T>HTTP .

Exceções

RequestFailedException

A exceção que captura os erros do serviço. Verifique as ErrorCode propriedades e Status para obter mais detalhes.

ArgumentNullException

A exceção é gerada quando digitalTwinId ou relationshipId é null.

Comentários

As relações são um link unidirecional de um gêmeo digital de origem para outro, conforme descrito no momento da criação do modelo atribuído do gêmeo digital.

Para obter mais exemplos, confira nossos exemplos de repositório.

Aplica-se a

Confira também

CreateOrReplaceRelationshipAsync<T>(String, String, T, Nullable<ETag>, CancellationToken)

Compartilhar via