Megosztás a következőn keresztül:


Role Assignments - List For Resource

Listázhatja az erőforrásokra vonatkozó összes szerepkör-hozzárendelést.

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}

URI-paraméterek

Name In Kötelező Típus Description
resourceGroupName
path True

string

Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket.

resourceName
path True

string

Az erőforrás neve.

resourceProviderNamespace
path True

string

Az erőforrás-szolgáltató névtere.

resourceType
path True

string

Az erőforrástípus neve. Egy webalkalmazás típusneve például "webhelyek" (a Microsoft.Web/sites webhelyről).

subscriptionId
path True

string

A cél-előfizetés azonosítója.

api-version
query True

string

A művelethez használandó API-verzió.

$filter
query

string

A műveletre alkalmazandó szűrő. Használja az $filter=atScope() függvényt az összes szerepkör-hozzárendelés visszaadásához a hatókörben vagy felett. A $filter=principalId eq {id} használatával visszaadhatja az összes szerepkör-hozzárendelést a megadott rendszerbiztonsági tag hatóköre felett vagy alatt.

tenantId
query

string

Bérlőazonosító bérlők közötti kérelemhez

Válaszok

Name Típus Description
200 OK

RoleAssignmentListResult

A szerepkör-hozzárendelések tömbét adja vissza.

Other Status Codes

ErrorResponse

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Engedélyek

Az API meghívásához egy olyan szerepkörrel kell rendelnie, amely a következő engedélyekkel rendelkezik. További információ: Beépített Azure-szerepkörök.

Microsoft.Authorization/roleAssignments/read

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

List role assignments for a resource

Mintakérelem

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

Mintaválasz

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

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

PrincipalType

A hozzárendelt rendszerbiztonsági tag azonosítójának egyszerű típusa.

RoleAssignment

Szerepkör-hozzárendelések

RoleAssignmentListResult

A szerepkör-hozzárendelési lista műveletének eredménye.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további adattípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

PrincipalType

A hozzárendelt rendszerbiztonsági tag azonosítójának egyszerű típusa.

Name Típus Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

Szerepkör-hozzárendelések

Name Típus Alapértelmezett érték Description
id

string

A szerepkör-hozzárendelés azonosítója.

name

string

A szerepkör-hozzárendelés neve.

properties.condition

string

A szerepkör-hozzárendelés feltételei. Ez korlátozza az erőforrásokat, amelyekhez hozzárendelhető. Például: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase "foo_storage_container"

properties.conditionVersion

string

A feltétel verziója. Jelenleg az egyetlen elfogadott érték a "2.0"

properties.createdBy

string

A hozzárendelést létrehozó felhasználó azonosítója

properties.createdOn

string

Létrehozás időpontja

properties.delegatedManagedIdentityResourceId

string

A delegált felügyelt identitás erőforrás azonosítója

properties.description

string

A szerepkör-hozzárendelés leírása

properties.principalId

string

A rendszerbiztonsági tag azonosítója.

properties.principalType

PrincipalType

User

A hozzárendelt rendszerbiztonsági tag azonosítójának egyszerű típusa.

properties.roleDefinitionId

string

A szerepkör-definíció azonosítója.

properties.scope

string

A szerepkör-hozzárendelés hatóköre.

properties.updatedBy

string

A hozzárendelést módosító felhasználó azonosítója

properties.updatedOn

string

Frissítés időpontja

type

string

A szerepkör-hozzárendelés típusa.

RoleAssignmentListResult

A szerepkör-hozzárendelési lista műveletének eredménye.

Name Típus Description
nextLink

string

A skipToken a következő eredményhalmaz lekéréséhez használható.

value

RoleAssignment[]

Szerepkör-hozzárendelési lista.