Partager via


Role Definitions - Create Or Update

Crée ou met à jour une définition de rôle.

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

Paramètres URI

Nom Dans Obligatoire Type Description
roleDefinitionId
path True

string

ID de la définition de rôle.

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.

Corps de la demande

Nom Type Description
properties.assignableScopes

string[]

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

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.

Réponses

Nom Type Description
201 Created

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

Create role definition

Exemple de requête

PUT https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId?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.