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?api-version=2022-04-01&$filter={$filter}&tenantId={tenantId}&$skipToken={$skipToken}

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
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 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 Descrição
200 OK

RoleAssignmentListResult

O pedido foi bem-sucedido.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

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

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Descrição
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": [
    {
      "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

Name Descrição
createdByType

O tipo de identidade que criou o recurso.

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.

systemData

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

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

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

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
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 Descrição
error

ErrorDetail

O objeto de erro.

PrincipalType

O tipo principal do ID principal atribuído.

Valor Descrição
User

User

Group

Grupo

ServicePrincipal

Serviço Principal

ForeignGroup

ForeignGroup

Device

Device

AgentUser

Identidade de agente derivada de um utilizador.

AgentServicePrincipal

Identidade do agente derivada de um principal de serviço.

RoleAssignment

Atribuições de Funções

Name Tipo Valor predefinido Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/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. Isto limita os recursos a que 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 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

systemData

systemData

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

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

RoleAssignmentListResult

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

Name Tipo Descrição
nextLink

string (uri)

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

value

RoleAssignment[]

Os itens de Atribuição de Papéis nesta página

systemData

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

Name Tipo Descrição
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.