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

ListCertificates

ListCertificates

列出在您的 AWS 账户中注册的证书。

对结果进行分页的默认页面大小为 25。您可以使用返回的标记来检索更多结果。

https

请求语法:

GET /certificates?pageSize=pageSize&marker=marker&isAscendingOrder=ascendingOrder

URI 请求参数:

名称

类型

请求?

描述

pageSize

PageSize

结果页面大小。

标记

Marker

用于获取下一组结果的标记。

ascendingOrder

AscendingOrder

指定结果的顺序。如果为 True,结果按创建日期的升序返回。

响应语法:

Content-type: application/json { "certificates": [ { "certificateArn": "string", "certificateId": "string", "status": "string", "creationDate": "timestamp" } ], "nextMarker": "string" }

响应正文参数:

名称

类型

请求?

描述

证书

证书

证书的描述。

nextMarker

Marker

下一组结果的标记,没有更多结果时为 null。

错误:

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

cli

摘要:

aws iot list-certificates \ [--page-size <value>] \ [--marker <value>] \ [--ascending-order | --no-ascending-order] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "pageSize": "integer", "marker": "string", "ascendingOrder": "boolean" }

cli-input-json 字段:

名称

类型

描述

pageSize

integer

范围 - 最大值:250,最小值:1

结果页面大小。

标记

字符串

模式:[A-Za-z0-9+/]+={0,2}

用于获取下一组结果的标记。

ascendingOrder

布尔值

指定结果的顺序。如果为 True,结果按创建日期的升序返回。

输出:

{ "certificates": [ { "certificateArn": "string", "certificateId": "string", "status": "string", "creationDate": "timestamp" } ], "nextMarker": "string" }

cli 输出字段:

名称

类型

描述

证书

列表

成员:Certificate

java 类:java.util.List

证书的描述。

certificateArn

字符串

证书的 ARN。

certificateId

字符串

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

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

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

status

字符串

证书的状态。

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

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

creationDate

timestamp

证书的创建日期和时间。

nextMarker

字符串

模式:[A-Za-z0-9+/]+={0,2}

下一组结果的标记,没有更多结果时为 null。

错误:

InvalidRequestException

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

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。