Role Assignments - List For Scope

Usługa:

Key Vault

Wersja interfejsu API:

2025-07-01

Pobiera przypisania ról dla zakresu.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
scope	path	True	string	Zakres przypisań ról.
vaultBaseUrl	path	True	string (uri)	Podstawowy adres URL instancji Key Vault (np. https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
$filter	query		string	Filtr do zastosowania w operacji. Użyj $filter=atScope(), aby zwrócić wszystkie przypisania ról na poziomie lub powyżej zakresu. Użyj $filter=principalId eq {id}, aby zwrócić wszystkie przypisania ról w, powyżej lub poniżej zakresu dla określonego podmiotu zabezpieczeń.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	RoleAssignmentListResult	Żądanie zakończyło się pomyślnie.
Other Status Codes	KeyVaultError	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://vault.azure.net/.default

Przykłady

Get role assignments for a scope

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

{
  "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"
    }
  ]
}

Definicje

Nazwa	Opis
Error
KeyVaultError	Wyjątek błędu magazynu kluczy.
RoleAssignment	Przypisania ról
RoleAssignmentListResult	Wynik operacji listy przypisania ról.
RoleAssignmentPropertiesWithScope	Właściwości przypisania roli z zakresem.
RoleScope	Zakres roli.

Error

Objekt

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

KeyVaultError

Objekt

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

RoleAssignment

Objekt

Przypisania ról

Nazwa	Typ	Opis
id	string	Identyfikator przypisania roli.
name	string	Nazwa przypisania roli.
properties	RoleAssignmentPropertiesWithScope	Właściwości przypisania roli.
type	string	Typ przypisania roli.

RoleAssignmentListResult

Objekt

Wynik operacji listy przypisania ról.

Nazwa	Typ	Opis
nextLink	string	Adres URL używany do pobierania następnego zestawu wyników.
value	RoleAssignment[]	Lista przypisań ról.

RoleAssignmentPropertiesWithScope

Objekt

Właściwości przypisania roli z zakresem.

Nazwa	Typ	Opis
principalId	string	Identyfikator podmiotu zabezpieczeń.
roleDefinitionId	string	Identyfikator definicji roli.
scope	RoleScope	Zakres roli.

RoleScope

Wyliczenie

Zakres roli.

Wartość	Opis
/	Zakres globalny
/keys	Zakres kluczy