Dela via


Twins - DigitalTwins ListIncomingRelationships

Hämtar all inkommande relation för en digital tvilling. Statuskoder:

  • 200 OK
  • 400 Felaktig begäran
    • InvalidArgument – ID:t för den digitala tvillingen är ogiltigt.
  • 404 – Hittades inte
    • DigitalTwinNotFound – Den digitala tvillingen hittades inte.
GET https://digitaltwins-hostname/digitaltwins/{id}/incomingrelationships?api-version=2023-10-31

URI-parametrar

Name I Obligatorisk Typ Description
id
path True

string

ID:t för den digitala tvillingen. ID:t är unikt inom tjänsten och skiftlägeskänsligt.

api-version
query True

string

Den begärda API-versionen.

Begärandehuvud

Name Obligatorisk Typ Description
traceparent

string

Identifierar begäran i ett distribuerat spårningssystem.

tracestate

string

Tillhandahåller leverantörsspecifik spårningsidentifieringsinformation och är ett komplement till traceparent.

Svar

Name Typ Description
200 OK

IncomingRelationshipCollection

Klart

Other Status Codes

ErrorResponse

Standardsvar.

Headers

x-ms-error-code: string

Säkerhet

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

Exempel

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"
}

Definitioner

Name Description
Error

Feldefinition.

ErrorResponse

Felsvar.

IncomingRelationship

En inkommande relation.

IncomingRelationshipCollection

En samling inkommande relationer som relaterar digitala tvillingar tillsammans.

InnerError

En mer specifik felbeskrivning än vad som angavs av det innehållande felet.

Error

Feldefinition.

Name Typ Description
code

string

Tjänstspecifik felkod som fungerar som understatus för HTTP-felkoden.

details

Error[]

Intern felinformation.

innererror

InnerError

Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.

message

string

En mänsklig läsbar representation av felet.

ErrorResponse

Felsvar.

Name Typ Description
error

Error

Felinformationen.

IncomingRelationship

En inkommande relation.

Name Typ Description
$relationshipId

string

En sträng som tillhandahålls av användaren och som representerar ID:t för den här relationen, unik i kontexten för den digitala källtvillingen, d.v.s. sourceId + relationshipId är unik i tjänstens kontext.

$relationshipLink

string

Länk till relationen som ska användas för borttagning.

$relationshipName

string

Namnet på relationen.

$sourceId

string

ID:t för den digitala källtvillingen.

IncomingRelationshipCollection

En samling inkommande relationer som relaterar digitala tvillingar tillsammans.

Name Typ Description
nextLink

string

En URI för att hämta nästa sida med objekt.

value

IncomingRelationship[]

En inkommande relation.

InnerError

En mer specifik felbeskrivning än vad som angavs av det innehållande felet.

Name Typ Description
code

string

En mer specifik felkod än vad som angavs av det innehållande felet.

innererror

InnerError

Ett objekt som innehåller mer specifik information än det aktuella objektet om felet.