Role Assignments - Create

Référence

Service:: Key Vault

Version d'API:: 7.4

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

HTTP

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

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

Partager via