1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/kms/keys/versions/create

75 lines
2.5 KiB
Text
Raw Normal View History

2022-03-01 04:29:52 +00:00
NAME
gcloud kms keys versions create - create a new version
SYNOPSIS
gcloud 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
Creates a new version within the given key.
EXAMPLES
The following command creates a new version within the frodo key,
fellowship keyring, and global location and sets it as the primary version:
$ gcloud kms keys versions create --location=global \
2022-03-01 21:43:54 +00:00
--keyring=fellowship --key=frodo --primary
2022-03-01 04:29:52 +00:00
The following command creates a new version within the legolas key,
fellowship keyring, us-central1 location,
https://example.kms/v0/some/key/path as the address for its external key,
and sets it as the key's primary version:
$ gcloud kms keys versions create --location=us-central1 \
2022-03-01 21:43:54 +00:00
--keyring=fellowship --key=legolas \
2022-03-01 04:29:52 +00:00
--external-key-uri=https://example.kms/v0/some/key/path \
--primary
The following command creates a new version within the bilbo key,
fellowship keyring, us-central1 location, v0/some/key/path as the ekm
connection key path for its external key, and sets it as the key's primary
version:
$ gcloud kms keys versions create --location=us-central1 \
2022-03-01 21:43:54 +00:00
--keyring=fellowship --key=bilbo \
--ekm-connection-key-path=v0/some/key/path --primary
2022-03-01 04:29:52 +00:00
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
2023-07-26 10:48:49 +00:00
If specified, immediately makes the new version primary. This should
only be used with the encryption purpose.
2022-03-01 04:29:52 +00:00
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
These variants are also available:
$ gcloud alpha kms keys versions create
$ gcloud beta kms keys versions create