Capacities - Update

Reference

Service:: Power BI Embedded

API Version:: 2021-01-01

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

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

Scopes

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

Příklady

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Sample Request

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

Sample Response

Status code:: 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"
  }
}

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

Response Body

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

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

Sample Response

Status code:: 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"
  }
}

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

Response Body

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

Capacities - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Scopes

Příklady

Update capacity parameters

Sample Request

Sample Response

Update capacity to Generation 2

Sample Request

Sample Response

Definice

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Další materiály