Compartilhar via

Role Assignments - List For Scope

Serviço:
Authorization
Versão da API:
2022-04-01

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
Com parâmetros opcionais: 
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter={$filter}&tenantId={tenantId}&$skipToken={$skipToken}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
scope
 path True

string

O identificador totalmente qualificado do Azure Resource Manager do recurso.
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. 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.
$skipToken
 query

string

O skipToken a ser aplicado na operação. Use $skipToken={skiptoken} para retornar atribuições de função paginada após a passagem de skipToken. Só há suporte em chamadas no nível do provedor.
tenantId
 query

string

ID do locatário para solicitação entre locatários

Respostas

Nome Tipo Description
200 OK

RoleAssignmentListResult

A solicitação foi bem-sucedida.
Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Permissões

Para chamar essa API, você precisa de uma função atribuída que tenha as permissões a seguir. Para obter mais informações, veja Funções internas do Azure.

Microsoft.Authorization/roleAssignments/read

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

List role assignments for scope

Solicitação de exemplo

GET https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01

Resposta de exemplo

Código de status:
200 
{
  "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"
      }
    }
  ]
}

Definições

Nome Description
createdByType

O tipo de identidade que criou o recurso.
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
PrincipalType

O tipo principal da ID da entidade de segurança atribuída.
RoleAssignment

Atribuições de função
RoleAssignmentListResult

Resultado da operação da lista de atribuição de função.
systemData

Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

PrincipalType

Enumeração

O tipo principal da ID da entidade de segurança atribuída.

Valor Description
User

Usuário
Group

Grupo
ServicePrincipal

ServicePrincipal
ForeignGroup

ForeignGroup
Device

Dispositivo

RoleAssignment

Objeto

Atribuições de função

Nome Tipo Valor padrão Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

O nome do recurso
properties.condition

string

As condições na atribuição de função. Isso limita os recursos aos quais pode ser atribuída. 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 aceito é '2.0'
properties.createdBy

string

ID do usuário que criou a atribuição
properties.createdOn

string (date-time)

Hora em que foi criado
properties.delegatedManagedIdentityResourceId

string

ID do recurso de identidade gerenciada delegado
properties.description

string

Descrição da atribuição de função
properties.principalId

string

A ID da entidade de segurança.
properties.principalType

PrincipalType

User

O tipo principal da ID da entidade de segurança atribuída.
properties.roleDefinitionId

string

A ID da 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
systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type

string

O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

RoleAssignmentListResult

Objeto

Resultado da operação da lista de atribuição de função.

Nome Tipo Description
nextLink

string (uri)

O link para a próxima página de itens
value

RoleAssignment[]

Os itens de Atribuição de Papel nesta página

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.