Role Assignments - List For Scope
Geef alle roltoewijzingen weer 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?api-version=2022-04-01&$filter={$filter}&tenantId={tenantId}&$skipToken={$skipToken}
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
scope
|
path | True |
string |
De volledig gekwalificeerde Azure Resource manager-identificatie van de resource. |
|
api-version
|
query | True |
string minLength: 1 |
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. |
|
|
$skip
|
query |
string |
Het skipToken dat moet worden toegepast op de bewerking. Gebruik $skipToken={skiptoken} om gepaginade roltoewijzingen te retourneren na het geslaagde skipToken. Alleen ondersteund voor aanroepen op providerniveau. |
|
|
tenant
|
query |
string |
Tenant-id voor aanvraag tussen tenants |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
De aanvraag is voltooid. |
|
| Other Status Codes |
Een onverwachte foutreactie. |
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 Flow.
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": [
{
"name": "b0f43c54-e787-4862-89b1-a653fa9cf747",
"type": "Microsoft.Authorization/roleAssignments",
"id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/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"
}
}
]
}
Definities
| Name | Description |
|---|---|
|
created |
Het type identiteit waarmee de resource is gemaakt. |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Foutreactie |
|
Principal |
Het principal-type van de toegewezen principal-id. |
|
Role |
Roltoewijzingen |
|
Role |
Resultaat van bewerking roltoewijzingslijst. |
|
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
| Waarde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
| Name | Type | Description |
|---|---|---|
| info |
object |
De aanvullende informatie. |
| type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
| Name | Type | Description |
|---|---|---|
| additionalInfo |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
De foutdetails. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
| Name | Type | Description |
|---|---|---|
| error |
Het foutobject. |
PrincipalType
Het principal-type van de toegewezen principal-id.
| Waarde | Description |
|---|---|
| User |
Gebruiker |
| Group |
Groep |
| ServicePrincipal |
Service Principaal |
| ForeignGroup |
ForeignGroup |
| Device |
Apparaat |
RoleAssignment
Roltoewijzingen
| Name | Type | Default value | Description |
|---|---|---|---|
| id |
string |
Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
| name |
string |
De naam van de resource |
|
| properties.condition |
string |
De voorwaarden voor de roltoewijzing. Dit beperkt de middelen 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 (date-time) |
Tijdstip waarop het 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 | User |
Het principal-type van de toegewezen principal-id. |
|
| properties.roleDefinitionId |
string |
De id van de roldefinitie. |
|
| properties.scope |
string |
Het bereik van de roltoewijzing. |
|
| properties.updatedBy |
string |
Id van de gebruiker die de toewijzing heeft bijgewerkt |
|
| properties.updatedOn |
string (date-time) |
Tijdstip waarop het is bijgewerkt |
|
| systemData |
Azure Resource Manager metadata met creationBy en modifiedBy informatie. |
||
| type |
string |
Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts" |
RoleAssignmentListResult
Resultaat van bewerking roltoewijzingslijst.
| Name | Type | Description |
|---|---|---|
| nextLink |
string (uri) |
De koppeling naar de volgende pagina met items |
| value |
De RoleAssignment-items op deze pagina |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
| Name | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
De tijdstempel van het maken van resources (UTC). |
| createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
| createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
| lastModifiedAt |
string (date-time) |
Het tijdstempel van de laatste wijziging van de resource (UTC) |
| lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
| lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |