Condividi tramite


Iot Hub Resource - Get Keys For Key Name

Ottenere un criterio di accesso condiviso per nome da un hub IoT. Per altre informazioni, vedere: 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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
keyName
path True

string

Nome dei criteri di accesso condiviso.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene l'hub IoT.

resourceName
path True

string

Nome dell'hub IoT.

subscriptionId
path True

string

L'identificatore della sottoscrizione.

api-version
query True

string

Versione dell'API.

Risposte

Nome Tipo Descrizione
200 OK

SharedAccessSignatureAuthorizationRule

Si tratta di un'operazione sincrona. Il corpo contiene criteri di accesso condiviso serializzati JSON, incluse le chiavi, che è possibile usare per accedere a uno o più endpoint dell'hub IoT.

Other Status Codes

ErrorDetails

DefaultErrorResponse

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

IotHubResource_GetKeysForKeyName

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AccessRights

Autorizzazioni assegnate ai criteri di accesso condiviso.

ErrorDetails

Dettagli errore.

SharedAccessSignatureAuthorizationRule

Proprietà di un criterio di accesso condiviso dell'hub IoT.

AccessRights

Autorizzazioni assegnate ai criteri di accesso condiviso.

Nome Tipo Descrizione
DeviceConnect

string

RegistryRead

string

RegistryRead, DeviceConnect

string

RegistryRead, RegistryWrite

string

RegistryRead, RegistryWrite, DeviceConnect

string

RegistryRead, RegistryWrite, ServiceConnect

string

RegistryRead, RegistryWrite, ServiceConnect, DeviceConnect

string

RegistryRead, ServiceConnect

string

RegistryRead, ServiceConnect, DeviceConnect

string

RegistryWrite

string

RegistryWrite, DeviceConnect

string

RegistryWrite, ServiceConnect

string

RegistryWrite, ServiceConnect, DeviceConnect

string

ServiceConnect

string

ServiceConnect, DeviceConnect

string

ErrorDetails

Dettagli errore.

Nome Tipo Descrizione
code

string

Codice di errore.

details

string

Dettagli dell'errore.

httpStatusCode

string

Codice di stato HTTP.

message

string

Messaggio di errore.

SharedAccessSignatureAuthorizationRule

Proprietà di un criterio di accesso condiviso dell'hub IoT.

Nome Tipo Descrizione
keyName

string

Nome dei criteri di accesso condiviso.

primaryKey

string

Chiave primaria.

rights

AccessRights

Autorizzazioni assegnate ai criteri di accesso condiviso.

secondaryKey

string

Chiave secondaria.