protectionRuleBase リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

organization内の Microsoft 365 データに適用される保護プランの一部としてクライアントによって指定された保護規則を表します。 現時点では、保護ポリシーが指定した条件と一致することを示すルールである包含ルールのみを定義できます。

現在、保護ルールは本質的に静的であり、ポリシーの変更は、ルールが実行されたときにのみ適用され、自動更新または動的更新は適用されません。

この抽象型は、 siteProtectionRule、 mailboxProtectionRule、 driveProtectionRule の基本型です。

このリソースには、次の制限事項が適用されます。

• バックアップ ポリシー作成ワークフローのサイト名または URL を使用してサイトを一括追加するための保護ルール API は、一度に最大 10 個のキーワードに対応できます。 各キーワード (keyword)には、少なくとも 3 文字、最大 255 文字を使用できます。
• セキュリティ グループまたは配布リストを使用してユーザー アカウントを一括追加するための保護規則 API は、一度に最大 3 つのグループに対応できます。
• ルールは静的であり、1 回だけ適用されます。 つまり、セキュリティ グループまたは配布リストは、バックアップ構成ポリシーに追加されるときにフラット化されます。 たとえば、ユーザーが元のセキュリティ グループに追加または削除された場合、グループまたはリストはシステムで動的に更新されません。

プロパティ

プロパティ	型	説明
id	String	ポリシーに関連付けられている保護規則の一意識別子。
createdBy	identitySet	ルールを作成したユーザーの ID。
createdDateTime	DateTimeOffset	ルールの作成時刻。
error	publicError	ルールに対する操作が失敗した場合のエラーの詳細が含まれます。
isAutoApplyEnabled	ブール型	true は、保護規則が動的であることを示します。 false 静的であることを示します。 現時点では、静的ルールのみがサポートされています。
lastModifiedBy	identitySet	ルールを最後に変更したユーザーの ID。
lastModifiedDateTime	DateTimeOffset	ルールに対して最後に行われた変更のタイムスタンプ。
status	protectionRuleStatus	保護規則の状態。 使用可能な値: draft、active、completed、completedWithErrors、unknownFutureValue。 メンバーは draft 現在サポートされていません。

protectionRuleStatus 値

メンバー	説明
ドラフト	作成時の保護規則の初期状態。 メンバーは draft 現在サポートされていません。
アクティブ	実行中の保護規則の状態。
完了	対応するポリシーに正常に適用された場合の保護規則の状態。
completedWithErrors	ルールが実行されたがエラーが発生したときの保護ルールの状態。
unknownFutureValue	進化可能な列挙センチネル値。 使用しないでください。

リレーションシップ

なし。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.protectionRuleBase",
  "id": "String (identifier)",
  "status": "String",
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "error": {
    "@odata.type": "microsoft.graph.publicError"
  },
  "isAutoApplyEnabled": "Boolean"
}