Role Assignments - Create

Service:

Key Vault

API Version:

7.4

Hiermee maakt u een roltoewijzing.

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

URI-parameters

Name	In	Vereist	Type	Description
roleAssignmentName	path	True	string	De naam van de roltoewijzing die moet worden gemaakt. Dit kan elke geldige GUID zijn.
scope	path	True	string	Het bereik van de roltoewijzing die moet worden gemaakt.
vaultBaseUrl	path	True	string	De kluisnaam, bijvoorbeeld https://myvault.vault.azure.net.
api-version	query	True	string	Client-API-versie.

Aanvraagbody

Name	Vereist	Type	Description
properties	True	RoleAssignmentProperties	Eigenschappen van roltoewijzing.

Antwoorden

Name	Type	Description
201 Created	RoleAssignment	Gemaakt: retourneert informatie over de roltoewijzing.
Other Status Codes	KeyVaultError	Key Vault foutbericht waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

PutRoleAssignments

Sample Request

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

Sample Response

Status code:

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

Definities

Name	Description
Error	De sleutelkluisserverfout.
KeyVaultError	De fout-uitzondering voor de sleutelkluis.
RoleAssignment	Roltoewijzingen
RoleAssignmentCreateParameters	Parameters voor het maken van roltoewijzingen.
RoleAssignmentProperties	Eigenschappen van roltoewijzing.
RoleAssignmentPropertiesWithScope	Eigenschappen van roltoewijzing met bereik.
RoleScope	Het rolbereik.

Error

De sleutelkluisserverfout.

Name	Type	Description
code	string	De foutcode.
innererror	Error	De sleutelkluisserverfout.
message	string	Het foutbericht.

KeyVaultError

De fout-uitzondering voor de sleutelkluis.

Name	Type	Description
error	Error	De sleutelkluisserverfout.

RoleAssignment

Roltoewijzingen

Name	Type	Description
id	string	De roltoewijzings-id.
name	string	De naam van de roltoewijzing.
properties	RoleAssignmentPropertiesWithScope	Eigenschappen van roltoewijzing.
type	string	Het roltoewijzingstype.

RoleAssignmentCreateParameters

Parameters voor het maken van roltoewijzingen.

Name	Type	Description
properties	RoleAssignmentProperties	Eigenschappen van roltoewijzing.

RoleAssignmentProperties

Eigenschappen van roltoewijzing.

Name	Type	Description
principalId	string	De principal-id die is toegewezen aan de rol. Dit wordt toegewezen aan de id in De Active Directory. Deze kan verwijzen naar een gebruiker, service-principal of beveiligingsgroep.
roleDefinitionId	string	De roldefinitie-id die wordt gebruikt in de roltoewijzing.

RoleAssignmentPropertiesWithScope

Eigenschappen van roltoewijzing met bereik.

Name	Type	Description
principalId	string	De principal-id.
roleDefinitionId	string	De roldefinitie-id.
scope	RoleScope	Het rolbereik.

RoleScope

Het rolbereik.

Name	Type	Description
/	string	Globaal bereik
/keys	string	Sleutelbereik