Admin - InformationProtection SetLabelsAsAdmin

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

Pour définir une étiquette de confidentialité à l’aide de cette API, l’utilisateur administrateur ou l’utilisateur délégué (le cas échéant) doit inclure l’étiquette dans sa stratégie d’étiquette. Pour obtenir un exemple d’utilisation, consultez Définir ou supprimer des étiquettes de confidentialité.

Permissions

• L’utilisateur doit être administrateur fabric.
• L’utilisateur administrateur et l’utilisateur délégué (le cas échéant) doivent disposer de droits d’utilisation suffisants pour définir des étiquettes.

Étendue requise

Tenant.ReadWrite.All

Limites

• Maximum 25 requêtes par heure.
• Chaque demande peut mettre à jour jusqu’à 2 000 éléments Power BI.
  
  

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

Corps de la demande

Réponses

Exemples

Example

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

{
  "artifacts": {
    "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"
      }
    ]
  },
  "labelId": "fe472f5e-636e-4c10-a1c6-7e9edc0b542p",
  "assignmentMethod": "Standard",
  "delegatedUser": {
    "emailAddress": "john@contoso.com"
  }
}

{
  "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

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.

assignmentMethod

Spécifie si l’étiquette affectée a été définie par un processus automatisé ou manuellement.

ChangeLabelStatus

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

DelegatedUser

Détails de l’utilisateur délégué. L’utilisateur doit être un utilisateur existant dans Power BI et Azure AAD et doit être connecté à Power BI au cours des trois derniers mois.

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.

InformationProtectionChangeLabelDetails

Composite des informations d’étiquette requises pour mettre à jour une étiquette de protection des informations

InformationProtectionChangeLabelResponse

Composite de l’id et de l’étiquette 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