Groups - Create Group
Создает новую рабочую область.
Разрешения
Этот вызов 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 |
(Предварительная версия функции) Указывает, следует ли создавать рабочую область. Единственное поддерживаемое значение — |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
name | True |
string |
Имя созданной группы |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК |
Примеры
Create a workspace example |
Example |
Create a workspace example
Образец запроса
POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
{
"name": "sample workspace"
}
Пример ответа
{
"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"
}
Пример ответа
{
"value": [
{
"id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "sample group"
}
]
}
Определения
Имя | Описание |
---|---|
Azure |
Ответ с подробными сведениями о ресурсе Azure, принадлежавом пользователю, например рабочей области Log Analytics. |
Default |
Формат хранилища набора данных по умолчанию в группе |
Group |
Группа Power BI |
Group |
Запрос Power BI на создание новой группы |
AzureResource
Ответ с подробными сведениями о ресурсе Azure, принадлежавом пользователю, например рабочей области Log Analytics.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса в Power BI. |
resourceGroup |
string |
Группа ресурсов в подписке, в которой находится ресурс. |
resourceName |
string |
Имя ресурса. |
subscriptionId |
string |
Подписка Azure, в которой находится ресурс. |
DefaultDatasetStorageFormat
Формат хранилища набора данных по умолчанию в группе
Значение | Описание |
---|---|
Large |
Формат хранения большого набора данных |
Small |
Формат хранения небольших наборов данных |
Group
Группа Power BI
Имя | Тип | Описание |
---|---|---|
capacityId |
string |
Идентификатор емкости |
dataflowStorageId |
string |
Идентификатор учетной записи хранения потока данных Power BI |
defaultDatasetStorageFormat |
Формат хранилища набора данных по умолчанию в рабочей области. Возвращается только в том случае, если |
|
id |
string |
идентификатор рабочей области; |
isOnDedicatedCapacity |
boolean |
Указывает, назначена ли группа выделенной емкости |
isReadOnly |
boolean |
Является ли группа доступной только для чтения |
logAnalyticsWorkspace |
Рабочая область Log Analytics, назначенная группе. Возвращается только при получении одной группы. |
|
name |
string |
Имя группы |
GroupCreationRequest
Запрос Power BI на создание новой группы
Имя | Тип | Описание |
---|---|---|
name |
string |
Имя созданной группы |