翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetPITRMalwareScanResults
継続的 (point-in-timeのマルウェアスキャン結果を返します。
リクエストの構文
GET /scan/pitr-malware-scan-results?BackupVaultName=BackupVaultName&MalwareScanner=MalwareScanner&RecoveryPointArn=RecoveryPointArn&ScanEndTime=ScanEndTime HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- BackupVaultName
-
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の AWS リージョンに一意の名前で識別されます。
必須: はい
- MalwareScanner
-
対応するスキャンジョブに使用されるスキャンエンジン。現在は、
GUARDDUTYのみがサポートされます。有効な値：
GUARDDUTY必須: はい
- RecoveryPointArn
-
スキャンのターゲット復旧ポイントを一意に識別する ARN。例:
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。必須: はい
- ScanEndTime
-
マルウェアスキャンの結果を調べるための継続的バックアップ内の時点。
必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"LastScanJobTime": number,
"ScanEndTime": number,
"ScanId": "string",
"ScanMode": "string",
"ScanResult": {
"ScanResultStatus": "string"
}
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- LastScanJobTime
-
指定された時点をカバーした最新のスキャンジョブの完了時間。
タイプ: タイムスタンプ
- ScanEndTime
-
クエリされた時点。これにより、リクエストで指定された時間がエコーバックされます。
タイプ: タイムスタンプ
- ScanId
-
対応するスキャンジョブ ID リクエストの送信元として Amazon GuardDuty によって生成されたスキャン ID AWS Backup。
タイプ: 文字列
- ScanMode
-
スキャンジョブに使用されるスキャンタイプを指定します。
型: 文字列
有効な値：
FULL_SCAN | INCREMENTAL_SCAN - ScanResult
-
スキャン
ScanResultStatus用の が含まれ、THREATS_FOUND、NO_THREATS_FOUND、または を返しますUNKNOWN。型: ScanResultInfo オブジェクト
エラー
すべてのアクションに共通のエラーについては、「一般的なエラータイプ」を参照してください。
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
- Context
- Type
HTTP ステータスコード: 400
- MissingParameterValueException
-
必須パラメータがないことを示します。
- Context
- Type
HTTP ステータスコード: 400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
- Context
- Type
HTTP ステータスコード: 400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
- Context
- Type
HTTP ステータスコード: 500
その他の参照資料
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
