All Products
Search
Document Center

Key Management Service:ListSecrets

Last Updated:Apr 10, 2026

Mengambil semua rahasia di Wilayah saat ini.

Deskripsi operasi

  • Untuk memanggil operasi ini, pengguna RAM atau peran RAM harus diberikan kebijakan yang diperlukan. Untuk informasi selengkapnya, lihat Resource Access Management.

  • Operasi ini hanya mengembalikan metadata secret, bukan nilai secret-nya.

Contoh berikut menunjukkan cara melakukan kueri terhadap secret yang dibuat oleh pengguna saat ini di wilayah saat ini. Parameter PageNumber diatur ke 1 dan PageSize diatur ke 2, sehingga mengembalikan metadata untuk dua secret.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

FetchTags

string

No

Menentukan apakah akan mengembalikan tag resource untuk setiap secret. Nilai yang valid:

  • true: Tag resource dikembalikan.

  • false (default): Tag resource tidak dikembalikan.

false

PageNumber

integer

No

Nomor halaman.
Nilainya harus lebih besar dari 0.
Default: 1.




1

PageSize

integer

No

Ukuran halaman.
Nilainya harus antara 1 hingga 100.
Default: 10.




2

Filters

string

No

Memfilter secret berdasarkan kondisi tertentu. Nilainya berupa daftar hingga 10 pasangan kunci-nilai. Saat Anda memfilter berdasarkan tag, kueri mengembalikan maksimal 4.000 resource. Jika lebih dari 4.000 resource sesuai dengan filter tersebut, panggil operasi ListResourceTags.

  • Key
    • Description: Properti filter.

    • Type: String.

  • Values
    • Description: Nilai filter.

    • Type: String.

    • Anda dapat menentukan hingga 10 item.

Nilai yang valid untuk Key:

  • Atur Key ke SecretName untuk memfilter berdasarkan nama secret.

  • Atur Key ke Description untuk memfilter berdasarkan deskripsi secret.

  • Atur Key ke TagKey untuk memfilter berdasarkan kunci tag.

  • Atur Key ke TagValue untuk memfilter berdasarkan nilai tag.

  • Atur Key ke DKMSInstanceId untuk memfilter berdasarkan ID instans KMS.

  • Atur Key ke SecretType untuk memfilter berdasarkan tipe secret. Values dapat berupa Generic, RDS, Redis, RAMCredentials, ECS, atau PolarDB.

  • Atur Key ke Creator untuk memfilter berdasarkan pembuat secret.

Jika Anda menentukan beberapa nilai untuk satu kunci, filter menerapkan logika OR. Misalnya, jika Anda memasukkan [ {"Key":"SecretName", "Values":["sec1","sec2"]} ], artinya: (SecretName=sec1 OR SecretName=sec2).

[{"Key":"SecretName", "Values":["Val1","Val2"]}]

Elemen respons

Element

Type

Description

Example

object

PageNumber

integer

Nomor halaman.

1

PageSize

integer

Jumlah entri per halaman.

2

RequestId

string

Identifier unik yang dihasilkan oleh Alibaba Cloud untuk permintaan ini. Gunakan identifier ini untuk melacak dan memecahkan masalah.

6a6287a0-ff34-4780-a790-fdfca900557f

TotalCount

integer

Jumlah secret.

55

SecretList

object

Secret

array<object>

Daftar secret.

array<object>

SecretName

string

Nama secret.

secret001

UpdateTime

string

Waktu terakhir secret diperbarui.

2024-07-17T07:59:05Z

SecretType

string

Tipe secret. Nilai yang valid:

  • Generic: secret generik.

  • Rds: secret RDS.

  • Redis: secret Redis atau Tair.

  • RAMCredentials: secret RAM.

  • ECS: secret ECS.

  • PolarDB: secret PolarDB.

Generic

PlannedDeleteTime

string

Waktu penghapusan terjadwal.

2024-08-17T07:59:05Z

CreateTime

string

Waktu secret dibuat.

2024-07-17T07:59:05Z

Tags

object

Tag

array<object>

Tag resource untuk secret.Parameter ini tidak dikembalikan jika parameter FetchTags diatur ke false atau tidak ditentukan.

object

Tag resource.

TagValue

string

Nilai tag.

val1

TagKey

string

Kunci tag.

key1

OwingService

string

Layanan pemilik.

alb

Contoh

Respons sukses

JSONformat

{
  "PageNumber": 1,
  "PageSize": 2,
  "RequestId": "6a6287a0-ff34-4780-a790-fdfca900557f",
  "TotalCount": 55,
  "SecretList": {
    "Secret": [
      {
        "SecretName": "secret001",
        "UpdateTime": "2024-07-17T07:59:05Z",
        "SecretType": "Generic",
        "PlannedDeleteTime": "2024-08-17T07:59:05Z",
        "CreateTime": "2024-07-17T07:59:05Z",
        "Tags": {
          "Tag": [
            {
              "TagValue": "val1",
              "TagKey": "key1"
            }
          ]
        },
        "OwingService": "alb"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

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
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.