Role Assignments - List For Scope
Liste todas as atribuições de função que se aplicam a um escopo.
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}
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
scope
|
path | True |
string |
O escopo da operação ou recurso. Os escopos válidos são: assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}' |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
|
$filter
|
query |
string |
O filtro a ser aplicado na operação. Use $filter=atScope() para retornar todas as atribuições de função no escopo ou acima dele. Use $filter=principalId eq {id} para retornar todas as atribuições de função em, acima ou abaixo do escopo da entidade de segurança especificada. |
|
|
$skip
|
query |
string |
O skipToken a ser aplicado na operação. Use $skipToken={skiptoken} para retornar atribuições de função paginadas após o skipToken passado. Suportado apenas em chamadas de nível de provedor. |
|
|
tenant
|
query |
string |
ID do locatário para solicitação entre locatários |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
Retorna uma matriz de atribuições de função. |
|
| Other Status Codes |
Resposta de erro descrevendo por que a operação falhou. |
Permissões
Para chamar esta API, tem de lhe ser atribuída uma função que tenha as seguintes permissões. Para obter mais informações, veja Funções incorporadas do Azure.
Microsoft.Authorization/roleAssignments/read
Segurança
azure_auth
Azure Ative Directory OAuth2 Flow
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Name | Description |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
List role assignments for scope
Pedido de amostra
Resposta da amostra
{
"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"
}
]
}
Definições
| Name | Description |
|---|---|
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Principal |
O tipo principal do ID principal atribuído. |
|
Role |
Atribuições de Funções |
|
Role |
Resultado da operação da lista de atribuição de função. |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Name | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
PrincipalType
O tipo principal do ID principal atribuído.
| Valor | Description |
|---|---|
| User | |
| Group | |
| ServicePrincipal | |
| ForeignGroup | |
| Device |
RoleAssignment
Atribuições de Funções
| Name | Tipo | Default value | Description |
|---|---|---|---|
| id |
string |
A ID da atribuição de função. |
|
| name |
string |
O nome da atribuição de função. |
|
| properties.condition |
string |
As condições na atribuição de função. Isso limita os recursos aos quais ele pode ser atribuído. Por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container' |
|
| properties.conditionVersion |
string |
Versão da condição. Atualmente, o único valor aceite é '2.0' |
|
| properties.createdBy |
string |
ID do usuário que criou a atribuição |
|
| properties.createdOn |
string (date-time) |
Tempo em que foi criado |
|
| properties.delegatedManagedIdentityResourceId |
string |
Id do recurso de identidade gerenciado delegado |
|
| properties.description |
string |
Descrição da atribuição de funções |
|
| properties.principalId |
string |
O ID principal. |
|
| properties.principalType | User |
O tipo principal do ID principal atribuído. |
|
| properties.roleDefinitionId |
string |
O ID de definição de função. |
|
| properties.scope |
string |
O escopo da atribuição de função. |
|
| properties.updatedBy |
string |
ID do usuário que atualizou a atribuição |
|
| properties.updatedOn |
string (date-time) |
Hora em que foi atualizado |
|
| type |
string |
O tipo de atribuição de função. |
RoleAssignmentListResult
Resultado da operação da lista de atribuição de função.
| Name | Tipo | Description |
|---|---|---|
| nextLink |
string |
O skipToken a ser usado para obter o próximo conjunto de resultados. |
| value |
Lista de atribuição de funções. |