Capacities - Get Capacities
Retorna uma lista de capacidades às quais o usuário tem acesso.
Permissions
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/capacitiesRespostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OKEY |
Exemplos
Example
Solicitação de exemplo
GET https://api.powerbi.com/v1.0/myorg/capacitiesResposta de exemplo
{
"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 |
|
Capacity |
O estado de capacidade |
|
capacity |
O direito de acesso que o usuário tem na capacidade |
|
Tenant |
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 |
O direito de acesso que um usuário tem na capacidade |
|
| displayName |
string |
O nome de exibição da capacidade |
| id |
string (uuid) |
A ID da capacidade |
| region |
string |
A região do Azure em que a capacidade foi provisionada |
| sku |
string |
O SKU de capacidade |
| state |
O estado de capacidade |
|
| tenantKey |
Informações de chave de criptografia (aplica-se apenas a rotas de administrador) |
|
| tenantKeyId |
string (uuid) |
A ID de uma chave de criptografia (aplicável somente à rota do administrador) |
CapacityState
O estado de capacidade
| Valor | Description |
|---|---|
| NotActivated |
Não suportado |
| Active |
A capacidade está pronta para uso |
| Provisioning |
A ativação da capacidade está em andamento |
| ProvisionFailed |
Falha no provisionamento da capacidade |
| PreSuspended |
Não suportado |
| Suspended |
O uso da capacidade é suspenso |
| Deleting |
A exclusão da capacidade está em andamento |
| Deleted |
A capacidade foi excluída e não está disponível |
| Invalid |
A capacidade não pode ser usada |
| UpdatingSku |
Uma alteração de SKU de capacidade está em andamento |
capacityUserAccessRight
O direito de acesso que o usuário tem na capacidade
| Valor | Description |
|---|---|
| None |
O usuário não tem acesso à capacidade |
| Assign |
O usuário tem direitos de colaborador e pode atribuir workspaces à capacidade |
| Admin |
O usuário tem direitos de administrador sobre a capacidade |
TenantKey
Informações de chave de criptografia
| Nome | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
A data e a hora de criação da chave de criptografia |
| id |
string (uuid) |
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 (date-time) |
A data e a hora da última atualização da chave de criptografia |