Bagikan melalui

Groups - Create Group

  • Referensi
Layanan:
Power BI REST APIs
Versi API:
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
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

OK

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

Object

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

Enumeration

Format penyimpanan himpunan data default dalam grup

Nilai Deskripsi
Large

Format penyimpanan himpunan data besar
Small

Format penyimpanan himpunan data kecil

Group

Object

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

Object

Permintaan Power BI untuk membuat grup baru

Nama Jenis Deskripsi
name

string

Nama grup yang baru dibuat