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

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 (uuid)

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

string

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

string

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

string (uuid)

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

DefaultDatasetStorageFormat

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

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

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

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

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

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

Имя только что созданной группы