gcloud: Thu Jan 19 00:56:33 UTC 2023

2026-07-16 12:22:03 +00:00 · 2023-01-19 00:56:33 +00:00 · 2023-01-19 00:56:33 +00:00 · 1248f773ec
commit 1248f773ec
parent 348d9760ee
1462 changed files with 51835 additions and 5402 deletions
--- a/gcloud/edge-cache/keysets/create
+++ b/gcloud/edge-cache/keysets/create
@ -0,0 +1,120 @@
+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
+