Capacities - Create

Reference

Service:: Power BI Embedded

API Version:: 2021-01-01

Zřídí zadanou vyhrazenou kapacitu na základě konfigurace zadané v požadavku.

PUT 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í obsahovat minimálně 3 znaky a maximálně 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	Vyžadováno	Typ	Description
location	True	string	Umístění prostředku PowerBI Dedicated
sku	True	CapacitySku	Skladová položka prostředku vyhrazené kapacity PowerBI.
properties.administration		DedicatedCapacityAdministrators	Kolekce správců vyhrazené kapacity
properties.mode		Mode	Určuje generování kapacity Power BI Embedded. Pokud není zadána žádná hodnota, použije se výchozí hodnota Gen2. Další informace
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ů.

Odpovědi

Name	Typ	Description
200 OK	DedicatedCapacity	OK. Operace se úspěšně dokončila.
201 Created	DedicatedCapacity	InProgress. Operace stále probíhá.
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

Create capacity

Sample Request

HTTP

PUT 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"
  },
  "location": "West US",
  "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:: 201

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.PowerBIDedicated/servers/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"
  }
}

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 identit uživatelů správce
Error	Objekt chyby
ErrorResponse	Popisuje formát chybové odpovědi.
IdentityType	Typ identity, která vytvořila nebo upravila prostředek.
Mode	Určuje generování kapacity Power BI Embedded. Pokud není zadána žá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 prostředku PowerBI Dedicated.
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í zadána žá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 kapacity. 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 prostředku PowerBI Dedicated.

DedicatedCapacityAdministrators

Pole identit uživatelů správce

Name	Typ	Description
members	string[]	Pole identit uživatelů správce.

Error

Objekt chyby

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

Popisuje formát chybové odpovědi.

Name	Typ	Description
error	Error	Objekt chyby

IdentityType

Typ identity, která vytvořila nebo upravila prostředek.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Určuje generování kapacity Power BI Embedded. Pokud není zadána žá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 změnila prostředek
lastModifiedByType	IdentityType	Typ identity, která naposledy změnila prostředek