Capacities - Update

Referência

Serviço:: Power BI Embedded

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

Atualizações o estado atual da capacidade dedicada especificada.

PATCH 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 pelo menos três caracteres de comprimento e não mais do que 63. Padrão Regex: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	O nome do grupo de recursos do Azure do qual uma determinada capacidade do PowerBIDedicated faz parte. Esse nome deve ter pelo menos 1 caractere de comprimento e não mais do que 90. Padrão Regex: `^[-\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.

Corpo da solicitação

Nome	Tipo	Description
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 nenhum valor for especificado, o valor padrão 'Gen2' será usado. Saiba mais
sku	CapacitySku	O SKU do recurso de capacidade dedicado.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

Respostas

Nome	Tipo	Description
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Aceito
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

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Solicitação de exemplo

HTTP

PATCH 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"
  },
  "properties": {
    "administration": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

Resposta de exemplo

Código de status:: 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 status:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationstatuses/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01
Location: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationresults/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01

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

Update capacity to Generation 2

Solicitação de exemplo

HTTP

PATCH 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"
  },
  "properties": {
    "mode": "Gen2"
  }
}

Resposta de exemplo

Código de status:: 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"
      ]
    },
    "mode": "Gen2",
    "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 status:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationstatuses/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01
Location: https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/westus/operationresults/7e4f488e-f071-4b1a-ae84-e25682d09e4c?api-version=2021-01-01

{
  "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"
      ]
    },
    "mode": "Gen2",
    "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

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 de administrador
DedicatedCapacityUpdateParameters	Especificação de solicitação de provisionamento
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 de 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 de 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 dedicado 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 de administrador

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

DedicatedCapacityUpdateParameters

Especificação de solicitação de provisionamento

Nome	Tipo	Description
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 nenhum valor for especificado, o valor padrão 'Gen2' será usado. Saiba mais
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 dedicado.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

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 de 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

Compartilhar via

Capacities - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Update capacity parameters

Solicitação de exemplo

Resposta de exemplo

Update capacity to Generation 2

Solicitação de exemplo

Resposta de exemplo

Definições

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Recursos adicionais