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

AssociateTargetsWithJob

AssociateTargetsWithJob

将组与持续任务关联。必须满足以下标准:

  • 创建任务时必须将 targetSelection 字段设置为“CONTINUOUS”。

  • 任务状态当前必须为“IN_PROGRESS”。

  • 与任务关联的目标总数不能超过 100。

https

请求语法:

POST /jobs/jobId/targets Content-type: application/json { "targets": [ "string" ], "comment": "string" }

URI 请求参数:

名称

类型

请求?

描述

jobId

JobId

您在创建此任务时向其分配的唯一标识符。

请求正文参数:

名称

类型

请求?

描述

targets

JobTargets

定义任务目标的事物组 ARN 列表。

comment

评论

一个可选的备注字符串,用于描述为什么将任务与目标关联。

响应语法:

Content-type: application/json { "jobArn": "string", "jobId": "string", "description": "string" }

响应正文参数:

名称

类型

请求?

描述

jobArn

JobArn

标识任务的 ARN。

jobId

JobId

您在创建此任务时向其分配的唯一标识符。

description

JobDescription

任务的简短文本描述。

错误:

InvalidRequestException

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

HTTP 响应代码:400

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

LimitExceededException

附加的实体数超过了限制。

HTTP 响应代码:410

ThrottlingException

速率超过限制。

HTTP 响应代码:429

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

cli

摘要:

aws iot associate-targets-with-job \ --targets <value> \ --job-id <value> \ [--comment <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "targets": [ "string" ], "jobId": "string", "comment": "string" }

cli-input-json 字段:

名称

类型

描述

目标

列表

成员:TargetArn

定义任务目标的事物组 ARN 列表。

jobId

字符串

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

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

您在创建此任务时向其分配的唯一标识符。

comment

字符串

最大长度:2028

模式:[^\\p{C}]+

一个可选的备注字符串,用于描述为什么将任务与目标关联。

输出:

{ "jobArn": "string", "jobId": "string", "description": "string" }

cli 输出字段:

名称

类型

描述

jobArn

字符串

标识任务的 ARN。

jobId

字符串

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

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

您在创建此任务时向其分配的唯一标识符。

description

字符串

最大长度:2028

模式:[^\\p{C}]+

任务的简短文本描述。

错误:

InvalidRequestException

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

ResourceNotFoundException

指定的资源不存在。

LimitExceededException

附加的实体数超过了限制。

ThrottlingException

速率超过限制。

ServiceUnavailableException

服务暂时不可用。