Share via


Groups - Update Group

Atualizações um workspace especificado.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo necessário

Workspace.ReadWrite.All

Limitações

  • Para capacidades compartilhadas, somente o nome pode ser atualizado.
  • Para capacidades Premium, somente o nome e defaultDatasetStorageFormat podem ser atualizados.
  • O nome deve ser exclusivo dentro de uma organização.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
groupId
path True

string

uuid

A ID do workspace

Corpo da solicitação

Nome Tipo Description
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

O formato de armazenamento do conjunto de dados padrão no grupo

name

string

O nome do grupo

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

Example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/e2284830-c8dc-416b-b19a-8cdcd2729332
{
  "name": "Updated Sales Results",
  "defaultDatasetStorageFormat": "Large"
}

Sample Response

Definições

Nome Description
DefaultDatasetStorageFormat

O formato de armazenamento do conjunto de dados padrão no grupo

UpdateGroupRequest

Uma solicitação de atualização para o grupo

DefaultDatasetStorageFormat

O formato de armazenamento do conjunto de dados padrão no grupo

Nome Tipo Description
Large

string

Formato de armazenamento de conjunto de dados grande

Small

string

Formato de armazenamento de conjunto de dados pequeno

UpdateGroupRequest

Uma solicitação de atualização para o grupo

Nome Tipo Description
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

O formato de armazenamento do conjunto de dados padrão no grupo

name

string

O nome do grupo