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

UpdateCertificate

UpdateCertificate

更新指定证书的状态。此操作是幂等的。

将证书移出 ACTIVE 状态 (包括 REVOKED) 不会断开当前连接的设备,但这些设备将无法重新连接。

使用证书对连接到 AWS IoT 的设备进行身份验证时,证书必须为 ACTIVE 状态。

https

请求语法:

PUT /certificates/certificateId?newStatus=newStatus

URI 请求参数:

名称

类型

请求?

描述

certificateId

CertificateId

证书的 ID。(证书 ARN 的最后一部分包含证书 ID。)

newStatus

CertificateStatus

新的状态。

注意:将状态设置为 PENDING_TRANSFER 将导致引发异常。PENDING_TRANSFER 是由 AWS IoT 内部使用的状态。它不提供给开发人员使用。

注意:状态值 REGISTER_INACTIVE 已弃用,不应再使用。

错误:

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

CertificateStateException

不允许执行该证书操作。

HTTP 响应代码:406

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

cli

摘要:

aws iot update-certificate \ --certificate-id <value> \ --new-status <value> \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "certificateId": "string", "newStatus": "string" }

cli-input-json 字段:

名称

类型

描述

certificateId

字符串

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

模式:(0x)?[a-fA-F0-9]+

证书的 ID。(证书 ARN 的最后一部分包含证书 ID。)

newStatus

字符串

新的状态。

注意:将状态设置为 PENDING_TRANSFER 将导致引发异常。PENDING_TRANSFER 是由 AWS IoT 内部使用的状态。它不提供给开发人员使用。

注意:状态值 REGISTER_INACTIVE 已弃用,不应再使用。

枚举:ACTIVE | INACTIVE | REVOKED | PENDING_TRANSFER | REGISTER_INACTIVE | PENDING_ACTIVATION

输出:

错误:

ResourceNotFoundException

指定的资源不存在。

CertificateStateException

不允许执行该证书操作。

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。