DigitalTwinsClient.CreateOrReplaceRelationship<T> メソッド

定義

名前空間:

Azure.DigitalTwins.Core

アセンブリ:

Azure.DigitalTwins.Core.dll

パッケージ:

Azure.DigitalTwins.Core v1.4.0

Source:

DigitalTwinsClient.cs

デジタル ツインのリレーションシップを同期的に作成します。 指定されたリレーションシップ ID が既に使用されている場合は、既存のリレーションシップを指定されたリレーションシップに置き換えようとします。

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)

型パラメーター

T

リレーションシップを逆シリアル化する型。

パラメーター

digitalTwinId

String

ソース デジタル ツインの ID。

relationshipId

String

削除するリレーションシップの ID。

relationship

T

作成するアプリケーション/json リレーションシップ。

ifNoneMatch

Nullable<ETag>

受信者キャッシュまたは配信元サーバーに対して要求メソッドを条件付きにする If-None-Match ヘッダー。ターゲット リソースの現在の表現はありません。 このプロパティの詳細については、「 RFC 7232」を参照してください。 許容される値は null または ""です。 IfNonMatch オプションが null の場合、サービスは既存のエンティティを新しいエンティティに置き換えます。 ifNoneMatch オプションが "" (または All) の場合、エンティティが既に存在する場合、サービスは要求を拒否します。 サービスで値が一致しない場合にのみ要求を行うオプションの ETag。

cancellationToken

CancellationToken

キャンセル トークン。

戻り値

Response<T>

HTTP 応答 Response<T>。

例外

RequestFailedException

サービスからエラーをキャプチャする例外。 詳細については、 ErrorCode プロパティと Status プロパティを確認してください。

ArgumentNullException

または relationshipId が の場合digitalTwinId、例外がnullスローされます。

注釈

リレーションシップは、デジタル ツインの割り当てられたモデルの作成時に説明されているように、ソース デジタル ツインから別のデジタル ツインへの一方向リンクです。

その他のサンプルについては、 リポジトリのサンプルを参照してください。

こちらもご覧ください

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