Groups - Create Group

Hizmet:

Power BI REST APIs

API Sürümü:

v1.0

Yeni bir çalışma alanı oluşturur.

İzinler

• Bu API çağrısı bir hizmet sorumlusu profili tarafından çağrılabilir. Daha fazla bilgi için bkz. Power BI Embeddedhizmet sorumlusu profilleri.
• Hizmet Sorumluları, Doku yöneticisi tarafından verilen izne sahip olmalıdır. Daha fazla bilgi için bkz. Hizmet sorumluları çalışma alanları, bağlantılar ve dağıtım işlem hatları oluşturabilir.

Gerekli Kapsam

Workspace.ReadWrite.All

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
workspaceV2	query		boolean	(Önizleme özelliği) Çalışma alanı oluşturulup oluşturulmayacağı. Desteklenen tek değer true.

İstek Gövdesi

Name	Gerekli	Tür	Description
name	True	string	Yeni oluşturulan grubun adı

Yanıtlar

Name	Tür	Description
200 OK	Group	Tamam

Örnekler

Create a workspace example

Example

Create a workspace example

Örnek isteği

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

İstek Gövdesi

{
  "name": "sample workspace"
}

Örnek yanıt

Durum kodu:

200

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

Example

Örnek isteği

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

İstek Gövdesi

{
  "name": "sample group"
}

Örnek yanıt

Durum kodu:

200

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

Tanımlar

Name	Description
AzureResource	Log Analytics çalışma alanı gibi kullanıcıya ait bir Azure kaynağının ayrıntılarını içeren yanıt.
DefaultDatasetStorageFormat	Gruptaki varsayılan veri kümesi depolama biçimi
Group	Power BI grubu
GroupCreationRequest	Yeni grup oluşturmak için Power BI isteği

AzureResource

Object

Log Analytics çalışma alanı gibi kullanıcıya ait bir Azure kaynağının ayrıntılarını içeren yanıt.

Name	Tür	Description
id	string (uuid)	Power BI içindeki kaynağın tanımlayıcısı.
resourceGroup	string	Kaynağın bulunduğu abonelik içindeki kaynak grubu.
resourceName	string	Kaynağın adı.
subscriptionId	string (uuid)	Kaynağın bulunduğu Azure aboneliği.

DefaultDatasetStorageFormat

Listeleme

Gruptaki varsayılan veri kümesi depolama biçimi

Değer	Description
Small	Küçük veri kümesi depolama biçimi
Large	Büyük veri kümesi depolama biçimi

Group

Object

Power BI grubu

Name	Tür	Description
capacityId	string (uuid)	Kapasite kimliği
dataflowStorageId	string (uuid)	Power BI veri akışı depolama hesabı kimliği
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Çalışma alanındaki varsayılan veri kümesi depolama biçimi. Yalnızca isOnDedicatedCapacitytrue döndürülür
id	string (uuid)	Çalışma alanı kimliği
isOnDedicatedCapacity	boolean	Grubun ayrılmış kapasiteye atanıp atanmadığı
isReadOnly	boolean	Grubun salt okunur olup olmadığı
logAnalyticsWorkspace	AzureResource	Gruba atanan Log Analytics çalışma alanı. Bu yalnızca tek bir grup alınırken döndürülür.
name	string	Grup adı

GroupCreationRequest

Object

Yeni grup oluşturmak için Power BI isteği

Name	Tür	Description
name	string	Yeni oluşturulan grubun adı