Dela via


Iot Dps Resource - List Keys For Key Name

Hämta en princip för delad åtkomst efter namn från en etableringstjänst.
Lista primära och sekundära nycklar för ett specifikt nyckelnamn

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/keys/{keyName}/listkeys?api-version=2022-12-12

URI-parametrar

Name I Obligatorisk Typ Description
keyName
path True

string

Namn på logisk nyckel att hämta nyckelvärden för.

provisioningServiceName
path True

string

Namnet på etableringstjänsten.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller etableringstjänsten.

subscriptionId
path True

string

Prenumerationsidentifieraren.

api-version
query True

string

Versionen av API:et.

Svar

Name Typ Description
200 OK

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Det här är en synkron åtgärd. Brödtexten innehåller en JSON-serialiserad princip för delad åtkomst, inklusive nycklar, som du kan använda för att komma åt en eller flera tjänstslutpunkter för etablering.

Other Status Codes

ErrorDetails

Standardfelsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

DPSGetKey

Exempelbegäran

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

Exempelsvar

{
  "keyName": "testKey",
  "primaryKey": "##################################",
  "secondaryKey": "################################",
  "rights": "RegistrationStatusWrite"
}

Definitioner

Name Description
AccessRightsDescription

Rättigheter som nyckeln har.

ErrorDetails

Felinformation.

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Beskrivning av nyckeln för delad åtkomst.

AccessRightsDescription

Rättigheter som nyckeln har.

Name Typ Description
DeviceConnect

string

EnrollmentRead

string

EnrollmentWrite

string

RegistrationStatusRead

string

RegistrationStatusWrite

string

ServiceConfig

string

ErrorDetails

Felinformation.

Name Typ Description
code

integer

Felkoden.

details

string

Felinformationen.

httpStatusCode

string

HTTP-statuskoden.

message

string

Felmeddelandet.

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Beskrivning av nyckeln för delad åtkomst.

Name Typ Description
keyName

string

Namnet på nyckeln.

primaryKey

string

Primärt SAS-nyckelvärde.

rights

AccessRightsDescription

Rättigheter som nyckeln har.

secondaryKey

string

Sekundärt SAS-nyckelvärde.