调用ListSecrets接口查询当前用户在当前地域创建的所有凭据。

此接口返回凭据对象的元数据信息，不返回被加密存储的凭据值。

本文将提供一个示例，返回当前用户在当前地域创建的凭据，其中当前页数PageNumber设置为1，每页中返回的个数PageSize设置为2，共返回2个凭据信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListSecrets

要执行的操作，取值：ListSecrets。
FetchTags String 否 false

返回值中是否包含凭据的资源标签。取值：

  • true：包含。
  • false（默认值）：不包含。
PageNumber Integer 否 1

当前页数。

取值范围：大于0。

默认值：1。
PageSize Integer 否 2

每页返回值的个数。

取值范围：1~100。

默认值：10。
Filters String 否 [{"Key":"SecretName", "Values":["$Val1","$Val2"]}]

凭据过滤器。由Key-Values键值对组成，长度为0~1。使用一个标签键值过滤资源时，查询到的资源数量不能超过4000个。如果资源数量超过4000个，请使用ListResourceTags接口进行查询。

  • Key
    • 描述：需要过滤的属性。
    • 类型：String。
    • 取值：
      • SecretName：凭据名称。
      • Description：凭据描述。
      • TagKey：标签键。
      • TagValue：标签值。
  • Values
    • 描述：期望过滤后包含的值。
    • 类型：String。
    • 长度：0~10。
    • 取值说明：
      • Key取值为SecretName时：长度为1~192个字符，可包含英文字母、数字和特殊字符 _/+=.@-。
      • Key取值为Description时：长度为1~256个字符。
      • Key取值为TagKey时：长度为1~256个字符，可包含英文字母、数字和特殊字符/_-.+=@:。
      • Key取值为TagValue时：长度为1~256个字符，可包含英文字母、数字和特殊字符 /_-.+=@:。

Filters同一个Key中的多个Value之间的逻辑关系为OR。例如：输入[ {"Key":"SecretName", "Values":["sec1","sec2"]} ]时，语义为： (SecretName=sec1 OR SecretName=sec2) 。

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

当前页数。
PageSize Integer 2

每页返回值的个数。

RequestId String 6a6287a0-ff34-4780-a790-fdfca900557f

请求ID。
SecretList Array of Secret

凭据列表。
Secret
CreateTime String 2020-07-17T07:59:05Z

创建时间。
PlannedDeleteTime String 2020-08-17T07:59:05Z

计划删除时间。
SecretName String secret001

凭据名称。
SecretType String Generic

凭据类型。取值：

  • Generic：普通凭据。
  • Rds：托管RDS凭据。
Tags Array of Tag

凭据的资源标签。

如果FetchTags取值为false或者未指定，则不返回该参数。
Tag
TagKey String key1

标签键。
TagValue String val1

标签值。
UpdateTime String 2020-07-17T07:59:05Z

更新时间。
TotalCount Integer 55

凭据列表中的凭据个数。

示例

请求示例

http(s)://[Endpoint]/?Action=ListSecrets
&PageNumber=1
&PageSize=2
&<公共请求参数>

正常返回示例

XML格式 

<KMS>
	  <SecretList>
		    <Secret>
			      <SecretName>secret001</SecretName>
			      <SecretType>Generic</SecretType>
			      <CreateTime>2020-07-17T07:59:05Z</CreateTime>
			      <UpdateTime>2020-07-17T07:59:05Z</UpdateTime>
		    </Secret>
		    <Secret>
			      <SecretName>cache_client</SecretName>
			      <SecretType>Generic</SecretType>
			      <CreateTime>2020-07-23T11:56:29Z</CreateTime>
			      <UpdateTime>2021-01-12T02:15:42Z</UpdateTime>
		    </Secret>
	  </SecretList>
	  <RequestId>6a6287a0-ff34-4780-a790-fdfca900557f</RequestId>
	  <PageNumber>1</PageNumber>
	  <PageSize>2</PageSize>
	  <TotalCount>55</TotalCount>
</KMS>

JSON格式 

{
	"SecretList": {
		"Secret": [
			{
				"SecretName": "secret001",
				"SecretType": "Generic",
				"CreateTime": "2020-07-17T07:59:05Z",
				"UpdateTime": "2020-07-17T07:59:05Z"
			},
			{
				"SecretName": "cache_client",
				"SecretType": "Generic",
				"CreateTime": "2020-07-23T11:56:29Z",
				"UpdateTime": "2021-01-12T02:15:42Z"
			}
		]
	},
	"RequestId": "6a6287a0-ff34-4780-a790-fdfca900557f",
	"PageNumber": 1,
	"PageSize": 2,
	"TotalCount": 55
}

错误码

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