调用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 |
凭据值的类型。 取值范围:
|
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"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交