Condividi tramite

Role Assignments - List For Scope

Servizio:
Authorization
Versione API:
2022-04-01

Elencare tutte le assegnazioni di ruolo applicabili a un ambito.

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01
Con parametri facoltativi: 
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter={$filter}&tenantId={tenantId}&$skipToken={$skipToken}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
scope
 path True

string

L'identificatore Azure Resource Manager completamente qualificato della risorsa.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.
$filter
 query

string

Filtro da applicare all'operazione. Usare $filter=atScope() per restituire tutte le assegnazioni di ruolo al di sopra dell'ambito. Usare $filter=principalId eq {id} per restituire tutte le assegnazioni di ruolo al di sopra o al di sotto dell'ambito per l'entità specificata.
$skipToken
 query

string

SkipToken da applicare all'operazione. Usare $skipToken={skiptoken} per restituire assegnazioni di ruolo di paging dopo il passaggio skipToken. Supportato solo nelle chiamate a livello di provider.
tenantId
 query

string

ID tenant per la richiesta tra tenant

Risposte

Nome Tipo Descrizione
200 OK

RoleAssignmentListResult

La richiesta ha avuto esito positivo.
Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Autorizzazioni

Per chiamare questa API, è necessario che ti sia stato assegnato un ruolo con le autorizzazioni seguenti. Per altre informazioni, vedere Ruoli predefiniti di Azure.

Microsoft.Authorization/roleAssignments/read

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

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

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

List role assignments for scope

Esempio di richiesta

GET https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "name": "b0f43c54-e787-4862-89b1-a653fa9cf747",
      "type": "Microsoft.Authorization/roleAssignments",
      "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
      "properties": {
        "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
        "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
        "principalType": "User",
        "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
      }
    }
  ]
}

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
PrincipalType

Tipo di entità dell'ID entità assegnato.
RoleAssignment

Assegnazioni di ruolo
RoleAssignmentListResult

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

Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

ErrorDetail[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

PrincipalType

Enumerazione

Tipo di entità dell'ID entità assegnato.

Valore Descrizione
User

User
Group

Gruppo
ServicePrincipal

Servizio Principale
ForeignGroup

ForeignGroup
Device

Dispositivo

RoleAssignment

Oggetto

Assegnazioni di ruolo

Nome Tipo Valore predefinito Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

Nome della risorsa
properties.condition

string

Condizioni per l'assegnazione di ruolo. Questo limita le risorse a cui può essere assegnato. ad esempio: @Resource[Microsoft. Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'
properties.conditionVersion

string

Versione della condizione. Attualmente l'unico valore accettato è '2.0'
properties.createdBy

string

ID dell'utente che ha creato l'assegnazione
properties.createdOn

string (date-time)

Ora di creazione
properties.delegatedManagedIdentityResourceId

string

ID della risorsa identità gestita delegata
properties.description

string

Descrizione dell'assegnazione di ruolo
properties.principalId

string

ID entità.
properties.principalType

PrincipalType

User

Tipo di entità dell'ID entità assegnato.
properties.roleDefinitionId

string

ID definizione del ruolo.
properties.scope

string

Ambito dell'assegnazione di ruolo.
properties.updatedBy

string

ID dell'utente che ha aggiornato l'assegnazione
properties.updatedOn

string (date-time)

Ora di aggiornamento
systemData

systemData

Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
type

string

Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts"

RoleAssignmentListResult

Oggetto

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

Nome Tipo Descrizione
nextLink

string (uri)

Collegamento alla pagina successiva di elementi
value

RoleAssignment[]

Gli elementi di Assegnazione dei Ruoli in questa pagina

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Timestamp della creazione della risorsa (UTC).
createdBy

string

Identità che ha creato la risorsa.
createdByType

createdByType

Tipo di identità che ha creato la risorsa.
lastModifiedAt

string (date-time)

Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.