Role Assignments - Create

Service:

Key Vault

API Version:

7.4

Membuat penetapan peran.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
roleAssignmentName	path	True	string	Nama penetapan peran yang akan dibuat. Ini bisa menjadi GUID yang valid.
scope	path	True	string	Cakupan penetapan peran yang akan dibuat.
vaultBaseUrl	path	True	string	Nama vault, misalnya https://myvault.vault.azure.net.
api-version	query	True	string	Versi API klien.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
properties	True	RoleAssignmentProperties	Properti penetapan peran.

Respons

Nama	Jenis	Deskripsi
201 Created	RoleAssignment	Dibuat - Mengembalikan informasi tentang penetapan peran.
Other Status Codes	KeyVaultError	Key Vault respons kesalahan yang menjelaskan mengapa operasi gagal.

Contoh

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

Definisi

Nama	Deskripsi
Error	Kesalahan server brankas kunci.
KeyVaultError	Pengecualian kesalahan brankas kunci.
RoleAssignment	Penetapan Peran
RoleAssignmentCreateParameters	Penetapan peran membuat parameter.
RoleAssignmentProperties	Properti penetapan peran.
RoleAssignmentPropertiesWithScope	Properti penetapan peran dengan cakupan.
RoleScope	Cakupan peran.

Error

Kesalahan server brankas kunci.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
innererror	Error	Kesalahan server brankas kunci.
message	string	Pesan kesalahan.

KeyVaultError

Pengecualian kesalahan brankas kunci.

Nama	Jenis	Deskripsi
error	Error	Kesalahan server brankas kunci.

RoleAssignment

Penetapan Peran

Nama	Jenis	Deskripsi
id	string	ID penetapan peran.
name	string	Nama penetapan peran.
properties	RoleAssignmentPropertiesWithScope	Properti penetapan peran.
type	string	Jenis penetapan peran.

RoleAssignmentCreateParameters

Penetapan peran membuat parameter.

Nama	Jenis	Deskripsi
properties	RoleAssignmentProperties	Properti penetapan peran.

RoleAssignmentProperties

Properti penetapan peran.

Nama	Jenis	Deskripsi
principalId	string	ID utama yang ditetapkan ke peran. Ini memetakan ke ID di dalam Direktori Aktif. Ini dapat menunjuk ke pengguna, perwakilan layanan, atau grup keamanan.
roleDefinitionId	string	ID definisi peran yang digunakan dalam penetapan peran.

RoleAssignmentPropertiesWithScope

Properti penetapan peran dengan cakupan.

Nama	Jenis	Deskripsi
principalId	string	ID utama.
roleDefinitionId	string	ID definisi peran.
scope	RoleScope	Cakupan peran.

RoleScope

Cakupan peran.

Nama	Jenis	Deskripsi
/	string	Lingkup global
/keys	string	Cakupan kunci