AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

StartOnDemandAuditTask

启动按需 Device Defender 审核。

https

请求语法:

POST /audit/tasks Content-type: application/json { "targetCheckNames": [ "string" ] }

请求正文参数:

名称

类型

请求?

描述

targetCheckNames

TargetAuditCheckNames

在审核过程中执行的检查。必须为您的账户启用您指定的检查,否则会出现异常。使用 DescribeAccountAuditConfiguration 查看所有检查的列表,包括已启用的检查,或使用 UpdateAccountAuditConfiguration 选择已启用的检查。

响应语法:

Content-type: application/json { "taskId": "string" }

响应正文参数:

名称

类型

请求?

描述

taskId

AuditTaskId

您启动的按需审核的 ID。

错误:

InvalidRequestException

请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

InternalFailureException

出现意外错误。

HTTP 响应代码:500

LimitExceededException

已超出限制。

HTTP 响应代码:410

cli

摘要:

aws iot start-on-demand-audit-task \ --target-check-names <value> \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "targetCheckNames": [ "string" ] }

cli-input-json 字段:

名称

类型

描述

targetCheckNames

列表

成员:AuditCheckName

在审核过程中执行的检查。必须为您的账户启用您指定的检查,否则会出现异常。使用 DescribeAccountAuditConfiguration 查看所有检查的列表,包括已启用的检查,或使用 UpdateAccountAuditConfiguration 选择已启用的检查。

输出:

{ "taskId": "string" }

cli 输出字段:

名称

类型

描述

taskId

string

最大长度:40,最小长度:1

模式:[a-zA-Z0-9-]+

您启动的按需审核的 ID。

错误:

InvalidRequestException

请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。

ThrottlingException

速率超过限制。

InternalFailureException

出现意外错误。

LimitExceededException

已超出限制。