1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-09 19:06:53 +00:00
gcloud-help/gcloud/netapp/kms-configs/update
2023-12-06 10:10:36 +00:00

154 lines
5.6 KiB
Text

NAME
gcloud netapp kms-configs update - update a Cloud NetApp Volumes KMS Config
SYNOPSIS
gcloud netapp kms-configs update (KMS_CONFIG : --location=LOCATION)
[--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]]
[--clear-labels | --remove-labels=[KEY,...]]
[--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING
--kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Updates a KMS (Key Management System) Config.
EXAMPLES
The following command updates a KMS Config instance named KMS_CONFIG with
all possible arguments:
$ gcloud netapp kms-configs update KMS_CONFIG \
--location=us-central1 --kms-location=europe-southwest1 \
--kms-project=new-kms-project --kms-keyring=kms-keyring2 \
--kms-key=crypto-key2
To update a KMS Config named KMS_CONFIG asynchronously, run the following
command:
$ gcloud netapp kms-configs update KMS_CONFIG --async \
--location=us-central1 --kms-location=europe-southwest1 \
--kms-project=new-kms-project --kms-keyring=kms-keyring2 \
--kms-key=crypto-key2
POSITIONAL ARGUMENTS
Kms config resource - The KMS Config to update 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 kms_config 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.
KMS_CONFIG
ID of the kms_config or fully qualified identifier for the
kms_config.
To set the kms_config attribute:
▸ provide the argument kms_config 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 of the kms_config.
To set the location attribute:
▸ provide the argument kms_config on the command line with a fully
specified name;
▸ provide the argument --location on the command line;
▸ set the property netapp/location.
FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
--description=DESCRIPTION
A description of the Cloud NetApp KMS Config
--update-labels=[KEY=VALUE,...]
List of label KEY=VALUE pairs to update. If a label exists, its value
is modified. Otherwise, a new label is created.
Keys must start with a lowercase character and contain only hyphens
(-), underscores (_), lowercase characters, and numbers. Values must
contain only hyphens (-), underscores (_), lowercase characters, and
numbers.
At most one of these can be specified:
--clear-labels
Remove all labels. If --update-labels is also specified then
--clear-labels is applied first.
For example, to remove all labels:
$ gcloud netapp kms-configs update --clear-labels
To remove all existing labels and create two new labels, foo and baz:
$ gcloud netapp kms-configs update --clear-labels \
--update-labels foo=bar,baz=qux
--remove-labels=[KEY,...]
List of label keys to remove. If a label does not exist it is
silently ignored. If --update-labels is also specified then
--update-labels is applied first.
Kms key resource - The Cloud KMS (Key Management Service) Crypto Key that
will be used The arguments in this group can be used to specify the
attributes of this resource.
--kms-key=KMS_KEY
ID of the kms_key or fully qualified identifier for the kms_key.
To set the kms-key attribute:
▸ provide the argument --kms-key on the command line.
This flag argument must be specified if any of the other arguments in
this group are specified.
--kms-keyring=KMS_KEYRING
The KMS keyring of the kms_key
To set the kms-keyring attribute:
▸ provide the argument --kms-key on the command line with a fully
specified name;
▸ provide the argument --kms-keyring on the command line.
--kms-location=KMS_LOCATION
The Cloud location for the kms_key.
To set the kms-location attribute:
▸ provide the argument --kms-key on the command line with a fully
specified name;
▸ provide the argument --kms-location on the command line;
▸ provide the argument --location on the command line;
▸ set the property netapp/location.
--kms-project=KMS_PROJECT
The Cloud project for the kms_key.
To set the kms-project attribute:
▸ provide the argument --kms-key on the command line with a fully
specified name;
▸ provide the argument --kms-project on the command line;
▸ set the property core/project.
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.
NOTES
This variant is also available:
$ gcloud beta netapp kms-configs update