Capacities - Create

Referência

Serviço:: Power BI Embedded

Versão da API:: 2021-01-01

Aprovisiona a capacidade dedicada especificada com base na configuração especificada no pedido.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
dedicatedCapacityName	path	True	string	O nome da capacidade Dedicada. Tem de ter um mínimo de 3 carateres e um máximo de 63. Padrão Regex: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	O nome do grupo de Recursos do Azure do qual faz parte uma determinada capacidade do PowerBIDedicated. Este nome tem de ter, pelo menos, 1 caráter de comprimento e não superior a 90. Padrão Regex: `^[-\w\._]+$`
subscriptionId	path	True	string	Um identificador exclusivo para uma subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	A versão da API de cliente.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do recurso dedicado do PowerBI.
sku	True	CapacitySku	O SKU do recurso de capacidade dedicada do PowerBI.
properties.administration		DedicatedCapacityAdministrators	Uma coleção de administradores de capacidade dedicados
properties.mode		Mode	Especifica a geração da capacidade de Power BI Embedded. Se não for especificado nenhum valor, é utilizado o valor predefinido 'Gen2'. Saiba mais
systemData		SystemData	Metadados relativos à criação e última modificação do recurso.
tags		object	Pares chave-valor de propriedades de aprovisionamento de recursos adicionais.

Respostas

Name	Tipo	Description
200 OK	DedicatedCapacity	OK. A operação foi concluída com êxito.
201 Created	DedicatedCapacity	Entrada. A operação ainda está em curso.
Other Status Codes	ErrorResponse	Resposta de erro que descreve a razão pela qual a operação falhou.

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	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Create capacity

Pedido de amostra

HTTP

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

{
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "location": "West US",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

Resposta da amostra

Código de estado:: 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",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2021-01-01T00:00:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-01T00:00:19.1234567Z"
  }
}

Código de estado:: 201

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/servers/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "state": "Provisioning"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  },
  "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

Name	Description
CapacityProvisioningState	O estado de implementação atual do recurso dedicado do PowerBI. O provisioningState é indicar estados para o aprovisionamento de recursos.
CapacitySku	Representa o nome do SKU e o escalão de preço do Azure para o recurso de capacidade dedicado do PowerBI.
CapacitySkuTier	O nome do escalão de preço do Azure ao qual se aplica o SKU.
DedicatedCapacity	Representa uma instância de um recurso de Capacidade Dedicada.
DedicatedCapacityAdministrators	Uma matriz de identidades de utilizador administrador
Error	O objeto de erro
ErrorResponse	Descreve o formato de Resposta a erros.
IdentityType	O tipo de identidade que criou/modificou o recurso.
Mode	Especifica a geração da capacidade de Power BI Embedded. Se não for especificado nenhum valor, é utilizado o valor predefinido 'Gen2'. Saiba mais
State	O estado atual do recurso dedicado do PowerBI. O estado é indicar mais estados fora do aprovisionamento de recursos.
SystemData	Metadados relativos à criação e última modificação do recurso.

CapacityProvisioningState

O estado de implementação atual do recurso dedicado do PowerBI. O provisioningState é indicar estados para o aprovisionamento de recursos.

Name	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 escalão de preço do Azure para o recurso de capacidade dedicado do PowerBI.

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

CapacitySkuTier

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

Name	Tipo	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

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

Name	Tipo	Description
id	string	Um identificador que representa o recurso dedicado do PowerBI.
location	string	Localização 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 de Power BI Embedded. Se não for especificado nenhum valor, é utilizado o valor predefinido 'Gen2'. Saiba mais
properties.provisioningState	CapacityProvisioningState	O estado de implementação atual do recurso dedicado do PowerBI. O provisioningState é indicar estados para o aprovisionamento de recursos.
properties.state	State	O estado atual do recurso dedicado do PowerBI. O estado é indicar mais estados fora do aprovisionamento de recursos.
properties.tenantId	string	ID do inquilino para a capacidade. Utilizado para criar a capacidade 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 aprovisionamento de recursos adicionais.
type	string	O tipo de recurso dedicado do PowerBI.

DedicatedCapacityAdministrators

Uma matriz de identidades de utilizador administrador

Name	Tipo	Description
members	string[]	Uma matriz de identidades de utilizador administrador.

Error

O objeto de erro

Name	Tipo	Description
code	string	Código de erro
message	string	Mensagem de erro a indicar por que motivo a operação falhou.

ErrorResponse

Descreve o formato de Resposta a erros.

Name	Tipo	Description
error	Error	O objeto de erro

IdentityType

O tipo de identidade que criou/modificou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Especifica a geração da capacidade de Power BI Embedded. Se não for especificado nenhum valor, é utilizado o valor predefinido 'Gen2'. Saiba mais

Name	Tipo	Description
Gen1	string
Gen2	string

State

O estado atual do recurso dedicado do PowerBI. O estado é indicar mais estados fora do aprovisionamento de recursos.

Name	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.

Name	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 pela última vez o recurso
lastModifiedByType	IdentityType	O tipo de identidade que modificou pela última vez o recurso

Partilhar via