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

UpdateCACertificate

UpdateCACertificate

更新已注册的 CA 证书。

https

请求语法:

PUT /cacertificate/caCertificateId?newStatus=newStatus&newAutoRegistrationStatus=newAutoRegistrationStatus Content-type: application/json { "registrationConfig": { "templateBody": "string", "roleArn": "string" }, "removeAutoRegistration": "boolean" }

URI 请求参数:

名称

类型

请求?

描述

certificateId

CertificateId

CA 证书标识符。

newStatus

CACertificateStatus

CA 证书更新后的状态。

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

newAutoRegistrationStatus

AutoRegistrationStatus

自动注册状态的新值。有效值为:“ENABLE”或“DISABLE”。

请求正文参数:

名称

类型

请求?

描述

registrationConfig

RegistrationConfig

有关注册配置的信息。

removeAutoRegistration

RemoveAutoRegistration

如果为 true,则删除自动注册。

错误:

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

cli

摘要:

aws iot update-ca-certificate \ --certificate-id <value> \ [--new-status <value>] \ [--new-auto-registration-status <value>] \ [--registration-config <value>] \ [--remove-auto-registration | --no-remove-auto-registration] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "certificateId": "string", "newStatus": "string", "newAutoRegistrationStatus": "string", "registrationConfig": { "templateBody": "string", "roleArn": "string" }, "removeAutoRegistration": "boolean" }

cli-input-json 字段:

名称

类型

描述

certificateId

字符串

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

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

CA 证书标识符。

newStatus

字符串

CA 证书更新后的状态。

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

枚举:ACTIVE | INACTIVE

newAutoRegistrationStatus

字符串

自动注册状态的新值。有效值为:“ENABLE”或“DISABLE”。

枚举:ENABLE | DISABLE

registrationConfig

RegistrationConfig

有关注册配置的信息。

templateBody

字符串

模板正文。

roleArn

字符串

最大长度:2048,最小长度:20

角色的 ARN。

removeAutoRegistration

布尔值

如果为 true,则删除自动注册。

输出:

错误:

ResourceNotFoundException

指定的资源不存在。

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。