Admin - Get Capacities As Admin

Layanan:

Power BI REST APIs

Versi API:

v1.0

Mengembalikan daftar kapasitas untuk organisasi.

Izin

• Pengguna harus menjadi administrator Fabric 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 ditetapkan di portal Microsoft Azure.

Cakupan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

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

Pembatasan

Maksimum 200 permintaan per jam.

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

Dengan parameter opsional:

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	OKE

Contoh

Example

Example with expand on tenant key

Example

Permintaan sampel

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

Respon sampel

Kode status:

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

Permintaan sampel

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

Respon sampel

Kode status:

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	Akses yang tepat 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. Setiap 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