Freigeben über

Role Assignments - Get

Dienst:
Key Vault
API-Version:
2025-07-01

Rufen Sie die angegebene Rollenzuweisung ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
roleAssignmentName
 path True

string

Der Name der Rollenzuweisung, die abgerufen werden soll.
scope
 path True

string

Der Bereich der Rollenzuweisung.
vaultBaseUrl
 path True

string (uri)

api-version
 query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

RoleAssignment

Die Anforderung ist erfolgreich.
Other Status Codes

KeyVaultError

Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

Get the specified role assignment

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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"
}

Definitionen

Name Beschreibung
Error
KeyVaultError

Die Key Vault-Fehlerausnahme.
RoleAssignment

Rollenzuweisungen
RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften mit Bereich.
RoleScope

Der Rollenbereich.

Error

Objekt
Name Typ Beschreibung
code

string

Der Fehlercode.
innererror

Error

Der Key Vault-Serverfehler.
message

string

Die Fehlermeldung.

KeyVaultError

Objekt

Die Key Vault-Fehlerausnahme.

Name Typ Beschreibung
error

Error

Der Key Vault-Serverfehler.

RoleAssignment

Objekt

Rollenzuweisungen

Name Typ Beschreibung
id

string

Die Rollenzuweisungs-ID.
name

string

Der Name der Rollenzuweisung.
properties

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften.
type

string

Der Rollenzuweisungstyp.

RoleAssignmentPropertiesWithScope

Objekt

Rollenzuweisungseigenschaften mit Bereich.

Name Typ Beschreibung
principalId

string

Die Prinzipal-ID.
roleDefinitionId

string

Die Rollendefinitions-ID.
scope

RoleScope

Der Rollenbereich.

RoleScope

Enumeration

Der Rollenbereich.

Wert Beschreibung
/

Globaler Geltungsbereich
/keys

Geltungsbereich von Schlüsseln