Capacities - Update

Hizmet:: Power BI Embedded

API Sürümü:: 2021-01-01

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
dedicatedCapacityName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Ayrılmış kapasitenin adı. En az 3 karakter ve en fazla 63 karakter olmalıdır.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	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	DedicatedCapacityAdministrators	Ayrılmış kapasite yöneticileri koleksiyonu
properties.mode	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	CapacitySku	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	DedicatedCapacity	Azure işlemi başarıyla tamamlandı.
202 Accepted	DedicatedCapacity	İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı. Üst Bilgiler Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

DedicatedCapacity

Azure işlemi başarıyla tamamlandı.

202 Accepted

DedicatedCapacity

İstek işleme için kabul edildi, ancak işleme henüz tamamlanmadı.

Üst Bilgiler

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

HTTP

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

Durum kodu:: 200

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

Durum kodu:: 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

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

HTTP

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

Durum kodu:: 200

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

Durum kodu:: 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

{
  "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
CapacityProvisioningState	PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını belirtmektir.
CapacitySku	PowerBI Ayrılmış kapasite kaynağı için SKU adını ve Azure fiyatlandırma katmanını temsil eder.
CapacitySkuTier	SKU'nun uygulandığı Azure fiyatlandırma katmanının adı.
createdByType	Kaynağı oluşturan kimliğin türü.
DedicatedCapacity	Ayrılmış Kapasite kaynağının bir örneğini temsil eder.
DedicatedCapacityAdministrators	Yönetici kullanıcı kimlikleri dizisi
DedicatedCapacityUpdateParameters	Sağlama isteği belirtimi
Error	Hata nesnesi.
ErrorResponse	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.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

CapacityProvisioningState

Listeleme

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

Object

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	CapacitySkuTier	SKU'nun uygulandığı Azure fiyatlandırma katmanının adı.

CapacitySkuTier

Listeleme

SKU'nun uygulandığı Azure fiyatlandırma katmanının adı.

Değer	Description
PBIE_Azure
Premium
AutoPremiumHost

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DedicatedCapacity

Object

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	DedicatedCapacityAdministrators	Ayrılmış kapasite yöneticileri koleksiyonu
properties.friendlyName	string	Kapasite adı
properties.mode	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	CapacityProvisioningState	PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını belirtmektir.
properties.state	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	CapacitySku	PowerBI Ayrılmış kapasite kaynağının SKU'su.
systemData	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

Object

Yönetici kullanıcı kimlikleri dizisi

Name	Tür	Description
members	string[]	Yönetici kullanıcı kimlikleri dizisi.

DedicatedCapacityUpdateParameters

Object

Sağlama isteği belirtimi

Name	Tür	Description
properties.administration	DedicatedCapacityAdministrators	Ayrılmış kapasite yöneticileri koleksiyonu
properties.friendlyName	string	Kapasite adı
properties.mode	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	CapacitySku	Ayrılmış kapasite kaynağının SKU'su.
tags	object	Ek sağlama özelliklerinin anahtar-değer çiftleri.

Error

Object

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

Object

Hata nesnesi

Name	Tür	Description
error	Error	Hata nesnesi.

Mode

Listeleme

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

Listeleme

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

Object

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	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	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Capacities - Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Update capacity parameters

Örnek isteği

Örnek yanıt

Update capacity to Generation 2

Örnek isteği

Örnek yanıt

Tanımlar

CapacityProvisioningState

CapacitySku

CapacitySkuTier

createdByType

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

Mode

State

systemData