Devices - Get Identity

Service:

IoT Hub

API Version:

2020-05-31-preview

Získá zařízení z registru identit IoT Hub.

GET https://fully-qualified-iothubname.azure-devices.net/devices/{id}?api-version=2020-05-31-preview

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
id	path	True	string	Jedinečný identifikátor zařízení.
api-version	query	True	string	Verze rozhraní API.

Odpovědi

Name	Typ	Description
200 OK	Device	OK.

Definice

Name	Description
AuthenticationMechanism
Device
DeviceCapabilities	Stav funkcí povolených na zařízení.
SymmetricKey
X509Thumbprint

AuthenticationMechanism

Name	Typ	Description
symmetricKey	SymmetricKey	Primární a sekundární klíče používané k ověřování na základě SAS.
type	enum: certificateAuthority none sas selfSigned	Typ ověřování použitý pro připojení ke službě.
x509Thumbprint	X509Thumbprint	Primární a sekundární kryptografické otisky x509 používané pro ověřování na základě x509.

Device

Name	Typ	Description
authentication	AuthenticationMechanism	Mechanismus ověřování používaný zařízením.
capabilities	DeviceCapabilities	Sada funkcí zařízení. Například jestli se jedná o hraniční zařízení nebo ne.
cloudToDeviceMessageCount	integer	Počet zpráv typu cloud-zařízení, které jsou aktuálně ve frontě k odeslání do zařízení.
connectionState	enum: Connected Disconnected	Stav zařízení.
connectionStateUpdatedTime	string	Datum a čas poslední aktualizace stavu připojení
deviceId	string	Jedinečný identifikátor zařízení.
deviceScope	string	Rozsah zařízení. Automaticky generované a neměnné pro hraniční zařízení a upravitelné v zařízeních typu list za účelem vytvoření vztahu podřízenosti a nadřazenosti
etag	string	Řetězec představující slabou značku ETag pro identitu zařízení podle RFC7232.
generationId	string	Řetězec vygenerovaný IoT Hub s rozlišováním velkých a malých písmen o délce až 128 znaků. Tato hodnota se používá k odlišení zařízení se stejným id zařízení, když byla odstraněna a znovu vytvořena.
lastActivityTime	string	Datum a čas, kdy zařízení naposledy připojilo, přijalo nebo odeslalo zprávu.
status	enum: disabled enabled	Stav zařízení. Pokud je stav zakázaný, zařízení se nemůže ke službě připojit.
statusReason	string	Řetězec dlouhý 128 znaků, ve kterém je uložen důvod stavu identity zařízení. Jsou povoleny všechny znaky UTF-8.
statusUpdatedTime	string	Datum a čas poslední aktualizace pole stavu

DeviceCapabilities

Stav funkcí povolených na zařízení.

Name	Typ	Description
iotEdge	boolean	Vlastnost, která určuje, jestli je zařízení hraničním zařízením, nebo ne.

SymmetricKey

Name	Typ	Description
primaryKey	string	Primární klíč zařízení kódovaný jako base64.
secondaryKey	string	Sekundární klíč zařízení kódovaný jako base64.

X509Thumbprint

Name	Typ	Description
primaryThumbprint	string	Primární kryptografický otisk klientského certifikátu X509.
secondaryThumbprint	string	Sekundární kryptografický otisk klientského certifikátu X509.