全部產品
Search
文件中心

:ListSecretVersionIds

更新時間:Jan 22, 2025

調用ListSecretVersionIds介面查詢憑據的所有版本資訊。

版本資訊中不包含憑據值。預設只返回有版本狀態的憑據版本。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱

類型

是否必選

樣本值

描述

Action String ListSecretVersionIds

要執行的操作。取值:ListSecretVersionIds

SecretName String secret001

憑據名稱或憑據資源名稱(ARN)。

說明 訪問其他阿里雲帳號下的憑據時,必須輸入憑據ARN。憑據ARN的格式為acs:kms:${region}:${account}:secret/${secret-name}
IncludeDeprecated String false

傳回值中是否包含沒有版本狀態的憑據版本。

取值範圍:

  • false(預設值):不包含
  • true:包含
PageNumber Integer 1

分頁查詢時,設定當前頁面的頁碼。預設值:1。

PageSize Integer 10

分頁查詢時,設定每頁大小。預設值:20。

返回資料

名稱

類型

樣本值

描述

SecretName String secret001

憑據名稱。

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

本次調用請求的ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。

PageSize Integer 10

當前頁大小。

PageNumber Integer 1

當前頁碼。

TotalCount Integer 1

清單項目總個數。

VersionIds Array of VersionId

憑據的版本資訊列表。

VersionId
VersionId String v1

版本號碼。

CreateTime String 2024-02-21T15:39:26Z

版本的建立時間。

VersionStages Array of String {"VersionStage": ["ACSCurrent","uStage1"]}

版本的狀態標記。

樣本

請求樣本

http(s)://[Endpoint]/?Action=ListSecretVersionIds
&SecretName=secret001
&IncludeDeprecated=false
&PageNumber=1
&PageSize=10
&公用請求參數

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。