文档首页/ 密码安全中心 DEW/ API参考/ API/ 凭据管理服务/ 凭据版本管理/ 查询凭据的版本列表 - ListSecretVersions
更新时间:2026-05-20 GMT+08:00
分享

查询凭据的版本列表 - ListSecretVersions

功能介绍

查询指定凭据下的版本列表信息

接口约束

此接口返回的信息为凭据版本的元数据信息,不包含凭据值

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    csms:secret:listVersion

    List

    secretName *

    • csms:Type

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    csms:secretVersion:list

    -

URI

GET /v1/{project_id}/secrets/{secret_name}/versions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID。可参考获取项目ID获取。

约束限制:

不涉及

取值范围:

以IAM服务接口返回值为准,字符长度32-32

默认取值:

不涉及

secret_name

String

参数解释:

凭据名称

约束限制:

不涉及

取值范围:

需要满足正则表达式:^[a-zA-Z0-9_-]{1,64}$

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

marker

String

参数解释:

以单页最后一条凭据名称作为分页标记。为空时为查询第一页。当前凭据版本最多存储20条,通常不建议设置此参数

约束限制:

marker需要和limit配合使用,不能独立使用。当最后一页返回数量小于limit时,表示查询结束

取值范围:

不涉及

默认取值:

不涉及

limit

Integer

参数解释:

查询返回凭据版本当前页面的数量。当前凭据版本最多存储20条,通常不建议设置此参数

约束限制:

每页默认返回20,最多返回20条凭据版本

取值范围:

不涉及

默认取值:

50

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)。使用AK、SK等认证方式,此处非必选

约束限制:

不涉及

取值范围:

IAM服务查询用户Token接口为准

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

version_metadatas

Array of VersionMetadata objects

参数解释:

凭据版本元数据对象

取值范围:

不涉及

page_info

PageInfo object

参数解释:

分页信息

取值范围:

不涉及

表5 VersionMetadata

参数

参数类型

描述

id

String

参数解释:

凭据的版本号标识符,凭据对象下唯一

取值范围:

不涉及

create_time

Long

参数解释:

凭据版本创建时间,时间戳,即从1970年1月1日至该时间的总秒数

取值范围:

不涉及

expire_time

Long

参数解释:

凭据版本过期时间,时间戳,即从1970年1月1日至该时间的总秒数。默认为空,凭据订阅“版本过期”事件类型时,有效期判断所依据的值

取值范围:

不涉及

kms_key_id

String

参数解释:

加密版本凭据值的KMS主密钥ID

取值范围:

不涉及

secret_name

String

参数解释:

凭据名称

取值范围:

不涉及

version_stages

Array of strings

参数解释:

凭据版本被标记的状态列表。每个版本标签对于凭据对象下版本是唯一存在的,如果创建版本时,指定的是同一凭据对象下的一个已经标记在其他版本上的状态,该标签将自动从其他版本上删除,并附加到此版本上

如果未指定version_stage的值,则凭据管理服务会自动移动临时标签SYSCURRENT到此新版本

取值范围:

不涉及

表6 PageInfo

参数

参数类型

描述

next_marker

String

参数解释:

下一页查询地址(本页的末尾凭据名称,下一页起始凭据名称)

取值范围:

不涉及

previous_marker

String

参数解释:

本页的起始凭据名称,上一页末尾凭据名称

取值范围:

不涉及

current_count

Integer

参数解释:

本页返回条目数量

取值范围:

不涉及

请求示例

响应示例

状态码:200

请求已成功

{
  "version_metadatas" : [ {
    "id" : "v1",
    "kms_key_id" : "b168fe00ff56492495a7d22974df2d0b",
    "create_time" : 1581507580000,
    "secret_name" : "secret-name-demo",
    "version_stages" : [ "SYSCURRENT" ]
  } ],
  "page_info" : {
    "next_marker" : "v10",
    "previous_marker" : "v1",
    "current_count" : 10
  }
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档