创建凭据版本 - CreateSecretVersion

功能介绍

在指定的凭据中，创建一个新的凭据版本，用于加密保管新的凭据值。默认情况下，新创建的凭据版本被标记为SYSCURRENT状态，而SYSCURRENT标记的前一个凭据版本被标记为SYSPREVIOUS状态。您可以通过指定VersionStage参数来覆盖默认行为。

接口约束

• 凭据管理服务console控制台仅使用secret_string字段。如果您想要添加二进制类型凭据到secret_binary字段中保存，必须使用SDK或API的方式。

• 凭据管理服务的每个凭据中最多可支持20个版本。

• 只能对处于ENABLED状态的凭据添加新的版本。

• 每次存入新的凭据值时，凭据版本号按照为v1，v2，v3...的模式自动增加。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  csms:secret:createVersion	Write	secretName *	csms:Type g:EnterpriseProjectId g:ResourceTag/<tag-key>	csms:secretVersion:create	kms:cmk:createDataKey

URI

POST /v1/{project_id}/secrets/{secret_name}/versions

请求参数

响应参数

状态码：200

状态码：400

状态码：401

状态码：403

状态码：404

状态码：500

状态码：502

状态码：504

请求示例

创建凭据版本，凭据值为secret_string。

{
  "secret_string" : "secret_string"
}

响应示例

状态码：200

请求已成功

{
  "version_metadata" : {
    "id" : "v1",
    "kms_key_id" : "b168fe00ff56492495a7d22974df2d0b",
    "create_time" : 1581507580000,
    "secret_name" : "secret-name-demo",
    "version_stages" : [ "SYSCURRENT" ]
  }
}

状态码

错误码

请参见错误码。