Admin - InformationProtection RemoveLabelsAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Supprimez les étiquettes de confidentialité des éléments Power BI (tels que les rapports ou les tableaux de bord) par ID d’élément.

Pour obtenir un exemple d’utilisation, consultez Définir ou supprimer des étiquettes de confidentialité.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (par exemple, Office 365 administrateur général ou administrateur de service Power BI).
L’utilisateur administrateur doit disposer de droits d’utilisation suffisants pour supprimer des étiquettes.

Étendue requise

Tenant.ReadWrite.All

Limites

25 demandes maximales par heure.
Chaque demande peut mettre à jour jusqu’à 2 000 éléments Power BI.

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

Corps de la demande

Nom	Type	Description
dashboards	ArtifactId[]	Liste des ID de tableau de bord uniques
dataflows	ArtifactId[]	Liste des ID de flux de données uniques
datasets	ArtifactStringId[]	Liste des ID de jeu de données uniques
reports	ArtifactId[]	Liste des ID de rapport uniques

Réponses

Nom	Type	Description
200 OK	InformationProtectionChangeLabelResponse	Ok

Exemples

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

Définitions

Nom	Description
ArtifactId	ID unique d’un élément Power BI au format UUID. Les ID de tableau de bord, de rapport et de flux de données sont au format UUID, et les ID de jeu de données peuvent être au format UUID ou chaîne.
ArtifactStringId	ID unique d’un élément Power BI au format chaîne ou UUID. Les ID de tableau de bord, de rapport et de flux de données sont au format UUID, et les ID de jeu de données peuvent être au format UUID ou chaîne.
ChangeLabelStatus	L’ID unique et l’étiquette de protection des informations changent l’état d’un élément Power BI
InformationProtectionArtifactsChangeLabel	Composite des ID d’élément Power BI pour chaque type d’élément. Les ID spécifient quels éléments Power BI nécessitent une mise à jour d’étiquette de protection des informations.
InformationProtectionChangeLabelResponse	Composite de l’ID et de l’état des étiquettes de protection des informations pour un ou plusieurs éléments Power BI organisés par type
status	État d’une opération de modification d’étiquette information protection

ArtifactId

ID unique d’un élément Power BI au format UUID. Les ID de tableau de bord, de rapport et de flux de données sont au format UUID, et les ID de jeu de données peuvent être au format UUID ou chaîne.

Nom	Type	Description
id	string	ID au format UUID

ArtifactStringId

ID unique d’un élément Power BI au format chaîne ou UUID. Les ID de tableau de bord, de rapport et de flux de données sont au format UUID, et les ID de jeu de données peuvent être au format UUID ou chaîne.

Nom	Type	Description
id	string	ID au format chaîne ou UUID

ChangeLabelStatus

L’ID unique et l’étiquette de protection des informations changent l’état d’un élément Power BI

Nom	Type	Description
id	string	ID unique d’un élément Power BI. L’ID est au format UUID pour les tableaux de bord, les rapports et les dataflows ; et au format UUID ou chaîne pour les jeux de données.
status	status	État d’une opération de modification d’étiquette information protection

InformationProtectionArtifactsChangeLabel

Composite des ID d’élément Power BI pour chaque type d’élément. Les ID spécifient quels éléments Power BI nécessitent une mise à jour d’étiquette de protection des informations.

Nom	Type	Description
dashboards	ArtifactId[]	Liste des ID de tableau de bord uniques
dataflows	ArtifactId[]	Liste des ID de flux de données uniques
datasets	ArtifactStringId[]	Liste des ID de jeu de données uniques
reports	ArtifactId[]	Liste des ID de rapport uniques

InformationProtectionChangeLabelResponse

Composite de l’ID et de l’état des étiquettes de protection des informations pour un ou plusieurs éléments Power BI organisés par type

Nom	Type	Description
dashboards	ChangeLabelStatus[]	Une liste contenant l’ID unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs tableaux de bord
dataflows	ChangeLabelStatus[]	Liste contenant l’ID unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs dataflows
datasets	ChangeLabelStatus[]	Une liste contenant l’ID unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs jeux de données
reports	ChangeLabelStatus[]	Liste contenant l’ID unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs rapports

status

État d’une opération de modification d’étiquette information protection

Nom	Type	Description
Failed	string	Échec de la définition d’une nouvelle étiquette. Veuillez réessayer.
FailedToGetUsageRights	string	Échec de la définition d’une nouvelle étiquette. L’élément Power BI a une étiquette de confidentialité avec des paramètres de protection, et Power BI n’a pas pu vérifier que l’utilisateur dispose de droits d’utilisation suffisants pour modifier l’étiquette.
InsufficientUsageRights	string	Échec de la définition d’une nouvelle étiquette. L’élément Power BI a une étiquette de confidentialité avec des paramètres de protection, et l’utilisateur administrateur (et l’utilisateur délégué, le cas échéant) ne dispose pas des droits d’utilisation suffisants pour modifier l’étiquette.
NotFound	string	L’ID ou l’étiquette de l’élément Power BI est introuvable
Succeeded	string	L’étiquette d’élément Power BI a été modifiée