Role Definitions - List

Service:

Key Vault

API Version:

7.4

Dapatkan semua definisi peran yang berlaku pada cakupan dan di atasnya.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleDefinitions?api-version=7.4

With optional parameters:

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleDefinitions?$filter={$filter}&api-version=7.4

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
scope	path	True	string	Cakupan definisi peran.
vaultBaseUrl	path	True	string	Nama vault, misalnya https://myvault.vault.azure.net.
api-version	query	True	string	Versi API klien.
$filter	query		string	Filter yang akan diterapkan pada operasi. Gunakan filter atScopeAndBelow untuk mencari di bawah cakupan yang diberikan juga.

Respons

Nama	Jenis	Deskripsi
200 OK	RoleDefinitionListResult	OK - Mengembalikan array definisi peran.
Other Status Codes	KeyVaultError	Key Vault respons kesalahan yang menjelaskan mengapa operasi gagal.

Contoh

ListRoleDefinitions

Sample Request

HTTP

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleDefinitions?api-version=7.4

Sample Response

Status code:

200

{
  "value": [
    {
      "properties": {
        "roleName": "Role name",
        "type": "roletype",
        "description": "Role description",
        "assignableScopes": [
          "/keys"
        ],
        "permissions": [
          {
            "actions": [
              "get"
            ],
            "notActions": []
          }
        ]
      },
      "id": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
      "type": "Microsoft.Authorization/roleDefinitions",
      "name": "roleDefinitionId"
    }
  ]
}

Definisi

Nama	Deskripsi
DataAction	Izin yang didukung untuk tindakan data.
Error	Kesalahan server brankas kunci.
KeyVaultError	Pengecualian kesalahan brankas kunci.
Permission	Izin definisi peran.
RoleDefinition	Definisi peran.
RoleDefinitionListResult	Hasil operasi daftar definisi peran.
RoleDefinitionType	Jenis definisi peran.
RoleScope	Cakupan peran.
RoleType	Jenis peran.

DataAction

Izin yang didukung untuk tindakan data.

Nama	Jenis	Deskripsi
Microsoft.KeyVault/managedHsm/backup/start/action	string	Mulai pencadangan HSM.
Microsoft.KeyVault/managedHsm/backup/status/action	string	Membaca status pencadangan HSM.
Microsoft.KeyVault/managedHsm/keys/backup/action	string	Cadangkan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/create	string	Membuat kunci HSM.
Microsoft.KeyVault/managedHsm/keys/decrypt/action	string	Dekripsi menggunakan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/delete	string	Menghapus kunci HSM.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/delete	string	Hapus menyeluruh kunci HSM yang dihapus.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/read/action	string	Membaca kunci HSM yang dihapus.
Microsoft.KeyVault/managedHsm/keys/deletedKeys/recover/action	string	Pulihkan kunci HSM yang dihapus.
Microsoft.KeyVault/managedHsm/keys/encrypt/action	string	Enkripsi menggunakan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/export/action	string	Mengekspor kunci HSM.
Microsoft.KeyVault/managedHsm/keys/import/action	string	Mengimpor kunci HSM.
Microsoft.KeyVault/managedHsm/keys/read/action	string	Baca metadata kunci HSM.
Microsoft.KeyVault/managedHsm/keys/release/action	string	Merilis kunci HSM menggunakan Rilis Kunci Aman.
Microsoft.KeyVault/managedHsm/keys/restore/action	string	Memulihkan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/sign/action	string	Masuk menggunakan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/unwrap/action	string	Buka bungkus menggunakan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/verify/action	string	Verifikasi menggunakan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/wrap/action	string	Bungkus menggunakan kunci HSM.
Microsoft.KeyVault/managedHsm/keys/write/action	string	Memperbarui kunci HSM.
Microsoft.KeyVault/managedHsm/restore/start/action	string	Mulai pemulihan HSM.
Microsoft.KeyVault/managedHsm/restore/status/action	string	Membaca status pemulihan HSM.
Microsoft.KeyVault/managedHsm/rng/action	string	Menghasilkan angka acak.
Microsoft.KeyVault/managedHsm/roleAssignments/delete/action	string	Menghapus penetapan peran.
Microsoft.KeyVault/managedHsm/roleAssignments/read/action	string	Dapatkan penetapan peran.
Microsoft.KeyVault/managedHsm/roleAssignments/write/action	string	Membuat atau memperbarui penetapan peran.
Microsoft.KeyVault/managedHsm/roleDefinitions/delete/action	string	Menghapus definisi peran.
Microsoft.KeyVault/managedHsm/roleDefinitions/read/action	string	Mendapatkan definisi peran.
Microsoft.KeyVault/managedHsm/roleDefinitions/write/action	string	Membuat atau memperbarui definisi peran.
Microsoft.KeyVault/managedHsm/securitydomain/download/action	string	Unduh domain keamanan HSM.
Microsoft.KeyVault/managedHsm/securitydomain/download/read	string	Periksa status unduhan domain keamanan HSM.
Microsoft.KeyVault/managedHsm/securitydomain/transferkey/read	string	Unduh kunci transfer domain keamanan HSM.
Microsoft.KeyVault/managedHsm/securitydomain/upload/action	string	Unggah domain keamanan HSM.
Microsoft.KeyVault/managedHsm/securitydomain/upload/read	string	Periksa status file pertukaran domain keamanan HSM.

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.

Permission

Izin definisi peran.

Nama	Jenis	Deskripsi
actions	string[]	Izin tindakan yang diberikan.
dataActions	DataAction[]	Izin tindakan data yang diberikan.
notActions	string[]	Izin tindakan yang dikecualikan tetapi tidak ditolak. Mereka dapat diberikan oleh definisi peran lain yang ditetapkan ke prinsipal.
notDataActions	DataAction[]	Izin tindakan data yang dikecualikan tetapi tidak ditolak. Mereka dapat diberikan oleh definisi peran lain yang ditetapkan ke prinsipal.

RoleDefinition

Definisi peran.

Nama	Jenis	Deskripsi
id	string	ID definisi peran.
name	string	Nama definisi peran.
properties.assignableScopes	RoleScope[]	Cakupan yang dapat ditetapkan definisi peran.
properties.description	string	Deskripsi definisi peran.
properties.permissions	Permission[]	Izin definisi peran.
properties.roleName	string	Nama peran.
properties.type	RoleType	Jenis peran.
type	RoleDefinitionType	Jenis definisi peran.

RoleDefinitionListResult

Hasil operasi daftar definisi peran.

Nama	Jenis	Deskripsi
nextLink	string	URL yang digunakan untuk mendapatkan serangkaian hasil berikutnya.
value	RoleDefinition[]	Daftar definisi peran.

RoleDefinitionType

Jenis definisi peran.

Nama	Jenis	Deskripsi
Microsoft.Authorization/roleDefinitions	string

RoleScope

Cakupan peran.

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

RoleType

Jenis peran.

Nama	Jenis	Deskripsi
AKVBuiltInRole	string	Peran bawaan.
CustomRole	string	Peran kustom.