- NAME
-
- gcloud beta kms keys versions create - create a new version
- SYNOPSIS
-
-
gcloud beta kms keys versions create[--ekm-connection-key-path=EKM_CONNECTION_KEY_PATH] [--external-key-uri=EXTERNAL_KEY_URI] [--key=KEY] [--keyring=KEYRING] [--location=LOCATION] [--primary] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Creates a new version within the given key. - EXAMPLES
-
The following command creates a new version within the
frodokey,fellowshipkeyring, andgloballocation and sets it as the primary version:gcloud beta kms keys versions create --location=global --keyring=fellowship --key=frodo --primaryThe following command creates a new version within the
legolaskey,fellowshipkeyring,us-central1location,https://example.kms/v0/some/key/pathas the address for its external key, and sets it as the key's primary version:gcloud beta kms keys versions create --location=us-central1 --keyring=fellowship --key=legolas --external-key-uri=https://example.kms/v0/some/key/path --primaryThe following command creates a new version within the
bilbokey,fellowshipkeyring,us-central1location,v0/some/key/pathas the ekm connection key path for its external key, and sets it as the key's primary version:gcloud beta kms keys versions create --location=us-central1 --keyring=fellowship --key=bilbo --ekm-connection-key-path=v0/some/key/path --primary - 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.
--primary-
If specified, immediately makes the new version primary. This should only be
used with the
encryptionpurpose.
- 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 helpfor details. - NOTES
-
This command is currently in beta and might change without notice. These
variants are also available:
gcloud kms keys versions creategcloud alpha kms keys versions create
gcloud beta kms keys versions create
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 2025-05-07 UTC.