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