Admin - InformationProtection SetLabelsAsAdmin

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

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

Per impostare un'etichetta di riservatezza usando questa API, l'utente amministratore o l'utente delegato (se specificato) deve avere l'etichetta inclusa nei criteri di etichetta. 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 e l'utente delegato (se specificato) devono disporre di diritti di utilizzo sufficienti per impostare 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/setLabels

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
artifacts	True	InformationProtectionArtifactsChangeLabel	Id elemento di Power BI composito per ogni tipo di elemento
labelId	True	string	ID etichetta, che deve essere nel criterio dell'etichetta dell'utente.
assignmentMethod		assignmentMethod	Specifica se l'etichetta assegnata è stata impostata da un processo automatizzato o manualmente.
delegatedUser		DelegatedUser	Dettagli utente delegati. Un utente delegato è un utente all'interno di un'organizzazione il cui amministratore imposta un'etichetta per conto dell'utente. Anche se l'amministratore imposta l'etichetta, l'utente delegato viene contrassegnato come autorità di certificazione dell'etichetta.

Risposte

Nome	Tipo	Descrizione
200 OK	InformationProtectionChangeLabelResponse	OK

Esempio

Example

Sample Request

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

Request Body

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

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.
assignmentMethod	Specifica se l'etichetta assegnata è stata impostata da un processo automatizzato o manualmente.
ChangeLabelStatus	L'ID univoco e l'etichetta di protezione delle informazioni cambiano lo stato di un elemento di Power BI
DelegatedUser	Dettagli utente delegati. L'utente deve essere un utente esistente in Power BI e Azure AAD e deve aver eseguito l'accesso a Power BI negli ultimi tre mesi.
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.
InformationProtectionChangeLabelDetails	Un composito di informazioni sull'etichetta necessarie per aggiornare un'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

assignmentMethod

Specifica se l'etichetta assegnata è stata impostata da un processo automatizzato o manualmente.

Nome	Tipo	Descrizione
Priviledged	string	L'etichetta è stata impostata manualmente
Standard	string	L'etichetta è stata impostata da un processo automatizzato (valore predefinito)

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

DelegatedUser

Dettagli utente delegati. L'utente deve essere un utente esistente in Power BI e Azure AAD e deve aver eseguito l'accesso a Power BI negli ultimi tre mesi.

Nome	Tipo	Descrizione
emailAddress	string	Indirizzo di posta elettronica dell'utente delegato

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

InformationProtectionChangeLabelDetails

Un composito di informazioni sull'etichetta necessarie per aggiornare un'etichetta di protezione delle informazioni

Nome	Tipo	Descrizione
artifacts	InformationProtectionArtifactsChangeLabel	Id elemento di Power BI composito per ogni tipo di elemento
assignmentMethod	assignmentMethod	Specifica se l'etichetta assegnata è stata impostata da un processo automatizzato o manualmente.
delegatedUser	DelegatedUser	Dettagli utente delegati. Un utente delegato è un utente all'interno di un'organizzazione il cui amministratore imposta un'etichetta per conto dell'utente. Anche se l'amministratore imposta l'etichetta, l'utente delegato viene contrassegnato come autorità di certificazione dell'etichetta.
labelId	string	ID etichetta, che deve essere nel criterio dell'etichetta dell'utente.

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

Share via