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


Groups - Get Group

Возвращает указанную рабочую область.

Разрешения

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

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

Workspace.Read.All или Workspace.ReadWrite.All

Ограничения

  • Для обновления разрешений пользователей для рабочих областей требуется время, и при использовании вызовов API они могут быть недоступны не сразу. Чтобы обновить разрешения пользователей, используйте вызов API "Обновить разрешения пользователя ".

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}

Параметры URI

Имя В Обязательно Тип Описание
groupId
path True

string

uuid

идентификатор рабочей области;

Ответы

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

Group

ОК

Примеры

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48

Sample Response

{
  "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
  "isReadOnly": false,
  "isOnDedicatedCapacity": true,
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
  "defaultDatasetStorageFormat": "Small",
  "name": "Sample Group 1"
}

Определения

Имя Описание
AzureResource

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

DefaultDatasetStorageFormat

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

Group

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

Имя группы