Groups - Create Group

Служба:: Power BI REST APIs

Версия API:: v1.0

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

Разрешения

Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в статье Профили субъекта-службы в Power BI Embedded.
Субъекты-службы должны иметь разрешение, предоставленное администратором Fabric. Дополнительные сведения см. в статье " Субъекты-службы" могут создавать рабочие области, подключения и конвейеры развертывания.

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

Workspace.ReadWrite.All

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

С использованием необязательных параметров:

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

Образец запроса

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

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

{
  "name": "sample workspace"
}

Пример ответа

Код состояния:: 200

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

Example

Образец запроса

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

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

{
  "name": "sample group"
}

Пример ответа

Код состояния:: 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

Object

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

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

DefaultDatasetStorageFormat

Перечисление

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

Значение	Описание
Small	Формат хранилища небольшого набора данных
Large	Формат хранилища большого набора данных

Group

Object

Группа Power BI

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

GroupCreationRequest

Object

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

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