Admin - InformationProtection RemoveLabelsAsAdmin

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Remova rótulos de confidencialidade de itens do Power BI (como relatórios ou painéis) por ID do item.

Para obter um exemplo de uso, consulte Definir ou remover rótulos de confidencialidade.

Permissões

O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI).
O usuário administrador deve ter direitos de uso suficientes para excluir rótulos.

Escopo necessário

Tenant.ReadWrite.All

Limitações

Máximo de 25 solicitações por hora.
Cada solicitação pode atualizar até 2.000 itens do Power BI.

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

Corpo da solicitação

Nome	Tipo	Description
dashboards	ArtifactId[]	Uma lista de IDs de painel exclusivas
dataflows	ArtifactId[]	Uma lista de IDs de fluxo de dados exclusivas
datasets	ArtifactStringId[]	Uma lista de IDs exclusivas do conjunto de dados
reports	ArtifactId[]	Uma lista de IDs de relatório exclusivas

Respostas

Nome	Tipo	Description
200 OK	InformationProtectionChangeLabelResponse	OK

Exemplos

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

Request Body

{
  "dashboards": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b"
    }
  ],
  "reports": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c"
    }
  ],
  "datasets": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e"
    },
    {
      "id": "myDatabaseName"
    }
  ],
  "dataflows": [
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8g"
    }
  ]
}

Sample Response

Status code:: 200

{
  "dashboards": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "status": "NotFound"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "status": "Failed"
    }
  ],
  "reports": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "status": "Succeeded"
    }
  ],
  "datasets": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e",
      "status": "InsufficientUsageRights"
    },
    {
      "id": "myDatabaseName",
      "status": "FailedToGetUsageRights"
    }
  ],
  "dataflows": [
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8g",
      "status": "Succeeded"
    }
  ]
}

Definições

Nome	Description
ArtifactId	A ID exclusiva de um item do Power BI no formato UUID. As IDs de painel, relatório e fluxo de dados estão no formato UUID e as IDs do conjunto de dados podem estar no formato UUID ou cadeia de caracteres.
ArtifactStringId	A ID exclusiva de um item do Power BI em formato de cadeia de caracteres ou UUID. As IDs de painel, relatório e fluxo de dados estão no formato UUID e as IDs do conjunto de dados podem estar no formato UUID ou cadeia de caracteres.
ChangeLabelStatus	A ID exclusiva e o status de alteração do rótulo de proteção de informações de um item do Power BI
InformationProtectionArtifactsChangeLabel	Uma composição de IDs de item do Power BI para cada tipo de item. As IDs especificam quais itens do Power BI exigem uma atualização do rótulo de proteção de informações.
InformationProtectionChangeLabelResponse	Uma composição da ID e do status de alteração do rótulo de proteção de informações para um ou mais itens do Power BI organizados por tipo
status	O status de uma operação de alteração de rótulo de proteção de informações

ArtifactId

A ID exclusiva de um item do Power BI no formato UUID. As IDs de painel, relatório e fluxo de dados estão no formato UUID e as IDs do conjunto de dados podem estar no formato UUID ou cadeia de caracteres.

Nome	Tipo	Description
id	string	Uma ID no formato UUID

ArtifactStringId

A ID exclusiva de um item do Power BI em formato de cadeia de caracteres ou UUID. As IDs de painel, relatório e fluxo de dados estão no formato UUID e as IDs do conjunto de dados podem estar no formato UUID ou cadeia de caracteres.

Nome	Tipo	Description
id	string	Uma ID no formato de cadeia de caracteres ou UUID

ChangeLabelStatus

A ID exclusiva e o status de alteração do rótulo de proteção de informações de um item do Power BI

Nome	Tipo	Description
id	string	A ID exclusiva de um item do Power BI. A ID está no formato UUID para dashboards, relatórios e fluxos de dados; e no formato UUID ou cadeia de caracteres para conjuntos de dados.
status	status	O status de uma operação de alteração de rótulo de proteção de informações

InformationProtectionArtifactsChangeLabel

Uma composição de IDs de item do Power BI para cada tipo de item. As IDs especificam quais itens do Power BI exigem uma atualização do rótulo de proteção de informações.

Nome	Tipo	Description
dashboards	ArtifactId[]	Uma lista de IDs de painel exclusivas
dataflows	ArtifactId[]	Uma lista de IDs de fluxo de dados exclusivas
datasets	ArtifactStringId[]	Uma lista de IDs exclusivas do conjunto de dados
reports	ArtifactId[]	Uma lista de IDs de relatório exclusivas

InformationProtectionChangeLabelResponse

Uma composição da ID e do status de alteração do rótulo de proteção de informações para um ou mais itens do Power BI organizados por tipo

Nome	Tipo	Description
dashboards	ChangeLabelStatus[]	Uma lista que contém a ID exclusiva e o status de alteração do rótulo de proteção de informações de um ou mais painéis
dataflows	ChangeLabelStatus[]	Uma lista que contém a ID exclusiva e o status de alteração do rótulo de proteção de informações de um ou mais fluxos de dados
datasets	ChangeLabelStatus[]	Uma lista que contém a ID exclusiva e o status de alteração do rótulo de proteção de informações de um ou mais conjuntos de dados
reports	ChangeLabelStatus[]	Uma lista que contém a ID exclusiva e o status de alteração do rótulo de proteção de informações de um ou mais relatórios

status

O status de uma operação de alteração de rótulo de proteção de informações

Nome	Tipo	Description
Failed	string	Falha ao definir um novo rótulo. Tente novamente.
FailedToGetUsageRights	string	Falha ao definir um novo rótulo. O item do Power BI tem um rótulo de confidencialidade com configurações de proteção e o Power BI não pôde verificar se o usuário tem direitos de uso suficientes para alterar o rótulo.
InsufficientUsageRights	string	Falha ao definir um novo rótulo. O item do Power BI tem um rótulo de confidencialidade com configurações de proteção e o usuário administrador (e o usuário delegado, se fornecido) não têm direitos de uso suficientes para alterar o rótulo.
NotFound	string	A ID ou o rótulo do item do Power BI não foi encontrado
Succeeded	string	O rótulo do item do Power BI foi alterado

Compartilhar via