1414
1515// Generated by the disco-to-proto3-converter. DO NOT EDIT!
1616// Source Discovery file: compute.v1beta.json
17- // Source file revision: 20260331
17+ // Source file revision: 20260410
1818// API name: compute
1919// API version: v1beta
2020
@@ -13501,8 +13501,8 @@ message CacheKeyPolicy {
1350113501
1350213502// Message containing CachePolicy configuration for URL Map's Route Action.
1350313503message CachePolicy {
13504- // Specifies the cache setting for all responses from this route.
13505- // If not specified, the default value is CACHE_ALL_STATIC.
13504+ // Specifies the cache setting for all responses from this route. If not
13505+ // specified, Cloud CDN uses ` CACHE_ALL_STATIC` mode .
1350613506 enum CacheMode {
1350713507 // A value indicating that the enum field is not set.
1350813508 UNDEFINED_CACHE_MODE = 0;
@@ -13529,84 +13529,91 @@ message CachePolicy {
1352913529
1353013530 // Bypass the cache when the specified request headers are matched by name,
1353113531 // e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13532- // header names can be specified. The cache is bypassed for all
13533- // cachePolicy.cacheMode settings .
13532+ // header names can be specified. The cache is bypassed for all `cacheMode`
13533+ // values .
1353413534 repeated string cache_bypass_request_header_names = 197581440;
1353513535
13536- // The CacheKeyPolicy for this CachePolicy.
13536+ // The cache key configuration. If not specified, the default behavior depends
13537+ // on the backend type: for Backend Services, the complete request URI is
13538+ // used; for Backend Buckets, the request URI is used without the protocol or
13539+ // host, and only query parameters known to Cloud Storage are included.
1353713540 optional CachePolicyCacheKeyPolicy cache_key_policy = 159263727;
1353813541
13539- // Specifies the cache setting for all responses from this route.
13540- // If not specified, the default value is CACHE_ALL_STATIC.
13542+ // Specifies the cache setting for all responses from this route. If not
13543+ // specified, Cloud CDN uses ` CACHE_ALL_STATIC` mode .
1354113544 // Check the CacheMode enum for the list of possible values.
1354213545 optional string cache_mode = 28877888;
1354313546
13544- // Specifies a separate client (e.g. browser client) maximum TTL. This is
13545- // used to clamp the max-age (or Expires) value sent to the client. With
13546- // FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the
13547- // response max-age directive, along with a "public" directive. For
13548- // cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age
13549- // from the origin (if specified), or else sets the response max-age
13550- // directive to the lesser of the client_ttl and default_ttl, and also
13551- // ensures a "public" cache-control directive is present.
13552- // If a client TTL is not specified, a default value (1 hour) will be used.
13553- // The maximum allowed value is 31,622,400s (1 year).
13547+ // Specifies a separate client (e.g. browser client) maximum TTL for cached
13548+ // content. This is used to clamp the max-age (or Expires) value sent to the
13549+ // client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13550+ // is used for the response max-age directive, along with a "public"
13551+ // directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13552+ // clamps the max-age from the origin (if specified), or else sets the
13553+ // response max-age directive to the lesser of the `clientTtl` and
13554+ // `defaultTtl`, and also ensures a "public" cache-control directive is
13555+ // present. The maximum allowed value is 31,622,400s (1 year). If not
13556+ // specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13557+ // Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13558+ // `USE_ORIGIN_HEADERS`.
1355413559 optional Duration client_ttl = 29034360;
1355513560
13556- // Specifies the default TTL for cached content served by this origin for
13557- // responses that do not have an existing valid TTL (max-age or s-maxage).
13558- // Setting a TTL of "0" means "always revalidate".
13559- // The value of defaultTTL cannot be set to a value greater than that of
13560- // maxTTL.
13561- // When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL
13562- // will overwrite the TTL set in all responses. The maximum allowed value is
13563- // 31,622,400s (1 year). Infrequently accessed objects may be evicted from
13564- // the cache before the defined TTL.
13561+ // Specifies the default TTL for cached content for responses that do not have
13562+ // an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
13563+ // "always revalidate". The value of `defaultTtl` cannot be set to a value
13564+ // greater than that of `maxTtl`. When the `cacheMode` is set to
13565+ // `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13566+ // responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13567+ // accessed objects may be evicted from the cache before the defined TTL. If
13568+ // not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13569+ // `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13570+ // `USE_ORIGIN_HEADERS`.
1356513571 optional Duration default_ttl = 100253422;
1356613572
13567- // Specifies the maximum allowed TTL for cached content served by this
13568- // origin.
13569- // Cache directives that attempt to set a max-age or s-maxage higher than
13570- // this, or an Expires header more than maxTTL seconds in the future will
13571- // be capped at the value of maxTTL, as if it were the value of an
13572- // s-maxage Cache-Control directive .
13573- // Headers sent to the client will not be modified.
13574- // Setting a TTL of "0" means "always revalidate".
13575- // The maximum allowed value is 31,622,400s (1 year). Infrequently accessed
13576- // objects may be evicted from the cache before the defined TTL .
13573+ // Specifies the maximum allowed TTL for cached content. Cache directives that
13574+ // attempt to set a max-age or s-maxage higher than this, or an Expires header
13575+ // more than `maxTtl` seconds in the future will be capped at the value of
13576+ // `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13577+ // Headers sent to the client will not be modified. Setting a TTL of "0" means
13578+ // "always revalidate". The maximum allowed value is 31,622,400s (1 year) .
13579+ // Infrequently accessed objects may be evicted from the cache before the
13580+ // defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13581+ // `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13582+ // mode .
1357713583 optional Duration max_ttl = 307578001;
1357813584
1357913585 // Negative caching allows per-status code TTLs to be set, in order
1358013586 // to apply fine-grained caching for common errors or redirects.
1358113587 // This can reduce the load on your origin and improve end-user
1358213588 // experience by reducing response latency.
13583- // When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS,
13584- // negative caching applies to responses with the specified response code
13585- // that lack any Cache-Control, Expires, or Pragma: no-cache directives.
13586- // When the cache mode is set to FORCE_CACHE_ALL, negative caching applies
13587- // to all responses with the specified response code, and override any
13588- // caching headers.
13589- // By default, Cloud CDN will apply the following default TTLs to these
13590- // status codes:
13591- // HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13592- // HTTP 404 (Not Found), 410 (Gone),
13593- // 451 (Unavailable For Legal Reasons): 120s
13594- // HTTP 405 (Method Not Found), 501 (Not Implemented): 60s.
13595- // These defaults can be overridden in negative_caching_policy.
13589+ // When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13590+ // `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13591+ // the specified response code that lack any Cache-Control, Expires, or
13592+ // Pragma: no-cache directives. When the `cacheMode` is set to
13593+ // `FORCE_CACHE_ALL`, negative caching applies to all responses
13594+ // with the specified response code, and overrides any caching headers. By
13595+ // default, Cloud CDN applies the following TTLs to these HTTP status codes:
13596+ //
13597+ // * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13598+ // * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13599+ // * 405 (Method Not Found), 501 (Not Implemented): 60s
13600+ //
13601+ // These defaults can be overridden in `negativeCachingPolicy`.
13602+ // If not specified, Cloud CDN applies negative caching by default.
1359613603 optional bool negative_caching = 336110005;
1359713604
1359813605 // Sets a cache TTL for the specified HTTP status code.
13599- // negative_caching must be enabled to configure negative_caching_policy.
13600- // Omitting the policy and leaving negative_caching enabled will use
13601- // Cloud CDN's default cache TTLs.
13602- // Note that when specifying an explicit negative_caching_policy, you
13603- // should take care to specify a cache TTL for all response codes
13604- // that you wish to cache. Cloud CDN will not apply any default
13605- // negative caching when a policy exists.
13606+ // `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13607+ // Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13608+ // CDN's default cache TTLs. Note that when specifying an explicit
13609+ // `negativeCachingPolicy`, you should take care to specify a cache TTL for
13610+ // all response codes that you wish to cache. Cloud CDN will not apply any
13611+ // default negative caching when a policy exists.
1360613612 repeated CachePolicyNegativeCachingPolicy negative_caching_policy = 155359996;
1360713613
1360813614 // If true then Cloud CDN will combine multiple concurrent cache fill
13609- // requests into a small number of requests to the origin.
13615+ // requests into a small number of requests to the origin. If not specified,
13616+ // Cloud CDN applies request coalescing by default.
1361013617 optional bool request_coalescing = 532808276;
1361113618
1361213619 // Serve existing content from the cache (if available) when revalidating
@@ -13628,15 +13635,15 @@ message CachePolicy {
1362813635// Policy defined on Route Action.
1362913636message CachePolicyCacheKeyPolicy {
1363013637 // Names of query string parameters to exclude in cache keys. All other
13631- // parameters will be included. Either specify excluded_query_parameters or
13632- // included_query_parameters , not both. '&' and '=' will be percent encoded
13633- // and not treated as delimiters.
13638+ // parameters will be included. Either specify `excludedQueryParameters`
13639+ // or `includedQueryParameters` , not both. '&' and '=' will be percent
13640+ // encoded and not treated as delimiters.
1363413641 //
1363513642 // Note: This field applies to routes that use backend services. Attempting
1363613643 // to set it on a route that points exclusively to Backend Buckets will
1363713644 // result in a configuration error. For routes that point to a Backend
13638- // Bucket, use includedQueryParameters to define which parameters should
13639- // be a part of the cache key.
13645+ // Bucket, use ` includedQueryParameters` to define which parameters should
13646+ // be part of the cache key.
1364013647 repeated string excluded_query_parameters = 124896150;
1364113648
1364213649 // If true, requests to different hosts will be cached separately.
@@ -13658,15 +13665,15 @@ message CachePolicyCacheKeyPolicy {
1365813665 optional bool include_protocol = 303507535;
1365913666
1366013667 // If true, include query string parameters in the cache key according to
13661- // included_query_parameters and excluded_query_parameters . If neither is
13662- // set, the entire query string will be included. If false, the query string
13663- // will be excluded from the cache key entirely.
13668+ // `includedQueryParameters` and `excludedQueryParameters` . If neither
13669+ // is set, the entire query string will be included. If false, the query
13670+ // string will be excluded from the cache key entirely.
1366413671 //
1366513672 // Note: This field applies to routes that use backend services. Attempting
1366613673 // to set it on a route that points exclusively to Backend Buckets will
13667- // result in a configuration error. For routes that point to a Backend
13668- // Bucket, use includedQueryParameters to define which parameters should
13669- // be a part of the cache key.
13674+ // result in a configuration error. For routes that point to a Backend
13675+ // Bucket, use ` includedQueryParameters` to define which parameters should
13676+ // be part of the cache key.
1367013677 optional bool include_query_string = 474036639;
1367113678
1367213679 // Allows HTTP cookies (by name) to be used in the cache key.
@@ -13683,9 +13690,9 @@ message CachePolicyCacheKeyPolicy {
1368313690 repeated string included_header_names = 533756345;
1368413691
1368513692 // Names of query string parameters to include in cache keys. All other
13686- // parameters will be excluded. Either specify included_query_parameters or
13687- // excluded_query_parameters , not both. '&' and '=' will be percent encoded
13688- // and not treated as delimiters.
13693+ // parameters will be excluded. Either specify `includedQueryParameters`
13694+ // or `excludedQueryParameters` , not both. '&' and '=' will be percent
13695+ // encoded and not treated as delimiters.
1368913696 repeated string included_query_parameters = 2319076;
1369013697
1369113698}
@@ -28682,8 +28689,10 @@ message HttpRetryPolicy {
2868228689
2868328690//
2868428691message HttpRouteAction {
28685- // Cache policy for this URL Map’s route. Available only for Global
28686- // EXTERNAL_MANAGED load balancer schemes.
28692+ // Specifies the cache policy configuration for matched traffic. Available
28693+ // only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
28694+ // property must be specified. This policy cannot be specified if any target
28695+ // backend has Identity-Aware Proxy enabled.
2868728696 optional CachePolicy cache_policy = 457366671;
2868828697
2868928698 // The specification for allowing client-side cross-origin requests. For more
0 commit comments