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

    DLPコンテンツ検査を実行し、結果を取得する(同期)

    この API エンドポイントは、DLP コンテンツ検査を同期的に実行し、結果を取得するために使用されます。 コンテンツ検査が最大タイムアウトである10秒を超えた場合、ステータスフィールドに「timeout」を設定したHTTP 200が返されます。この呼び出しは、 summary とdetailsの評決タイプのみをサポートします。

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

    • Max File Size: 1 megabyte
    • Timeout: 10秒
    • Max DLP Profiles: 100
    • Character Length of Each Profile name: 256文字

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

    POST

    https://<appliance_ip>/inspections

    呼び出し例

    curl -X 'POST' \
      'https://10.0.0.1/inspections' \
      -H 'accept: multipart/mixed' \
      -H 'Content-Type: multipart/form-data' \
      -H 'x-netskope-generate-incidents: true' \
      -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=@dlp.txt;type=text/plain'

    回答例

    #200 Example
    
    Indicates a successful response, and the results are provided in multiple multipart/mixed parts.
    

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

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

    Valid Query Parameters:

    パラメータ

    名前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

    Responses

    状態MeaningデスクリプションSchema
    200OK応答が成功したことを示し、結果は複数の部分(複数パートまたは混合パート)に分けて提供されます。列をなして
    400要求の形式が正しくありませんリクエストは無効でした。レスポンスには、リクエストが拒否された原因となったエラー情報が含まれています(利用可能な場合)。string
    413ペイロードが大きすぎる指定されたコンテンツは大きすぎるため、スキャンできません。なし
    500内部サーバーエラーリクエストの実行中にエラーが発生しました。レスポンスには、リクエストが拒否された原因となったエラー情報が含まれています(利用可能な場合)。string
    503サービスは利用できませんリクエストを実行するためのリソースがありません。なし

    応答スキーマ

    ステータスコード 200

    名前タイプRequired制限デスクリプション
    » 結果データfalsenone検査の総合結果が記載されています。これには、検査の状況と、検査の結果として得られた一致結果が含まれます。
    "" 状態truenoneスキャン要求のステータスを指定します。
    success – コンテンツの検査は正常に完了しました。
    timeout – コンテンツ検査に時間がかかりすぎたため、タイムアウトしました。
    error – コンテンツ検査の実行中にエラーが発生しました。
    »» ステータス情報stringfalsenone状況に関する追加情報。例えば、 statusがエラーの場合、このフィールドは発生したエラーの詳細を示すために存在する可能性があります。
    "" まとめfalsenonenone
    »»» 判決stringtruenone判決。以下のいずれか:
    hit
    no_hit
    »»» 評決タイプstringtruenone判決の種類。以下のいずれか:
    full
    partial
    """ 重大度stringfalsenoneその規則の厳しさ。以下のいずれか:
    none
    low
    medium
    high
    critical
    »»» プロフィールtruenoneスキャン中に使用するプロファイルのリスト。 プロファイルは、一致するものを検索する際にどの DLP ルールを使用するかを決定します。 一致を検索する際に。
    »»» トランザクションIDstringtruenoneこの試合のトランザクションID。
    "" 結果[物体]falsenoneスキャンが正常に完了した場合(ステータスが成功の場合)、このフィールドが表示されることがあります。これにはエントリの配列が含まれており、スキャンされたコンテンツ内のファイル/サブファイルごとに1つずつエントリが格納されています。ルールに一致したファイル/サブファイル、または保護されているためスキャンできなかったファイル/サブファイルのみがここに表示されます。スキャンされたものの、上記2つの条件のいずれも満たさなかったファイルは、ここには表示されません。
    »»» バイパスされたプロファイル[string]falsenoneスキャン対象のファイルが何らかの方法で保護されていたため、リクエストから除外されたプロファイルの一覧を指定します。このフィールドが存在しない場合、プロファイルはスキップされませんでした。
    »»» metadataobjecttruenone検査対象コンテンツに関するメタデータ。
    »»»» subfilebooleantruenoneコンテナファイルがDLPに渡された場合、その中のサブファイルもスキャンされます。このフィールドがtrueの場合、一致するのはサブファイルです。このフィールドが false の場合、DLP に渡されたコンテンツがコンテナではなかったか、一致がコンテナ自体に対して行われたかのいずれかです。
    »»»» ファイルIDintegerfalsenoneファイル/サブファイルの内部識別子。
    »»»» namestringfalsenone名前(例)検査対象コンテンツのファイル名(存在する場合)。
    """" サイズinteger(uint64)falsenoneファイル/サブファイルのサイズ(バイト単位)。
    »»»» sha256stringfalsenone検査対象コンテンツのSHA256ハッシュ値。
    """" 言語stringfalsenone検査対象コンテンツの検出された言語。
    """" タイプstringfalsenone検査対象コンテンツの検出された種類。
    »»»» カテゴリstringfalsenone検査対象コンテンツの検出されたカテゴリ。
    »»»» mime_typestringfalsenone検査対象コンテンツのMIMEタイプ。
    »»»» 保護objectfalsenoneこのフィールドは、コンテンツが何らかの方法で保護されている場合に存在します。保護には、暗号化とmicrosoft_aipのいずれか、または両方が含まれる場合があります。
    »»»»» 暗号化objectfalsenone内容は暗号化されています。暗号化されたコンテンツのマッチデータは作成できません。
    »»»»»» ファイルタイプbooleanfalsenoneファイルの入力で暗号化された内容が検出されます。
    »»»»»» 分類booleanfalsenone暗号化されたコンテンツは機密扱いで検出されます。
    »»»»»» 分類スコア数値(倍精度浮動小数点数)falsenone分類で検出された暗号化コンテンツのスコア。
    »»»»» microsoft_aipobjectfalsenoneこのコンテンツはマイクロソフトのAIP(アプリケーション知的財産権)によって保護されています。コンテンツが保護されていない場合、検査が行われ、照合データが生成される可能性があります。保護されていないマッチデータを作成できない場合、データは生成されません。
    """""" 状態stringtruenoneMicrosoft AIP の保護状態:
    protected : コンテンツの保護を解除できなかったため、検査されませんでした。
    unsanctioned : コンテンツは既知のMIPインフラストラクチャ外でAIP保護されていたため、保護を解除できず、検査も行われませんでした。
    sanctioned : コンテンツは既知のMIPインフラストラクチャによってAIPで保護されていました。そのようなコンテンツは保護されておらず、スキャンされる可能性があります。また、DRMラベルが抽出されている可能性もあります。
    »»»» drmobjectfalsenoneコンテンツはDRMシステムによって保護されています。
    »»»»» labels[物体]truenone詳細なDRMラベル情報を含むDRMラベルオブジェクトの配列。
    »»»»»» idstringtruenoneラベルのID。
    »»»»»» namestringtruenoneラベルの名前。
    """""" 実例stringtruenoneラベルのインスタンス。
    »»»»»» vendorstringtruenoneラベルの販売業者。
    »»»»»» データ分類ラベルstringtruenoneデータ分類ラベル。
    »»» マッチ[物体]falsenone詳細なDLPマッチ情報を含むマッチエントリオブジェクトの配列。
    »»»» idstringfalsenoneマッチ識別子。これがキャッシュされたマッチの場合、これは前のマッチのIDに設定されます。それ以外の場合、このフィールドは、将来一致が見つかった場合に DLP が参照するために使用する新しい識別子です。 さらに、キャッシュされていないレスポンスの場合、このファイルに対応するextracted_text multipart/mixedパートが返され、この値がそのパートのContent-Dispositionヘッダーのnameフィールドに設定されます。
    »»»» キャッシュ済みbooleantruenoneもしこれが真実であれば、この一致はDLPキャッシュ内で見つかったことを意味し、つまりコンテンツは既にこのプロファイルでスキャンされているため、今回のリクエストの一部としてスキャンされなかったということです。idには、コンテンツがスキャンされたときに作成されたidが設定されます。このため、DLPキャッシュにはフォレンジックデータが保存されないため、試合に関連するフォレンジック情報は提供されません。
    »»»» プロフィールanytruenonenone

    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指定されたエンティティが一致した回数。
    »»»»»»» データ型stringfalsenoneこのエンティティを記述する一般的なデータ型。
    »»»»»»» 感度レベルstringtruenoneこのエンティティはどの程度感度の高い一致ですか?感度が低い、中程度、高い、クリティカルのいずれか
    »»»»»» マッチ数integertruenoneエンティティルールが一致する件数。
    »»»»»» 感度レベルtruenoneこのエンティティはどの程度感度の高い一致ですか?以下のいずれか:
    not_sensitive
    low
    medium
    high
    critical
    »»»»»» ユニークカウントintegerfalsenoneルールに一致した固有のエントリの数。このフィールドは、プロファイルでルールを一意にカウントするように指定されている場合にのみ表示されます。
    »»»»» 構造化分類objectfalsenone一致する分類タイプルールの詳細
    »»»»»» エンティティの概要truenone一致したエンティティとそのエンティティに対応するカウントの配列。
    »»»»»» マッチ数integertruenoneエンティティルールが一致する件数。
    »»»»»» 感度レベルtruenoneこのエンティティはどの程度感度の高い一致ですか?感度が低い、中程度、高い、クリティカルのいずれか
    »»»»»» データ型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

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

    このトピックでは
    • DLPコンテンツ検査を実行し、結果を取得する(同期)