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

RegisterThing

RegisterThing

预配置事物。

https

请求语法:

POST /things Content-type: application/json { "templateBody": "string", "parameters": { "string": "string" } }

请求正文参数:

名称

类型

请求?

描述

templateBody

TemplateBody

预配置模板。有关更多信息,请参阅以编程方式进行预置

parameters

参数

用于预配置事物的参数。有关更多信息,请参阅以编程方式进行预置

响应语法:

Content-type: application/json { "certificatePem": "string", "resourceArns": { "string": "string" } }

响应正文参数:

名称

类型

请求?

描述

certificatePem

CertificatePem

resourceArns

ResourceArns

所生成资源的 ARN。

错误:

InternalFailureException

出现意外错误。

HTTP 响应代码:500

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InvalidRequestException

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

HTTP 响应代码:400

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ThrottlingException

速率超过限制。

HTTP 响应代码:429

ConflictingResourceUpdateException

资源更新冲突异常。在两个待处理更新导致冲突时,会引发此异常。

HTTP 响应代码:409

ResourceRegistrationFailureException

资源注册失败。

HTTP 响应代码:400

cli

摘要:

aws iot register-thing \ --template-body <value> \ [--parameters <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "templateBody": "string", "parameters": { "string": "string" } }

cli-input-json 字段:

名称

类型

描述

templateBody

字符串

预配置模板。有关更多信息,请参阅以编程方式进行预置

parameters

map

用于预配置事物的参数。有关更多信息,请参阅以编程方式进行预置

输出:

{ "certificatePem": "string", "resourceArns": { "string": "string" } }

cli 输出字段:

名称

类型

描述

certificatePem

字符串

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

resourceArns

map

所生成资源的 ARN。

错误:

InternalFailureException

出现意外错误。

ServiceUnavailableException

服务暂时不可用。

InvalidRequestException

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

UnauthorizedException

您没有权限执行此操作。

ThrottlingException

速率超过限制。

ConflictingResourceUpdateException

资源更新冲突异常。在两个待处理更新导致冲突时,会引发此异常。

ResourceRegistrationFailureException

资源注册失败。