Role Assignments - Get

Tjänst:

Key Vault

API-version:

2025-07-01

Hämta den angivna rolltilldelningen.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2025-07-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
roleAssignmentName	path	True	string	Namnet på rolltilldelningen som ska hämtas.
scope	path	True	string	Omfånget för rolltilldelningen.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	RoleAssignment	Begäran har slutförts.
Other Status Codes	KeyVaultError	Ett oväntat felsvar.

Säkerhet

OAuth2Auth

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

Omfattningar

Name	Description
https://vault.azure.net/.default

Exempel

Get the specified role assignment

Exempelbegäran

HTTP

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2025-07-01

Exempelsvar

Statuskod:

200

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId",
    "scope": "/keys"
  },
  "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleAssignmentId"
}

Definitioner

Name	Description
Error
KeyVaultError	Felundantaget för nyckelvalvet.
RoleAssignment	Rolltilldelningar
RoleAssignmentPropertiesWithScope	Rolltilldelningsegenskaper med omfång.
RoleScope	Rollens omfång.

Error

Objekt

Name	Typ	Description
code	string	Felkoden.
innererror	Error	Felet på nyckelvalvsservern.
message	string	Felmeddelandet.

KeyVaultError

Objekt

Felundantaget för nyckelvalvet.

Name	Typ	Description
error	Error	Felet på nyckelvalvsservern.

RoleAssignment

Objekt

Rolltilldelningar

Name	Typ	Description
id	string	Rolltilldelnings-ID:t.
name	string	Namnet på rolltilldelningen.
properties	RoleAssignmentPropertiesWithScope	Egenskaper för rolltilldelning.
type	string	Typ av rolltilldelning.

RoleAssignmentPropertiesWithScope

Objekt

Rolltilldelningsegenskaper med omfång.

Name	Typ	Description
principalId	string	Huvud-ID:t.
roleDefinitionId	string	Rolldefinitions-ID.
scope	RoleScope	Rollens omfång.

RoleScope

Uppräkning

Rollens omfång.

Värde	Description
/	Global räckvidd
/keys	Omfång för nycklar