Admin - InformationProtection RemoveLabelsAsAdmin
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 être administrateur fabric.
- L’utilisateur administrateur doit disposer de droits d’utilisation suffisants pour supprimer des étiquettes.
Étendue requise
Tenant.ReadWrite.All
Limitations
- 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/removeLabels
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| dashboards |
Liste des ID de tableau de bord uniques |
|
| dataflows |
Liste des ID de flux de données uniques |
|
| datasets |
Liste des ID de jeu de données uniques |
|
| reports |
Liste des ID de rapport uniques |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
D’ACCORD |
Exemples
Example
Exemple de requête
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"
}
]
}
Exemple de réponse
{
"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 |
|---|---|
|
Artifact |
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. |
|
Artifact |
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. |
|
Change |
L’ID unique et l’étiquette de protection des informations changent l’état d’un élément Power BI |
|
Information |
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. |
|
Information |
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 |
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 (uuid) |
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 flux de données ; et au format UUID ou chaîne pour les jeux de données. |
| 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 |
Liste des ID de tableau de bord uniques |
|
| dataflows |
Liste des ID de flux de données uniques |
|
| datasets |
Liste des ID de jeu de données uniques |
|
| reports |
Liste des ID de rapport uniques |
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
| Nom | Type | Description |
|---|---|---|
| dashboards |
Liste contenant l’id unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs tableaux de bord |
|
| dataflows |
Liste contenant l’id unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs dataflows |
|
| datasets |
Liste contenant l’ID unique et l’étiquette de protection des informations changent l’état d’un ou plusieurs jeux de données |
|
| reports |
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
| Valeur | Description |
|---|---|
| Failed |
Échec de la définition d’une nouvelle étiquette. Réessayez. |
| FailedToGetUsageRights |
É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 |
Échec de la définition d’une nouvelle étiquette. L’élément Power BI a une étiquette de confidentialité avec les paramètres de protection, et l’utilisateur administrateur (et l’utilisateur délégué, le cas échéant) n’a pas suffisamment de droits d’utilisation pour modifier l’étiquette. |
| NotFound |
L’ID ou l’étiquette de l’élément Power BI n’a pas été trouvé |
| Succeeded |
L’étiquette d’élément Power BI a été modifiée |