Admin - InformationProtection RemoveLabelsAsAdmin

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

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 tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI).
El usuario administrador debe tener suficientes derechos de uso para 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	ArtifactId[]	Una lista de identificadores de panel únicos
dataflows	ArtifactId[]	Una lista de identificadores de flujo de datos únicos
datasets	ArtifactStringId[]	Una lista de identificadores de conjunto de datos únicos
reports	ArtifactId[]	Una lista de identificadores de informe únicos

Respuestas

Nombre	Tipo	Description
200 OK	InformationProtectionChangeLabelResponse	Aceptar

Ejemplos

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"
    }
  ]
}

Definiciones

Nombre	Description
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 cadena.
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 cadena.
ChangeLabelStatus	El identificador único y el estado de cambio de etiqueta de protección de la información de un elemento de Power BI
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 la información.
InformationProtectionChangeLabelResponse	Una composición del estado de cambio del identificador y de la 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 la 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 cadena.

Nombre	Tipo	Description
id	string	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 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 uuID o formato de cadena para conjuntos de datos.
status	status	Estado de una operación de cambio de etiqueta de protección de la 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 la información.

Nombre	Tipo	Description
dashboards	ArtifactId[]	Una lista de identificadores de panel únicos
dataflows	ArtifactId[]	Una lista de identificadores de flujo de datos únicos
datasets	ArtifactStringId[]	Una lista de identificadores de conjunto de datos únicos
reports	ArtifactId[]	Una lista de identificadores de informe únicos

InformationProtectionChangeLabelResponse

Una composición del estado de cambio del identificador y de la etiqueta de protección de la información para uno o varios elementos de Power BI organizados por tipo

Nombre	Tipo	Description
dashboards	ChangeLabelStatus[]	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	ChangeLabelStatus[]	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	ChangeLabelStatus[]	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	ChangeLabelStatus[]	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 la información

Nombre	Tipo	Description
Failed	string	No se pudo establecer una nueva etiqueta. Inténtelo de nuevo.
FailedToGetUsageRights	string	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	string	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	string	No se encontró el identificador o etiqueta del elemento de Power BI.
Succeeded	string	Se cambió la etiqueta de elemento de Power BI.