Admin - InformationProtection SetLabelsAsAdmin

Ustaw etykiety poufności dla elementów usługi Power BI (takich jak raporty lub pulpity nawigacyjne) według identyfikatora elementu.

Aby ustawić etykietę poufności przy użyciu tego interfejsu API, administrator lub delegowany użytkownik (jeśli podano) musi mieć etykietę dołączona do zasad etykiet. Aby zapoznać się z przykładem użycia, zobacz Ustawianie lub usuwanie etykiet poufności.

Permissions

• Użytkownik musi być administratorem sieci szkieletowej.
• Administrator i delegowany użytkownik (jeśli podano) muszą mieć wystarczające prawa użytkowania , aby ustawić etykiety.

Wymagany zakres

Tenant.ReadWrite.All

Ograniczenia

• Maksymalnie 25 żądań na godzinę.
• Każde żądanie może zaktualizować do 2000 elementów usługi Power BI.
  
  

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

Treść żądania

Odpowiedzi

Przykłady

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

Definicje

ArtifactId

Unikatowy identyfikator elementu usługi Power BI w formacie UUID. Identyfikatory pulpitów nawigacyjnych, raportów i przepływów danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

ArtifactStringId

Unikatowy identyfikator elementu usługi Power BI w formacie ciągu lub UUID. Identyfikatory pulpitów nawigacyjnych, raportów i przepływów danych są w formacie UUID, a identyfikatory zestawów danych mogą być w formacie UUID lub ciągu.

assignmentMethod

Określa, czy przypisana etykieta została ustawiona przez zautomatyzowany proces, czy ręcznie.

ChangeLabelStatus

Stan zmiany unikatowego identyfikatora i etykiety ochrony informacji elementu usługi Power BI

DelegatedUser

Szczegóły delegowanego użytkownika. Użytkownik musi być istniejącym użytkownikiem w usługach Power BI i Azure AAD i musi zalogować się do usługi Power BI w ciągu ostatnich trzech miesięcy.

InformationProtectionArtifactsChangeLabel

Złożony identyfikator elementów usługi Power BI dla każdego typu elementu. Identyfikatory określają, które elementy usługi Power BI wymagają aktualizacji etykiety ochrony informacji.

InformationProtectionChangeLabelDetails

Złożona informacja o etykiecie wymagana do zaktualizowania etykiety ochrony informacji

InformationProtectionChangeLabelResponse

Złożony stan zmiany etykiety identyfikatora i ochrony informacji dla co najmniej jednego elementu usługi Power BI zorganizowanego według typu

status

Stan operacji zmiany etykiety ochrony informacji