Capacities - Update
Frissíti a megadott dedikált kapacitás aktuális állapotát.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
dedicated
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-z][a-z0-9]*$ |
A dedikált kapacitás neve. Legalább 3 karakterből és legfeljebb 63 karakterből állhat. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
subscription
|
path | True |
string minLength: 1 |
A cél-előfizetés azonosítója. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Kérelem törzse
| Name | Típus | Description |
|---|---|---|
| properties.administration |
Dedikált kapacitásgazdák gyűjteménye |
|
| properties.mode |
A Power BI Embedded-kapacitás létrehozását adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ |
|
| sku |
A dedikált kapacitás erőforrás termékváltozata. |
|
| tags |
object |
Kulcs-érték párok további kiépítési tulajdonságokhoz. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Az Azure-művelet sikeresen befejeződött. |
|
| 202 Accepted |
A kérelem feldolgozásra lett elfogadva, de a feldolgozás még nem fejeződött be. Fejlécek
|
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory Oauth2-folyamat.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Name | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
| Update capacity parameters |
| Update capacity to Generation 2 |
Update capacity parameters
Mintakérelem
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"
}
}
Mintaválasz
{
"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
Mintakérelem
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"
}
}
Mintaválasz
{
"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"
}
}
Definíciók
| Name | Description |
|---|---|
|
Capacity |
A dedikált PowerBI-erőforrás aktuális üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotainak jelzése. |
|
Capacity |
A dedikált PowerBI-kapacitáserőforrás termékváltozatának nevét és Azure-tarifacsomagját jelöli. |
|
Capacity |
Annak az Azure-tarifacsomagnak a neve, amelyre az SKU vonatkozik. |
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Dedicated |
Dedikált kapacitású erőforrás egy példányát jelöli. |
|
Dedicated |
Rendszergazdai felhasználói identitások tömbje |
|
Dedicated |
Kiépítési kérelem specifikációja |
| Error |
A hibaobjektum. |
|
Error |
A hibaobjektum |
| Mode |
A Power BI Embedded-kapacitás létrehozását adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ |
| State |
A dedikált PowerBI-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez. |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
CapacityProvisioningState
A dedikált PowerBI-erőforrás aktuális üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotainak jelzése.
| Érték | Description |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
CapacitySku
A dedikált PowerBI-kapacitáserőforrás termékváltozatának nevét és Azure-tarifacsomagját jelöli.
| Name | Típus | Description |
|---|---|---|
| capacity |
integer (int32) |
A termékváltozat kapacitása. |
| name |
string |
A termékváltozat-szint neve. |
| tier |
Annak az Azure-tarifacsomagnak a neve, amelyre az SKU vonatkozik. |
CapacitySkuTier
Annak az Azure-tarifacsomagnak a neve, amelyre az SKU vonatkozik.
| Érték | Description |
|---|---|
| PBIE_Azure | |
| Premium | |
| AutoPremiumHost |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DedicatedCapacity
Dedikált kapacitású erőforrás egy példányát jelöli.
| Name | Típus | Description |
|---|---|---|
| id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Az a földrajzi hely, ahol az erőforrás él |
| name |
string |
Az erőforrás neve |
| properties.administration |
Dedikált kapacitásgazdák gyűjteménye |
|
| properties.friendlyName |
string |
Kapacitás neve |
| properties.mode |
A Power BI Embedded-kapacitás létrehozását adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ |
|
| properties.provisioningState |
A dedikált PowerBI-erőforrás aktuális üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotainak jelzése. |
|
| properties.state |
A dedikált PowerBI-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez. |
|
| properties.tenantId |
string |
A kapacitás bérlőazonosítója. Pro Plus-kapacitás létrehozásához használatos. |
| sku |
A Dedikált PowerBI-kapacitás erőforrás termékváltozata. |
|
| systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
|
| tags |
object |
Erőforráscímkék. |
| type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
DedicatedCapacityAdministrators
Rendszergazdai felhasználói identitások tömbje
| Name | Típus | Description |
|---|---|---|
| members |
string[] |
Rendszergazdai felhasználói identitások tömbje. |
DedicatedCapacityUpdateParameters
Kiépítési kérelem specifikációja
| Name | Típus | Description |
|---|---|---|
| properties.administration |
Dedikált kapacitásgazdák gyűjteménye |
|
| properties.friendlyName |
string |
Kapacitás neve |
| properties.mode |
A Power BI Embedded-kapacitás létrehozását adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ |
|
| properties.tenantId |
string |
A kapacitás bérlőazonosítója. Pro Plus-kapacitás létrehozásához használatos. |
| sku |
A dedikált kapacitás erőforrás termékváltozata. |
|
| tags |
object |
Kulcs-érték párok további kiépítési tulajdonságokhoz. |
Error
A hibaobjektum.
| Name | Típus | Description |
|---|---|---|
| code |
string |
Hibakód |
| message |
string |
A művelet sikertelen voltát jelző hibaüzenet. |
ErrorResponse
A hibaobjektum
| Name | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
Mode
A Power BI Embedded-kapacitás létrehozását adja meg. Ha nincs megadva érték, a rendszer az alapértelmezett "Gen2" értéket használja. További információ
| Érték | Description |
|---|---|
| Gen1 | |
| Gen2 |
State
A dedikált PowerBI-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.
| Érték | Description |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
| Name | Típus | Description |
|---|---|---|
| createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
| createdBy |
string |
Az erőforrást létrehozó identitás. |
| createdByType |
Az erőforrást létrehozó identitás típusa. |
|
| lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
| lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
| lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |