gcloud alpha edge-cache services update

NAME
gcloud alpha edge-cache services update - update an EdgeCacheService resource
SYNOPSIS
gcloud alpha edge-cache services update(SERVICE :--location=LOCATION)[--async][--description=DESCRIPTION][--edge-security-policy=EDGE_SECURITY_POLICY][--edge-ssl-certificate=[EDGE_SSL_CERTIFICATE,…]][--enable-logging][--labels=[KEY=VALUE,…]][--logging-sample-rate=LOGGING_SAMPLE_RATE][--require-tls][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Update an existing EdgeCacheService resource.
EXAMPLES
To update an EdgeCacheService resource called 'my-service' run:
gcloudalphaedge-cacheservicesupdatemy-service--description="new description"
POSITIONAL ARGUMENTS
Service resource - The name of the EdgeCacheService 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 argumentservice on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

SERVICE
ID of the service or fully qualified identifier for the service.

To set theservice attribute:

  • provide the argumentservice 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 argumentservice 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.
--edge-security-policy=EDGE_SECURITY_POLICY
Resource URL that points at the Cloud Armor edge security policy that is appliedon each request against the EdgeCacheService.

Security Policies should be specified as relative resource URLs - for exampleprojects/my-project/locations/global/securityPolicies/my-policy

Note that only security policies with a type ofEDGE can beattached to an EdgeCacheService.

--edge-ssl-certificate=[EDGE_SSL_CERTIFICATE,…]
URLs to sslCertificate resources that are used to authenticate connectionsbetween users and the EdgeCacheService.

Certificates should be specified as relative resource URLs - for exampleprojects/my-project/locations/global/certificates/my-cert

Note that only "global" certificates with a "scope" ofEDGE_CACHEcan be attached to an EdgeCacheService.

You may specify up to 5 SSL certificates per Service.

--enable-logging
Specifies whether to enable logging for traffic served by this service.

Defaults to false.

--labels=[KEY=VALUE,…]
List of KEY=VALUE labels to attach to this resource.
--logging-sample-rate=LOGGING_SAMPLE_RATE
Configures the sampling rate of requests, where 1.0 means all logged requestsare reported and 0.0 means no logged requests are reported. The default value is1.0, and the value of the field must be in [0, 1].

This field can only be specified if logging is enabled for this service.

--require-tls
Require TLS (HTTPS) for all clients connecting to this service.

Clients who connect over HTTP (port 80) will receive a HTTP 301 to the same URLover HTTPS (port 443). You must have at least one (1) edgeSslCertificatespecified to enable this.

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-cacheservicesupdate

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.