Groups - Create Group

Layanan:

Power BI REST APIs

Versi API:

v1.0

Membuat ruang kerja baru.

Hak akses

• Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: profil perwakilan layanan di Power BI Embedded.
• Perwakilan Layanan harus memiliki izin yang diberikan oleh administrator Fabric. Untuk informasi selengkapnya, lihat: Perwakilan layanan dapat membuat ruang kerja, koneksi, dan alur penyebaran.

Cakupan yang Diperlukan

Workspace.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups

Dengan parameter opsional:

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceV2	query		boolean	(Fitur pratinjau) Apakah akan membuat ruang kerja. Satu-satunya nilai yang didukung adalah true.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
name	True	string	Nama grup yang baru dibuat

Respons

Nama	Jenis	Deskripsi
200 OK	Group	OKE

Contoh

Create a workspace example

Example

Create a workspace example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True

Isi Permintaan

{
  "name": "sample workspace"
}

Respon sampel

Kode status:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace"
    }
  ]
}

Example

Permintaan sampel

POST https://api.powerbi.com/v1.0/myorg/groups

Isi Permintaan

{
  "name": "sample group"
}

Respon sampel

Kode status:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    }
  ]
}

Definisi

Nama	Deskripsi
AzureResource	Respons yang merinci sumber daya Azure milik pengguna seperti ruang kerja Analitik Log.
DefaultDatasetStorageFormat	Format penyimpanan himpunan data default dalam grup
Group	Grup Power BI
GroupCreationRequest	Permintaan Power BI untuk membuat grup baru

AzureResource

Objek

Respons yang merinci sumber daya Azure milik pengguna seperti ruang kerja Analitik Log.

Nama	Jenis	Deskripsi
id	string (uuid)	Pengidentifikasi untuk sumber daya dalam Power BI.
resourceGroup	string	Grup sumber daya dalam langganan tempat sumber daya berada.
resourceName	string	Nama sumber daya.
subscriptionId	string (uuid)	Langganan Azure tempat sumber daya berada.

DefaultDatasetStorageFormat

Enumeration

Format penyimpanan himpunan data default dalam grup

Nilai	Deskripsi
Small	Format penyimpanan himpunan data kecil
Large	Format penyimpanan himpunan data besar

Group

Objek

Grup Power BI

Nama	Jenis	Deskripsi
capacityId	string (uuid)	ID kapasitas
dataflowStorageId	string (uuid)	ID akun penyimpanan aliran data Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Format penyimpanan himpunan data default di ruang kerja. Dikembalikan hanya ketika isOnDedicatedCapacitytrue
id	string (uuid)	ID ruang kerja
isOnDedicatedCapacity	boolean	Apakah grup ditetapkan ke kapasitas khusus
isReadOnly	boolean	Apakah grup bersifat baca-saja
logAnalyticsWorkspace	AzureResource	Ruang kerja Analitik Log yang ditetapkan ke grup. Ini dikembalikan hanya saat mengambil satu grup.
name	string	Nama grup

GroupCreationRequest

Objek

Permintaan Power BI untuk membuat grup baru

Nama	Jenis	Deskripsi
name	string	Nama grup yang baru dibuat