Admin - InformationProtection RemoveLabelsAsAdmin
Remova rótulos de confidencialidade de itens do Power BI (como relatórios ou dashboards) por ID do item.
Para obter um exemplo de uso, consulte Definir ou remover rótulos de confidencialidade.
Permissões
- O usuário deve ser um administrador do Fabric.
- O usuário administrador deve ter direitos de uso de 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 |
Uma lista de IDs exclusivas do painel |
|
| dataflows |
Uma lista de IDs de fluxo de dados exclusivas |
|
| datasets |
Uma lista de IDs exclusivas do conjunto de dados |
|
| reports |
Uma lista de IDs de relatório exclusivas |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OKEY |
Exemplos
Example
Solicitação de exemplo
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"
}
]
}
Resposta de exemplo
{
"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 |
|---|---|
|
Artifact |
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. |
|
Artifact |
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. |
|
Change |
A ID exclusiva e o status de alteração do rótulo de proteção de informações de um item do Power BI |
|
Information |
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 de rótulo de proteção de informações. |
|
Information |
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 (uuid) |
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 em 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 |
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 de rótulo de proteção de informações.
| Nome | Tipo | Description |
|---|---|---|
| dashboards |
Uma lista de IDs exclusivas do painel |
|
| dataflows |
Uma lista de IDs de fluxo de dados exclusivas |
|
| datasets |
Uma lista de IDs exclusivas do conjunto de dados |
|
| reports |
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 |
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 |
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 |
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 |
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
| Valor | Description |
|---|---|
| Failed |
Falha ao definir um novo rótulo. Tente novamente. |
| FailedToGetUsageRights |
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 |
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 tem direitos de uso suficientes para alterar o rótulo. |
| NotFound |
A ID ou o rótulo do item do Power BI não foi encontrado |
| Succeeded |
O rótulo de item do Power BI foi alterado |