Admin - InformationProtection RemoveLabelsAsAdmin

Başvuru

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

Power BI öğelerindeki duyarlılık etiketlerini (raporlar veya panolar gibi) öğe kimliğine göre kaldırın.

Kullanım örneği için bkz. Duyarlılık etiketlerini ayarlama veya kaldırma.

İzinler

Kullanıcının yönetici haklarına (Office 365 Genel Yönetici veya Power BI Hizmet Yöneticisi gibi) sahip olması gerekir.
Yönetici kullanıcının etiketleri silmek için yeterli kullanım haklarına sahip olması gerekir.

Gerekli Kapsam

Tenant.ReadWrite.All

Sınırlamalar

Saatte en fazla 25 istek.
Her istek en fazla 2.000 Power BI öğesi güncelleştirebilir.

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

İstek Gövdesi

Name	Tür	Description
dashboards	ArtifactId[]	Benzersiz pano kimliklerinin listesi
dataflows	ArtifactId[]	Benzersiz veri akışı kimliklerinin listesi
datasets	ArtifactStringId[]	Benzersiz veri kümesi kimliklerinin listesi
reports	ArtifactId[]	Benzersiz rapor kimliklerinin listesi

Yanıtlar

Name	Tür	Description
200 OK	InformationProtectionChangeLabelResponse	Tamam

Örnekler

Example

Örnek isteği

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

İstek Gövdesi

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

Örnek yanıt

Durum kodu:: 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"
    }
  ]
}

Tanımlar

Name	Description
ArtifactId	UUID biçimindeki bir Power BI öğesinin benzersiz kimliği. Pano, rapor ve veri akışı kimlikleri UUID biçimindedir ve veri kümesi kimlikleri UUID veya dize biçiminde olabilir.
ArtifactStringId	Bir Power BI öğesinin dize veya UUID biçimindeki benzersiz kimliği. Pano, rapor ve veri akışı kimlikleri UUID biçimindedir ve veri kümesi kimlikleri UUID veya dize biçiminde olabilir.
ChangeLabelStatus	Power BI öğesinin benzersiz kimliği ve bilgi koruma etiketi durumunu değiştirir
InformationProtectionArtifactsChangeLabel	Her öğe türü için Power BI öğe kimliklerinin bileşimi. Kimlikler, hangi Power BI öğelerinin bilgi koruma etiketi güncelleştirmesi gerektirdiğini belirtir.
InformationProtectionChangeLabelResponse	Türe göre düzenlenmiş bir veya daha fazla Power BI öğesi için kimlik ve bilgi koruma etiketi değişiklik durumunun bileşimi
status	Bilgi koruma etiketi değiştirme işleminin durumu

ArtifactId

UUID biçimindeki bir Power BI öğesinin benzersiz kimliği. Pano, rapor ve veri akışı kimlikleri UUID biçimindedir ve veri kümesi kimlikleri UUID veya dize biçiminde olabilir.

Name	Tür	Description
id	string	UUID biçiminde bir kimlik

ArtifactStringId

Bir Power BI öğesinin dize veya UUID biçimindeki benzersiz kimliği. Pano, rapor ve veri akışı kimlikleri UUID biçimindedir ve veri kümesi kimlikleri UUID veya dize biçiminde olabilir.

Name	Tür	Description
id	string	Dize veya UUID biçiminde bir kimlik

ChangeLabelStatus

Power BI öğesinin benzersiz kimliği ve bilgi koruma etiketi durumunu değiştirir

Name	Tür	Description
id	string	Power BI öğesinin benzersiz kimliği. Kimlik, panolar, raporlar ve veri akışları için UUID biçimindedir; ve veri kümeleri için UUID veya dize biçiminde.
status	status	Bilgi koruma etiketi değiştirme işleminin durumu

InformationProtectionArtifactsChangeLabel

Her öğe türü için Power BI öğe kimliklerinin bileşimi. Kimlikler, hangi Power BI öğelerinin bilgi koruma etiketi güncelleştirmesi gerektirdiğini belirtir.

Name	Tür	Description
dashboards	ArtifactId[]	Benzersiz pano kimliklerinin listesi
dataflows	ArtifactId[]	Benzersiz veri akışı kimliklerinin listesi
datasets	ArtifactStringId[]	Benzersiz veri kümesi kimliklerinin listesi
reports	ArtifactId[]	Benzersiz rapor kimliklerinin listesi

InformationProtectionChangeLabelResponse

Türe göre düzenlenmiş bir veya daha fazla Power BI öğesi için kimlik ve bilgi koruma etiketi değişiklik durumunun bileşimi

Name	Tür	Description
dashboards	ChangeLabelStatus[]	Benzersiz kimliği ve bilgi koruma etiketini içeren liste, bir veya daha fazla panonun durumunu değiştirir
dataflows	ChangeLabelStatus[]	Benzersiz kimliği ve bilgi koruma etiketini içeren liste, bir veya daha fazla veri akışının durumunu değiştirir
datasets	ChangeLabelStatus[]	Benzersiz kimlik ve bilgi koruma etiketi içeren liste, bir veya daha fazla veri kümesinin durumunu değiştirir
reports	ChangeLabelStatus[]	Benzersiz kimliği ve bilgi koruma etiketini içeren liste, bir veya daha fazla raporun durumunu değiştirir

status

Bilgi koruma etiketi değiştirme işleminin durumu

Name	Tür	Description
Failed	string	Yeni etiket ayarlanamadı. Lütfen yeniden deneyin.
FailedToGetUsageRights	string	Yeni etiket ayarlanamadı. Power BI öğesinde koruma ayarları içeren bir duyarlılık etiketi var ve Power BI, kullanıcının etiketi değiştirmek için yeterli kullanım haklarına sahip olduğunu doğrulayamadı.
InsufficientUsageRights	string	Yeni etiket ayarlanamadı. Power BI öğesinin koruma ayarları içeren bir duyarlılık etiketi vardır ve yönetici kullanıcı (ve varsa temsilci kullanıcı) etiketi değiştirmek için yeterli kullanım haklarına sahip değildir.
NotFound	string	Power BI öğe kimliği veya etiketi bulunamadı
Succeeded	string	Power BI öğe etiketi değiştirildi

Aracılığıyla paylaş