Partilhar via


Admin - WorkspaceInfo GetModifiedWorkspaces

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

Se o parâmetro modifiedSince opcional 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 parâmetro modifiedSince não for usado, as IDs de todos os workspaces na organização serão retornadas. A data e hora especificada pelo parâmetro modifiedSince 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 ser um administrador do Fabric ou autenticar usando uma entidade de serviço.

Ao executar em autenticação de entidade de serviço, um aplicativo não deve ter permissões necessárias de consentimento do administrador para o Power BI definidas 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
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
excludeInActiveWorkspaces
query

boolean

Se deseja excluir workspaces inativos

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[]

OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

ModifiedWorkspace

Um workspace modificado

Nome Tipo Description
id

string (uuid)

A ID do objeto do workspace