Devices - Get Relationship

Szolgáltatás:

IoT Central

API-verzió:

2022-07-31

Az eszköz azonosítóját és az eszközhöz társított kapcsolatazonosítót tekintve kérje le a kapcsolat részleteit.
Eszközkapcsolat lekérése azonosító alapján

GET https://{subdomain}.{baseDomain}/api/devices/{deviceId}/relationships/{relationshipId}?api-version=2022-07-31

URI-paraméterek

Name	In	Kötelező	Típus	Description
baseDomain	path	True	string	Az Azure IoT Central szolgáltatáskéréseinek alaptartománya.
deviceId	path	True	string	Az eszköz egyedi azonosítója.
relationshipId	path	True	string	Az eszközök közötti kapcsolat egyedi azonosítója.
subdomain	path	True	string	Az alkalmazás altartománya.
api-version	query	True	string	A meghívott API verziója.

Válaszok

Name	Típus	Description
200 OK	DeviceRelationship	Siker
Other Status Codes	Error	Hibaválasz érkezett az IoT Central szolgáltatástól. Fejlécek x-ms-error-code: string

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get device relationship by ID

Mintakérelem

HTTP

GET https://appsubdomain.azureiotcentral.com/api/devices/device1/relationships/relationship1?api-version=2022-07-31

Mintaválasz

Állapotkód:

200

{
  "id": "relationship1",
  "source": "device1",
  "target": "device2"
}

Definíciók

Name	Description
DeviceRelationship	Egy felsőbb réteg és egy alsóbb rétegbeli eszköz közötti kapcsolatot képviselő objektum.
Error	A válaszhiba definíciója.
ErrorDetails	A hiba részletes információi.

DeviceRelationship

Objektum

Egy felsőbb réteg és egy alsóbb rétegbeli eszköz közötti kapcsolatot képviselő objektum.

Name	Típus	Description
id	string	A kapcsolat egyedi azonosítója.
source	string	A forráseszköz (szülő) eszközazonosítója.
target	string	A céleszköz (gyermek) eszközazonosítója.

Error

Objektum

A válaszhiba definíciója.

Name	Típus	Description
error	ErrorDetails	Az aktuális kérés hibaadatai.

ErrorDetails

Objektum

A hiba részletes információi.

Name	Típus	Description
code	string	Hibakód.
message	string	Hibaüzenet részletei.
requestId	string	Az aktuális kérés korrelációs azonosítója.
time	string (date-time-rfc1123)	A hibakérés sikertelen volt.