Bagikan melalui


Role Assignments - List For Resource

Mencantumkan semua penetapan peran yang berlaku untuk sumber daya.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter={$filter}&tenantId={tenantId}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
resourceGroupName
path True

string

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

resourceName
path True

string

Nama sumber daya.

resourceProviderNamespace
path True

string

Namespace penyedia sumber daya.

resourceType
path True

string

Nama jenis sumber daya. Misalnya nama jenis aplikasi web adalah 'situs' (dari Microsoft.Web/sites).

subscriptionId
path True

string

ID langganan target.

api-version
query True

string

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 pada, di atas atau di bawah cakupan untuk prinsipal yang ditentukan.

tenantId
query

string

ID Penyewa untuk permintaan lintas penyewa

Respons

Nama Jenis Deskripsi
200 OK

RoleAssignmentListResult

Mengembalikan array penetapan peran.

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Izin

Untuk memanggil API ini, Anda harus diberi peran yang memiliki izin berikut. Untuk informasi selengkapnya, lihat Peran bawaan Azure.

Microsoft.Authorization/roleAssignments/read

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

List role assignments for a resource

Permintaan sampel

GET https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/resourceGroups/testrg/providers/Microsoft.DocumentDb/databaseAccounts/test-db-account/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01

Respon sampel

{
  "value": [
    {
      "properties": {
        "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
        "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
        "principalType": "User",
        "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
      },
      "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
      "type": "Microsoft.Authorization/roleAssignments",
      "name": "b0f43c54-e787-4862-89b1-a653fa9cf747"
    },
    {
      "properties": {
        "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
        "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
        "principalType": "User",
        "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/resourceGroups/testrg"
      },
      "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/resourceGroups/testrg/providers/Microsoft.Authorization/roleAssignments/96786e4b-dede-4c2e-8736-8ab911987f08",
      "type": "Microsoft.Authorization/roleAssignments",
      "name": "96786e4b-dede-4c2e-8736-8ab911987f08"
    },
    {
      "properties": {
        "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
        "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
        "principalType": "User",
        "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/resourceGroups/testrg/providers/Microsoft.DocumentDb/databaseAccounts/test-db-account"
      },
      "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/resourceGroups/testrg/providers/Microsoft.DocumentDb/databaseAccounts/test-db-account/providers/Microsoft.Authorization/roleAssignments/05c5a614-a7d6-4502-b150-c2fb455033ff",
      "type": "Microsoft.Authorization/roleAssignments",
      "name": "05c5a614-a7d6-4502-b150-c2fb455033ff"
    }
  ]
}

Definisi

Nama Deskripsi
ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

PrincipalType

Jenis utama ID utama yang ditetapkan.

RoleAssignment

Penetapan Peran

RoleAssignmentListResult

Hasil operasi daftar penetapan peran.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

PrincipalType

Jenis utama ID utama yang ditetapkan.

Nama Jenis Deskripsi
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

Penetapan Peran

Nama Jenis Nilai default Deskripsi
id

string

ID penetapan peran.

name

string

Nama penetapan peran.

properties.condition

string

Kondisi pada penetapan peran. Ini membatasi sumber daya yang dapat ditetapkan. misalnya: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versi kondisi. Saat ini satu-satunya nilai yang diterima adalah '2.0'

properties.createdBy

string

Id pengguna yang membuat penugasan

properties.createdOn

string

Waktu pembuatannya

properties.delegatedManagedIdentityResourceId

string

Id sumber daya identitas terkelola yang didelegasikan

properties.description

string

Deskripsi penetapan peran

properties.principalId

string

ID utama.

properties.principalType

PrincipalType

User

Jenis utama ID utama yang ditetapkan.

properties.roleDefinitionId

string

ID definisi peran.

properties.scope

string

Cakupan penetapan peran.

properties.updatedBy

string

Id pengguna yang memperbarui penugasan

properties.updatedOn

string

Waktu pembaruan

type

string

Jenis penetapan peran.

RoleAssignmentListResult

Hasil operasi daftar penetapan peran.

Nama Jenis Deskripsi
nextLink

string

SkipToken yang digunakan untuk mendapatkan serangkaian hasil berikutnya.

value

RoleAssignment[]

Daftar penetapan peran.