调用GetSecretValue接口获取凭据值。

  • 如果不指定版本号或版本状态，则凭据管家默认返回被标记为ACSCurrent的版本凭据值。
  • 如果指定的凭据使用了用户指定的主密钥来保护凭据值，则需要调用者同时具备相应主密钥的kms:Decrypt权限。

调试

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

请求参数

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

系统规定参数。取值：GetSecretValue。
SecretName String 是 secret001

凭据名称。
VersionStage String 否 ACSCurrent

版本状态。如果指定此参数，则凭据管家返回被标记为指定状态的版本的凭据值。

默认值：ACSCurrent。

VersionId String 否 00000000000000000000000000000001

版本号。如果指定此参数，则凭据管家返回指定版本号的凭据值。

返回数据

名称 类型 示例值 描述
CreateTime String 2020-02-21T15:39:26Z

凭据版本的创建时间。
RequestId String 8dde04f4-0d27-431c-a0f2-a89c8af016c6

请求ID。
SecretData String testdata1

凭据值。凭据管家将存储的密文凭据值进行解密后返回。
SecretDataType String text

凭据值的类型。

取值范围：

  • binary
  • text
SecretName String secret001

凭据名称。
VersionId String 00000000000000000000000000000001

凭据版本的标识符。
VersionStages List { "VersionStage": [ "ACSCurrent" ] }

凭据版本的状态标记。

示例

请求示例

http(s)://[Endpoint]/?Action=GetSecretValue
&SecretName=secret001
&<公共请求参数>

正常返回示例

XML 格式 

<SecretName>secret001</SecretName>
<VersionId>00000000000000000000000000000001</VersionId>
<SecretData>testdata1</SecretData>
<SecretDataType>text</SecretDataType>
<VersionStages>
    <VersionStage>ACSCurrent</VersionStage>
</VersionStages>
<CreateTime>2020-02-21T15:39:26Z</CreateTime>
<RequestId>8dde04f4-0d27-431c-a0f2-a89c8af016c6</RequestId>

JSON 格式 

{
	"SecretName": "secret001",
	"VersionId": "00000000000000000000000000000001",
	"SecretData": "testdata1",
	"SecretDataType": "text",
	"VersionStages": {
		"VersionStage": [
			"ACSCurrent"
		]
	},
	"CreateTime": "2020-02-21T15:39:26Z",
	"RequestId": "8dde04f4-0d27-431c-a0f2-a89c8af016c6"
}

错误码

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