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

RegisterCertificate

向 AWS IoT 注册设备证书。如果您有多个 CA 证书具有相同主题字段,则必须指定用于对所注册设备证书进行签名的 CA 证书。

请求语法:

POST /certificate/register?setAsActive=setAsActive Content-type: application/json { "certificatePem": "string", "caCertificatePem": "string", "status": "string" }

URI 请求参数:

名称

类型

请求?

描述

setAsActive

SetAsActiveFlag

指定 CA 证书是否设置为活动状态的布尔值。

请求正文参数:

名称

类型

请求?

描述

certificatePem

CertificatePem

PEM 格式的证书数据。

caCertificatePem

CertificatePem

用于对所要注册的设备证书进行签名的 CA 证书。

status

CertificateStatus

注册证书请求的状态。

响应语法:

Content-type: application/json { "certificateArn": "string", "certificateId": "string" }

响应正文参数:

名称

类型

请求?

描述

certificateArn

CertificateArn

证书 ARN。

certificateId

CertificateId

证书标识符。

错误:

ResourceAlreadyExistsException

该资源已存在。

HTTP 响应代码:409

InvalidRequestException

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

HTTP 响应代码:400

CertificateValidationException

证书无效。

HTTP 响应代码:400

CertificateStateException

不允许执行该证书操作。

HTTP 响应代码:406

CertificateConflictException

无法验证用于对您尝试注册的设备证书进行签名的 CA 证书。当您注册了具有相同主题字段和公有密钥的多个 CA 证书时,会出现这种情况。

HTTP 响应代码:409

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

CLI

摘要:

aws iot register-certificate \ --certificate-pem <value> \ [--ca-certificate-pem <value>] \ [--set-as-active | --no-set-as-active] \ [--status <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "certificatePem": "string", "caCertificatePem": "string", "status": "string" }

cli-input-json 字段:

名称

类型

描述

certificatePem

字符串

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

PEM 格式的证书数据。

caCertificatePem

字符串

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

用于对所要注册的设备证书进行签名的 CA 证书。

status

字符串

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

java 类:iot.identity.service.CertificateStatus

注册证书请求的状态。

输出:

{ "certificateArn": "string", "certificateId": "string" }

cli 输出字段:

名称

类型

描述

certificateArn

字符串

证书 ARN。

certificateId

字符串

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

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

证书标识符。

本页内容: