Capacities - Update
Belirtilen Ayrılmış kapasitenin geçerli durumunu güncelleştirir.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01
URI Parametreleri
| Name | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
dedicated
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-z][a-z0-9]*$ |
Ayrılmış kapasitenin adı. En az 3 karakter ve en fazla 63 karakter olmalıdır. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız. |
|
subscription
|
path | True |
string minLength: 1 |
Hedef aboneliğin kimliği. |
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
| Name | Tür | Description |
|---|---|---|
| properties.administration |
Ayrılmış kapasite yöneticileri koleksiyonu |
|
| properties.mode |
Power BI Embedded kapasitesinin neslini belirtir. Hiçbir değer belirtilmezse, varsayılan değer '2. Nesil' kullanılır. Daha Fazla Bilgi |
|
| sku |
Ayrılmış kapasite kaynağının SKU'su. |
|
| tags |
object |
Ek sağlama özelliklerinin anahtar-değer çiftleri. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
Azure işlemi başarıyla tamamlandı. |
|
| 202 Accepted |
İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı. Üst Bilgiler
|
|
| Other Status Codes |
Beklenmeyen bir hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Akışı.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
| Name | Description |
|---|---|
| user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
| Update capacity parameters |
| Update capacity to Generation 2 |
Update capacity parameters
Örnek isteği
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"
}
}
Örnek yanıt
{
"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
Örnek isteği
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"
}
}
Örnek yanıt
{
"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"
}
}
Tanımlar
| Name | Description |
|---|---|
|
Capacity |
PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını belirtmektir. |
|
Capacity |
PowerBI Ayrılmış kapasite kaynağı için SKU adını ve Azure fiyatlandırma katmanını temsil eder. |
|
Capacity |
SKU'nun uygulandığı Azure fiyatlandırma katmanının adı. |
|
created |
Kaynağı oluşturan kimliğin türü. |
|
Dedicated |
Ayrılmış Kapasite kaynağının bir örneğini temsil eder. |
|
Dedicated |
Yönetici kullanıcı kimlikleri dizisi |
|
Dedicated |
Sağlama isteği belirtimi |
| Error |
Hata nesnesi. |
|
Error |
Hata nesnesi |
| Mode |
Power BI Embedded kapasitesinin neslini belirtir. Hiçbir değer belirtilmezse, varsayılan değer '2. Nesil' kullanılır. Daha Fazla Bilgi |
| State |
PowerBI Ayrılmış kaynağının geçerli durumu. Durum, kaynak sağlama dışında daha fazla durum belirtmektir. |
|
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
CapacityProvisioningState
PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını belirtmektir.
| Değer | Description |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
CapacitySku
PowerBI Ayrılmış kapasite kaynağı için SKU adını ve Azure fiyatlandırma katmanını temsil eder.
| Name | Tür | Description |
|---|---|---|
| capacity |
integer (int32) |
SKU'nun kapasitesi. |
| name |
string |
SKU düzeyinin adı. |
| tier |
SKU'nun uygulandığı Azure fiyatlandırma katmanının adı. |
CapacitySkuTier
SKU'nun uygulandığı Azure fiyatlandırma katmanının adı.
| Değer | Description |
|---|---|
| PBIE_Azure | |
| Premium | |
| AutoPremiumHost |
createdByType
Kaynağı oluşturan kimliğin türü.
| Değer | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DedicatedCapacity
Ayrılmış Kapasite kaynağının bir örneğini temsil eder.
| Name | Tür | Description |
|---|---|---|
| id |
string |
Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Kaynağın bulunduğu coğrafi konum |
| name |
string |
Kaynağın adı |
| properties.administration |
Ayrılmış kapasite yöneticileri koleksiyonu |
|
| properties.friendlyName |
string |
Kapasite adı |
| properties.mode |
Power BI Embedded kapasitesinin neslini belirtir. Hiçbir değer belirtilmezse, varsayılan değer '2. Nesil' kullanılır. Daha Fazla Bilgi |
|
| properties.provisioningState |
PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını belirtmektir. |
|
| properties.state |
PowerBI Ayrılmış kaynağının geçerli durumu. Durum, kaynak sağlama dışında daha fazla durum belirtmektir. |
|
| properties.tenantId |
string |
Kapasite için kiracı kimliği. Pro Plus kapasitesi oluşturmak için kullanılır. |
| sku |
PowerBI Ayrılmış kapasite kaynağının SKU'su. |
|
| systemData |
createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri. |
|
| tags |
object |
Kaynak etiketleri. |
| type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
DedicatedCapacityAdministrators
Yönetici kullanıcı kimlikleri dizisi
| Name | Tür | Description |
|---|---|---|
| members |
string[] |
Yönetici kullanıcı kimlikleri dizisi. |
DedicatedCapacityUpdateParameters
Sağlama isteği belirtimi
| Name | Tür | Description |
|---|---|---|
| properties.administration |
Ayrılmış kapasite yöneticileri koleksiyonu |
|
| properties.friendlyName |
string |
Kapasite adı |
| properties.mode |
Power BI Embedded kapasitesinin neslini belirtir. Hiçbir değer belirtilmezse, varsayılan değer '2. Nesil' kullanılır. Daha Fazla Bilgi |
|
| properties.tenantId |
string |
Kapasite için kiracı kimliği. Pro Plus kapasitesi oluşturmak için kullanılır. |
| sku |
Ayrılmış kapasite kaynağının SKU'su. |
|
| tags |
object |
Ek sağlama özelliklerinin anahtar-değer çiftleri. |
Error
Hata nesnesi.
| Name | Tür | Description |
|---|---|---|
| code |
string |
Hata kodu |
| message |
string |
İşlemin neden başarısız olduğunu gösteren hata iletisi. |
ErrorResponse
Hata nesnesi
| Name | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
Mode
Power BI Embedded kapasitesinin neslini belirtir. Hiçbir değer belirtilmezse, varsayılan değer '2. Nesil' kullanılır. Daha Fazla Bilgi
| Değer | Description |
|---|---|
| Gen1 | |
| Gen2 |
State
PowerBI Ayrılmış kaynağının geçerli durumu. Durum, kaynak sağlama dışında daha fazla durum belirtmektir.
| Değer | Description |
|---|---|
| Deleting | |
| Succeeded | |
| Failed | |
| Paused | |
| Suspended | |
| Provisioning | |
| Updating | |
| Suspending | |
| Pausing | |
| Resuming | |
| Preparing | |
| Scaling |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
| Name | Tür | Description |
|---|---|---|
| createdAt |
string (date-time) |
Kaynak oluşturma (UTC) zaman damgası. |
| createdBy |
string |
Kaynağı oluşturan kimlik. |
| createdByType |
Kaynağı oluşturan kimliğin türü. |
|
| lastModifiedAt |
string (date-time) |
Kaynağın son değişikliğinin zaman damgası (UTC) |
| lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
| lastModifiedByType |
Kaynağı en son değiştiren kimlik türü. |