Admin - InformationProtection RemoveLabelsAsAdmin
Quite las etiquetas de confidencialidad de los elementos de Power BI (como informes o paneles) por identificador de elemento.
Para obtener un ejemplo de uso, consulte Establecer o quitar etiquetas de confidencialidad.
Permisos
- El usuario debe ser administrador de Fabric.
- El usuario administrador debe tener suficientes derechos de uso eliminar etiquetas.
Ámbito requerido
Tenant.ReadWrite.All
Limitaciones
- Máximo de 25 solicitudes por hora.
- Cada solicitud puede actualizar hasta 2000 elementos de Power BI.
POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| dashboards |
Lista de identificadores de panel únicos |
|
| dataflows |
Lista de identificadores de flujo de datos únicos |
|
| datasets |
Lista de identificadores de conjunto de datos únicos |
|
| reports |
Lista de identificadores de informe únicos |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
De acuerdo |
Ejemplos
Example
Solicitud de ejemplo
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"
}
]
}
Respuesta de muestra
{
"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"
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Artifact |
Identificador único de un elemento de Power BI en formato UUID. Los identificadores de panel, informe y flujo de datos están en formato UUID y los identificadores de conjunto de datos pueden estar en formato UUID o de cadena. |
|
Artifact |
Identificador único de un elemento de Power BI en formato de cadena o UUID. Los identificadores de panel, informe y flujo de datos están en formato UUID y los identificadores de conjunto de datos pueden estar en formato UUID o de cadena. |
|
Change |
El identificador único y el estado de cambio de etiqueta de protección de la información de un elemento de Power BI |
|
Information |
Compuesto de identificadores de elementos de Power BI para cada tipo de elemento. Los identificadores especifican qué elementos de Power BI requieren una actualización de etiqueta de protección de información. |
|
Information |
Una composición del estado de cambio de identificador y de etiqueta de protección de la información para uno o varios elementos de Power BI organizados por tipo |
| status |
Estado de una operación de cambio de etiqueta de protección de información |
ArtifactId
Identificador único de un elemento de Power BI en formato UUID. Los identificadores de panel, informe y flujo de datos están en formato UUID y los identificadores de conjunto de datos pueden estar en formato UUID o de cadena.
| Nombre | Tipo | Description |
|---|---|---|
| id |
string (uuid) |
Un identificador en formato UUID |
ArtifactStringId
Identificador único de un elemento de Power BI en formato de cadena o UUID. Los identificadores de panel, informe y flujo de datos están en formato UUID y los identificadores de conjunto de datos pueden estar en formato UUID o de cadena.
| Nombre | Tipo | Description |
|---|---|---|
| id |
string |
Un identificador en formato de cadena o UUID |
ChangeLabelStatus
El identificador único y el estado de cambio de etiqueta de protección de la información de un elemento de Power BI
| Nombre | Tipo | Description |
|---|---|---|
| id |
string |
Identificador único de un elemento de Power BI. El identificador está en formato UUID para paneles, informes y flujos de datos; y en formato UUID o de cadena para conjuntos de datos. |
| status |
Estado de una operación de cambio de etiqueta de protección de información |
InformationProtectionArtifactsChangeLabel
Compuesto de identificadores de elementos de Power BI para cada tipo de elemento. Los identificadores especifican qué elementos de Power BI requieren una actualización de etiqueta de protección de información.
| Nombre | Tipo | Description |
|---|---|---|
| dashboards |
Lista de identificadores de panel únicos |
|
| dataflows |
Lista de identificadores de flujo de datos únicos |
|
| datasets |
Lista de identificadores de conjunto de datos únicos |
|
| reports |
Lista de identificadores de informe únicos |
InformationProtectionChangeLabelResponse
Una composición del estado de cambio de identificador y de etiqueta de protección de la información para uno o varios elementos de Power BI organizados por tipo
| Nombre | Tipo | Description |
|---|---|---|
| dashboards |
Una lista que contiene el identificador único y el estado de cambio de etiqueta de protección de la información de uno o varios paneles |
|
| dataflows |
Una lista que contiene el identificador único y el estado de cambio de etiqueta de protección de la información de uno o varios flujos de datos |
|
| datasets |
Una lista que contiene el identificador único y el estado de cambio de etiqueta de protección de la información de uno o varios conjuntos de datos |
|
| reports |
Una lista que contiene el identificador único y el estado de cambio de etiqueta de protección de la información de uno o varios informes |
status
Estado de una operación de cambio de etiqueta de protección de información
| Valor | Description |
|---|---|
| Failed |
No se pudo establecer una nueva etiqueta. Vuelva a intentarlo. |
| FailedToGetUsageRights |
No se pudo establecer una nueva etiqueta. El elemento de Power BI tiene una etiqueta de confidencialidad con la configuración de protección y Power BI no pudo comprobar que el usuario tiene suficientes derechos de uso para cambiar la etiqueta. |
| InsufficientUsageRights |
No se pudo establecer una nueva etiqueta. El elemento de Power BI tiene una etiqueta de confidencialidad con la configuración de protección y el usuario administrador (y el usuario delegado, si se proporciona) no tiene suficientes derechos de uso para cambiar la etiqueta. |
| NotFound |
No se encontró el identificador o la etiqueta del elemento de Power BI. |
| Succeeded |
Se cambió la etiqueta de elemento de Power BI. |