Capacities - Update

Başvuru

Service:: Power BI Embedded

API Version:: 2021-01-01

Belirtilen Ayrılmış kapasitenin geçerli durumunu Güncelleştirmeler.

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	Ayrılmış kapasitenin adı. En az 3 karakter uzunluğunda ve en fazla 63 karakter uzunluğunda olmalıdır. Regex pattern: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Belirli bir PowerBIDedicated kapasitesinin parçası olduğu Azure Kaynak grubunun adı. Bu ad en az 1 karakter uzunluğunda ve 90'dan fazla olmamalıdır. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Microsoft Azure aboneliği için benzersiz tanımlayıcı. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.
api-version	query	True	string	İstemci 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 oluşturulmasını belirtir. Hiçbir değer belirtilmezse, varsayılan değer 'Gen2' 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	Tamam
202 Accepted	DedicatedCapacity	Kabul edildi
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Sample Request

HTTP

PATCH 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"
  },
  "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:: 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

Response Body

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

Update capacity to Generation 2

Sample Request

HTTP

PATCH 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"
  },
  "properties": {
    "mode": "Gen2"
  }
}

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"
      ]
    },
    "mode": "Gen2",
    "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:: 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

Response Body

{
  "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"
      ]
    },
    "mode": "Gen2",
    "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"
  }
}

Tanımlar

Name	Description
CapacityProvisioningState	PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını gösterir.
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ı.
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 yanıtının biçimini açıklar.
IdentityType	Kaynağı oluşturan/değiştiren kimliğin türü.
Mode	Power BI Embedded kapasitesinin oluşturulmasını belirtir. Hiçbir değer belirtilmezse, varsayılan değer 'Gen2' 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

PowerBI Ayrılmış kaynağının geçerli dağıtım durumu. provisioningState, kaynak sağlama durumlarını gösterir.

Name	Tür	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

PowerBI Ayrılmış kapasite kaynağı için SKU adını ve Azure fiyatlandırma katmanını temsil eder.

Name	Tür	Description
capacity	integer	SKU'nun kapasitesi.
name	string	SKU düzeyinin adı.
tier	CapacitySkuTier	SKU'nun uygulandığı Azure fiyatlandırma katmanının adı.

CapacitySkuTier

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

Name	Tür	Description
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Ayrılmış Kapasite kaynağının bir örneğini temsil eder.

Name	Tür	Description
id	string	PowerBI Ayrılmış kaynağını temsil eden tanımlayıcı.
location	string	PowerBI Ayrılmış kaynağının konumu.
name	string	PowerBI Ayrılmış kaynağının adı.
properties.administration	DedicatedCapacityAdministrators	Ayrılmış kapasite yöneticileri koleksiyonu
properties.friendlyName	string	Kapasite adı
properties.mode	Mode	Power BI Embedded kapasitesinin oluşturulmasını belirtir. Hiçbir değer belirtilmezse, varsayılan değer 'Gen2' 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ı gösterir.
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	Kapasitenin 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	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
tags	object	Ek kaynak sağlama özelliklerinin anahtar-değer çiftleri.
type	string	PowerBI Ayrılmış kaynağının türü.

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	DedicatedCapacityAdministrators	Ayrılmış kapasite yöneticileri koleksiyonu
properties.friendlyName	string	Kapasite adı
properties.mode	Mode	Power BI Embedded kapasitesinin oluşturulmasını belirtir. Hiçbir değer belirtilmezse, varsayılan değer 'Gen2' kullanılır. Daha Fazla Bilgi
properties.tenantId	string	Kapasitenin 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

Hata nesnesi

Name	Tür	Description
code	string	Hata kodu
message	string	İşlemin neden başarısız olduğunu belirten hata iletisi.

ErrorResponse

Hata yanıtının biçimini açıklar.

Name	Tür	Description
error	Error	Hata nesnesi

IdentityType

Kaynağı oluşturan/değiştiren kimliğin türü.

Name	Tür	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Power BI Embedded kapasitesinin oluşturulmasını belirtir. Hiçbir değer belirtilmezse, varsayılan değer 'Gen2' kullanılır. Daha Fazla Bilgi

Name	Tür	Description
Gen1	string
Gen2	string

State

PowerBI Ayrılmış kaynağının geçerli durumu. Durum, kaynak sağlama dışında daha fazla durum belirtmektir.

Name	Tür	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

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string	Kaynak oluşturma zaman damgası (UTC)
createdBy	string	Kaynağı oluşturan kimliğin tanımlayıcısı
createdByType	IdentityType	Kaynağı oluşturan kimliğin türü
lastModifiedAt	string	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı son değiştiren kimliğin tanımlayıcısı
lastModifiedByType	IdentityType	Kaynağı en son değiştiren kimliğin türü

Capacities - Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Scopes

Örnekler

Update capacity parameters

Sample Request

Sample Response

Update capacity to Generation 2

Sample Request

Sample Response

Tanımlar

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Ek kaynaklar