Capacities - Update

Referensi

Layanan:: Power BI Embedded

Versi API:: 2021-01-01

Updates status kapasitas Khusus yang ditentukan saat ini.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBIDedicated/capacities/{dedicatedCapacityName}?api-version=2021-01-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
dedicatedCapacityName	path	True	string	Nama kapasitas Khusus. Panjangnya harus minimal 3 karakter, dan tidak lebih dari 63. Pola regex: `^[a-z][a-z0-9]*$`
resourceGroupName	path	True	string	Nama grup Sumber Daya Azure di mana kapasitas PowerBIDedicated tertentu adalah bagian. Panjang nama ini harus minimal 1 karakter, dan tidak lebih dari 90. Pola regex: `^[-\w\._]+$`
subscriptionId	path	True	string	Pengidentifikasi unik untuk langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi API klien.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.administration	DedicatedCapacityAdministrators	Kumpulan administrator kapasitas Khusus
properties.mode	Mode	Menentukan pembuatan kapasitas Power BI Embedded. Jika tidak ada nilai yang ditentukan, nilai default 'Gen2' digunakan. Pelajari Selengkapnya
sku	CapacitySku	SKU sumber daya kapasitas Khusus.
tags	object	Pasangan kunci-nilai dari properti provisi tambahan.

Respons

Nama	Jenis	Deskripsi
200 OK	DedicatedCapacity	OK
202 Accepted	DedicatedCapacity	Diterima
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Update capacity parameters

Update capacity to Generation 2

Update capacity parameters

Permintaan sampel

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

Respon sampel

Kode status:: 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"
  }
}

Kode status:: 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

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

Permintaan sampel

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

Respon sampel

Kode status:: 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"
  }
}

Kode status:: 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

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

Definisi

Nama	Deskripsi
CapacityProvisioningState	Status penyebaran sumber daya Khusus PowerBI saat ini. ProvisioningState adalah untuk menunjukkan status untuk provisi sumber daya.
CapacitySku	Mewakili nama SKU dan tingkat harga Azure untuk sumber daya kapasitas Khusus PowerBI.
CapacitySkuTier	Nama tingkat harga Azure tempat SKU berlaku.
DedicatedCapacity	Mewakili instans sumber daya Kapasitas Khusus.
DedicatedCapacityAdministrators	Array identitas pengguna administrator
DedicatedCapacityUpdateParameters	Spesifikasi permintaan provisi
Error	Objek kesalahan
ErrorResponse	Menjelaskan format respons Kesalahan.
IdentityType	Jenis identitas yang membuat/memodifikasi sumber daya.
Mode	Menentukan pembuatan kapasitas Power BI Embedded. Jika tidak ada nilai yang ditentukan, nilai default 'Gen2' digunakan. Pelajari Selengkapnya
State	Status sumber daya Khusus PowerBI saat ini. Statusnya adalah untuk menunjukkan lebih banyak status di luar provisi sumber daya.
SystemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

CapacityProvisioningState

Status penyebaran sumber daya Khusus PowerBI saat ini. ProvisioningState adalah untuk menunjukkan status untuk provisi sumber daya.

Nama	Jenis	Deskripsi
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

Mewakili nama SKU dan tingkat harga Azure untuk sumber daya kapasitas Khusus PowerBI.

Nama	Jenis	Deskripsi
capacity	integer	Kapasitas SKU.
name	string	Nama tingkat SKU.
tier	CapacitySkuTier	Nama tingkat harga Azure tempat SKU berlaku.

CapacitySkuTier

Nama tingkat harga Azure tempat SKU berlaku.

Nama	Jenis	Deskripsi
AutoPremiumHost	string
PBIE_Azure	string
Premium	string

DedicatedCapacity

Mewakili instans sumber daya Kapasitas Khusus.

Nama	Jenis	Deskripsi
id	string	Pengidentifikasi yang mewakili sumber daya Khusus PowerBI.
location	string	Lokasi sumber daya Khusus PowerBI.
name	string	Nama sumber daya Khusus PowerBI.
properties.administration	DedicatedCapacityAdministrators	Kumpulan administrator kapasitas Khusus
properties.friendlyName	string	Nama kapasitas
properties.mode	Mode	Menentukan pembuatan kapasitas Power BI Embedded. Jika tidak ada nilai yang ditentukan, nilai default 'Gen2' digunakan. Pelajari Selengkapnya
properties.provisioningState	CapacityProvisioningState	Status penyebaran sumber daya Khusus PowerBI saat ini. ProvisioningState adalah untuk menunjukkan status untuk provisi sumber daya.
properties.state	State	Status sumber daya Khusus PowerBI saat ini. Statusnya adalah untuk menunjukkan lebih banyak status di luar provisi sumber daya.
properties.tenantId	string	ID penyewa untuk kapasitas. Digunakan untuk membuat kapasitas Pro Plus.
sku	CapacitySku	SKU sumber daya kapasitas Khusus PowerBI.
systemData	SystemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
tags	object	Pasangan kunci-nilai dari properti provisi sumber daya tambahan.
type	string	Jenis sumber daya Khusus PowerBI.

DedicatedCapacityAdministrators

Array identitas pengguna administrator

Nama	Jenis	Deskripsi
members	string[]	Array identitas pengguna administrator.

DedicatedCapacityUpdateParameters

Spesifikasi permintaan provisi

Nama	Jenis	Deskripsi
properties.administration	DedicatedCapacityAdministrators	Kumpulan administrator kapasitas Khusus
properties.friendlyName	string	Nama kapasitas
properties.mode	Mode	Menentukan pembuatan kapasitas Power BI Embedded. Jika tidak ada nilai yang ditentukan, nilai default 'Gen2' digunakan. Pelajari Selengkapnya
properties.tenantId	string	ID penyewa untuk kapasitas. Digunakan untuk membuat kapasitas Pro Plus.
sku	CapacitySku	SKU sumber daya kapasitas Khusus.
tags	object	Pasangan kunci-nilai dari properti provisi tambahan.

Error

Objek kesalahan

Nama	Jenis	Deskripsi
code	string	Kode kesalahan
message	string	Pesan kesalahan yang menunjukkan mengapa operasi gagal.

ErrorResponse

Menjelaskan format respons Kesalahan.

Nama	Jenis	Deskripsi
error	Error	Objek kesalahan

IdentityType

Jenis identitas yang membuat/memodifikasi sumber daya.

Nama	Jenis	Deskripsi
Application	string
Key	string
ManagedIdentity	string
User	string

Mode

Menentukan pembuatan kapasitas Power BI Embedded. Jika tidak ada nilai yang ditentukan, nilai default 'Gen2' digunakan. Pelajari Selengkapnya

Nama	Jenis	Deskripsi
Gen1	string
Gen2	string

State

Status sumber daya Khusus PowerBI saat ini. Statusnya adalah untuk menunjukkan lebih banyak status di luar provisi sumber daya.

Nama	Jenis	Deskripsi
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

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC)
createdBy	string	Pengidentifikasi untuk identitas yang membuat sumber daya
createdByType	IdentityType	Jenis identitas yang membuat sumber daya
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Pengidentifikasi untuk identitas yang terakhir mengubah sumber daya
lastModifiedByType	IdentityType	Jenis identitas yang terakhir mengubah sumber daya

Bagikan melalui

Capacities - Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

Update capacity parameters

Permintaan sampel

Respon sampel

Update capacity to Generation 2

Permintaan sampel

Respon sampel

Definisi

CapacityProvisioningState

CapacitySku

CapacitySkuTier

DedicatedCapacity

DedicatedCapacityAdministrators

DedicatedCapacityUpdateParameters

Error

ErrorResponse

IdentityType

Mode

State

SystemData

Sumber Daya Tambahan: