1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-09 19:06:53 +00:00
gcloud-help/gcloud/parametermanager/parameters/versions/create
2025-04-02 10:41:45 +00:00

110 lines
4.4 KiB
Text

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 version my-parameter-version of parameter
my-parameter in location global run:
$ gcloud parametermanager parameters versions create \
my-parameter-version --parameter=my-parameter --location=global
POSITIONAL ARGUMENTS
Version resource - Identifier. [Output only] The resource name of the
ParameterVersion in the format
projects/*/locations/*/parameters/*/versions/*. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other
ways.
To set the project attribute:
◆ provide the argument version on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
VERSION
ID of the version or fully qualified identifier for the version.
To set the version attribute:
▸ provide the argument version on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--location=LOCATION
The location id of the version resource.
To set the location attribute:
▸ provide the argument version on the command line with a fully
specified name;
▸ provide the argument --location on the command line.
--parameter=PARAMETER
The parameter id of the version resource.
To set the parameter attribute:
▸ provide the argument version on the command line with a fully
specified 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 file containing the value of payload_data.
OPTIONAL FLAGS
--disabled
Disabled boolean to determine if a ParameterVersion acts as a metadata
only resource (payload is never returned if disabled is true). If true
any calls will always default to BASIC view even if the user explicitly
passes FULL view as part 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 that if you must retry your request, the server will know to
ignore the request if it has already been completed. The server will
guarantee that for at least 60 minutes since the first request.
For example, consider a situation where you make an initial request and
the request times out. If you make the request again with the same
request ID, the server can check if original operation with the same
request ID was received, and if so, will ignore the second request.
This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID
is not supported (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 the parametermanager/v1 API. The full documentation for
this API can be found at:
https://cloud.google.com/secret-manager/parameter-manager/docs/overview