Role Assignments - List For Scope

Riferimento

Servizio:: Key Vault

Versione API:: 7.4

Ottiene le assegnazioni di ruolo per un ambito.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
scope	path	True	string	Ambito delle assegnazioni di ruolo.
vaultBaseUrl	path	True	string	Nome dell'insieme di credenziali, ad esempio https://myvault.vault.azure.net.
api-version	query	True	string	Versione API client.
$filter	query		string	Filtro da applicare all'operazione. Usare $filter=atScope() per restituire tutte le assegnazioni di ruolo in corrispondenza o superiore all'ambito. Usare $filter=principalId eq {id} per restituire tutte le assegnazioni di ruolo in corrispondenza, sopra o sotto l'ambito dell'entità specificata.

Risposte

Nome	Tipo	Descrizione
200 OK	RoleAssignmentListResult	OK: restituisce una matrice di assegnazioni di ruolo.
Other Status Codes	KeyVaultError	Key Vault risposta di errore che descrive perché l'operazione non è riuscita.

Esempio

ListRoleAssignments

Esempio di richiesta

HTTP

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

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	Errore del server dell'insieme di credenziali delle chiavi.
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.
RoleAssignment	Assegnazioni di ruoli
RoleAssignmentListResult	Risultato dell'operazione dell'elenco delle assegnazioni di ruolo.
RoleAssignmentPropertiesWithScope	Proprietà dell'assegnazione di ruoli con ambito.
RoleScope	Ambito del ruolo.

Error

Errore del server dell'insieme di credenziali delle chiavi.

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

Eccezione di errore dell'insieme di credenziali delle chiavi.

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

RoleAssignment

Assegnazioni di ruoli

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

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

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

RoleAssignmentPropertiesWithScope

Proprietà dell'assegnazione di ruoli con ambito.

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

RoleScope

Ambito del ruolo.

Nome	Tipo	Descrizione
/	string	Ambito globale
/keys	string	Ambito chiavi

Condividi tramite