Partager via


Role Definitions - Get By Id

Obtient une définition de rôle par ID.

GET https://management.azure.com/{roleId}?disambiguation_dummy&api-version=2022-04-01

Paramètres URI

Nom Dans Obligatoire Type Description
roleId
path True

string

ID de définition de rôle complet. Utilisez le format /subscriptions/{guid}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId} pour les définitions de rôle au niveau de l’abonnement, ou /providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId} pour les définitions de rôle au niveau du locataire.

api-version
query True

string

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

Réponses

Nom Type Description
200 OK

RoleDefinition

OK : retourne des informations sur la définition de rôle.

Other Status Codes

ErrorResponse

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

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

Get role definition by ID

Exemple de requête

GET https://management.azure.com/roleDefinitionId?disambiguation_dummy&api-version=2022-04-01

Exemple de réponse

{
  "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.

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.