Groups - Create Group

Service:

Power BI REST APIs

API Version:

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 Embedded hizmet sorumlusu profilleri.

Gerekli Kapsam

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}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
workspaceV2	query		boolean	(Önizleme özelliği) Çalışma alanı oluşturulup oluşturulmayacağı. Desteklenen tek değerdir 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

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"
    }
  ]
}

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

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	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	Kaynağın bulunduğu Azure aboneliği.

DefaultDatasetStorageFormat

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

Name	Tür	Description
Large	string	Büyük veri kümesi depolama biçimi
Small	string	Küçük veri kümesi depolama biçimi

Group

Power BI grubu

Name	Tür	Description
capacityId	string	Kapasite kimliği
dataflowStorageId	string	Power BI veri akışı depolama hesabı kimliği
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Çalışma alanındaki varsayılan veri kümesi depolama biçimi. Yalnızca şu durumlarda döndürülür:isOnDedicatedCapacitytrue
id	string	Ç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

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

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