ストレージスキャンポリシーの更新 - Netskope技術ドキュメント

使うこのエンドポイントはストレージスキャンの更新ポリシーです。ポリシーを更新した後、使う Apply Changes エンドポイントでテナントを更新してください。

リクエストエンドポイント

https://<tenant-URL>/api/v1/storage_scan_policies/?token=<token>&op=<update>

Valid parameters include:

鍵	タイプ	Value	デスクリプション
`op`	string	`create`	必須。手術は完了しました。
`name`	string	Ex: `LQ_storage`	必須。既存のストレージスキャンポリシーと同じ名前であってはなりません。
`cloud_provider`	string	`aws \| googlecloud`	必須。ストレージプラットフォームプロバイダー。
`instanceConditional`	JSONオブジェクトの配列	AWS `accountID`AWSアカウントID。 GCP `projectID`: GCPプロジェクトID。 `folderID`: GCPフォルダID。 `organisationID`: GCP組織ID。	任意。明示的なインスタンスが使用され、ポリシーで DLP プロファイルが使用される場合、すべてのインスタンスのインスタンスセットアップで DLP サービスがチェックされている必要があります。明示的なインスタンスが使用され、ポリシーで脅威保護プロファイルが使用される場合、すべてのインスタンスのインスタンス設定で脅威保護サービスがチェックされている必要があります。 blocklist が true の場合 => スキャンせず、ここで戻ります。allowlist が true の場合 => 次の条件に進みます。
`objectContainerConditional`	JSONオブジェクトの配列	AWS `name`バケットの名前。 `region`バケットが利用可能な地域。 `tags`AWSバケットに関連付けられたタグ。 `access`「私的」、「公的」。オブジェクトは公開することができます。 GCP `name`GCPバケットの名前。 `region`: GCPバケットが利用可能なリージョン。 `labels`ラベルをキーと値のペアとして GCPバケットで使用します。 `storageClass`GCPで有効なストレージクラスは、「STANDARD」、「NEARLINE」、「COLDLINE」、「ARCHIVE」です。 `access`「私的」、「公的」	任意。明示されている場合は、オブジェクトストア属性の条件に一致するファイルイベントにスキャンを絞り込むことができます。ここに挙げられている属性は、オブジェクトのコンテナ／ストアに関するものです。例えば、AWS の場合はバケット、Azure の場合は StorageAccount などとなります。 blocklist が true の場合 => スキャンせず、ここで戻ります。allowlist が true の場合 => 次の条件に進みます。
`objectConditional`	JSONオブジェクトの配列	AWS `name`オブジェクトの名前。 `key`オブジェクトへのパス（オブジェクト名を含む）。 `owner`AWSオブジェクトの所有者名。 `contentType`AWSによって決定されたmimeType。 `storageClass`AWS で有効なストレージクラスは「STANDARD」、「REDUCED_REDUNDANCY」、「STANDARD_IA」、「ONEZONE_IA」、「INTELLIGENT_TIERING」、「GLACIER」、「DEEP_ARCHIVE」、「OUTPOSTS」です。 `serverSideEncryption`AWS で利用可能なサーバー側暗号化は、「AES256」または「aws:kms」のいずれかである必要があります。 `extension`: オブジェクトのファイル拡張子。 `tags`オブジェクトに関連付けられたタグ。 `access`「私的」、「公的」 GCP: `name`オブジェクトの名前。 `key`オブジェクト名を含むオブジェクトへのパス。 `owner`: GCPオブジェクトの所有者名。 `contentType`GCPによって決定されたmimeType。 `extension`: オブジェクトのファイル拡張子。 `access`「私的」、「公的」	任意。明示的であれば、オブジェクト属性の条件に一致するファイルイベントにスキャンを絞り込むことができます。ここに列挙されている属性は、オブジェクトまたはファイルに対応しています。ブロックリストがtrueの場合 => スキャンせず、ここに戻ります。許可リストがtrueの場合 => スキャンを送信します。
`dlp.profileNames`	string	文字列の配列	Optional. 既存のDLPプロファイル名である必要があります。 `iaas_storage_dlp_enabled` 有効にする必要があります。空の配列でも構いません。 `tss.profileNames`では使用できません。
`tts.profileNames`	string	文字列の配列	`dlp.profileNames`が指定されていない場合は必須です。既存の脅威対策プロファイル名である必要があります。 `iaas_storage_dlp_enabled` 有効にする必要があります。空の配列でも構いません。 `dlp.profileNames`では使用できません。
`enabled`	boolean	`true \| false`	必須。ポリシーを有効にするために`true`を費やします。ユーザー`false`がポリシーを無効にします。
`maxScanFrequency`	string	`3h \| 6h \| 12h \| 24h \| 7d \|30d`	任意。スキャン頻度を決定します。
`notify`	object	`interval`通知間の時間間隔。 `to_users`通知を受け取るユーザーグループ。 `emails`: 通知する追加ユーザーの電子メールアドレス。 `from_user`：電子メールの送信元となる電子メールアドレス。	メール通知の詳細です。

更新ポリシー要求の例

POST 'https://<tenant-URL>/api/v1/storage_scan_policies?token=<token>&op=update' 
--header 'Content-Type: application/json' 
--data-raw '{
    "name": "oldPolicyName",
    "new_name": "newPolicyName",
    "cloud_provider": "aws",
    "instanceConditional": {
      ...
    },
    "objectContainerConditional": {
      ...
    },
    "objectConditional": {
      ...
    },
    "dlp": {
        "profileNames": [
            "DLP Profile 1",
            "DLP Profile 2"
        ]
    },
    "maxScanFrequency": "7d",
    "action": "Alert",
    "enabled": true,
    "notify": {
      "interval": "30",
      "to_users": [
        "admin"
      ],
      "emails": [
        "abc@netskope.com"
      ],
      "from_user": "abc@netskope.com"
    }
}'