Capacities - Get Capacities

Service:

Power BI REST APIs

API Version:

v1.0

Retorna uma lista de capacidades às quais o usuário tem acesso.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded. O criador de perfil deve ter permissões de capacidade.

Escopo Necessário

Capacity.Read.All ou Capacity.ReadWrite.All

GET https://api.powerbi.com/v1.0/myorg/capacities

Respostas

Nome	Tipo	Description
200 OK	Capacities	OK

Exemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/capacities

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin"
    }
  ]
}

Definições

Nome	Description
Capacities	Wrapper de resposta OData para uma lista de capacidade do Power BI
Capacity	Uma capacidade do Power BI
CapacityState	O estado de capacidade
capacityUserAccessRight	O direito de acesso que o usuário tem na capacidade
TenantKey	Informações de chave de criptografia

Capacities

Wrapper de resposta OData para uma lista de capacidade do Power BI

Nome	Tipo	Description
odata.context	string
value	Capacity[]	A lista de capacidade

Capacity

Uma capacidade do Power BI

Nome	Tipo	Description
admins	string[]	Uma matriz de administradores de capacidade
capacityUserAccessRight	capacityUserAccessRight	O direito de acesso que um usuário tem na capacidade
displayName	string	O nome de exibição da capacidade
id	string	A ID da capacidade
region	string	A região do Azure em que a capacidade foi provisionada
sku	string	O SKU de capacidade
state	CapacityState	O estado de capacidade
tenantKey	TenantKey	Informações de chave de criptografia (só se aplica a rotas de administrador)
tenantKeyId	string	A ID de uma chave de criptografia (aplicável somente à rota de administrador)

CapacityState

O estado de capacidade

Nome	Tipo	Description
Active	string	A capacidade está pronta para uso
Deleted	string	A capacidade foi excluída e não está disponível
Deleting	string	A exclusão da capacidade está em andamento
Invalid	string	A capacidade não pode ser usada
NotActivated	string	Sem suporte
PreSuspended	string	Sem suporte
ProvisionFailed	string	Falha no provisionamento da capacidade
Provisioning	string	A ativação da capacidade está em andamento
Suspended	string	O uso da capacidade está suspenso
UpdatingSku	string	Uma alteração de SKU de capacidade está em andamento

capacityUserAccessRight

O direito de acesso que o usuário tem na capacidade

Nome	Tipo	Description
Admin	string	O usuário tem direitos de administrador na capacidade
Assign	string	O usuário tem direitos de colaborador e pode atribuir workspaces à capacidade
None	string	O usuário não tem acesso à capacidade

TenantKey

Informações de chave de criptografia

Nome	Tipo	Description
createdAt	string	A data e a hora de criação da chave de criptografia
id	string	A ID da chave de criptografia
isDefault	boolean	Se a chave de criptografia é a chave padrão para todo o locatário. Qualquer capacidade recém-criada herda a chave padrão.
keyVaultKeyIdentifier	string	O URI que especifica exclusivamente a chave de criptografia no Azure Key Vault
name	string	O nome da chave de criptografia
updatedAt	string	A última data e hora da atualização da chave de criptografia