Поделиться через

Groups - Create Group

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
v1.0

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

Разрешения

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

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

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

Идентификатор ресурса в Power BI.
resourceGroup

string

Группа ресурсов в подписке, в которой находится ресурс.
resourceName

string

Имя ресурса.
subscriptionId

string

Подписка Azure, в которой находится ресурс.

DefaultDatasetStorageFormat

Enumeration

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

Значение Описание
Large

Формат хранения большого набора данных
Small

Формат хранения небольших наборов данных

Group

Object

Группа 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

Object

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

Имя Тип Описание
name

string

Имя созданной группы