Partager via


Role Definitions - List

Obtenez toutes les définitions de rôle applicables à l’étendue et au-dessus.

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

Paramètres URI

Nom Dans Obligatoire Type Description
scope
path True

string

Étendue de la définition de rôle.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

$filter
query

string

Filtre à appliquer à l’opération. Utilisez également le filtre atScopeAndBelow pour effectuer une recherche sous l’étendue donnée.

Réponses

Nom Type Description
200 OK

RoleDefinitionListResult

OK : retourne un tableau de définitions de rôles.

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Autorisations

Pour appeler cette API, vous devez disposer d’un rôle qui a les autorisations suivantes. Pour plus d’informations, voir Rôles intégrés Azure.

Microsoft.Authorization/roleDefinitions/read

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

List role definitions for scope

Sample Request

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

Sample Response

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

Définitions

Nom Description
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

Permission

Autorisations de définition de rôle.

RoleDefinition

Définition de rôle.

RoleDefinitionListResult

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

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

Permission

Autorisations de définition de rôle.

Nom Type Description
actions

string[]

Actions autorisées.

dataActions

string[]

Actions données autorisées.

notActions

string[]

Actions refusées.

notDataActions

string[]

Actions de données refusées.

RoleDefinition

Définition de rôle.

Nom Type Description
id

string

ID de définition de rôle.

name

string

Nom de la définition de rôle.

properties.assignableScopes

string[]

Étendues assignables de définition de rôle.

properties.createdBy

string

ID de l’utilisateur qui a créé l’affectation

properties.createdOn

string

Heure à laquelle il a été créé

properties.description

string

Description de la définition de rôle.

properties.permissions

Permission[]

Autorisations de définition de rôle.

properties.roleName

string

Nom du rôle.

properties.type

string

Type de rôle.

properties.updatedBy

string

ID de l’utilisateur qui a mis à jour l’affectation

properties.updatedOn

string

Heure à laquelle il a été mis à jour

type

string

Type de définition de rôle.

RoleDefinitionListResult

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

Nom Type Description
nextLink

string

URL à utiliser pour obtenir l’ensemble de résultats suivant.

value

RoleDefinition[]

Liste de définitions de rôle.