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

Objek

Pembungkus respons OData untuk daftar kapasitas Power BI

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

Capacity

Objek

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 (uuid)	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 (uuid)	ID kunci enkripsi (hanya berlaku untuk rute admin)

CapacityState

Enumeration

Status kapasitas

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

capacityUserAccessRight

Enumeration

Hak akses yang dimiliki pengguna pada kapasitas

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

TenantKey

Objek

Informasi kunci enkripsi

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanggal dan waktu pembuatan kunci enkripsi
id	string (uuid)	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 (date-time)	Tanggal dan waktu pembaruan terakhir kunci enkripsi