Method: projects.secrets.addVersion

Creates a new SecretVersion containing secret data and attaches it to an existing Secret.

HTTP request

POST https://secretmanager.googleapis.com/v1/{parent=projects/*/secrets/*}:addVersion

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The resource name of the Secret to associate with the SecretVersion in the format projects/*/secrets/*.

Authorization requires the following IAM permission on the specified resource parent:

  • secretmanager.versions.add

Request body

The request body contains data with the following structure:

JSON representation
{
  "payload": {
    object (SecretPayload)
  }
}
Fields
payload

object (SecretPayload)

Required. The secret payload of the SecretVersion.

Response body

If successful, the response body contains an instance of SecretVersion.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.