Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Membuat ruang kerja baru.

Izin

Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Workspace.ReadWrite.All

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

With optional parameters:

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	OK

Contoh

Create a workspace example

Example

Create a workspace example

Sample Request

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

Request Body

{
  "name": "sample workspace"
}

Sample Response

Status code:

200

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

Example

Sample Request

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

Request Body

{
  "name": "sample group"
}

Sample Response

Status code:

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

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

Nama	Jenis	Deskripsi
id	string	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	Langganan Azure tempat sumber daya berada.

DefaultDatasetStorageFormat

Format penyimpanan himpunan data default dalam grup

Nama	Jenis	Deskripsi
Large	string	Format penyimpanan himpunan data besar
Small	string	Format penyimpanan himpunan data kecil

Group

Grup Power BI

Nama	Jenis	Deskripsi
capacityId	string	ID kapasitas
dataflowStorageId	string	ID akun penyimpanan aliran data Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Format penyimpanan himpunan data default di ruang kerja. Dikembalikan hanya ketika isOnDedicatedCapacity adalah true
id	string	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 hanya dikembalikan saat mengambil satu grup.
name	string	Nama grup

GroupCreationRequest

Permintaan Power BI untuk membuat grup baru

Nama	Jenis	Deskripsi
name	string	Nama grup yang baru dibuat