Twins - DigitalTwins ListIncomingRelationships
デジタル ツインのすべての受信リレーションシップを取得します。 状態コード:
- 200 OK
- 400 Bad Request
- InvalidArgument - デジタル ツイン ID が無効です。
- 404 見つかりません
- DigitalTwinNotFound - デジタル ツインが見つかりませんでした。
GET https://digitaltwins-hostname/digitaltwins/{id}/incomingrelationships?api-version=2023-10-31
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
id
|
path | True |
string |
デジタル ツインの ID。 ID はサービス内で一意であり、大文字と小文字が区別されます。 |
api-version
|
query | True |
string |
要求された API バージョン。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
traceparent |
string |
分散トレース システム内の要求を識別します。 |
|
tracestate |
string |
ベンダー固有のトレース識別情報を提供し、traceparent に対応しています。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
Success |
|
Other Status Codes |
既定の応答。 Headers x-ms-error-code: string |
セキュリティ
oauth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0
例
List incoming relationships
Sample Request
GET https://digitaltwins-hostname/digitaltwins/mySourceTwin/incomingrelationships?api-version=2023-10-31
Sample Response
{
"value": [
{
"$sourceId": "mySourceTwin",
"$relationshipId": "firstRelationshipId",
"$relationshipName": "myRelationship",
"$relationshipLink": "/digitaltwins/mySourceTwin/relationships/myRelationship/firstRelationshipId"
},
{
"$sourceId": "mySourceTwin",
"$relationshipId": "secondRelationshipId",
"$relationshipName": "myRelationship",
"$relationshipLink": "/digitaltwins/mySourceTwin/relationships/myRelationship/secondRelationshipId"
}
],
"nextLink": "url-to-next-page"
}
定義
名前 | 説明 |
---|---|
Error |
エラー定義。 |
Error |
エラー応答。 |
Incoming |
受信リレーションシップ。 |
Incoming |
デジタル ツインを相互に関連付ける受信リレーションシップのコレクション。 |
Inner |
含まれているエラーによって提供されたよりも具体的なエラーの説明。 |
Error
エラー定義。
名前 | 型 | 説明 |
---|---|---|
code |
string |
HTTP エラー コードのサブステータスとして機能するサービス固有のエラー コード。 |
details |
Error[] |
内部エラーの詳細。 |
innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
|
message |
string |
エラーの人間が判読できる表現。 |
ErrorResponse
エラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラーの詳細です。 |
IncomingRelationship
受信リレーションシップ。
名前 | 型 | 説明 |
---|---|---|
$relationshipId |
string |
このリレーションシップの ID を表すユーザー指定の文字列。ソース デジタル ツインのコンテキストで一意です。つまり、sourceId + relationshipId はサービスのコンテキストで一意です。 |
$relationshipLink |
string |
削除に使用するリレーションシップへのリンク。 |
$relationshipName |
string |
リレーションシップの名前。 |
$sourceId |
string |
ソース デジタル ツインの ID。 |
IncomingRelationshipCollection
デジタル ツインを相互に関連付ける受信リレーションシップのコレクション。
名前 | 型 | 説明 |
---|---|---|
nextLink |
string |
オブジェクトの次のページを取得する URI。 |
value |
受信リレーションシップ。 |
InnerError
含まれているエラーによって提供されたよりも具体的なエラーの説明。
名前 | 型 | 説明 |
---|---|---|
code |
string |
含まれているエラーによって提供されたよりも具体的なエラー コード。 |
innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示