Admin - Get Capacities As Admin

Service:

Power BI REST APIs

API Version:

v1.0

Mengembalikan daftar kapasitas untuk organisasi.

Izin

• Pengguna harus memiliki hak administrator (seperti Office 365 Administrator Global atau Administrator Layanan Power BI) atau mengautentikasi menggunakan perwakilan layanan.
• Izin yang didelegasikan didukung.

Saat berjalan di bawah autentikasi perwakilan layanan, aplikasi tidak boleh memiliki izin admin yang diperlukan untuk Power BI yang diatur di dalam portal Azure.

Cakupan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

Hanya relevan saat mengautentikasi melalui token akses admin standar yang didelegasikan. Tidak boleh ada ketika autentikasi melalui perwakilan layanan digunakan.

GET https://api.powerbi.com/v1.0/myorg/admin/capacities

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
$expand	query		string	Memperluas entitas terkait sebaris

Respons

Nama	Jenis	Deskripsi
200 OK	Capacities	OK

Contoh

Example

Example with expand on tenant key

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7"
    }
  ]
}

Example with expand on tenant key

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "tenantKey": {
        "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
        "name": "Contoso Sales",
        "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
        "isDefault": true,
        "createdAt": "2019-04-30T21:35:15.867-07:00",
        "updatedAt": "2019-04-30T21:35:15.867-07:00"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
Capacities	Pembungkus respons OData untuk daftar kapasitas Power BI
Capacity	Kapasitas Power BI
CapacityState	Status kapasitas
capacityUserAccessRight	Hak akses yang dimiliki pengguna pada kapasitas
TenantKey	Informasi kunci enkripsi

Capacities

Pembungkus respons OData untuk daftar kapasitas Power BI

Nama	Jenis	Deskripsi
odata.context	string
value	Capacity[]	Daftar kapasitas

Capacity

Kapasitas Power BI

Nama	Jenis	Deskripsi
admins	string[]	Array admin kapasitas
capacityUserAccessRight	capacityUserAccessRight	Hak akses yang dimiliki pengguna pada kapasitas
displayName	string	Nama tampilan kapasitas
id	string	ID kapasitas
region	string	Wilayah Azure tempat kapasitas disediakan
sku	string	SKU kapasitas
state	CapacityState	Status kapasitas
tenantKey	TenantKey	Informasi kunci enkripsi (hanya berlaku untuk rute admin)
tenantKeyId	string	ID kunci enkripsi (hanya berlaku untuk rute admin)

CapacityState

Status kapasitas

Nama	Jenis	Deskripsi
Active	string	Kapasitas siap digunakan
Deleted	string	Kapasitas dihapus dan tidak tersedia
Deleting	string	Penghapusan kapasitas sedang berlangsung
Invalid	string	Kapasitas tidak dapat digunakan
NotActivated	string	Tidak didukung
PreSuspended	string	Tidak didukung
ProvisionFailed	string	Penyediaan kapasitas gagal
Provisioning	string	Aktivasi kapasitas sedang berlangsung
Suspended	string	Penggunaan kapasitas ditangguhkan
UpdatingSku	string	Perubahan SKU kapasitas sedang berlangsung

capacityUserAccessRight

Hak akses yang dimiliki pengguna pada kapasitas

Nama	Jenis	Deskripsi
Admin	string	Pengguna memiliki hak administrator pada kapasitas
Assign	string	Pengguna memiliki hak kontributor dan dapat menetapkan ruang kerja ke kapasitas
None	string	Pengguna tidak memiliki akses ke kapasitas

TenantKey

Informasi kunci enkripsi

Nama	Jenis	Deskripsi
createdAt	string	Tanggal dan waktu pembuatan kunci enkripsi
id	string	ID kunci enkripsi
isDefault	boolean	Apakah kunci enkripsi adalah kunci default untuk seluruh penyewa. Kapasitas yang baru dibuat mewarisi kunci default.
keyVaultKeyIdentifier	string	URI yang secara unik menentukan kunci enkripsi di Azure Key Vault
name	string	Nama kunci enkripsi
updatedAt	string	Tanggal dan waktu pembaruan terakhir kunci enkripsi