Capacities - Update

Serviço:: Power BI Embedded

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

Atualiza 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 minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	O nome da capacidade dedicada. Deve ser um mínimo de 3 caracteres e um máximo de 63.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

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 do Power BI Embedded. Se nenhum valor for especificado, o valor padrão 'Gen2' será usado. Saiba Mais
sku	CapacitySku	A SKU do recurso de capacidade dedicado.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

Respostas

Nome	Tipo	Description
200 OK	DedicatedCapacity	A operação do Azure foi concluída com êxito.
202 Accepted	DedicatedCapacity	A solicitação foi aceita para processamento, mas o processamento ainda não foi concluído. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

DedicatedCapacity

A operação do Azure foi concluída com êxito.

202 Accepted

DedicatedCapacity

A solicitação foi aceita para processamento, mas o processamento ainda não foi concluído.

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo 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

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

Resposta de exemplo

Código de status:: 200

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

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

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

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

{
  "properties": {
    "mode": "Gen2"
  },
  "sku": {
    "name": "A1",
    "tier": "PBIE_Azure"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Resposta de exemplo

Código de status:: 200

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

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

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

Definições

Nome	Description
CapacityProvisioningState	O estado de implantação atual do recurso dedicado do PowerBI. O provisioningState deve 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 dedicado do PowerBI.
CapacitySkuTier	O nome do tipo de preço do Azure ao qual a SKU se aplica.
createdByType	O tipo de identidade que criou o recurso.
DedicatedCapacity	Representa uma instância de um recurso de Capacidade Dedicada.
DedicatedCapacityAdministrators	Uma matriz de identidades de usuário do administrador
DedicatedCapacityUpdateParameters	Especificação de solicitação de provisionamento
Error	O objeto de erro.
ErrorResponse	O objeto de erro
Mode	Especifica a geração da capacidade do 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

Enumeração

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

Valor	Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

CapacitySku

Objeto

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

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

CapacitySkuTier

Enumeração

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

Valor	Description
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DedicatedCapacity

Objeto

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

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
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 do 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 deve 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	A SKU do recurso de capacidade dedicado do PowerBI.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DedicatedCapacityAdministrators

Objeto

Uma matriz de identidades de usuário do administrador

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

DedicatedCapacityUpdateParameters

Objeto

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 do 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	A SKU do recurso de capacidade dedicado.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

Error

Objeto

O objeto de erro.

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

ErrorResponse

Objeto

O objeto de erro

Nome	Tipo	Description
error	Error	O objeto de erro.

Mode

Enumeração

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

Valor	Description
Gen1
Gen2

State

Enumeração

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

Valor	Description
Deleting
Succeeded
Failed
Paused
Suspended
Provisioning
Updating
Suspending
Pausing
Resuming
Preparing
Scaling

systemData

Objeto

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

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	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

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData