gcloud edge-cache keysets create

NAME
gcloud edge-cache keysets create - create an EdgeCacheKeyset resource
SYNOPSIS
gcloud 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
Create a new EdgeCacheKeyset resource.
EXAMPLES
To create an EdgeCacheKeyset resource called 'my-keyset', run:
gcloudedge-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 edge-cache keysetscreate.

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

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 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/v1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/networking
NOTES
This variant is also available:
gcloudalphaedge-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.