Admin - InformationProtection RemoveLabelsAsAdmin

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Rimuovere le etichette di riservatezza dagli elementi di Power BI, ad esempio report o dashboard, in base all'ID elemento.

Per un esempio di utilizzo, vedere Impostare o rimuovere le etichette di riservatezza.

Autorizzazioni

L'utente deve avere diritti di amministratore, ad esempio Office 365 amministratore globale o amministratore del servizio Power BI.
L'utente amministratore deve disporre di diritti di utilizzo sufficienti per eliminare le etichette.

Ambito obbligatorio

Tenant.ReadWrite.All

Limitazioni

Massimo 25 richieste all'ora.
Ogni richiesta può aggiornare fino a 2.000 elementi di Power BI.

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

Corpo della richiesta

Nome	Tipo	Descrizione
dashboards	ArtifactId[]	Elenco di ID dashboard univoci
dataflows	ArtifactId[]	Elenco di ID flusso di dati univoci
datasets	ArtifactStringId[]	Elenco di ID set di dati univoci
reports	ArtifactId[]	Elenco di ID report univoci

Risposte

Nome	Tipo	Descrizione
200 OK	InformationProtectionChangeLabelResponse	OK

Esempio

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

Definizioni

Nome	Descrizione
ArtifactId	ID univoco di un elemento di Power BI in formato UUID. Gli ID dashboard, report e flusso di dati sono in formato UUID e gli ID set di dati possono essere in formato UUID o stringa.
ArtifactStringId	ID univoco di un elemento di Power BI in formato stringa o UUID. Gli ID dashboard, report e flusso di dati sono in formato UUID e gli ID set di dati possono essere in formato UUID o stringa.
ChangeLabelStatus	L'ID univoco e l'etichetta di protezione delle informazioni cambiano lo stato di un elemento di Power BI
InformationProtectionArtifactsChangeLabel	Id elemento di Power BI composito per ogni tipo di elemento. Gli ID specificano quali elementi di Power BI richiedono un aggiornamento dell'etichetta di protezione delle informazioni.
InformationProtectionChangeLabelResponse	Composizione dello stato di modifica dell'etichetta ID e dell'etichetta di protezione delle informazioni per uno o più elementi di Power BI organizzati per tipo
status	Stato di un'operazione di modifica dell'etichetta di protezione delle informazioni

ArtifactId

ID univoco di un elemento di Power BI in formato UUID. Gli ID dashboard, report e flusso di dati sono in formato UUID e gli ID set di dati possono essere in formato UUID o stringa.

Nome	Tipo	Descrizione
id	string	ID in formato UUID

ArtifactStringId

ID univoco di un elemento di Power BI in formato stringa o UUID. Gli ID dashboard, report e flusso di dati sono in formato UUID e gli ID set di dati possono essere in formato UUID o stringa.

Nome	Tipo	Descrizione
id	string	ID in formato stringa o UUID

ChangeLabelStatus

L'ID univoco e l'etichetta di protezione delle informazioni cambiano lo stato di un elemento di Power BI

Nome	Tipo	Descrizione
id	string	ID univoco di un elemento di Power BI. L'ID è in formato UUID per dashboard, report e flussi di dati; e in formato UUID o stringa per i set di dati.
status	status	Stato di un'operazione di modifica dell'etichetta di protezione delle informazioni

InformationProtectionArtifactsChangeLabel

Id elemento di Power BI composito per ogni tipo di elemento. Gli ID specificano quali elementi di Power BI richiedono un aggiornamento dell'etichetta di protezione delle informazioni.

Nome	Tipo	Descrizione
dashboards	ArtifactId[]	Elenco di ID dashboard univoci
dataflows	ArtifactId[]	Elenco di ID flusso di dati univoci
datasets	ArtifactStringId[]	Elenco di ID set di dati univoci
reports	ArtifactId[]	Elenco di ID report univoci

InformationProtectionChangeLabelResponse

Composizione dello stato di modifica dell'etichetta ID e dell'etichetta di protezione delle informazioni per uno o più elementi di Power BI organizzati per tipo

Nome	Tipo	Descrizione
dashboards	ChangeLabelStatus[]	Elenco contenente l'ID univoco e lo stato di modifica dell'etichetta di protezione delle informazioni di uno o più dashboard
dataflows	ChangeLabelStatus[]	Elenco contenente l'ID univoco e lo stato di modifica dell'etichetta di protezione delle informazioni di uno o più flussi di dati
datasets	ChangeLabelStatus[]	Elenco contenente l'ID univoco e lo stato di modifica dell'etichetta di protezione delle informazioni di uno o più set di dati
reports	ChangeLabelStatus[]	Elenco contenente l'ID univoco e lo stato di modifica dell'etichetta di protezione delle informazioni di uno o più report

status

Stato di un'operazione di modifica dell'etichetta di protezione delle informazioni

Nome	Tipo	Descrizione
Failed	string	Impossibile impostare una nuova etichetta. Riprovare.
FailedToGetUsageRights	string	Impossibile impostare una nuova etichetta. L'elemento di Power BI ha un'etichetta di riservatezza con le impostazioni di protezione e Power BI non è in grado di verificare che l'utente disponga di diritti di utilizzo sufficienti per modificare l'etichetta.
InsufficientUsageRights	string	Impossibile impostare una nuova etichetta. L'elemento di Power BI ha un'etichetta di riservatezza con le impostazioni di protezione e l'utente amministratore (e l'utente delegato, se specificato) non dispone di diritti di utilizzo sufficienti per modificare l'etichetta.
NotFound	string	L'ID elemento o l'etichetta di Power BI non sono stati trovati
Succeeded	string	L'etichetta dell'elemento di Power BI è stata modificata

Condividi tramite