Compartir a través de


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

ArtifactId[]

Lista de identificadores de panel únicos

dataflows

ArtifactId[]

Lista de identificadores de flujo de datos únicos

datasets

ArtifactStringId[]

Lista de identificadores de conjunto de datos únicos

reports

ArtifactId[]

Lista de identificadores de informe únicos

Respuestas

Nombre Tipo Description
200 OK

InformationProtectionChangeLabelResponse

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
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.

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.

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 información.

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

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

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

ArtifactId[]

Lista de identificadores de panel únicos

dataflows

ArtifactId[]

Lista de identificadores de flujo de datos únicos

datasets

ArtifactStringId[]

Lista de identificadores de conjunto de datos únicos

reports

ArtifactId[]

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

ChangeLabelStatus[]

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

ChangeLabelStatus[]

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

ChangeLabelStatus[]

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

ChangeLabelStatus[]

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.