gcloud parametermanager parameters versions create

NAME
gcloud parametermanager parameters versions create - creates an Parameter Manager parameter version
SYNOPSIS
gcloud parametermanager parameters versions create(VERSION :--location=LOCATION--parameter=PARAMETER)((--payload-data=PAYLOAD_DATA |--payload-data-from-file=PATH_TO_FILE))[--disabled][--request-id=REQUEST_ID][GCLOUD_WIDE_FLAG]
DESCRIPTION
Creates a new parameter version using the provided parameter data.
EXAMPLES
To create a parameter versionmy-parameter-version of parametermy-parameter in locationglobal run:
gcloudparametermanagerparametersversionscreatemy-parameter-version--parameter=my-parameter--location=global
POSITIONAL ARGUMENTS
Version resource - Identifier. [Output only] The resource name of theParameterVersion in the formatprojects/*/locations/*/parameters/*/versions/*. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentversion on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

VERSION
ID of the version or fully qualified identifier for the version.

To set theversion attribute:

  • provide the argumentversion on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--location=LOCATION
The location id of the version resource.

To set thelocation attribute:

  • provide the argumentversion on the command line with a fullyspecified name;
  • provide the argument--location on the command line.
--parameter=PARAMETER
The parameter id of the version resource.

To set theparameter attribute:

  • provide the argumentversion on the command line with a fullyspecified name;
  • provide the argument--parameter on the command line.
REQUIRED FLAGS
Message for storing a ParameterVersion resource's payload data

This must be specified.

Exactly one of these must be specified:
--payload-data=PAYLOAD_DATA
bytes data for storing payload.
--payload-data-from-file=PATH_TO_FILE
bytes data for storing payload. Use a full or relative path to a local filecontaining the value of payload_data.
OPTIONAL FLAGS
--disabled
Disabled boolean to determine if a ParameterVersion acts as a metadata onlyresource (payload is never returned if disabled is true). If true any calls willalways default to BASIC view even if the user explicitly passes FULL view aspart of the request. A render call on a disabled resource fails with an error.Default value is False.
--request-id=REQUEST_ID
An optional request ID to identify requests. Specify a unique request ID so thatif you must retry your request, the server will know to ignore the request if ithas already been completed. The server will guarantee that for at least 60minutes since the first request.

For example, consider a situation where you make an initial request and therequest times out. If you make the request again with the same request ID, theserver can check if original operation with the same request ID was received,and if so, will ignore the second request. This prevents clients fromaccidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is notsupported (00000000-0000-0000-0000-000000000000).

GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

API REFERENCE
This command uses theparametermanager/v1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/secret-manager/parameter-manager/docs/overview

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.