本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # DescribeScanJob 返回指定 ScanJob ID 的扫描任务详细信息。 ## 请求语法 ``` GET /scan/jobs/ScanJobId HTTP/1.1 ``` ## URI 请求参数请求使用以下 URI 参数。 ** [ScanJobId](#API_DescribeScanJob_RequestSyntax) ** 对扫描资源的请求 AWS Backup 进行唯一标识。是否必需：是 ## 请求体该请求没有请求正文。 ## 响应语法 ``` HTTP/1.1 200 Content-type: application/json { "AccountId": "string", "BackupVaultArn": "string", "BackupVaultName": "string", "CompletionDate": number, "CreatedBy": { "BackupPlanArn": "string", "BackupPlanId": "string", "BackupPlanVersion": "string", "BackupRuleId": "string" }, "CreationDate": number, "IamRoleArn": "string", "MalwareScanner": "string", "RecoveryPointArn": "string", "ResourceArn": "string", "ResourceName": "string", "ResourceType": "string", "ScanBaseRecoveryPointArn": "string", "ScanId": "string", "ScanJobId": "string", "ScanMode": "string", "ScannerRoleArn": "string", "ScanResult": { "ScanResultStatus": "string" }, "State": "string", "StatusMessage": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [AccountId](#API_DescribeScanJob_ResponseSyntax) ** 返回拥有扫描任务的账户 ID。模式：`^[0-9]{12}$` 类型：字符串 ** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) ** 用于唯一标识备份库的 Amazon 资源名称 (ARN)；例如，`arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault` 类型：字符串 ** [BackupVaultName](#API_DescribeScanJob_ResponseSyntax) ** 用于存储备份的逻辑容器的名称。Backup 存储库由用于创建备份存储库的账户和创建备份存储库的 AWS 区域所特有的名称进行标识。模式：`^[a-zA-Z0-9\-\_\.]{2,50}$` 类型：字符串 ** [CompletionDate](#API_DescribeScanJob_ResponseSyntax) ** 备份索引创建完成的日期和时间，采用 Unix 时间格式和协调世界时（UTC）。`CompletionDate` 的值精确到毫秒。例如，值 1516925490.087 表示 2018 年 1 月 26 日星期五上午 12:11:30.087。类型：时间戳 ** [CreatedBy](#API_DescribeScanJob_ResponseSyntax) ** 包含有关创建扫描任务的识别信息，包括启动扫描的备份计划和规则。类型：[ScanJobCreator](API_ScanJobCreator.md) 对象 ** [CreationDate](#API_DescribeScanJob_ResponseSyntax) ** 备份索引创建完成的日期和时间，采用 Unix 时间格式和协调世界时（UTC）。`CreationDate` 的值精确到毫秒。例如，值 1516925490.087 表示 2018 年 1 月 26 日星期五上午 12:11:30.087。类型：时间戳 ** [IamRoleArn](#API_DescribeScanJob_ResponseSyntax) ** 唯一标识备份保管库的 Amazon 资源名称 (ARN)；例如，`arn:aws:iam::123456789012:role/S3Access`。类型：字符串 ** [MalwareScanner](#API_DescribeScanJob_ResponseSyntax) ** 用于相应扫描任务的扫描引擎。目前仅支持 `GUARDUTY`。类型：字符串有效值：`GUARDDUTY` ** [RecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) ** 一个 ARN，用于唯一标识要扫描的目标恢复点。；例如，。`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45` 类型：字符串 ** [ResourceArn](#API_DescribeScanJob_ResponseSyntax) ** 一个 ARN，用于唯一标识相应恢复点 ARN 的源资源。类型：字符串 ** [ResourceName](#API_DescribeScanJob_ResponseSyntax) ** 属于指定备份的资源的非唯一名称。类型：字符串 ** [ResourceType](#API_DescribeScanJob_ResponseSyntax) ** 要备份的 AWS 资源类型；例如，亚马逊 Elastic Block Store (Amazon EBS) 卷。模式：`^[a-zA-Z0-9\-\_\.]{1,50}$` 类型：字符串有效值：`EBS | EC2 | S3` ** [ScanBaseRecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) ** 一个 ARN，用于唯一标识扫描的基本恢复点。只有在执行增量扫描任务时，才会填充此字段。类型：字符串 ** [ScanId](#API_DescribeScanJob_ResponseSyntax) ** Amazon GuardDuty 为相应的 Scan Job ID 请求生成的扫描 ID AWS Backup。类型：字符串 ** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) ** 唯一标识请求的扫描任务 ID AWS Backup。类型：字符串 ** [ScanMode](#API_DescribeScanJob_ResponseSyntax) ** 指定用于扫描任务的扫描类型。类型：字符串有效值：`FULL_SCAN | INCREMENTAL_SCAN` ** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) ** 指定用于扫描任务的扫描器 IAM 角色 ARN。类型：字符串 ** [ScanResult](#API_DescribeScanJob_ResponseSyntax) ** 包含扫描任务和返回的`THREATS_FOUND`或已完成任务`NO_THREATS_FOUND`的。`ScanResultsStatus` 类型：[ScanResultInfo](API_ScanResultInfo.md) 对象 ** [State](#API_DescribeScanJob_ResponseSyntax) ** 扫描任务的当前状态。类型：字符串有效值：`CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` ** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) ** 一条详细消息，解释备份资源作业的状态。类型：字符串 ## 错误有关所有操作返回的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** InvalidParameterValueException ** 表示参数的值有问题。例如，该值超出了范围。 ** Context ** ** Type ** HTTP 状态代码：400 ** MissingParameterValueException ** 表示缺少必需的参数。 ** Context ** ** Type ** HTTP 状态代码：400 ** ResourceNotFoundException ** 该操作所需的资源不存在。 ** Context ** ** Type ** HTTP 状态代码：400 ** ServiceUnavailableException ** 由于服务器发生临时故障而导致请求失败。 ** Context ** ** Type ** HTTP 状态代码：500 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeScanJob) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeScanJob) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeScanJob) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeScanJob) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeScanJob) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeScanJob) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeScanJob) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeScanJob) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeScanJob) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeScanJob)