Partilhar via


Capacities - Get Capacities

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

{
  "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