Compartilhar via


Admin - InformationProtection RemoveLabelsAsAdmin

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
{
  "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

{
  "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