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

CreateThingType

CreateThingType

创建新事物类型。

https

请求语法:

POST /thing-types/thingTypeName Content-type: application/json { "thingTypeProperties": { "thingTypeDescription": "string", "searchableAttributes": [ "string" ] } }

URI 请求参数:

名称

类型

请求?

描述

thingTypeName

ThingTypeName

事务类型的名称。

请求正文参数:

名称

类型

请求?

描述

thingTypeProperties

ThingTypeProperties

要创建的事物类型的 ThingTypeProperties。它包含有关新事物类型的信息 (包括描述),以及可搜索事物属性名称的列表。

响应语法:

Content-type: application/json { "thingTypeName": "string", "thingTypeArn": "string", "thingTypeId": "string" }

响应正文参数:

名称

类型

请求?

描述

thingTypeName

ThingTypeName

事务类型的名称。

thingTypeArn

ThingTypeArn

事物类型的 Amazon 资源名称 (ARN)。

thingTypeId

ThingTypeId

事物类型 ID。

错误:

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

ResourceAlreadyExistsException

该资源已存在。

HTTP 响应代码:409

cli

摘要:

aws iot create-thing-type \ --thing-type-name <value> \ [--thing-type-properties <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "thingTypeName": "string", "thingTypeProperties": { "thingTypeDescription": "string", "searchableAttributes": [ "string" ] } }

cli-input-json 字段:

名称

类型

描述

thingTypeName

字符串

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

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

事务类型的名称。

thingTypeProperties

ThingTypeProperties

要创建的事物类型的 ThingTypeProperties。它包含有关新事物类型的信息 (包括描述),以及可搜索事物属性名称的列表。

thingTypeDescription

字符串

最大长度:2028

模式:[\\p {Graph}]*

事物类型的描述。

searchableAttributes

列表

成员:AttributeName

java 类:java.util.List

可搜索事物属性名称的列表。

输出:

{ "thingTypeName": "string", "thingTypeArn": "string", "thingTypeId": "string" }

cli 输出字段:

名称

类型

描述

thingTypeName

字符串

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

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

事务类型的名称。

thingTypeArn

字符串

事物类型的 Amazon 资源名称 (ARN)。

thingTypeId

字符串

事物类型 ID。

错误:

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。

ResourceAlreadyExistsException

该资源已存在。