Role Assignments - Create

Service:

Key Vault

API Version:

7.4

Skapar en rolltilldelning.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
roleAssignmentName	path	True	string	Namnet på rolltilldelningen som ska skapas. Det kan vara valfritt giltigt GUID.
scope	path	True	string	Omfånget för rolltilldelningen som ska skapas.
vaultBaseUrl	path	True	string	Valvnamnet, till exempel https://myvault.vault.azure.net.
api-version	query	True	string	Klient-API-version.

Begärandetext

Name	Obligatorisk	Typ	Description
properties	True	RoleAssignmentProperties	Egenskaper för rolltilldelning.

Svar

Name	Typ	Description
201 Created	RoleAssignment	Skapad – returnerar information om rolltilldelningen.
Other Status Codes	KeyVaultError	Key Vault felsvar som beskriver varför åtgärden misslyckades.

Exempel

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

Definitioner

Name	Description
Error	Key Vault-serverns fel.
KeyVaultError	Felfelet för nyckelvalvet.
RoleAssignment	Rolltilldelningar
RoleAssignmentCreateParameters	Skapa parametrar för rolltilldelning.
RoleAssignmentProperties	Egenskaper för rolltilldelning.
RoleAssignmentPropertiesWithScope	Rolltilldelningsegenskaper med omfång.
RoleScope	Rollomfånget.

Error

Key Vault-serverns fel.

Name	Typ	Description
code	string	Felkoden.
innererror	Error	Key Vault-serverns fel.
message	string	Felmeddelandet.

KeyVaultError

Felfelet för nyckelvalvet.

Name	Typ	Description
error	Error	Key Vault-serverns fel.

RoleAssignment

Rolltilldelningar

Name	Typ	Description
id	string	Rolltilldelnings-ID.
name	string	Rolltilldelningens namn.
properties	RoleAssignmentPropertiesWithScope	Egenskaper för rolltilldelning.
type	string	Rolltilldelningstypen.

RoleAssignmentCreateParameters

Skapa parametrar för rolltilldelning.

Name	Typ	Description
properties	RoleAssignmentProperties	Egenskaper för rolltilldelning.

RoleAssignmentProperties

Egenskaper för rolltilldelning.

Name	Typ	Description
principalId	string	Det huvudkonto-ID som tilldelats rollen. Detta mappar till ID:t i Active Directory. Den kan peka på en användare, tjänstens huvudnamn eller säkerhetsgrupp.
roleDefinitionId	string	Rolldefinitions-ID:t som används i rolltilldelningen.

RoleAssignmentPropertiesWithScope

Rolltilldelningsegenskaper med omfång.

Name	Typ	Description
principalId	string	Huvudkonto-ID.
roleDefinitionId	string	Rolldefinitions-ID.
scope	RoleScope	Rollomfånget.

RoleScope

Rollomfånget.

Name	Typ	Description
/	string	Globalt omfång
/keys	string	Omfång för nycklar