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

DescribeCertificate

DescribeCertificate

获取有关指定证书的信息。

https

请求语法:

GET /certificates/certificateId

URI 请求参数:

名称

类型

请求?

描述

certificateId

CertificateId

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

响应语法:

Content-type: application/json { "certificateDescription": { "certificateArn": "string", "certificateId": "string", "caCertificateId": "string", "status": "string", "certificatePem": "string", "ownedBy": "string", "previousOwnedBy": "string", "creationDate": "timestamp", "lastModifiedDate": "timestamp", "transferData": { "transferMessage": "string", "rejectReason": "string", "transferDate": "timestamp", "acceptDate": "timestamp", "rejectDate": "timestamp" } } }

响应正文参数:

名称

类型

请求?

描述

certificateDescription

CertificateDescription

证书的描述。

错误:

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

cli

摘要:

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

cli-input-json format:

{ "certificateId": "string" }

cli-input-json 字段:

名称

类型

描述

certificateId

字符串

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

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

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

输出:

{ "certificateDescription": { "certificateArn": "string", "certificateId": "string", "caCertificateId": "string", "status": "string", "certificatePem": "string", "ownedBy": "string", "previousOwnedBy": "string", "creationDate": "timestamp", "lastModifiedDate": "timestamp", "transferData": { "transferMessage": "string", "rejectReason": "string", "transferDate": "timestamp", "acceptDate": "timestamp", "rejectDate": "timestamp" } } }

cli 输出字段:

名称

类型

描述

certificateDescription

CertificateDescription

证书的描述。

certificateArn

字符串

证书的 ARN。

certificateId

字符串

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

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

证书的 ID。

caCertificateId

字符串

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

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

签名此证书所用 CA 证书的证书 ID。

status

字符串

证书的状态。

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

certificatePem

字符串

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

PEM 格式的证书数据。

ownedBy

字符串

模式:[0-9]{12}

拥有证书的 AWS 账户的 ID。

previousOwnedBy

字符串

模式:[0-9]{12}

证书以前拥有者的 AWS 账户 ID。

creationDate

timestamp

证书的创建日期和时间。

lastModifiedDate

timestamp

上次修改证书的日期和时间。

transferData

TransferData

传输数据。

transferMessage

字符串

最大长度:128

传输消息。

rejectReason

字符串

最大长度:128

拒绝传输的原因。

transferDate

timestamp

传输发生的日期。

acceptDate

timestamp

接受传输的日期。

rejectDate

timestamp

拒绝传输的日期。

错误:

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。

ResourceNotFoundException

指定的资源不存在。