Admin - InformationProtection SetLabelsAsAdmin

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 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 dahil edilmiş olması gerekir. Kullanım örneği için bkz. Duyarlılık etiketlerini ayarlama veya kaldırma.

Permissions

Kullanıcının Doku yöneticisi 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 (uuid)	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ş içinde yöneticisi kullanıcı adına etiket ayarlayan bir kullanıcıdır. Yönetici etiketi ayarlasa da, temsilci tarafından 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	Bir Power BI öğesinin 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.
ArtifactStringId	Dize veya 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.
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 etiketi değişiklik durumunun bileşimi
status	Bilgi koruma etiketi değiştirme işleminin durumu

ArtifactId

Object

Bir Power BI öğesinin 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 (uuid)	UUID biçiminde bir kimlik

ArtifactStringId

Object

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

assignmentMethod

Listeleme

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

Değer	Description
Standard	Etiket otomatik bir işlem tarafından ayarlandı (varsayılan değer)
Priviledged	Etiket el ile ayarlandı

ChangeLabelStatus

Object

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

Object

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

Object

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

Object

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ş içinde yöneticisi kullanıcı adına etiket ayarlayan bir kullanıcıdır. Yönetici etiketi ayarlasa da, temsilci tarafından atanan kullanıcı etiket veren olarak işaretlenir.
labelId	string (uuid)	Kullanıcının etiket ilkesinde olması gereken etiket kimliği.

InformationProtectionChangeLabelResponse

Object

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 kimlik ve bilgi koruma etiketi 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 bir 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

Listeleme

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

Değer	Description
Failed	Yeni etiket ayarlanamadı. Lütfen yeniden deneyin.
FailedToGetUsageRights	Yeni etiket ayarlanamadı. Power BI öğesinin 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	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	Power BI öğe kimliği veya etiketi bulunamadı
Succeeded	Power BI öğe etiketi değiştirildi