この API は、DLP 構造化データ分類ジョブを開始するために使用します。 これは、分類目的で指定された形式で提出される列指向データ（SQLデータベースからエクスポートされるデータなど）を指します。リクエストは、ジョブIDを返します。 リクエストの結果を取得するには、それを使用します。 これは通常、社内での使用を目的としていますが、参考資料としてここに記載しています。
このエンドポイントには、いくつかの追加の制限事項があります。
- Character Length of Each Profile name: 256文字
- Max File Size: 1 megabyte
- Max DLP Profiles: 100
リクエストエンドポイント
POST
https://<appliance_ip>/inspections/structured-classification
呼び出し例
curl -X 'POST' \
'http://localhost/inspections/structured-classification' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-F 'request={"content":{"id":"b1f793e4d4a26ac7b695bb1fd1fb0ce3cb5d729c401d8528f8bb92598006cf85"},"profiles":["DLP-PCI","DLP-PII"],"results":{"verdict":"details"},"sender":{"app_name":"AWS_RDS"}}' \
-F 'content=@notes.txt;type=text/plain'
回答例
#202 Response
{
"job_id": "7e548ccf-c96e-4f5f-9f9e-4a468776972e"
}
Valid Query Parameters:
| 名前 | In | タイプ | Required | デスクリプション |
|---|---|---|---|---|
| body | body | object | true | none |
| " リクエスト | body | object | true | 構造化データ検査要求のプロパティを指定します。 |
| "" コンテンツ | body | object | true | リクエストの一部として送信されるコンテンツについて説明します。 |
| »»» id | body | string | true | 送信されたコンテンツのSHA256ハッシュ値。 |
| »» プロフィール | body | true | スキャン中に使用するプロファイルのリスト。 プロファイルは、一致するものを検索する際にどの DLP ルールを使用するかを決定します。 一致を検索する際に。 | |
| "" 結果 | body | object | false | 検査から返されるDLPオンデマンド構造化分類結果のプロパティを指定します。 |
| »»» 判決 | body | string | false | 試合の詳細情報の返送量を指定します。次のいずれか： details – 試合の詳細が含まれます。判決に関する詳細情報には、結果の一致、プロファイル、およびファイルごとのルールが含まれます。判決が指定されていない場合は、詳細が返送されます。 |
| »» 送信者 | body | false | リクエストの呼び出し元について説明します。 | |
| »»» アプリ名 | body | string | true | 呼び出しをトリガーしたアプリケーション |
| " コンテンツ | body | 文字列（バイナリ） | true | none |
Enumerated Values
| パラメータ | Value |
|---|---|
| »»» 判決 | details |
Responses
| 状態 | Meaning | デスクリプション | Schema |
|---|---|---|---|
| 202 | Accepted | リクエストが承認されたことを示します。これは正常で、予想される結果です。 | 列をなして |
| 400 | 要求の形式が正しくありません | リクエストは無効でした。レスポンスには、リクエストが拒否された原因となったエラー情報が含まれています（利用可能な場合）。 | string |
| 413 | ペイロードが大きすぎる | 指定されたコンテンツは大きすぎるため、スキャンできません。 | なし |
| 500 | 内部サーバーエラー | リクエストの実行中にエラーが発生しました。レスポンスには、リクエストが拒否された原因となったエラー情報が含まれています（利用可能な場合）。 | string |
| 503 | サービスは利用できません | リクエストを実行するためのリソースがありません。 | なし |
応答スキーマ
ステータスコード 202
このオブジェクトは、非同期検査リクエストのためにDLPオンデマンドアプライアンスに返され、アプライアンスがリクエストを受け入れ、非同期で処理することを示します。
| 名前 | タイプ | Required | 制限 | デスクリプション |
|---|---|---|---|---|
| » job_id | true | none | リクエスト固有のトークン。 |
この操作には認証は必要ありません