登录控制台
AWS IoT
开发人员指南
AWS Documentation » AWS IoT » 开发人员指南 » IoT 命令 » RegisterCertificate
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]+

证书标识符。

本页内容：