Delen via


Role Assignments - List For Scope

Alle roltoewijzingen weergeven die van toepassing zijn op een bereik.

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}

URI-parameters

Name In Vereist Type Description
scope
path True

string

Het bereik van de bewerking of resource. Geldige bereiken zijn: abonnement (indeling: /subscriptions/{subscriptionId}), resourcegroep (indeling: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' of resource (indeling: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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 binnen 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.

$skipToken
query

string

Het skipToken dat moet worden toegepast op de bewerking. Gebruik $skipToken={skiptoken} om pagineerde roltoewijzingen te retourneren na het geslaagde skipToken. Alleen ondersteund voor aanroepen op providerniveau.

tenantId
query

string

Tenant-id voor aanvraag tussen 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 scope

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/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"
    }
  ]
}

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[]

Aanvullende informatie over de fout.

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 roltoewijzings-id.

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 roltoewijzingstype.

RoleAssignmentListResult

Resultaat van de bewerking van de lijst met roltoewijzingen.

Name Type Description
nextLink

string

Het skipToken dat moet worden gebruikt om de volgende set resultaten op te halen.

value

RoleAssignment[]

Lijst met roltoewijzingen.