Admin - WorkspaceInfo GetModifiedWorkspaces

Referência

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Obtém uma lista de IDs de workspace na organização.

Se o parâmetro opcional modifiedSince for definido como uma data e hora, somente as IDs de workspaces que foram alteradas após essa data e hora serão retornadas. Se o modifiedSince parâmetro não for usado, as IDs de todos os workspaces na organização serão retornadas. A data e hora especificada pelo modifiedSince parâmetro deve estar no intervalo de 30 minutos (para permitir que as alterações no workspace entrem em vigor) até 30 dias antes da hora atual.

Permissões

O usuário deve ter direitos de administrador (como Microsoft Administrador Global do 365 ou Administrador de Serviços do Power BI) ou autenticar usando uma entidade de serviço.

Ao executar em autenticação de entidade de serviço, um aplicativo não deve ter nenhuma permissão de consentimento de administrador necessária para o Power BI definida nele no portal do Azure.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Relevante somente ao autenticar por meio de um token de acesso de administrador delegado padrão. Não deve estar presente quando a autenticação por meio de uma entidade de serviço é usada.

Limitações

Máximo de 30 solicitações por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified

Com parâmetros opcionais:

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Parâmetros de URI

Nome	Em	Tipo	Description
excludeInActiveWorkspaces	query	boolean	Se os workspaces inativos devem ser excluídos
excludePersonalWorkspaces	query	boolean	Se deseja excluir workspaces pessoais
modifiedSince	query	string date-time	Data da última modificação (deve estar no formato UTC compatível com ISO 8601)

Respostas

Nome	Tipo	Description
200 OK	ModifiedWorkspace[]	OK

Exemplos

Example

Sample request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

Sample response

Status code:: 200

[
  {
    "id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Definições

ModifiedWorkspace

Um workspace modificado

Nome	Tipo	Description
id	string	A ID do objeto do workspace

Compartilhar via