Role Assignments - List For Scope

Szolgáltatás:

Key Vault

API-verzió:

2025-07-01

Szerepkör-hozzárendeléseket kér le egy hatókörhöz.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
scope	path	True	string	A szerepkör-hozzárendelések hatóköre.
vaultBaseUrl	path	True	string (uri)	A Key Vault példány alap URL-je (pl. https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
$filter	query		string	A műveletre alkalmazandó szűrő. A $filter=atScope() használatával a hatókörben vagy felett lévő összes szerepkör-hozzárendelést visszaadhatja. A $filter=principalId eq {id} használatával a megadott rendszerbiztonsági tag hatókörén, felette vagy alatt lévő összes szerepkör-hozzárendelést visszaadhatja.

Válaszok

Name	Típus	Description
200 OK	RoleAssignmentListResult	A kérés sikeres volt.
Other Status Codes	KeyVaultError	Váratlan hibaválasz.

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

Get role assignments for a scope

Mintakérelem

HTTP

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

Mintaválasz

Állapotkó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"
    }
  ]
}

Definíciók

Name	Description
Error
KeyVaultError	A kulcstartó hibakivétele.
RoleAssignment	Szerepkör hozzárendelések
RoleAssignmentListResult	Szerepkör-hozzárendelési lista műveleti eredménye.
RoleAssignmentPropertiesWithScope	Szerepkör-hozzárendelési tulajdonságok hatókörrel.
RoleScope	A szerepkör hatóköre.

Error

Tárgy

Name	Típus	Description
code	string	A hibakód.
innererror	Error	A Key Vault-kiszolgáló hibája.
message	string	A hibaüzenet.

KeyVaultError

Tárgy

A kulcstartó hibakivétele.

Name	Típus	Description
error	Error	A Key Vault-kiszolgáló hibája.

RoleAssignment

Tárgy

Szerepkör hozzárendelések

Name	Típus	Description
id	string	A szerepkör-hozzárendelés azonosítója.
name	string	A szerepkör-hozzárendelés neve.
properties	RoleAssignmentPropertiesWithScope	Szerepkör-hozzárendelés tulajdonságai.
type	string	A szerepkör-hozzárendelés típusa.

RoleAssignmentListResult

Tárgy

Szerepkör-hozzárendelési lista műveleti eredménye.

Name	Típus	Description
nextLink	string	A következő találatkészlet lekéréséhez használandó URL-cím.
value	RoleAssignment[]	Szerepkör-hozzárendelési lista.

RoleAssignmentPropertiesWithScope

Tárgy

Szerepkör-hozzárendelési tulajdonságok hatókörrel.

Name	Típus	Description
principalId	string	Az egyszerű azonosító.
roleDefinitionId	string	A szerepkördefiníció azonosítója.
scope	RoleScope	A szerepkör hatóköre.

RoleScope

Felsorolás

A szerepkör hatóköre.

Érték	Description
/	Globális hatókör
/keys	Kulcsok hatóköre