- NAME
-
- gcloud alpha kms keys versions update - update a key version
- SYNOPSIS
-
-
gcloud alpha kms keys versions update
VERSION
[--ekm-connection-key-path
=EKM_CONNECTION_KEY_PATH
] [--external-key-uri
=EXTERNAL_KEY_URI
] [--key
=KEY
] [--keyring
=KEYRING
] [--location
=LOCATION
] [--state
=STATE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
gcloud alpha kms keys versions update can be used to update the key versions. Updates can be made to the the key versions's state (enabling or disabling it), to its external key URI (if the key version has protection level EXTERNAL), or to its ekm connection key path (if the key version has protection level EXTERNAL_VPC). - EXAMPLES
-
The following command enables the key version 8 of key
frodo
within keyringfellowship
and locationus-east1
:gcloud alpha kms keys versions update 8 --location=us-east1 --keyring=fellowship --key=frodo --state=enabled
The following command disables the key version 8 of key
frodo
within keyringfellowship
and locationus-east1
:gcloud alpha kms keys versions update 8 --location=us-east1 --keyring=fellowship --key=frodo --state=disabled
The following command updates the external key URI of version 8 of key
frodo
within keyringfellowship
and locationus-east1
:gcloud alpha kms keys versions update 8 --location=us-east1 --keyring=fellowship --key=frodo --external-key-uri=https://example.kms/v0/some/key/path
The following command updates the ekm connection key path of version 8 of key
bilbo
within keyringfellowship
and locationus-east1
:gcloud alpha kms keys versions update 8 --location=us-east1 --keyring=fellowship --key=bilbo --ekm-connection-key-path=v0/some/key/path
- POSITIONAL ARGUMENTS
-
VERSION
- Name of the version to describe.
- FLAGS
-
--ekm-connection-key-path
=EKM_CONNECTION_KEY_PATH
- The path to the external key material on the EKM for keys with protection level "external-vpc".
--external-key-uri
=EXTERNAL_KEY_URI
- The URI of the external key for keys with protection level "external".
--key
=KEY
- The containing key.
--keyring
=KEYRING
- Key ring of the key.
--location
=LOCATION
- Location of the keyring.
--state
=STATE
- State of the key version.
- 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 command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud kms keys versions update
gcloud beta kms keys versions update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-06 UTC.