Iot Hub Resource - Get Keys For Key Name

Usługa:: IoT Hub

Wersja interfejsu API:: 2023-06-30

Uzyskaj zasady dostępu współdzielonego według nazwy z centrum IoT Hub. Aby uzyskać więcej informacji, zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-security.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/IotHubKeys/{keyName}/listkeys?api-version=2023-06-30

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
keyName	path	True	string	Nazwa zasad dostępu współdzielonego.
resourceGroupName	path	True	string	Nazwa grupy zasobów, która zawiera centrum IoT.
resourceName	path	True	string	Nazwa centrum IoT.
subscriptionId	path	True	string	Identyfikator subskrypcji.
api-version	query	True	string	Wersja interfejsu API.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SharedAccessSignatureAuthorizationRule	Jest to operacja synchroniczna. Treść zawiera zasady dostępu współdzielonego serializowane w formacie JSON, w tym klucze, których można użyć do uzyskiwania dostępu do co najmniej jednego punktu końcowego centrum IoT.
Other Status Codes	ErrorDetails	DefaultErrorResponse

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

IotHubResource_GetKeysForKeyName

Przykładowe żądanie

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/IotHubKeys/iothubowner/listkeys?api-version=2023-06-30

Przykładowa odpowiedź

Kod stanu:: 200

{
  "keyName": "iothubowner",
  "primaryKey": "<primaryKey>",
  "secondaryKey": "<secondaryKey>",
  "rights": "RegistryWrite, ServiceConnect, DeviceConnect"
}

Definicje

Nazwa	Opis
AccessRights	Uprawnienia przypisane do zasad dostępu współdzielonego.
ErrorDetails	Szczegóły błędu.
SharedAccessSignatureAuthorizationRule	Właściwości zasad dostępu współdzielonego centrum IoT Hub.

AccessRights

Wyliczanie

Uprawnienia przypisane do zasad dostępu współdzielonego.

Wartość	Opis
RegistryRead
RegistryWrite
ServiceConnect
DeviceConnect
RegistryRead, RegistryWrite
RegistryRead, ServiceConnect
RegistryRead, DeviceConnect
RegistryWrite, ServiceConnect
RegistryWrite, DeviceConnect
ServiceConnect, DeviceConnect
RegistryRead, RegistryWrite, ServiceConnect
RegistryRead, RegistryWrite, DeviceConnect
RegistryRead, ServiceConnect, DeviceConnect
RegistryWrite, ServiceConnect, DeviceConnect
RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect

ErrorDetails

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	string	Szczegóły błędu.
httpStatusCode	string	Kod stanu HTTP.
message	string	Komunikat o błędzie.

SharedAccessSignatureAuthorizationRule