Improve documentation for google_compute_backend_bucket.cdn_policy (#13765) (#22498)

[upstream:5f017350aa52a7d3502957a36766254cb5e00953]

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

google/services/compute/resource_compute_backend_bucket.go

@@ -138,23 +138,26 @@ be percent encoded and not treated as delimiters.`,
 The possible values are: USE_ORIGIN_HEADERS, FORCE_CACHE_ALL and CACHE_ALL_STATIC Possible values: ["USE_ORIGIN_HEADERS", "FORCE_CACHE_ALL", "CACHE_ALL_STATIC"]`,
 						},
 						"client_ttl": {
-							Type:        schema.TypeInt,
-							Computed:    true,
-							Optional:    true,
-							Description: `Specifies the maximum allowed TTL for cached content served by this origin.`,
+							Type:     schema.TypeInt,
+							Computed: true,
+							Optional: true,
+							Description: `Specifies the maximum allowed TTL for cached content served by this origin. When the
+'cache_mode' is set to "USE_ORIGIN_HEADERS", you must omit this field.`,
 						},
 						"default_ttl": {
 							Type:     schema.TypeInt,
 							Computed: true,
 							Optional: true,
 							Description: `Specifies the default TTL for cached content served by this origin for responses
-that do not have an existing valid TTL (max-age or s-max-age).`,
+that do not have an existing valid TTL (max-age or s-max-age). When the 'cache_mode'
+is set to "USE_ORIGIN_HEADERS", you must omit this field.`,
 						},
 						"max_ttl": {
-							Type:        schema.TypeInt,
-							Computed:    true,
-							Optional:    true,
-							Description: `Specifies the maximum allowed TTL for cached content served by this origin.`,
+							Type:     schema.TypeInt,
+							Computed: true,
+							Optional: true,
+							Description: `Specifies the maximum allowed TTL for cached content served by this origin. When the
+'cache_mode' is set to "USE_ORIGIN_HEADERS", you must omit this field.`,
 						},
 						"negative_caching": {
 							Type:        schema.TypeBool,

website/docs/r/compute_backend_bucket.html.markdown

@@ -214,15 +214,18 @@ The following arguments are supported:
 * `default_ttl` -
   (Optional)
   Specifies the default TTL for cached content served by this origin for responses
-  that do not have an existing valid TTL (max-age or s-max-age).
+  that do not have an existing valid TTL (max-age or s-max-age). When the `cache_mode`
+  is set to "USE_ORIGIN_HEADERS", you must omit this field.
 
 * `max_ttl` -
   (Optional)
-  Specifies the maximum allowed TTL for cached content served by this origin.
+  Specifies the maximum allowed TTL for cached content served by this origin. When the
+  `cache_mode` is set to "USE_ORIGIN_HEADERS", you must omit this field.
 
 * `client_ttl` -
   (Optional)
-  Specifies the maximum allowed TTL for cached content served by this origin.
+  Specifies the maximum allowed TTL for cached content served by this origin. When the
+  `cache_mode` is set to "USE_ORIGIN_HEADERS", you must omit this field.
 
 * `negative_caching` -
   (Optional)