sensitivityLabel リソースの種類

名前空間: microsoft.graph.security

情報に秘密度ラベルを適切に適用する方法を詳しく説明する情報保護ラベルについて説明します。 informationProtectionLabel リソースは、ユーザーまたはテナントに適用される秘密度ラベルの構成を記述します。

メソッド

プロパティ

秘密度ラベル API フィルター規則

このセクションでは、さまざまな秘密度ラベル API 呼び出しに適用できるフィルタールールと制約について説明します。

シナリオ 1: 秘密度ラベル (1 つ以上) を返す

ユーザーは API を呼び出し、1 つ以上のラベル ID GUID でフィルター処理します。

例

$filter=((id eq 'guid1') or (id eq 'guid2') or (id eq 'guid3'))

ルール

1. isScopedToUser を使用した OR 制限

   • isScopedToUserフィルター パラメーターが存在する場合、フィルター パラメーターでorは許可されません

2. OR による事前フィルター動作

   • フィルター パラメーターに or が存在する場合、 locale フィルター パラメーターと contentFormats フィルター パラメーター (存在する場合) はプリフィルター処理に使用されません

3. 内部 OR 例外

   • パラメーター ツリーに該当する内部 or 操作は許可されます

シナリオ 2: 単一の ID とユーザー権利のフィルターを使用して秘密度ラベルの結果を返す

ユーザーは API を呼び出し、1 つのラベル ID GUID と 1 つのユーザー権利でフィルター処理します。

例

$filter=(id eq 'guid1' and ownerEmail eq 'ownerEmail1')

ルール

1. 複数パラメーターを使用した OR 制限

   • フィルター パラメーターが isScopedToUser、 id、または ownerEmail のいずれかに当てはまる場合、フィルター パラメーターで or は許可されません

2. ownerEmail の検証

   • ownerEmail idなしで存在すると、ArgumentExceptionスローされます。

3. OR による事前フィルター動作

   • $filter文字列に or が存在する場合、 locale および contentFormats フィルター パラメーターは無視され、結果の事前フィルター処理には使用されません。

4. 内部 OR 例外

   • 個々の句の間で内部 or 演算を使用できます。

シナリオ 2.5: 複数の ID とユーザー権利のフィルターを使用して秘密度ラベルの結果を返す

ユーザーは API を呼び出し、複数の ID と ownerEmail でフィルター処理しようとしています。 この結果を得るには、1 つのブール句でラベル ID と ownerEmail の両方を組み合わせる必要があります。

例

$filter=(
   (id eq 'guid1' and ownerEmail eq 'ownerEmail1')
  or (id eq 'guid2')
  or (id eq 'guid3' and ownerEmail eq 'ownerEmail2')
)

この $filter パターンは、標準 OData 仕様の拡張機能です。 標準の OData では、この方法で複数のタプルを or と組み合わせることは、通常サポートされていません。 ただし、この API では、各 (id, ownerEmail) ペアが個別に評価され、結果の権利情報がマージされるタプルベースの OR パターンを使用できます。 標準的な OData $filter 動作の詳細については、 OData 仕様を参照してください。

複数の ID で単一の呼び出しを使用するフィルターを使用し、複数のラベルの権限を取得することをお勧めします。これにより、アプリから行う必要のある API 呼び出しの数が削減されるためです。

ownerEmail は省略可能であり、ラベル レベルの権限のみをフェッチするために省略できます。

ルール

1. 厳密な OR パターン

   • 上記のように、OR 演算によって組み合わせられたタプルベースの構造のみがサポートされています。

   • OR 演算の他の組み合わせや、関連のないフィルターの混合は許可されず、ArgumentException が発生します。

2. ownerEmail の検証

   • ownerEmail 必ず idと一緒に表示する必要があります。 ownerEmail単独で使用すると、ArgumentExceptionが発生します。

3. 内部 OR 例外

   • サブ句を使用して句を組み合わせることができます。 サブ句の例を次に示します: (id eq 'guid1' and ownerEmail eq 'ownerEmail1')

   • この例には、3 つのサブ句があります。 ID と ownerEmail を組み合わせる場合は、サブ句で AND を使用します。 OR を使用しないでください。それ以外の場合は、例外をスローします。

4. 事前フィルタリング動作

   • or を使用すると、locale パラメーターと contentFormats パラメーター (指定された場合) は、プリフィルター処理では無視されます。

動作の概要

シナリオ 3: 秘密度ラベルの権利 /id/rights

ルール

1. ownerEmail を使用した OR 制限

   • or フィルター パラメーターを ownerEmail した操作では例外が発生します。

2. 内部 OR 例外

   • パラメーター ツリーに該当する内部 or 操作が許可されます。

isScopedToUser パラメーター ルール

このセクションでは、秘密度ラベル API の isScopedToUser パラメーターの動作と制約について説明します。

パラメーターの動作

isScopedToUser = true

• 結果: 有効なラベルのみを表示する
• ユース ケース: アクティブ/有効ラベルの Standard フィルター
• 状態: 推奨される使用方法

isScopedToUser = false

• 結果: 無効なラベルのみを表示する
• ユース ケース: 制限付き - この値では使用しないのが理想的です
• 状態: 通常の操作には推奨されません

isScopedToUser が渡されない

• 結果: すべてのラベル (有効と無効の両方) を表示する
• ユース ケース: 包括的なラベル取得
• 状態: パラメーターを省略した場合の既定の動作

制限

テナント ラベルの例外

• 動作: テナント ラベルを取得するときに、 isScopedToUser を使用すると、 ArgumentException
• 理由: パラメーターはテナント レベルのラベル操作には適用されません
• 解決策: テナント ラベルを操作するときに isScopedToUser パラメーターを省略する

リレーションシップ

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.security.sensitivityLabel",
  "actionSource": "String",
  "applicableTo": "String",
  "applicationMode": "String",
  "assignedPolicies": [{"@odata.type": "microsoft.graph.labelPolicy"}],
  "autoLabeling": {"@odata.type": "microsoft.graph.autoLabeling"},
  "autoTooltip": "String",
  "color": "String",
  "description": "String",
  "displayName": "String",
  "hasProtection": "Boolean",
  "id": "String (identifier)",
  "isDefault": "Boolean",
  "isEnabled": "Boolean",
  "isEndpointProtectionEnabled": "Boolean",
  "isScopedToUser": "Boolean",
  "labelActions": [{"@odata.type": "microsoft.graph.encryptWithUserDefinedRights"}],
  "locale": "String",
  "name": "String",
  "priority": "Int32",
  "toolTip": "String"
}