Netskope LogoNetskope Logo
  • セキュリティサービス
  • AIサービス
  • ネットワークサービス
  • 分析サービス
  • 統合
  • getting-started.svg始める
    • サポート
    • コミュニティ
    • Netskope.com
    © 2026 無断転載を禁じます。Netskope 株式会社
    トップページ
    DLP - 情報漏洩対策
    オンデマンドのデータ損失防止
    DLPオンデマンドへのデータ送信
    保護対象: DLPオンデマンドAPI
    非構造化データの DLP コンテンツ検査ジョブの開始 (非同期)

    非構造化データの DLP コンテンツ検査ジョブの開始 (非同期)

    このAPIは、DLP(データ損失防止)コンテンツ検査ジョブをスケジュールするための非同期エンドポイントです。このAPIは検査対象コンテンツを受け取り、非同期処理のためのジョブID、または利用可能な場合はキャッシュからの即時結果を返します。

    このエンドポイントには、いくつかの追加の制限事項があります。

    • Max File Size: 128 MB
    • Max DLP Profiles: 100
    • Character Length of Each Profile name: 256文字

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

    POST

    https://<appliance_ip>/inspections/jobs

    呼び出し例

    curl -X 'POST' \
      'https://10.0.0.1/inspections/jobs' \
      -H 'accept: multipart/form-data' \
      -H 'x-netskope-generate-incidents: true' \
      -H 'Content-Type: multipart/form-data' \
      -F 'request={"profiles":["DLP-PCI","DLP-PII"],"content":{"id":"b1f793e4d4a26ac7b695bb1fd1fb0ce3cb5d729c401d8528f8bb92598006cf85","name":"SecretFile.txt","object_id":"AA-74GXZ","true_file_type":230},"modules":{"file_filter":{"skip":true},"drm":{"labels":[{"id":"c7d03ebd-804d-489c-94c6-8167224c3c1b","name":"chris_encryption_all_enabled","instance":"epdlpsjc1","vendor":"mip"}]}},"results":{"verdict":"summary"},"sender":{"app_name":"AWS_RDS"}}' \
      -F 'content=@SecretFile.txt;type=text/txt'

    回答例

    #A cached hit was found, therefore no job was scheduled. The results are returned in json.
    #200 Response
    HTTP/1.1 200 OK
    Content-Type: multipart/form-data; boundary=8b9eb155309408d78d1886c2af2803fdba94a7bea3dac274b3da5fa31e92

    --8b9eb155309408d78d1886c2af2803fdba94a7bea3dac274b3da5fa31e92
    Content-Disposition: form-data; name="result_data"
    Content-Type: application/json

    {"status":"success","summary":{"profiles":["DLP-PCI","DLP-PII"],"transaction_id":"3947352303853909965","verdict":"hit","verdict_type":"full"}}
    --8b9eb155309408d78d1886c2af2803fdba94a7bea3dac274b3da5fa31e92--
    #No prior request is found and a new job is started.
    #202 Response
    {
      "job_id": "8a426a5f-0d2e-0a2e-3595a-303202a7a2e"
    }

    リクエストヘッダーx-netskope-generate-incidentsが追加されるのは、ユーザーがアラートやインシデントの生成方法を指定できるようにするためです。

    レスポンスヘッダーも作成されました: x-netskope-incidents-posted 。レスポンスヘッダーには、アラートとインシデントが管理プレーンに投稿されたかどうかが反映されます。

    Valid Query Parameters are:

    名前InタイプRequiredデスクリプション
    bodybodyobjecttruenone
    " リクエストbodyobjecttrue検査依頼のプロパティを指定します。
    »» プロフィールbodytrueスキャン中に使用するプロファイルのリスト。 プロファイルは、一致するものを検索する際にどの DLP ルールを使用するかを決定します。 一致を検索する際に。
    "" コンテンツbodytrueリクエストの一部としてDLPに送信されるコンテンツについて説明します。
    »»» idbodystringtrueコンテンツのSHA256ハッシュ
    »»» namebodystringfalse名前(例)コンテンツのファイル名)
    »»» オブジェクトIDbodystringfalseデータのオブジェクト識別子。
    »»» 真のファイルタイプbodyintegerfalseNetskopeの真のファイルタイプ(数値ID)
    »» modulesbodyfalse検査中に実行される個々のDLPモジュールの設定を指定します。 検査中。
    »»» ファイルフィルターbodyobjectfalseファイルフィルタモジュールの設定を指定します。
    »»»» スキップbodybooleanfalse条件が真の場合、ファイルフィルタリングはスキップされます。
    »»» drmbodyobjectfalseDLPに明示的なDRMラベルを渡すことを可能にします。
    »»»» labelsbody[物体]truenone
    »»»»» idbodystringtrueラベルのID。
    »»»»» namebodystringfalseラベルの名前。
    """"" 実例bodystringfalseラベルのインスタンス。
    »»»»» vendorbodystringtrueラベルの販売業者。
    "" 結果bodyobjectfalse検査から返されるDLPオンデマンド結果のプロパティを指定します。
    »»» 判決bodystringfalse返される試合の詳細情報の量を指定します。次のいずれかが返されます:
    summary – 判決の要約が返されます。これには、結果、判決の種類、プロファイルのリスト、重大度が含まれます。
    details – 試合の詳細が含まれます。判決に関する詳細は、結果の一致、プロファイル、およびファイルごとのルールを含みます。
    forensics – 試合の概要、詳細、および鑑識結果が含まれます。ルール情報、一致したテキスト、抽出されたコンテンツなど、試合に関するすべての詳細情報が返されます。ご注意ください。この操作を行うと、ファイル全体のフルスキャンが実行されます。判決が指定されていない場合は、デフォルトで要約タイプとなり、判決の要約が返されます。
    »» 送信者bodyfalseリクエストの呼び出し元について説明します。
    »»» アプリ名bodystringtrue呼び出しをトリガーしたアプリケーション
    " コンテンツbody文字列(バイナリ)truenone

    Enumerated Values

    パラメータValue
    »»» 判決summary
    details
    forensics

    Responses

    状態MeaningデスクリプションSchema
    200OK以前のリクエストが見つかりました。これはキャッシュされたレスポンスです。結果はJSON形式で返されます。列をなして
    202Acceptedリクエストが承認されたことを示します。これは正常で、予想される結果です。列をなして
    400要求の形式が正しくありませんリクエストは無効でした。レスポンスには、リクエストが拒否された原因となったエラー情報が含まれています(利用可能な場合)。string
    413ペイロードが大きすぎる指定されたコンテンツは大きすぎるため、スキャンできません。なし
    500内部サーバーエラーリクエストの実行中にエラーが発生しました。レスポンスには、リクエストが拒否された原因となったエラー情報が含まれています(利用可能な場合)。string
    503サービスは利用できませんリクエストを実行するためのリソースがありません。なし

    allOf

    名前タイプRequired制限デスクリプション
    »»»»» anonymousfalsenoneプロフィール名。

    and

    名前タイプRequired制限デスクリプション
    »»»»» anonymousanyfalsenone一致するルールが関連付けられているプロファイル。

    continued

    名前タイプRequired制限デスクリプション
    »»»» action_threshold_metbooleantruenone真の場合、アクションしきい値に達したことを意味し、DLPクライアントはこのプロファイルに関連付けられたアクションを実行する必要があります。このフィールドがfalseの場合、アクションのしきい値に達していないため、このプロファイルに関連付けられたアクションは実行されません。
    »»»» 最大重症度stringfalsenone一致するルールの最大厳格度。
    »»»» ルール[物体]falsenonenone
    »»»»» namestringtruenoneルールの名称。
    """"" 重大度stringtruenoneルールの厳しさが響いた。以下のいずれか:
    none
    low
    medium
    high
    critical
    """"" タイプstringtruenoneルールの種類。次のいずれか:
    entity : 特定のエンティティが見つかったときに一致するルール。これらのルールに一致する場合、エンティティのサブフィールドが存在します。
    not_entity : 特定のエンティティが見つからない場合に一致するルール。これらのルールに一致する場合、エンティティのサブフィールドが存在します。
    file_filter : ファイルフィルタルール。分類 分類規則。指紋 指紋に関する規則。これらのルールに一致する場合、指紋サブフィールドが存在します。fingerprint_group :
    フィンガープリント 2.0 グループルール。これらのルールに一致する場合、 fingerprint_groupサブフィールドが存在します。
    structured_classification :構造化された分類ルール。これらのルールに一致する場合、 structured_classificationサブフィールドが存在します。
    »»»»» entityobjectfalsenoneContains details about the entity rule that matched. This field is present when type is entity or not_entity.
    »»»»»» 加重平均booleantruenoneIf true this rule is using the weighted score to determine the severity. If false, count is being used.
    """""" スコアintegertruenoneルールの加重スコアは一致しています。
    »»»»»» 制限に達しましたbooleantruenoneもしこれが真実であれば、このルールにおける最大一致数に達したことになります。これは、特定されたデータの一部が結果から除外されたことを意味します。
    »»»»»» エンティティの概要truenone一致したエンティティとそのエンティティに対応するカウントの配列。
    »»»»»»» entitystringtruenone一致したエンティティの名前。
    »»»»»»» カウントintegertruenone指定されたエンティティが一致した回数。
    »»»»»»» データ型falsenoneこのエンティティを記述する一般的なデータ型。
    »»»»»»» 感度レベルtruenoneルールの厳しさが響いた。以下のいずれか:
    none
    low
    medium
    high
    critical
    »»»»»» マッチ数integertruenoneエンティティルールが一致する件数。
    »»»»»» 感度レベルtruenoneこのエンティティはどの程度感度の高い一致ですか?以下のいずれか:
    not_sensitive
    low
    medium
    high
    critical
    »»»»»» ユニークカウントintegerfalsenoneルールに一致した固有のエントリの数。このフィールドは、プロファイルでルールを一意にカウントするように指定されている場合にのみ表示されます。
    »»»»» 構造化分類objectfalsenone一致する分類タイプルールの詳細
    »»»»»» エンティティの概要truenone一致したエンティティとそのエンティティに対応するカウントの配列。
    »»»»»» マッチ数integertruenoneエンティティルールが一致する件数。
    »»»»»» 感度レベルtruenoneこのエンティティはどの程度感度の高い一致ですか?の 1 つ
    not_sensitive
    low
    medium
    high
    critical
    »»»»»» データ型falsenoneこのエンティティを記述する一般的なデータ型。
    »»»»» 指紋objectfalsenoneThis field is present when type is fingerprint.
    »»»»»» 分類stringtruenone一致した分類。
    """""" マッチstringtruenone一致したファイル。
    """""" スコアintegertruenone一致した指紋のスコア。
    »»»»» 指紋グループobjectfalsenoneThis field is present when type is fingerprint_group.
    """""" マッチstringtruenone一致した指紋ファイル。
    """""" スコアintegertruenone一致した指紋ファイルの類似度スコア。
    »»» 鑑識objectfalsenonenone
    »»»» 抽出されたテキストstring(string)falsenone文字列識別子使うは、抽出されたテキストをマルチパート応答の対応する部分と相関させるためです
    »»»» エンティティルールが一致するstring(string)falsenoneエンティティルールをマルチパート応答の対応する部分と一致させるための文字列識別子使う。
    »»»» プレビュー画像string(string)falsenone文字列識別子使うはプレビュー画像をマルチパート応答の対応する部分と相関させます。
    »»»» オリジナルサブファイルstring(string)falsenone文字列識別子 元のサブファイルをマルチパートレスポンス内の対応する部分と関連付けるために使用されます。

    Enumerated Values

    PropertyValue
    検査状況: ステータスsuccess
    timeout
    error
    verdicthit
    no_hit
    verdict_typefull
    partial
    重大度none
    low
    medium
    high
    critical
    MicrosoftAipProtectionStation: ステータスprotected
    unsanctioned
    sanctioned
    重大度none
    low
    medium
    high
    critical
    タイプentity
    not_entity
    file_filter
    classification
    fingerprint
    fingerprint_group
    structured_classification
    sensitivity_levelnot_sensitive
    low
    medium
    high
    critical

    ステータスコード 202

    このオブジェクトは、DLPがリクエストを受け入れ、非同期で処理することを示すために、非同期検査リクエストのためにDLPオンデマンドアプライアンスに返されます。

    名前タイプRequired制限デスクリプション
    » job_idtruenoneリクエスト固有のトークン。

    この操作には認証は必要ありません

    このトピックでは
    • 非構造化データの DLP コンテンツ検査ジョブの開始 (非同期)