Sdílet prostřednictvím


Capacities - Update

Aktualizace aktuální stav zadané vyhrazené kapacity.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
dedicatedCapacityName
path True

string

Název vyhrazené kapacity. Musí mít alespoň 3 znaky a nesmí být delší než 63.

Vzor regulárního výrazu: ^[a-z][a-z0-9]*$

resourceGroupName
path True

string

Název skupiny prostředků Azure, jejíž součástí je daná kapacita PowerBIDedicated. Tento název musí mít délku nejméně 1 znak a nesmí být delší než 90.

Vzor regulárního výrazu: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Jedinečný identifikátor předplatného Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby.

api-version
query True

string

Verze rozhraní API klienta.

Text požadavku

Name Typ Description
properties.administration

DedicatedCapacityAdministrators

Kolekce správců vyhrazené kapacity

properties.mode

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

sku

CapacitySku

Skladová položka prostředku vyhrazené kapacity.

tags

object

Páry klíč-hodnota dalších vlastností zřizování.

Odpovědi

Name Typ Description
200 OK

DedicatedCapacity

OK

202 Accepted

DedicatedCapacity

Přijato

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Update capacity parameters
Update capacity to Generation 2

Update capacity parameters

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CapacityProvisioningState

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

CapacitySku

Představuje název skladové položky a cenovou úroveň Azure pro prostředek vyhrazené kapacity PowerBI.

CapacitySkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

DedicatedCapacity

Představuje instanci prostředku vyhrazené kapacity.

DedicatedCapacityAdministrators

Pole uživatelských identit správců

DedicatedCapacityUpdateParameters

Specifikace žádosti o zřízení

Error

Objekt error

ErrorResponse

Popisuje formát chybové odpovědi.

IdentityType

Typ identity, která vytvořila nebo změnila prostředek.

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

State

Aktuální stav prostředku PowerBI Dedicated. Stav má označit více stavů mimo zřizování prostředků.

SystemData

Metadata týkající se vytvoření a poslední změny prostředku.

CapacityProvisioningState

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

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

Představuje název skladové položky a cenovou úroveň Azure pro prostředek vyhrazené kapacity PowerBI.

Name Typ Description
capacity

integer

Kapacita skladové položky.

name

string

Název úrovně skladové položky.

tier

CapacitySkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

CapacitySkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

Name Typ Description
AutoPremiumHost

string

PBIE_Azure

string

Premium

string

DedicatedCapacity

Představuje instanci prostředku vyhrazené kapacity.

Name Typ Description
id

string

Identifikátor, který představuje prostředek PowerBI Dedicated.

location

string

Umístění prostředku PowerBI Dedicated.

name

string

Název vyhrazeného prostředku PowerBI.

properties.administration

DedicatedCapacityAdministrators

Kolekce správců vyhrazené kapacity

properties.friendlyName

string

Název kapacity

properties.mode

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

properties.provisioningState

CapacityProvisioningState

Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků.

properties.state

State

Aktuální stav prostředku PowerBI Dedicated. Stav má označit více stavů mimo zřizování prostředků.

properties.tenantId

string

ID tenanta pro kapacitu. Používá se k vytváření kapacity Pro Plus.

sku

CapacitySku

Skladová položka prostředku vyhrazené kapacity PowerBI.

systemData

SystemData

Metadata týkající se vytvoření a poslední změny prostředku.

tags

object

Páry klíč-hodnota dalších vlastností zřizování prostředků.

type

string

Typ vyhrazeného prostředku PowerBI.

DedicatedCapacityAdministrators

Pole uživatelských identit správců

Name Typ Description
members

string[]

Pole uživatelských identit správce.

DedicatedCapacityUpdateParameters

Specifikace žádosti o zřízení

Name Typ Description
properties.administration

DedicatedCapacityAdministrators

Kolekce správců vyhrazené kapacity

properties.friendlyName

string

Název kapacity

properties.mode

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

properties.tenantId

string

ID tenanta pro kapacitu. Používá se k vytváření kapacity Pro Plus.

sku

CapacitySku

Skladová položka prostředku vyhrazené kapacity.

tags

object

Páry klíč-hodnota dalších vlastností zřizování.

Error

Objekt error

Name Typ Description
code

string

Kód chyby

message

string

Chybová zpráva s informacemi o tom, proč operace selhala.

ErrorResponse

Popisuje formát chybové odpovědi.

Name Typ Description
error

Error

Objekt error

IdentityType

Typ identity, která vytvořila nebo změnila prostředek.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace

Name Typ Description
Gen1

string

Gen2

string

State

Aktuální stav prostředku PowerBI Dedicated. Stav má označit více stavů mimo zřizování prostředků.

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

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identifikátor identity, která vytvořila prostředek

createdByType

IdentityType

Typ identity, která vytvořila prostředek

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identifikátor identity, která naposledy upravila prostředek

lastModifiedByType

IdentityType

Typ identity, která prostředek naposledy upravila