Role Assignments - Create

Service:

Key Vault

API Version:

7.4

Létrehoz egy szerepkör-hozzárendelést.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
roleAssignmentName	path	True	string	A létrehozandó szerepkör-hozzárendelés neve. Bármilyen érvényes GUID lehet.
scope	path	True	string	A létrehozandó szerepkör-hozzárendelés hatóköre.
vaultBaseUrl	path	True	string	A tároló neve, például https://myvault.vault.azure.net.
api-version	query	True	string	Ügyfél API-verziója.

Kérelem törzse

Name	Kötelező	Típus	Description
properties	True	RoleAssignmentProperties	Szerepkör-hozzárendelés tulajdonságai.

Válaszok

Name	Típus	Description
201 Created	RoleAssignment	Létrehozva – A szerepkör-hozzárendeléssel kapcsolatos információkat adja vissza.
Other Status Codes	KeyVaultError	Key Vault hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Példák

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

Definíciók

Name	Description
Error	A Key Vault-kiszolgáló hibája.
KeyVaultError	A key vault hibakivétele.
RoleAssignment	Szerepkör-hozzárendelések
RoleAssignmentCreateParameters	Szerepkör-hozzárendelési paraméterek létrehozása.
RoleAssignmentProperties	Szerepkör-hozzárendelés tulajdonságai.
RoleAssignmentPropertiesWithScope	Szerepkör-hozzárendelés tulajdonságai hatókörrel.
RoleScope	A szerepkör hatóköre.

Error

A Key Vault-kiszolgáló hibája.

Name	Típus	Description
code	string	A hibakód.
innererror	Error	A Key Vault-kiszolgáló hibája.
message	string	A hibaüzenet.

KeyVaultError

A key vault hibakivétele.

Name	Típus	Description
error	Error	A Key Vault-kiszolgáló hibája.

RoleAssignment

Szerepkör-hozzárendelések

Name	Típus	Description
id	string	A szerepkör-hozzárendelés azonosítója.
name	string	A szerepkör-hozzárendelés neve.
properties	RoleAssignmentPropertiesWithScope	Szerepkör-hozzárendelés tulajdonságai.
type	string	A szerepkör-hozzárendelés típusa.

RoleAssignmentCreateParameters

Szerepkör-hozzárendelési paraméterek létrehozása.

Name	Típus	Description
properties	RoleAssignmentProperties	Szerepkör-hozzárendelés tulajdonságai.

RoleAssignmentProperties

Szerepkör-hozzárendelés tulajdonságai.

Name	Típus	Description
principalId	string	A szerepkörhöz rendelt egyszerű azonosító. Ez megfelel az Active Directoryban található azonosítónak. Egy felhasználóra, szolgáltatásnévre vagy biztonsági csoportra mutathat.
roleDefinitionId	string	A szerepkör-hozzárendelésben használt szerepkördefiníció-azonosító.

RoleAssignmentPropertiesWithScope

Szerepkör-hozzárendelés tulajdonságai hatókörrel.

Name	Típus	Description
principalId	string	Az egyszerű azonosító.
roleDefinitionId	string	A szerepkördefiníció azonosítója.
scope	RoleScope	A szerepkör hatóköre.

RoleScope

A szerepkör hatóköre.

Name	Típus	Description
/	string	Globális hatókör
/keys	string	Kulcsok hatóköre