Role Assignments - List For Scope

Service:

Key Vault

Version d'API:

2025-07-01

Obtient les attributions de rôles pour une étendue.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
scope	path	True	string	L’étendue des attributions de rôles.
vaultBaseUrl	path	True	string (uri)	L’URL de base de l’instance Key Vault (par exemple https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
$filter	query		string	Filtre à appliquer sur l’opération. Utilisez $filter=atScope() pour renvoyer toutes les attributions de rôles au niveau ou au-dessus de la portée. Utilisez $filter=principalId eq {id} pour renvoyer toutes les attributions de rôle au-dessus, au-dessous de la portée du principal spécifié.

Réponses

Nom	Type	Description
200 OK	RoleAssignmentListResult	La demande a réussi.
Other Status Codes	KeyVaultError	Réponse d’erreur inattendue.

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

Get role assignments for a scope

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
Error
KeyVaultError	Exception d’erreur du coffre de clés.
RoleAssignment	Attributions de rôles
RoleAssignmentListResult	Résultat de l’opération de liste d’attribution de rôle.
RoleAssignmentPropertiesWithScope	Propriétés d’attribution de rôle avec portée.
RoleScope	Étendue du rôle.

Error

Objet

Nom	Type	Description
code	string	Code d’erreur.
innererror	Error	Erreur du serveur key vault.
message	string	Message d’erreur.

KeyVaultError

Objet

Exception d’erreur du coffre de clés.

Nom	Type	Description
error	Error	Erreur du serveur key vault.

RoleAssignment

Objet

Attributions de rôles

Nom	Type	Description
id	string	ID d’attribution de rôle.
name	string	Nom de l’attribution de rôle.
properties	RoleAssignmentPropertiesWithScope	Propriétés d’attribution de rôle.
type	string	Type d’attribution de rôle.

RoleAssignmentListResult

Objet

Résultat de l’opération de liste d’attribution de rôle.

Nom	Type	Description
nextLink	string	URL à utiliser pour obtenir l’ensemble de résultats suivant.
value	RoleAssignment[]	Liste d’attribution des rôles.

RoleAssignmentPropertiesWithScope

Objet

Propriétés d’attribution de rôle avec portée.

Nom	Type	Description
principalId	string	ID du principal.
roleDefinitionId	string	ID de définition de rôle.
scope	RoleScope	Étendue du rôle.

RoleScope

Énumération

Étendue du rôle.

Valeur	Description
/	Étendue globale
/keys	Portée des clés