Partager via


Role Assignments - Create

Crée une attribution de rôle.

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

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

Nom du coffre, par exemple https://myvault.vault.azure.net.

api-version
query True

string

Version d’API client.

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

Créé : retourne des informations sur l’attribution de rôle.

Other Status Codes

KeyVaultError

Key Vault réponse d’erreur décrivant la raison de l’échec de l’opération.

Exemples

PutRoleAssignments

Exemple de requête

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

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

Exemple de réponse

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

Erreur du serveur du coffre de clés.

KeyVaultError

Exception d’erreur du coffre de clés.

RoleAssignment

Affectations de rôles

RoleAssignmentCreateParameters

L’attribution de rôle crée des paramètres.

RoleAssignmentProperties

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

RoleAssignmentPropertiesWithScope

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

RoleScope

Étendue du rôle.

Error

Erreur du serveur du coffre de clés.

Nom Type Description
code

string

Code d'erreur.

innererror

Error

Erreur du serveur du coffre de clés.

message

string

Message d’erreur.

KeyVaultError

Exception d’erreur du coffre de clés.

Nom Type Description
error

Error

Erreur du serveur du coffre de clés.

RoleAssignment

Affectations 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

L’attribution de rôle crée des paramètres.

Nom Type Description
properties

RoleAssignmentProperties

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

RoleAssignmentProperties

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

Nom Type Description
principalId

string

ID de principal affecté au rôle. Cela correspond à l’ID dans 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

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

Nom Type Description
principalId

string

ID du principal.

roleDefinitionId

string

ID de définition de rôle.

scope

RoleScope

Étendue du rôle.

RoleScope

Étendue du rôle.

Nom Type Description
/

string

Étendue globale

/keys

string

Étendue des clés