Role Assignments - List For Scope

Service:

Key Vault

API-versie:

2025-07-01

Krijgt roltoewijzingen voor een bereik.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
scope	path	True	string	De reikwijdte van de roltoewijzingen.
vaultBaseUrl	path	True	string (uri)	De basis-URL van de Key Vault-instantie (bijv. https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
$filter	query		string	Het filter dat moet worden toegepast op de bewerking. Gebruik $filter=atScope() om alle roltoewijzingen op of boven het bereik te retourneren. Gebruik $filter=principalId eq {id} om alle roltoewijzingen op, boven of onder het bereik voor de opgegeven principal te retourneren.

Antwoorden

Name	Type	Description
200 OK	RoleAssignmentListResult	De aanvraag is voltooid.
Other Status Codes	KeyVaultError	Een onverwachte foutreactie.

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

Voorbeelden

Get role assignments for a scope

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
Error
KeyVaultError	De uitzondering voor de sleutelkluisfout.
RoleAssignment	Roltoewijzingen
RoleAssignmentListResult	Roltoewijzing lijst resultaat bewerking.
RoleAssignmentPropertiesWithScope	Eigenschappen van roltoewijzing met bereik.
RoleScope	Het rolbereik.

Error

Object

Name	Type	Description
code	string	De foutcode.
innererror	Error	De sleutelkluisserverfout.
message	string	Het foutbericht.

KeyVaultError

Object

De uitzondering voor de sleutelkluisfout.

Name	Type	Description
error	Error	De sleutelkluisserverfout.

RoleAssignment

Object

Roltoewijzingen

Name	Type	Description
id	string	De roltoewijzings-id.
name	string	De naam van de roltoewijzing.
properties	RoleAssignmentPropertiesWithScope	Eigenschappen van roltoewijzing.
type	string	Het type roltoewijzing.

RoleAssignmentListResult

Object

Roltoewijzing lijst resultaat bewerking.

Name	Type	Description
nextLink	string	De URL die moet worden gebruikt voor het ophalen van de volgende set resultaten.
value	RoleAssignment[]	Lijst met roltoewijzingen.

RoleAssignmentPropertiesWithScope

Object

Eigenschappen van roltoewijzing met bereik.

Name	Type	Description
principalId	string	De principal-id.
roleDefinitionId	string	De id van de roldefinitie.
scope	RoleScope	Het rolbereik.

RoleScope

Opsomming

Het rolbereik.

Waarde	Description
/	Globaal bereik
/keys	Reikwijdte van de toetsen