Delen via


Role Assignments - List For Resource

Alle roltoewijzingen weergeven die van toepassing zijn op een resource.

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-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

resourceName
path True

string

De resourcenaam.

resourceProviderNamespace
path True

string

De naamruimte van de resourceprovider.

resourceType
path True

string

De naam van het resourcetype. De typenaam van een web-app is bijvoorbeeld 'sites' (van Microsoft.Web/sites).

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

$filter
query

string

Het filter dat moet worden toegepast op de bewerking. Gebruik $filter=atScope() om alle roltoewijzingen op of boven het bereik te retourneren. Gebruik $filter=principalId eq {id} om alle roltoewijzingen op, boven of onder het bereik voor de opgegeven principal te retourneren.

tenantId
query

string

Tenant-id voor aanvraag voor meerdere tenants

Antwoorden

Name Type Description
200 OK

RoleAssignmentListResult

Retourneert een matrix met roltoewijzingen.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Machtigingen

Als u deze API wilt aanroepen, moet er aan u een rol zijn toegewezen met de volgende machtigingen. Zie Ingebouwde rollen in Azure voor meer informatie.

Microsoft.Authorization/roleAssignments/read

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

List role assignments for a resource

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

PrincipalType

Het principal-type van de toegewezen principal-id.

RoleAssignment

Roltoewijzingen

RoleAssignmentListResult

Resultaat van de bewerking van de lijst met roltoewijzingen.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

PrincipalType

Het principal-type van de toegewezen principal-id.

Name Type Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

Roltoewijzingen

Name Type Default value Description
id

string

De id van de roltoewijzing.

name

string

De naam van de roltoewijzing.

properties.condition

string

De voorwaarden voor de roltoewijzing. Dit beperkt de resources waaraan het kan worden toegewezen. bijvoorbeeld: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versie van de voorwaarde. Momenteel is de enige geaccepteerde waarde '2.0'

properties.createdBy

string

Id van de gebruiker die de toewijzing heeft gemaakt

properties.createdOn

string

Tijdstip waarop deze is gemaakt

properties.delegatedManagedIdentityResourceId

string

Id van de gedelegeerde beheerde identiteitsresource

properties.description

string

Beschrijving van roltoewijzing

properties.principalId

string

De principal-id.

properties.principalType

PrincipalType

User

Het principal-type van de toegewezen principal-id.

properties.roleDefinitionId

string

De roldefinitie-id.

properties.scope

string

Het bereik van de roltoewijzing.

properties.updatedBy

string

Id van de gebruiker die de toewijzing heeft bijgewerkt

properties.updatedOn

string

Tijdstip waarop deze is bijgewerkt

type

string

Het type roltoewijzing.

RoleAssignmentListResult

Resultaat van de bewerking van de lijst met roltoewijzingen.

Name Type Description
nextLink

string

Het skipToken dat moet worden gebruikt voor het ophalen van de volgende set resultaten.

value

RoleAssignment[]

Lijst met roltoewijzingen.