Partager via

Role Assignments - Create

Service:
Key Vault
Version d'API:
2025-07-01

Crée une attribution de rôle.

PUT {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2025-07-01

Paramètres URI

Nom Dans Obligatoire Type Description
roleAssignmentName
 path True

string

Nom de l’attribution de rôle à créer. Il peut s’agir de n’importe quel GUID valide.
scope
 path True

string

Étendue de l’attribution de rôle à créer.
vaultBaseUrl
 path True

string (uri)

api-version
 query True

string

minLength: 1

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

Corps de la demande

Nom Obligatoire Type Description
properties True

RoleAssignmentProperties

Propriétés d’attribution de rôle.

Réponses

Nom Type Description
201 Created

RoleAssignment

La requête a réussi et une nouvelle ressource a été créée en conséquence.
Other Status Codes

KeyVaultError

Réponse d’erreur inattendue.

Sécurité

OAuth2Auth

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

Étendues

Nom Description
https://vault.azure.net/.default

Exemples

Create a role assignment

Exemple de requête

PUT https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2025-07-01

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId"
  }
}

Exemple de réponse

Code d’état:
201 
{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId",
    "scope": "/keys"
  },
  "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleAssignmentId"
}

Définitions

Nom Description
Error
KeyVaultError

Exception d’erreur du coffre de clés.
RoleAssignment

Attributions de rôles
RoleAssignmentCreateParameters

Paramètres de création d’attribution de rôle.
RoleAssignmentProperties

Propriétés d’attribution de rôle.
RoleAssignmentPropertiesWithScope

Propriétés d’attribution de rôle avec portée.
RoleScope

Étendue du rôle.

Error

Object
Nom Type Description
code

string

Code d’erreur.
innererror

Error

Erreur de serveur Key Vault.
message

string

Message d’erreur.

KeyVaultError

Object

Exception d’erreur du coffre de clés.

Nom Type Description
error

Error

Erreur de serveur Key Vault.

RoleAssignment

Object

Attributions de rôles

Nom Type Description
id

string

ID d’attribution de rôle.
name

string

Nom de l’attribution de rôle.
properties

RoleAssignmentPropertiesWithScope

Propriétés d’attribution de rôle.
type

string

Type d’attribution de rôle.

RoleAssignmentCreateParameters

Object

Paramètres de création d’attribution de rôle.

Nom Type Description
properties

RoleAssignmentProperties

Propriétés d’attribution de rôle.

RoleAssignmentProperties

Object

Propriétés d’attribution de rôle.

Nom Type Description
principalId

string

ID principal affecté au rôle. Cela correspond à l’ID à l’intérieur d’Active Directory. Il peut pointer vers un utilisateur, un principal de service ou un groupe de sécurité.
roleDefinitionId

string

ID de définition de rôle utilisé dans l’attribution de rôle.

RoleAssignmentPropertiesWithScope

Object

Propriétés d’attribution de rôle avec portée.

Nom Type Description
principalId

string

ID du principal.
roleDefinitionId

string

ID de définition de rôle.
scope

RoleScope

Étendue du rôle.

RoleScope

Énumération

Étendue du rôle.

Valeur Description
/

Portée mondiale
/keys

Portée des clés