ListSecretVersionIds - 查询凭据的所有版本信息

查询凭据的所有版本信息。

接口说明

  • RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制

  • 版本信息中不包含凭据值。默认只返回有版本状态的凭据版本。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

SecretName

string

凭据名称或凭据资源名称(ARN)。

说明

访问其他阿里云账号下的凭据时,必须输入凭据 ARN。凭据 ARN 的格式为acs:kms:${region}:${account}:secret/${secret-name}

secret001

IncludeDeprecated

string

返回值中是否包含没有版本状态的凭据版本。

取值范围:

  • false(默认值):不包含

  • true:包含

false

PageNumber

integer

分页查询时,设置当前页面的页码。默认值:1。

1

PageSize

integer

分页查询时,设置每页大小。默认值:20。

10

返回参数

名称

类型

描述

示例值

object

SecretName

string

凭据名称。

secret001

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47

PageSize

integer

当前页大小。

10

PageNumber

integer

当前页码。

1

TotalCount

integer

列表项总个数。

1

VersionIds

object

VersionId

array<object>

凭据的版本信息列表。

object

凭据的版本信息列表。

VersionId

string

版本号。

v1

CreateTime

string

版本的创建时间。

2024-02-21T15:39:26Z

VersionStages

object

VersionStage

array

版本的状态标记。

string

版本的状态标记。

{"VersionStage": ["ACSCurrent","uStage1"]}

示例

正常返回示例

JSON格式

{
  "SecretName": "secret001",
  "RequestId": "5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalCount": 1,
  "VersionIds": {
    "VersionId": [
      {
        "VersionId": "v1",
        "CreateTime": "2024-02-21T15:39:26Z",
        "VersionStages": {
          "VersionStage": [
            "{\"VersionStage\": [\"ACSCurrent\",\"uStage1\"]}"
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter some of the specified parameters "\" is not valid
500 InternalFailure Internal Failure
403 Forbidden.NoPermission This operation is forbidden by permission system
404 Forbidden.ResourceNotFound Resource not found

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情