Iot Dps Resource - List Keys

Servizio:: IoT Hub Device Provisioning Service

Versione API:: 2026-08-31

Elencare le chiavi primarie e secondarie per un servizio di provisioning.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/listkeys?api-version=2026-08-31

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
provisioningServiceName	path	True	string	Nome del servizio di rifornimento da recuperare.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	SharedAccessSignatureAuthorizationRuleListResult	Operazione Azure completata con successo.
Other Status Codes	ErrorDetails	Risposta di errore imprevista.

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	impersonare il tuo account utente

Esempio

DPSListKeys

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/listkeys?api-version=2026-08-31

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "keyName": "key1",
      "primaryKey": "#####################################",
      "rights": "ServiceConfig",
      "secondaryKey": "###################################"
    },
    {
      "keyName": "key2",
      "primaryKey": "#######################################",
      "rights": "ServiceConfig",
      "secondaryKey": "####################################="
    }
  ]
}

Definizioni

Nome	Descrizione
AccessRightsDescription	Diritti di cui dispone la chiave.
ErrorDetails	Dettagli errore.
SharedAccessSignatureAuthorizationRuleAccessRightsDescription	Descrizione della chiave di accesso condiviso.
SharedAccessSignatureAuthorizationRuleListResult	Elenco delle chiavi di accesso condivise.

AccessRightsDescription

Enumerazione

Diritti di cui dispone la chiave.

Valore	Descrizione
ServiceConfig
EnrollmentRead
EnrollmentWrite
DeviceConnect
RegistrationStatusRead
RegistrationStatusWrite

ErrorDetails

Oggetto

Dettagli errore.

Nome	Tipo	Descrizione
code	integer (int32)	Codice di errore.
details	string	Dettagli dell'errore.
httpStatusCode	string	Codice di stato HTTP.
message	string	Messaggio di errore.

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Oggetto

Descrizione della chiave di accesso condiviso.

Nome	Tipo	Descrizione
keyName	string	Nome della chiave.
primaryKey	string	Valore della chiave di firma di accesso condiviso primario.
rights	AccessRightsDescription	Diritti di cui dispone la chiave.
secondaryKey	string	Valore della chiave di firma di accesso condiviso secondario.

SharedAccessSignatureAuthorizationRuleListResult

Oggetto

Elenco delle chiavi di accesso condivise.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]	Gli elementi SharedAccessAuthorizationAuthorizationRightsAccessDescription su questa pagina