Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Создает новую рабочую область.

Разрешения

Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в статье Профили субъектов-служб в Power BI Embedded.

Требуемая область

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

Имя	В	Обязательно	Тип	Описание
workspaceV2	query		boolean	(Предварительная версия функции) Указывает, следует ли создавать рабочую область. Единственное поддерживаемое значение — true.

Текст запроса

Имя	Обязательно	Тип	Описание
name	True	string	Имя созданной группы

Ответы

Имя	Тип	Описание
200 OK	Group	ОК

Примеры

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

Определения

Имя	Описание
AzureResource	Ответ с подробными сведениями о ресурсе Azure, принадлежавом пользователю, например рабочей области Log Analytics.
DefaultDatasetStorageFormat	Формат хранилища набора данных по умолчанию в группе
Group	Группа Power BI
GroupCreationRequest	Запрос Power BI на создание новой группы

AzureResource

Ответ с подробными сведениями о ресурсе Azure, принадлежавом пользователю, например рабочей области Log Analytics.

Имя	Тип	Описание
id	string	Идентификатор ресурса в Power BI.
resourceGroup	string	Группа ресурсов в подписке, в которой находится ресурс.
resourceName	string	Имя ресурса.
subscriptionId	string	Подписка Azure, в которой находится ресурс.

DefaultDatasetStorageFormat

Формат хранилища набора данных по умолчанию в группе

Имя	Тип	Описание
Large	string	Формат хранения большого набора данных
Small	string	Формат хранения небольших наборов данных

Group

Группа Power BI

Имя	Тип	Описание
capacityId	string	Идентификатор емкости
dataflowStorageId	string	Идентификатор учетной записи хранения потока данных Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Формат хранилища набора данных по умолчанию в рабочей области. Возвращается только в том случае, если isOnDedicatedCapacity имеет значение true
id	string	идентификатор рабочей области;
isOnDedicatedCapacity	boolean	Указывает, назначена ли группа выделенной емкости
isReadOnly	boolean	Является ли группа доступной только для чтения
logAnalyticsWorkspace	AzureResource	Рабочая область Log Analytics, назначенная группе. Возвращается только при получении одной группы.
name	string	Имя группы

GroupCreationRequest

Запрос Power BI на создание новой группы

Имя	Тип	Описание
name	string	Имя созданной группы