AWS IoT
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

DeleteThing

删除指定的事物。

请求语法:

DELETE /things/thingName?expectedVersion=expectedVersion

URI 请求参数:

名称

类型

请求?

描述

thingName

ThingName

要删除的事物的名称。

expectedVersion

OptionalVersion

注册表中预期的事物记录的版本。如果注册表中记录的版本与请求中指定的预期版本不匹配,则使用 VersionConflictException 拒绝 DeleteThing 请求。

错误:

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

VersionConflictException

传递到命令的事物的版本不同于使用 --version 参数指定的版本时,将引发异常错误。

HTTP 响应代码:409

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

CLI

摘要:

aws iot delete-thing \ --thing-name <value> \ [--expected-version <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "thingName": "string", "expectedVersion": "long" }

cli-input-json 字段:

名称

类型

描述

thingName

字符串

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

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

要删除的事物的名称。

expectedVersion

long

java 类:java.lang.Long

注册表中预期的事物记录的版本。如果注册表中记录的版本与请求中指定的预期版本不匹配,则使用 VersionConflictException 拒绝 DeleteThing 请求。

输出:

本页内容: