Admin - InformationProtection SetLabelsAsAdmin

Başvuru

Hizmet:: Power BI REST APIs

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

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

Bu API'yi kullanarak duyarlılık etiketi ayarlamak için yönetici kullanıcının veya temsilci kullanıcının (sağlanmışsa) etiket ilkesine eklenmiş olması gerekir. 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öneticisi veya Power BI Hizmet Yöneticisi gibi) sahip olması gerekir.
Yönetici kullanıcı ve temsilci kullanıcı (sağlanmışsa) etiketleri ayarlamak için yeterli kullanım haklarına sahip olmalıdır.

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/setLabels

İstek Gövdesi

Name	Gerekli	Tür	Description
artifacts	True	InformationProtectionArtifactsChangeLabel	Her öğe türü için Power BI öğe kimliklerinin bileşimi
labelId	True	string	Kullanıcının etiket ilkesinde olması gereken etiket kimliği.
assignmentMethod		assignmentMethod	Atanan etiketin otomatik bir işlem tarafından mı yoksa el ile mi ayarlandığını belirtir.
delegatedUser		DelegatedUser	Temsilci kullanıcı ayrıntıları. Temsilci olarak atanan kullanıcı, bir kuruluştaki yönetici tarafından kullanıcı adına etiket ayarlayan bir kullanıcıdır. Yönetici etiketi ayarlasa da, temsilci atanan kullanıcı etiket veren olarak işaretlenir.

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/setLabels

İstek Gövdesi

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

Ö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çiminde 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	Dize veya UUID biçiminde 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.
assignmentMethod	Atanan etiketin otomatik bir işlem tarafından mı yoksa el ile mi ayarlandığını belirtir.
ChangeLabelStatus	Power BI öğesinin benzersiz kimliği ve bilgi koruma etiketi değişiklik durumu
DelegatedUser	Temsilci kullanıcı ayrıntıları. Kullanıcının Power BI ve Azure AAD'de mevcut bir kullanıcı olması ve son üç ay içinde Power BI'da oturum açmış olması gerekir.
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.
InformationProtectionChangeLabelDetails	Bilgi koruma etiketini güncelleştirmek için gereken etiket bilgilerinin bileşimi
InformationProtectionChangeLabelResponse	Türe göre düzenlenmiş bir veya daha fazla Power BI öğesi için kimlik ve bilgi koruma etiketinin değişiklik durumunun bileşimi
status	Bilgi koruma etiketi değiştirme işleminin durumu

ArtifactId

UUID biçiminde 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

Dize veya UUID biçiminde 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	Dize veya UUID biçiminde bir kimlik

assignmentMethod

Atanan etiketin otomatik bir işlem tarafından mı yoksa el ile mi ayarlandığını belirtir.

Name	Tür	Description
Priviledged	string	Etiket el ile ayarlandı
Standard	string	Etiket otomatik bir işlem tarafından ayarlandı (varsayılan değer)

ChangeLabelStatus

Power BI öğesinin benzersiz kimliği ve bilgi koruma etiketi değişiklik durumu

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

DelegatedUser

Temsilci kullanıcı ayrıntıları. Kullanıcının Power BI ve Azure AAD'de mevcut bir kullanıcı olması ve son üç ay içinde Power BI'da oturum açmış olması gerekir.

Name	Tür	Description
emailAddress	string	Temsilci olarak atanan kullanıcının e-posta adresi

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

InformationProtectionChangeLabelDetails

Bilgi koruma etiketini güncelleştirmek için gereken etiket bilgilerinin bileşimi

Name	Tür	Description
artifacts	InformationProtectionArtifactsChangeLabel	Her öğe türü için Power BI öğe kimliklerinin bileşimi
assignmentMethod	assignmentMethod	Atanan etiketin otomatik bir işlem tarafından mı yoksa el ile mi ayarlandığını belirtir.
delegatedUser	DelegatedUser	Temsilci kullanıcı ayrıntıları. Temsilci olarak atanan kullanıcı, bir kuruluştaki yönetici tarafından kullanıcı adına etiket ayarlayan bir kullanıcıdır. Yönetici etiketi ayarlasa da, temsilci atanan kullanıcı etiket veren olarak işaretlenir.
labelId	string	Kullanıcının etiket ilkesinde olması gereken etiket kimliği.

InformationProtectionChangeLabelResponse

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

Name	Tür	Description
dashboards	ChangeLabelStatus[]	Benzersiz kimliği ve bilgi koruma etiketini içeren bir liste, bir veya daha fazla panonun durumunu değiştirir
dataflows	ChangeLabelStatus[]	Benzersiz kimliği ve bilgi koruma etiketini içeren bir liste, bir veya daha fazla veri akışının durumunu değiştirir
datasets	ChangeLabelStatus[]	Benzersiz kimliği ve bilgi koruma etiketini 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 bir 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ı olan 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ş