Role Definitions - List

Ottenere tutte le definizioni di ruolo applicabili all'ambito e versioni successive.

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?api-version=2022-04-01
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?$filter={$filter}&api-version=2022-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
scope
path True

string

Ambito della definizione del ruolo.

api-version
query True

string

Versione dell'API da usare per questa operazione.

$filter
query

string

Filtro da applicare all'operazione. Usare anche il filtro atScopeAndBelow per cercare sotto l'ambito specificato.

Risposte

Nome Tipo Descrizione
200 OK

RoleDefinitionListResult

OK: restituisce una matrice di definizioni di ruolo.

Other Status Codes

ErrorResponse

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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 definitions for scope

Esempio di richiesta

GET https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions?api-version=2022-04-01

Risposta di esempio

{
  "value": [
    {
      "properties": {
        "roleName": "Role name",
        "type": "roletype",
        "description": "Role description",
        "assignableScopes": [
          "/subscriptions/subId"
        ],
        "permissions": [
          {
            "actions": [
              "action"
            ],
            "notActions": [],
            "dataActions": [
              "dataAction"
            ],
            "notDataActions": []
          }
        ]
      },
      "id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
      "type": "Microsoft.Authorization/roleDefinitions",
      "name": "roleDefinitionId"
    }
  ]
}

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

Permission

Autorizzazioni di definizione del ruolo.

RoleDefinition

Definizione del ruolo.

RoleDefinitionListResult

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

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

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

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

Permission

Autorizzazioni di definizione del ruolo.

Nome Tipo Descrizione
actions

string[]

Azioni consentite.

dataActions

string[]

Azioni dati consentite.

notActions

string[]

Azioni negate.

notDataActions

string[]

Azioni dati negate.

RoleDefinition

Definizione del ruolo.

Nome Tipo Descrizione
id

string

ID definizione del ruolo.

name

string

Nome della definizione del ruolo.

properties.assignableScopes

string[]

Ambiti assegnabili di definizione del ruolo.

properties.createdBy

string

ID dell'utente che ha creato l'assegnazione

properties.createdOn

string

Ora di creazione

properties.description

string

Descrizione della definizione del ruolo.

properties.permissions

Permission[]

Autorizzazioni di definizione del ruolo.

properties.roleName

string

Nome del ruolo.

properties.type

string

Tipo di ruolo.

properties.updatedBy

string

ID dell'utente che ha aggiornato l'assegnazione

properties.updatedOn

string

Ora in cui è stato aggiornato

type

string

Tipo di definizione del ruolo.

RoleDefinitionListResult

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

Nome Tipo Descrizione
nextLink

string

URL da usare per ottenere il set successivo di risultati.

value

RoleDefinition[]

Elenco delle definizioni di ruolo.