Partilhar via


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.

$skipToken
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.

tenantId
query

string

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

Respostas

Name Tipo Description
200 OK

RoleAssignmentListResult

Retorna uma matriz de atribuições de função.

Other Status Codes

ErrorResponse

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

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

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
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

PrincipalType

O tipo principal do ID principal atribuído.

RoleAssignment

Atribuições de Funções

RoleAssignmentListResult

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

ErrorAdditionalInfo[]

O erro informações adicionais.

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

Resposta de erro

Name Tipo Description
error

ErrorDetail

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

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

RoleAssignment[]

Lista de atribuição de funções.