Capacities - Get Details

Referência

Service:: Power BI Embedded

API Version:: 2021-01-01

Obtém detalhes sobre a capacidade dedicada especificada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
dedicatedCapacityName	path	True	string	O nome da capacidade dedicada. Ele deve ter um mínimo de 3 caracteres e um máximo de 63. Regex pattern: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	O nome do grupo de recursos do Azure do qual uma determinada capacidade PowerBIDedicated faz parte. Esse nome deve ter pelo menos 1 caractere de comprimento e não mais de 90. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Um identificador exclusivo para uma assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	A versão da API do cliente.

Respostas

Nome	Tipo	Description
200 OK	DedicatedCapacity	OK. A operação foi bem-sucedida.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Get details of a capacity

Sample Request

HTTP

GET https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest?api-version=2021-01-01

Sample Response

Status code:: 200

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/capacities/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {},
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

Definições

Nome	Description
CapacityProvisioningState	O estado de implantação atual do recurso Dedicado do PowerBI. O provisioningState é para indicar estados para provisionamento de recursos.
CapacitySku	Representa o nome do SKU e o tipo de preço do Azure para o recurso de capacidade dedicada do PowerBI.
CapacitySkuTier	O nome do tipo de preço do Azure ao qual o SKU se aplica.
DedicatedCapacity	Representa uma instância de um recurso de Capacidade Dedicada.
DedicatedCapacityAdministrators	Uma matriz de identidades de usuário administrador
Error	O objeto de erro
ErrorResponse	Descreve o formato da resposta de erro.
IdentityType	O tipo de identidade que criou/modificou o recurso.
Mode	Especifica a geração da capacidade Power BI Embedded. Se nenhum valor for especificado, o valor padrão 'Gen2' será usado. Saiba mais
State	O estado atual do recurso Dedicado do PowerBI. O estado é para indicar mais estados fora do provisionamento de recursos.
SystemData	Metadados relativos à criação e à última modificação do recurso.

CapacityProvisioningState

O estado de implantação atual do recurso Dedicado do PowerBI. O provisioningState é para indicar estados para provisionamento de recursos.

Nome	Tipo	Description
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

CapacitySku

Representa o nome do SKU e o tipo de preço do Azure para o recurso de capacidade dedicada do PowerBI.

Nome	Tipo	Description
capacity	integer	A capacidade do SKU.
name	string	Nome do nível de SKU.
tier	CapacitySkuTier	O nome do tipo de preço do Azure ao qual o SKU se aplica.

CapacitySkuTier

O nome do tipo de preço do Azure ao qual o SKU se aplica.

Nome	Tipo	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Representa uma instância de um recurso de Capacidade Dedicada.

Nome	Tipo	Description
id	string	Um identificador que representa o recurso Dedicado do PowerBI.
location	string	Local do recurso Dedicado do PowerBI.
name	string	O nome do recurso Dedicado do PowerBI.
properties.administration	DedicatedCapacityAdministrators	Uma coleção de administradores de capacidade dedicados
properties.friendlyName	string	Nome da capacidade
properties.mode	Mode	Especifica a geração da capacidade Power BI Embedded. Se nenhum valor for especificado, o valor padrão 'Gen2' será usado. Saiba mais
properties.provisioningState	CapacityProvisioningState	O estado de implantação atual do recurso Dedicado do PowerBI. O provisioningState é para indicar estados para provisionamento de recursos.
properties.state	State	O estado atual do recurso Dedicado do PowerBI. O estado é para indicar mais estados fora do provisionamento de recursos.
properties.tenantId	string	ID do locatário para a capacidade. Usado para criar a capacidade do Pro Plus.
sku	CapacitySku	O SKU do recurso de capacidade dedicada do PowerBI.
systemData	SystemData	Metadados relativos à criação e à última modificação do recurso.
tags	object	Pares chave-valor de propriedades de provisionamento de recursos adicionais.
type	string	O tipo do recurso Dedicado do PowerBI.

DedicatedCapacityAdministrators

Uma matriz de identidades de usuário administrador

Nome	Tipo	Description
members	string[]	Uma matriz de identidades de usuário administrador.

Error

O objeto de erro

Nome	Tipo	Description
code	string	Código do erro
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponse

Descreve o formato da resposta de erro.

Nome	Tipo	Description
error	Error	O objeto de erro

IdentityType

O tipo de identidade que criou/modificou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Especifica a geração da capacidade Power BI Embedded. Se nenhum valor for especificado, o valor padrão 'Gen2' será usado. Saiba mais

Nome	Tipo	Description
Gen1	string
Gen2	string

State

O estado atual do recurso Dedicado do PowerBI. O estado é para indicar mais estados fora do provisionamento de recursos.

Nome	Tipo	Description
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

SystemData

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

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC)
createdBy	string	Um identificador para a identidade que criou o recurso
createdByType	IdentityType	O tipo de identidade que criou o recurso
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	Um identificador para a identidade que modificou o recurso pela última vez
lastModifiedByType	IdentityType	O tipo de identidade que modificou o recurso pela última vez