Capacities - Update
Aktualizuje 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 |
|---|---|---|---|---|
|
dedicated
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-z][a-z0-9]*$ |
Název vyhrazené kapacity. Musí mít maximálně 3 znaky a maximálně 63 znaků. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Název skupiny prostředků. Název nerozlišuje malá a velká písmena. |
|
subscription
|
path | True |
string minLength: 1 |
ID cílového předplatného. |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
| Name | Typ | Description |
|---|---|---|
| properties.administration |
Kolekce správců vyhrazené kapacity |
|
| properties.mode |
Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace |
|
| sku |
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 |
Operace Azure byla úspěšně dokončena. |
|
| 202 Accepted |
Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno. Hlavičky
|
|
| Other Status Codes |
Neočekávaná chybová odpověď |
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
{
"properties": {
"administration": {
"members": [
"azsdktest@microsoft.com",
"azsdktest2@microsoft.com"
]
}
},
"sku": {
"name": "A1",
"tier": "PBIE_Azure"
},
"tags": {
"testKey": "testValue"
}
}
Ukázková odpověď
{
"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"
}
}
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
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
{
"properties": {
"mode": "Gen2"
},
"sku": {
"name": "A1",
"tier": "PBIE_Azure"
},
"tags": {
"testKey": "testValue"
}
}
Ukázková odpověď
{
"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"
}
}
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"
}
}
Definice
| Name | Description |
|---|---|
|
Capacity |
Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků. |
|
Capacity |
Představuje název skladové položky a cenovou úroveň Azure pro prostředek kapacity PowerBI Dedicated. |
|
Capacity |
Název cenové úrovně Azure, na kterou se skladová položka vztahuje. |
|
created |
Typ identity, která prostředek vytvořila. |
|
Dedicated |
Představuje instanci prostředku vyhrazené kapacity. |
|
Dedicated |
Pole identit uživatelů správce |
|
Dedicated |
Specifikace žádosti o zřízení |
| Error |
Objekt chyby. |
|
Error |
Objekt chyby |
| 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 vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků. |
|
system |
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ů.
| Hodnota | Description |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
CapacitySku
Představuje název skladové položky a cenovou úroveň Azure pro prostředek kapacity PowerBI Dedicated.
| Name | Typ | Description |
|---|---|---|
| capacity |
integer (int32) |
Kapacita skladové položky. |
| name |
string |
Název úrovně skladové položky. |
| tier |
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.
| Hodnota | Description |
|---|---|
| PBIE_Azure | |
| Premium | |
| AutoPremiumHost |
createdByType
Typ identity, která prostředek vytvořila.
| Hodnota | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DedicatedCapacity
Představuje instanci prostředku vyhrazené kapacity.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Geografické umístění, ve kterém se nachází zdroj |
| name |
string |
Název prostředku |
| properties.administration |
Kolekce správců vyhrazené kapacity |
|
| properties.friendlyName |
string |
Název kapacity |
| properties.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 |
Aktuální stav nasazení prostředku PowerBI Dedicated. ProvisioningState označuje stavy zřizování prostředků. |
|
| properties.state |
Aktuální stav vyhrazeného prostředku PowerBI Stav označuje 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 |
Skladová položka prostředku kapacity PowerBI Dedicated. |
|
| systemData |
Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil. |
|
| tags |
object |
Značky prostředků |
| type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
DedicatedCapacityAdministrators
Pole identit uživatelů správce
| Name | Typ | Description |
|---|---|---|
| members |
string[] |
Pole identit uživatelů správce. |
DedicatedCapacityUpdateParameters
Specifikace žádosti o zřízení
| Name | Typ | Description |
|---|---|---|
| properties.administration |
Kolekce správců vyhrazené kapacity |
|
| properties.friendlyName |
string |
Název kapacity |
| properties.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 |
Skladová položka prostředku vyhrazené kapacity. |
|
| tags |
object |
Páry klíč-hodnota dalších vlastností zřizování. |
Error
Objekt chyby.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Kód chyby |
| message |
string |
Chybová zpráva označující, proč operace selhala. |
ErrorResponse
Objekt chyby
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
Mode
Určuje generování kapacity Power BI Embedded. Pokud není zadaná žádná hodnota, použije se výchozí hodnota Gen2. Další informace
| Hodnota | Description |
|---|---|
| Gen1 | |
| Gen2 |
State
Aktuální stav vyhrazeného prostředku PowerBI Stav označuje více stavů mimo zřizování prostředků.
| Hodnota | Description |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Časové razítko vytvoření prostředku (UTC). |
| createdBy |
string |
Identita, která prostředek vytvořila. |
| createdByType |
Typ identity, která prostředek vytvořila. |
|
| lastModifiedAt |
string (date-time) |
Časové razítko poslední změny zdroje (UTC) |
| lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
| lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |