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 do URI

Name	Em	Necessário	Tipo	Description
dedicatedCapacityName	path	True	string	O nome da capacidade Dedicada. Tem de ter, pelo menos, 3 carateres de comprimento e não mais 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, um caráter de comprimento e não mais de 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	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 não for especificado nenhum valor, é utilizado o valor predefinido 'Gen2'. Saiba mais
sku	CapacitySku	O SKU do recurso capacidade dedicada.
tags	object	Pares chave-valor de propriedades de aprovisionamento adicionais.

Respostas

Name	Tipo	Description
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Aceite
Other Status Codes	ErrorResponse	Resposta de erro que descreve o motivo 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

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Pedido de amostra

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

Pedido de amostra

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 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"
      ]
    },
    "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 estado:: 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

Name	Description
CapacityProvisioningState	O estado de implementação atual do recurso dedicado do PowerBI. O provisioningState indica 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 dedicada do PowerBI.
CapacitySkuTier	O nome do escalão 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 utilizador administrador
DedicatedCapacityUpdateParameters	Especificação do pedido de aprovisionamento
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 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 indica 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 dedicada 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 o SKU se aplica.

CapacitySkuTier

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

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 indica 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 da capacidade. Utilizado para criar 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 do recurso dedicado do PowerBI.

DedicatedCapacityAdministrators

Uma matriz de identidades de utilizador administrador

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

DedicatedCapacityUpdateParameters

Especificação do pedido de aprovisionamento

Name	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 não for especificado nenhum valor, é utilizado o valor predefinido 'Gen2'. Saiba mais
properties.tenantId	string	ID do inquilino da capacidade. Utilizado para criar capacidade Pro Plus.
sku	CapacitySku	O SKU do recurso capacidade dedicada.
tags	object	Pares chave-valor de propriedades de aprovisionamento adicionais.

Error

O objeto de erro

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

ErrorResponse

Descreve o formato da resposta de Erro.

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

Partilhar via

Capacities - Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Update capacity parameters

Pedido de amostra

Resposta da amostra

Update capacity to Generation 2

Pedido de amostra

Resposta da amostra

Definições

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Recursos adicionais