gcloud alpha edge-cache keysets create

NAME
gcloud alpha edge-cache keysets create - create an EdgeCacheKeyset resource
SYNOPSIS
gcloud alpha edge-cache keysets create(KEYSET :--location=LOCATION)[--async][--description=DESCRIPTION][--labels=[KEY=VALUE,…]][--public-key=[id=ID],[managed=MANAGED],[value=VALUE]][--validation-shared-key=[secret_version=SECRET_VERSION]][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Create a new EdgeCacheKeyset resource.
EXAMPLES
To create an EdgeCacheKeyset resource called 'my-keyset', run:
gcloudalphaedge-cachekeysetscreatemy-keyset--public-key='id=KEYID,value=BASE64PUBLICKEY'
POSITIONAL ARGUMENTS
Keyset resource - The name of the EdgeCacheKeyset resource to create. Thearguments 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 inother ways.

To set theproject attribute:

  • provide the argumentkeyset on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

KEYSET
ID of the keyset or fully qualified identifier for the keyset.

To set thekeyset attribute:

  • provide the argumentkeyset on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--location=LOCATION
The location Id.To set thelocation attribute:
  • provide the argumentkeyset on the command line with a fullyspecified name;
  • provide the argument--location on the command line;
  • use global location.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION
Human-readable description of the resource.
--labels=[KEY=VALUE,…]
List of KEY=VALUE labels to attach to this resource.
--public-key=[id=ID],[managed=MANAGED],[value=VALUE]
Set of public keys to use for validating signed requests, when associated with aroute. This flag can be repeated to create a Keyset with multiple public keys.

If you are providing your own public keys, specify the key in the formid=ID,value=BASE64ENCODEDPUBLICKEY.

If you are using Google-managed public keys as part of a dual-token setup,specify the key in the formid=ID,managed=true.

id
id (name) name of the key within the keyset.
value
URL-safe base64 encoded public key. Cannot be specified ifmanaged=true.
managed
Boolean indicating this is a Google-managed key. Cannot be specified ifvalue=true.
To create a public key withid 'foo', pass--public-key='id=foo,value=VALUE' to gcloud alpha edge-cachekeysets create.

To create a Google-managed public key withid 'bar', pass--public-key='id=foo,managed=true' to gcloud alpha edge-cachekeysets create.

At least one of public-key or validation-shared-key must be specified.

--validation-shared-key=[secret_version=SECRET_VERSION]
An ordered list of shared keys to use for validating signed requests.

To create a validation shared key pointing to a Secret Manager secret versionwith nameprojects/PROJECT/secrets/SECRET/versions/VERSION, pass--validation-shared-key='secret_version=projects/PROJECT/secrets/SECRET/versions/VERSION'to gcloud alpha edge-cache keysets create.

secret_version
The name of the secret in Secret Manager. Must be in the formatprojects/PROJECT/secrets/SECRET/versions/VERSION.
At least one of public-key or validation-shared-key must be specified.
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 thenetworkservices/v1alpha1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/networking
NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. This variant is also available:
gcloudedge-cachekeysetscreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.