Capacities - Update

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

Name In Required Type Description
dedicatedCapacityName
path True
  • string

O nome da capacidade dedicada. Ele deve ter pelo menos 3 caracteres de comprimento e não mais do que 63.

Regex pattern: ^[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.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

Um identificador exclusivo para uma assinatura 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

Name Type Description
properties.administration

Uma coleção de administradores de capacidade dedicados

properties.mode

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

sku

A SKU do recurso de capacidade dedicada.

tags
  • object

Pares chave-valor de propriedades de provisionamento adicionais.

Respostas

Name Type Description
200 OK

OK

202 Accepted

Aceito

Other Status Codes

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Flow Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Update capacity parameters
Update capacity to Generation 2

Update capacity parameters

Sample Request

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

Sample Response

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

Sample Request

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

Sample Response

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

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 da 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 a SKU se aplica.

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 error

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

Name Type 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 da SKU e o tipo de preço do Azure para o recurso de capacidade dedicada do PowerBI.

Name Type Description
capacity
  • integer

A capacidade da SKU.

name
  • string

Nome do nível de SKU.

tier

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

CapacitySkuTier

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

Name Type Description
AutoPremiumHost
  • string
PBIE_Azure
  • string
Premium
  • string

DedicatedCapacity

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

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

Uma coleção de administradores de capacidade dedicados

properties.friendlyName
  • string

Nome da capacidade

properties.mode

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

properties.provisioningState

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

properties.state

O estado atual do recurso Dedicado do PowerBI. O estado deve indicar mais estados fora do provisionamento de recursos.

properties.tenantId
  • string

ID do locatário para a capacidade. Usado para criar Pro mais capacidade.

sku

A SKU do recurso de capacidade dedicada do PowerBI.

systemData

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

tags
  • object

Pares chave-valor de propriedades adicionais de provisionamento de recursos.

type
  • string

O tipo do recurso Dedicado do PowerBI.

DedicatedCapacityAdministrators

Uma matriz de identidades de usuário do administrador

Name Type Description
members
  • string[]

Uma matriz de identidades de usuário de administrador.

DedicatedCapacityUpdateParameters

Especificação de solicitação de provisionamento

Name Type Description
properties.administration

Uma coleção de administradores de capacidade dedicados

properties.friendlyName
  • string

Nome da capacidade

properties.mode

Especifica a geração da capacidade 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 Pro mais capacidade.

sku

A SKU do recurso de capacidade dedicada.

tags
  • object

Pares chave-valor de propriedades de provisionamento adicionais.

Error

O objeto error

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

Name Type Description
error

O objeto error

IdentityType

O tipo de identidade que criou/modificou o recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

Mode

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

Name Type Description
Gen1
  • string
Gen2
  • string

State

O estado atual do recurso Dedicado do PowerBI. O estado deve indicar mais estados fora do provisionamento de recursos.

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

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

O tipo de identidade que modificou o recurso pela última vez