Iot Dps Resource - List Keys For Key Name
Rufen Sie eine freigegebene Zugriffsrichtlinie anhand des Namens von einem Bereitstellungsdienst ab.
Auflisten von Primär- und Sekundärschlüsseln für einen bestimmten Schlüsselnamen
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/keys/{keyName}/listkeys?api-version=2022-12-12
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
key
|
path | True |
string |
Logischer Schlüsselname zum Abrufen von Schlüsselwerten |
|
provisioning
|
path | True |
string |
Name des Bereitstellungsdiensts. |
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die den Bereitstellungsdienst enthält. |
|
subscription
|
path | True |
string |
Der Abonnementbezeichner. |
|
api-version
|
query | True |
string |
Die Version der API. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Shared |
Dies ist ein synchroner Vorgang. Der Text enthält eine JSON-serialisierte Richtlinie für den freigegebenen Zugriff, einschließlich Schlüsseln, die Sie für den Zugriff auf einen oder mehrere Bereitstellungsdienstendpunkte verwenden können. |
| Other Status Codes |
Standardfehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
DPSGetKey
Beispielanforderung
POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/keys/testKey/listkeys?api-version=2022-12-12
Beispiel für eine Antwort
{
"keyName": "testKey",
"primaryKey": "##################################",
"secondaryKey": "################################",
"rights": "RegistrationStatusWrite"
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Access |
Rechte, die dieser Schlüssel hat. |
|
Error |
Fehlerdetails. |
|
Shared |
Beschreibung des freigegebenen Zugriffsschlüssels. |
AccessRightsDescription
Rechte, die dieser Schlüssel hat.
| Wert | Beschreibung |
|---|---|
| ServiceConfig | |
| EnrollmentRead | |
| EnrollmentWrite | |
| DeviceConnect | |
| RegistrationStatusRead | |
| RegistrationStatusWrite |
ErrorDetails
Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
integer (int32) |
Der Fehlercode. |
| details |
string |
Die Fehlerdetails. |
| httpStatusCode |
string |
Der HTTP-Statuscode. |
| message |
string |
Die Fehlermeldung. |
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]
Beschreibung des freigegebenen Zugriffsschlüssels.
| Name | Typ | Beschreibung |
|---|---|---|
| keyName |
string |
Der Name des Schlüssels. |
| primaryKey |
string |
Primärer SAS-Schlüsselwert. |
| rights |
Rechte, die dieser Schlüssel hat. |
|
| secondaryKey |
string |
Sekundärer SAS-Schlüsselwert. |