Role Assignments - List For Scope
Mencantumkan semua penetapan peran yang berlaku untuk cakupan.
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?$filter={$filter}&api-version=2022-04-01&tenantId={tenantId}&$skipToken={$skipToken}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
scope
|
path | True |
string |
Cakupan operasi atau sumber daya. Cakupan yang valid adalah: langganan (format: '/subscriptions/{subscriptionId}'), grup sumber daya (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', atau sumber daya (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' |
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. |
|
$skip
|
query |
string |
SkipToken untuk diterapkan pada operasi. Gunakan $skipToken={skiptoken} untuk mengembalikan penetapan peran halaman setelah skipToken lulus. Hanya didukung pada panggilan tingkat penyedia. |
|
tenant
|
query |
string |
ID Penyewa untuk permintaan lintas penyewa |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Mengembalikan array penetapan peran. |
|
Other Status Codes |
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
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
List role assignments for scope
Sample Request
Sample Response
{
"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"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Error |
Info tambahan kesalahan manajemen sumber daya. |
Error |
Detail kesalahan. |
Error |
Respons kesalahan |
Principal |
Jenis utama ID utama yang ditetapkan. |
Role |
Penetapan Peran |
Role |
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 |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ErrorResponse
Respons kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
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 | 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 |
Daftar penetapan peran. |