Role Assignments - List For Scope

Servizio:

Key Vault

Versione API:

2025-07-01

Ottiene le assegnazioni di ruolo per un ambito.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
scope	path	True	string	Ambito delle assegnazioni di ruolo.
vaultBaseUrl	path	True	string (uri)	L'URL base dell'istanza di Key Vault (ad https://myvault.vault.azure.net/esempio )
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$filter	query		string	Filtro da applicare all'operazione. Usa $filter=atScope() per restituire tutte le assegnazioni di ruolo in corrispondenza o al di sopra dell'ambito. Usa $filter=principalId eq {id} per restituire tutte le assegnazioni di ruolo a, sopra o sotto l'ambito per l'entità specificata.

Risposte

Nome	Tipo	Descrizione
200 OK	RoleAssignmentListResult	La richiesta ha avuto esito positivo.
Other Status Codes	KeyVaultError	Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://vault.azure.net/.default

Esempio

Get role assignments for a scope

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Error
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.
RoleAssignment	Assegnazioni di ruolo
RoleAssignmentListResult	Risultato dell'operazione dell'elenco di assegnazioni di ruolo.
RoleAssignmentPropertiesWithScope	Proprietà dell'assegnazione di ruolo con ambito.
RoleScope	Ambito del ruolo.

Error

Oggetto

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	Error	Errore del server dell'insieme di credenziali delle chiavi.
message	string	Messaggio di errore.

KeyVaultError

Oggetto

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
error	Error	Errore del server dell'insieme di credenziali delle chiavi.

RoleAssignment

Oggetto

Assegnazioni di ruolo

Nome	Tipo	Descrizione
id	string	ID assegnazione di ruolo.
name	string	Nome dell'assegnazione di ruolo.
properties	RoleAssignmentPropertiesWithScope	Proprietà dell'assegnazione di ruolo.
type	string	Tipo di assegnazione di ruolo.

RoleAssignmentListResult

Oggetto

Risultato dell'operazione dell'elenco di assegnazioni di ruolo.

Nome	Tipo	Descrizione
nextLink	string	URL da usare per ottenere il set di risultati successivo.
value	RoleAssignment[]	Elenco di assegnazione dei ruoli.

RoleAssignmentPropertiesWithScope

Oggetto

Proprietà dell'assegnazione di ruolo con ambito.

Nome	Tipo	Descrizione
principalId	string	ID entità.
roleDefinitionId	string	ID definizione del ruolo.
scope	RoleScope	Ambito del ruolo.

RoleScope

Enumerazione

Ambito del ruolo.

Valore	Descrizione
/	Ambito Globale
/keys	Ambito delle chiavi