informationProtectionLabel: listLabels (非推奨)
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
Information Protection ラベル API は非推奨となり、2023 年 1 月 1 日にデータの返しを停止します。 新しい informationProtection、 sensitivityLabel、および関連するリソースを使用してください。
ユーザーまたはorganizationで使用できる情報保護ラベルのコレクションを取得します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | InformationProtectionPolicy.Read | 注意事項なし。 |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | InformationProtectionPolicy.Read.All | 注意事項なし。 |
HTTP 要求
サインインしているユーザーまたは指定したユーザーが使用できるラベルを取得するには:
GET /me/informationProtection/policy/labels
GET /users/{id | user-principal-name}/informationProtection/policy/labels
organizationで使用できるラベルを取得するには:
GET /informationProtection/policy/labels
省略可能なクエリ パラメーター
また、このメソッドは応答をカスタマイズするための一部の OData クエリ パラメーターをサポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
User-Agent | 呼び出し元のアプリケーションの名前とバージョンについて説明します。 Azure Information Protection Analytics で詳細が表示されます。 推奨される形式は ApplicationName/Version です。 省略可能です。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK
応答コードと、応答本文の informationProtectionLabel オブジェクトのコレクションを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/me/informationProtection/policy/labels
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
User-agent: ContosoLOBApp/1.0
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('1e36d926-d716-4197-ba86-a6e18eb910b9')/informationProtection/policy/labels",
"value": [
{
"id": "3a80e051-487c-40d4-b491-73ad25d997e6",
"name": "General",
"description": "Consult Contoso data labeling policy for more details.",
"color": "",
"sensitivity": 1,
"tooltip": "Data classified as Contoso General.",
"isActive": true,
"parent": null
},
{
"id": "4662f9a3-dd50-4a20-b984-a7be82e0e79c",
"name": "Confidential",
"description": "Consult Contoso data labeling policy for more details.",
"color": "",
"sensitivity": 2,
"tooltip": "Data classificed as Contoso Confidential.",
"isActive": true,
"parent": null
},
{
"id": "4b18e8bb-b4a5-4695-85d0-8ae23ef27892",
"name": "Highly Confidential",
"description": "Consult Contoso data labeling policy for more details.",
"color": "",
"sensitivity": 3,
"tooltip": "Data classified as Contoso Highly Confidential.",
"isActive": true,
"parent": null
},
{
"id": "a20cbae4-0c05-448c-b342-cb6c618d0957",
"name": "Contoso Full Time Employees",
"description": "Consult Contoso data labeling policy for more details.",
"color": "",
"sensitivity": 4,
"tooltip": "Data classified as Contoso Highly Confidential for Contoso Full Time Employees",
"isActive": true,
"parent": {
"id": "4b18e8bb-b4a5-4695-85d0-8ae23ef27892",
"name": "Highly Confidential",
"description": "Consult Contoso data labeling policy for more details.",
"color": "",
"sensitivity": 3,
"tooltip": "Data classified as Contoso Highly Confidential.",
"isActive": true,
"parent": null
}
}
]
}