DigitalTwinsClient.GetIncomingRelationshipsAsync Method

Reference

Definition

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Package:: Azure.DigitalTwins.Core v1.4.0

Source:: DigitalTwinsClient.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets all the relationships referencing a digital twin as a target by iterating through a collection asynchronously.

public virtual Azure.AsyncPageable<Azure.DigitalTwins.Core.IncomingRelationship> GetIncomingRelationshipsAsync (string digitalTwinId, System.Threading.CancellationToken cancellationToken = default);

abstract member GetIncomingRelationshipsAsync : string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.DigitalTwins.Core.IncomingRelationship>
override this.GetIncomingRelationshipsAsync : string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.DigitalTwins.Core.IncomingRelationship>

Public Overridable Function GetIncomingRelationshipsAsync (digitalTwinId As String, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of IncomingRelationship)

Parameters

digitalTwinId: String

The Id of the target digital twin.

cancellationToken: CancellationToken

The cancellation token.

Returns

AsyncPageable<IncomingRelationship>

The pageable list AsyncPageable<T> of application/json relationships directed towards the specified digital twin and the HTTP response.

Exceptions

RequestFailedException

The exception that captures the errors from the service. Check the ErrorCode and Status properties for more details.

ArgumentNullException

The exception is thrown when digitalTwinId is null.

Examples

AsyncPageable<IncomingRelationship> incomingRelationships = client.GetIncomingRelationshipsAsync("buildingTwinId");

await foreach (IncomingRelationship incomingRelationship in incomingRelationships)
{
    Console.WriteLine($"Found an incoming relationship '{incomingRelationship.RelationshipId}' from '{incomingRelationship.SourceId}'.");
}

Remarks

For more samples, see our repo samples.

Applies to

Share via