Role Assignments - List For Scope

Služba:

Key Vault

Verze rozhraní API:

2025-07-01

Získá přiřazení rolí pro obor.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
scope	path	True	string	Rozsah přiřazení rolí.
vaultBaseUrl	path	True	string (uri)	Základní URL instance Key Vault (např. https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
$filter	query		string	Filtr, který se má použít pro operaci. Pomocí $filter=atScope() vrátíte všechna přiřazení rolí v oboru nebo nad ním. Pomocí příkazu $filter=principalId eq {id} můžete vrátit všechna přiřazení rolí na, nad nebo pod oborem zadaného objektu zabezpečení.

Odpovědi

Name	Typ	Description
200 OK	RoleAssignmentListResult	Požadavek byl úspěšný.
Other Status Codes	KeyVaultError	Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

Get role assignments for a scope

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
Error
KeyVaultError	Výjimka chyby trezoru klíčů.
RoleAssignment	Přiřazení rolí
RoleAssignmentListResult	Výsledek operace seznamu přiřazení rolí.
RoleAssignmentPropertiesWithScope	Vlastnosti přiřazení role s oborem.
RoleScope	Obor role.

Error

Objekt

Name	Typ	Description
code	string	Kód chyby.
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva.

KeyVaultError

Objekt

Výjimka chyby trezoru klíčů.

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

RoleAssignment

Objekt

Přiřazení rolí

Name	Typ	Description
id	string	ID přiřazení role.
name	string	Název přiřazení role.
properties	RoleAssignmentPropertiesWithScope	Vlastnosti přiřazení role.
type	string	Typ přiřazení role.

RoleAssignmentListResult

Objekt

Výsledek operace seznamu přiřazení rolí.

Name	Typ	Description
nextLink	string	Adresa URL, která se má použít k získání další sady výsledků.
value	RoleAssignment[]	Seznam přiřazení rolí.

RoleAssignmentPropertiesWithScope

Objekt

Vlastnosti přiřazení role s oborem.

Name	Typ	Description
principalId	string	ID objektu zabezpečení.
roleDefinitionId	string	ID definice role.
scope	RoleScope	Obor role.

RoleScope

Výčet

Obor role.

Hodnota	Description
/	Globální obor
/keys	Rozsah klíčů