Role Assignments - List For Scope

Layanan:

Key Vault

Versi API:

2025-07-01

Mendapatkan penetapan peran untuk cakupan.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01

Dengan parameter opsional:

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01&$filter={$filter}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
scope	path	True	string	Ruang lingkup penugasan peran.
vaultBaseUrl	path	True	string (uri)	URL dasar instance Key Vault (misalnya https://myvault.vault.azure.net/)
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$filter	query		string	Filter yang akan diterapkan pada operasi. Gunakan $filter=atScope() untuk mengembalikan semua penetapan peran pada atau di atas cakupan. Gunakan $filter=principalId eq {id} untuk mengembalikan semua penetapan peran di, di atas, atau di bawah cakupan untuk perwakilan yang ditentukan.

Respons

Nama	Jenis	Deskripsi
200 OK	RoleAssignmentListResult	Permintaan telah berhasil.
Other Status Codes	KeyVaultError	Respons kesalahan tak terduga.

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://vault.azure.net/.default

Contoh

Get role assignments for a scope

Permintaan sampel

HTTP

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01

Respon sampel

Kode status:

200

{
  "value": [
    {
      "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
KeyVaultError	Pengecualian kesalahan brankas kunci.
RoleAssignment	Penetapan Peran
RoleAssignmentListResult	Hasil operasi daftar penetapan peran.
RoleAssignmentPropertiesWithScope	Properti penetapan peran dengan cakupan.
RoleScope	Cakupan peran.

Error

Objek

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

KeyVaultError

Objek

Pengecualian kesalahan brankas kunci.

Nama	Jenis	Deskripsi
error	Error	Kesalahan server brankas kunci.

RoleAssignment

Objek

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.

RoleAssignmentListResult

Objek

Hasil operasi daftar penetapan peran.

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

RoleAssignmentPropertiesWithScope

Objek

Properti penetapan peran dengan cakupan.

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

RoleScope

Enumerasi

Cakupan peran.

Nilai	Deskripsi
/	Cakupan global
/keys	Cakupan kunci