gcloud alpha edge-cache keysets update

NAME
gcloud alpha edge-cache keysets update - update an EdgeCacheKeyset resource
SYNOPSIS
gcloud alpha edge-cache keysets update (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) Update an existing EdgeCacheKeyset resource.
EXAMPLES
To update an EdgeCacheKeyset resource called 'my-keyset', run:
gcloud alpha edge-cache keysets update my-keyset --public-key='id=KEYID,value=BASE64PUBLICKEY'

The update command appends keys to an existing EdgeCacheKeyset resource. To add more than one key to an EdgeCacheKeyset resource, provide multiple --public-key values:

gcloud alpha edge-cache keysets update my-keyset --public-key='id=KEYID,value=BASE64PUBLICKEY' --public-key='id=EXISTING,value=EXISTINGPUBLICKEY'

You can specify, and an EdgeCacheKeyset resource can contain, up to three (3) public keys. To delete unused public keys within an existing Keyset, use the import command to specify the EdgeCacheKeyset resource in full, omitting any unused publicKey items.

POSITIONAL ARGUMENTS
Keyset resource - The name of the EdgeCacheKeyset resource to update. The arguments 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 in other ways.

To set the project attribute:

  • provide the argument keyset on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

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

To set the keyset attribute:

  • provide the argument keyset on the command line.

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

--location=LOCATION
The location Id. To set the location attribute:
  • provide the argument keyset on the command line with a fully specified 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 a route. 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 form id=ID,value=BASE64ENCODEDPUBLICKEY.

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

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

To create a Google-managed public key with id 'bar', pass --public-key='id=foo,managed=true' to gcloud alpha edge-cache keysets update.

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 version with name projects/PROJECT/secrets/SECRET/versions/VERSION, pass --validation-shared-key='secret_version=projects/PROJECT/secrets/SECRET/versions/VERSION' to gcloud alpha edge-cache keysets update.

secret_version
The name of the secret in Secret Manager. Must be in the format projects/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 the networkservices/v1alpha1 API. The full documentation 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 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. This variant is also available:
gcloud edge-cache keysets update