Compartilhar via


Groups - Update Group

Atualiza um workspace especificado.

Permissions

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

OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

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

Valor Description
Small

Formato de armazenamento de conjunto de dados pequeno

Large

Formato de armazenamento de conjunto de dados grande

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