Freigeben über


Role Assignments - List For Scope

Ruft Rollenzuweisungen für einen Bereich ab.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=7.4
GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?$filter={$filter}&api-version=7.4

URI-Parameter

Name In Erforderlich Typ Beschreibung
scope
path True

string

Der Bereich der Rollenzuweisungen.

vaultBaseUrl
path True

string

Der Tresorname, z. B https://myvault.vault.azure.net. .

api-version
query True

string

Client-API-Version.

$filter
query

string

Der Filter, der auf den Vorgang angewendet werden soll. Verwenden Sie $filter=atScope(), um alle Rollenzuweisungen am oder oberhalb des Bereichs zurückzugeben. Verwenden Sie $filter=principalId eq {id}, um alle Rollenzuweisungen über oder unterhalb des Bereichs für den angegebenen Prinzipal zurückzugeben.

Antworten

Name Typ Beschreibung
200 OK

RoleAssignmentListResult

OK: Gibt ein Array von Rollenzuweisungen zurück.

Other Status Codes

KeyVaultError

Key Vault Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

ListRoleAssignments

Beispielanforderung

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments?api-version=7.4

Beispiel für eine Antwort

{
  "value": [
    {
      "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

Der Schlüsseltresorserverfehler.

KeyVaultError

Die Schlüsseltresorfehler-Ausnahme.

RoleAssignment

Rollenzuweisungen

RoleAssignmentListResult

Ergebnis des Vorgangs "Rollenzuweisungsliste".

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften mit Bereich.

RoleScope

Der Rollenbereich.

Error

Der Schlüsseltresorserverfehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

innererror

Error

Der Schlüsseltresorserverfehler.

message

string

Die Fehlermeldung.

KeyVaultError

Die Schlüsseltresorfehler-Ausnahme.

Name Typ Beschreibung
error

Error

Der Schlüsseltresorserverfehler.

RoleAssignment

Rollenzuweisungen

Name Typ Beschreibung
id

string

Hierbei handelt es sich um die Rollenzuweisungs-ID.

name

string

Der Rollenzuweisungsname.

properties

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften.

type

string

Der Rollenzuweisungstyp.

RoleAssignmentListResult

Ergebnis des Vorgangs "Rollenzuweisungsliste".

Name Typ Beschreibung
nextLink

string

Die URL, die zum Abrufen der nächsten Ergebnismenge verwendet werden soll.

value

RoleAssignment[]

Rollenzuweisungsliste.

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften mit Bereich.

Name Typ Beschreibung
principalId

string

Die Prinzipal-ID.

roleDefinitionId

string

Hierbei handelt es sich um die Rollendefinitions-ID.

scope

RoleScope

Der Rollenbereich.

RoleScope

Der Rollenbereich.

Name Typ Beschreibung
/

string

Globaler Bereich

/keys

string

Schlüsselbereich