mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 10:35:03 +00:00
123 lines
4.4 KiB
Text
123 lines
4.4 KiB
Text
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=PUBLIC_KEY]
|
|
[--validation-shared-key=VALIDATION_SHARED_KEY] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
Create a new EdgeCacheKeyset resource.
|
|
|
|
EXAMPLES
|
|
To create an EdgeCacheKeyset resource called 'my-keyset', run:
|
|
|
|
$ gcloud edge-cache keysets create my-keyset \
|
|
--public-key='id=KEYID,value=BASE64PUBLICKEY'
|
|
|
|
POSITIONAL ARGUMENTS
|
|
Keyset resource - The name of the EdgeCacheKeyset resource to create. 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;
|
|
◆ set the property core/project;
|
|
◆ provide the argument --project on the command line.
|
|
|
|
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=PUBLIC_KEY
|
|
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 edge-cache keysets create.
|
|
|
|
To create a Google-managed public key with id 'bar', pass
|
|
--public-key='id=foo,managed=true' to gcloud edge-cache keysets create.
|
|
|
|
At least one of public-key or validation-shared-key must be specified.
|
|
|
|
--validation-shared-key=VALIDATION_SHARED_KEY
|
|
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 edge-cache keysets create.
|
|
|
|
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/v1 API. The full documentation for
|
|
this API can be found at: https://cloud.google.com/networking
|
|
|
|
NOTES
|
|
This variant is also available:
|
|
|
|
$ gcloud alpha edge-cache keysets create
|
|
|