调用PutSecretValue接口为凭据存入一个新版本的凭据值。

此接口用于存入新版本的凭据值,而不能用于修改已有版本的凭据值。

默认情况下,新存入的凭据值被标记为ACSCurrent,而ACSCurrent标记的前一个版本被标记为ACSPrevious。您可以通过指定VersionStage参数来覆盖该默认行为。

存入新版本时需指定版本号,凭据管家按照如下规则进行操作:

  • 如果指定版本号在凭据内并不存在,则创建新版本并存入凭据值。
  • 如果指定版本号在凭据内已经存在,且关联的凭据值和参数中指定的凭据值相等,则请求会被忽略,并且返回成功(请求是幂等的)。
  • 如果指定版本号在凭据内已经存在,但是关联的凭据值和参数中指定的凭据值并不相等,则请求会被拒绝,且返回失败。

调试

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

请求参数

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

要执行的操作,系统规定参数。

取值:PutSecretValue

SecretData String importantdata

凭据值。被加密后存入指定的新版本中。

SecretName String secret001

凭据名称。

VersionId String 00000000000000000000000000000000203

新凭据版本的版本号。凭据内唯一。

SecretDataType String text

凭据值类型。取值范围:

  • text
  • binary

    默认值:text

VersionStages String ["ACSCurrent", "UStage1","Ustage2"]

凭据版本在存入时需要被同时标记的版本状态。如果您不指定此参数,凭据管家默认为新版本标记ACSCurrent

返回数据

名称 类型 示例值 描述
RequestId String 6d394629-3ae3-4412-bb83-ae95ceb2b5da

请求ID。

SecretName String secret001

凭据名称。

VersionId String 00000000000000000000000000000000203

被存入凭据版本的版本号。

VersionStages List { "VersionStage": [ "ACSCurrent", "UStage1", "Ustage2" ] }

版本被标记的状态。

示例

请求示例

http(s)://[Endpoint]/?Action=PutSecretValue
&SecretData=importantdata
&SecretDataType=text
&SecretName=secret001
&VersionId=00000000000000000000000000000000203
&<公共请求参数>

正常返回示例

XML 格式

<SecretName>secret001</SecretName>
<VersionId>00000000000000000000000000000000203</VersionId>
<VersionStages>
    <VersionStage>ACSCurrent</VersionStage>
    <VersionStage>UStage1</VersionStage>
    <VersionStage>Ustage2</VersionStage>
</VersionStages>
<RequestId>6d394629-3ae3-4412-bb83-ae95ceb2b5da</RequestId>

JSON 格式

{
	"SecretName": "secret001",
	"VersionId": "00000000000000000000000000000000203",
	"VersionStages": {
		"VersionStage": [
			"ACSCurrent",
			"UStage1",
			"Ustage2"
		]
	},
	"RequestId": "6d394629-3ae3-4412-bb83-ae95ceb2b5da"
}

错误码

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