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

Name	Em	Necessário	Tipo	Description
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	O nome da capacidade dedicada. Deve ter 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 utilizar para esta operação.

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 do 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 dedicada.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

Respostas

Name	Tipo	Description
200 OK	DedicatedCapacity	Operação do Azure concluída com êxito.
202 Accepted	DedicatedCapacity	O pedido foi aceite 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.

Name

Tipo

Description

200 OK

DedicatedCapacity

Operação do Azure concluída com êxito.

202 Accepted

DedicatedCapacity

O pedido foi aceite 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 Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar 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

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

Resposta da amostra

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

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

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

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

Resposta da amostra

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

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

Name	Description
CapacityProvisioningState	O estado atual de implantação do recurso PowerBI dedicado. O provisioningState deve indicar estados para provisionamento de recursos.
CapacitySku	Representa o nome da SKU e a camada de preços do Azure para o recurso de capacidade dedicada do PowerBI.
CapacitySkuTier	O nome da camada de preços do Azure à 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 administrador
DedicatedCapacityUpdateParameters	Especificação de solicitação de provisão
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 PowerBI dedicado. O estado deve indicar mais estados fora do provisionamento de recursos.
systemData	Metadados referentes à criação e última modificação do recurso.

CapacityProvisioningState

Enumeração

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

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

CapacitySku

Object

Representa o nome da SKU e a camada de preços do Azure para o recurso de capacidade dedicada do PowerBI.

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

CapacitySkuTier

Enumeração

O nome da camada de preços do Azure à 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

Object

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

Name	Tipo	Description
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A geolocalização onde o recurso vive
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 atual de implantação do recurso PowerBI dedicado. O provisioningState deve indicar estados para provisionamento de recursos.
properties.state	State	O estado atual do recurso PowerBI dedicado. O estado deve indicar mais estados fora do provisionamento de recursos.
properties.tenantId	string	ID do locatário para a capacidade. Usado para criar capacidade Pro Plus.
sku	CapacitySku	A SKU do recurso de capacidade dedicada do PowerBI.
systemData	systemData	Metadados do Azure Resource Manager contendo 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

Object

Uma matriz de identidades de usuário administrador

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

DedicatedCapacityUpdateParameters

Object

Especificação de solicitação de provisão

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 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 capacidade Pro Plus.
sku	CapacitySku	O SKU do recurso de capacidade dedicada.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

Error

Object

O objeto de erro.

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

ErrorResponse

Object

O objeto de erro

Name	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 PowerBI dedicado. O estado deve indicar mais estados fora do provisionamento de recursos.

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

systemData

Object

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

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

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

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData