DigitalTwinsClient.CreateOrReplaceRelationshipAsync<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 assí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 System.Threading.Tasks.Task<Azure.Response<T>> CreateOrReplaceRelationshipAsync<T> (string digitalTwinId, string relationshipId, T relationship, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function CreateOrReplaceRelationshipAsync(Of T) (digitalTwinId As String, relationshipId As String, relationship 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

O tipo com 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 que está sendo criada.

relationship: T

A relação application/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 no serviço.

cancellationToken: CancellationToken

O token de cancelamento.

Retornos

Task<Response<T>>

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.

Exemplos

var floorBuildingRelationshipPayload = new CustomRelationship
{
    Id = "floorBuildingRelationshipId",
    SourceId = "floorTwinId",
    TargetId = "buildingTwinId",
    Name = "containedIn",
    Prop1 = "Prop1 val",
    Prop2 = 4
};

Response<CustomRelationship> createCustomRelationshipResponse = await client
    .CreateOrReplaceRelationshipAsync<CustomRelationship>("floorTwinId", "floorBuildingRelationshipId", floorBuildingRelationshipPayload);
Console.WriteLine($"Created a digital twin relationship '{createCustomRelationshipResponse.Value.Id}' " +
    $"from twin '{createCustomRelationshipResponse.Value.SourceId}' to twin '{createCustomRelationshipResponse.Value.TargetId}'.");

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

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

Compartilhar via