CachePolicy.php

<?php
# Generated by the protocol buffer compiler.  DO NOT EDIT!
# source: google/cloud/compute/v1/compute.proto

namespace Google\Cloud\Compute\V1;

use Google\Protobuf\Internal\GPBType;
use Google\Protobuf\Internal\GPBUtil;
use Google\Protobuf\RepeatedField;

/**
 * Message containing CachePolicy configuration for URL Map's Route Action.
 *
 * Generated from protobuf message <code>google.cloud.compute.v1.CachePolicy</code>
 */
class CachePolicy extends \Google\Protobuf\Internal\Message
{
    /**
     * Bypass the cache when the specified request headers are matched by name,
     * e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
     * header names can be specified. The cache is bypassed for all `cacheMode`
     * values.
     *
     * Generated from protobuf field <code>repeated string cache_bypass_request_header_names = 197581440;</code>
     */
    private $cache_bypass_request_header_names;
    /**
     * The cache key configuration. If not specified, the default behavior depends
     * on the backend type: for Backend Services, the complete request URI is
     * used; for Backend Buckets, the request URI is used without the protocol or
     * host, and only query parameters known to Cloud Storage are included.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.CachePolicyCacheKeyPolicy cache_key_policy = 159263727;</code>
     */
    protected $cache_key_policy = null;
    /**
     * Specifies the cache setting for all responses from this route. If not
     * specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
     * Check the CacheMode enum for the list of possible values.
     *
     * Generated from protobuf field <code>optional string cache_mode = 28877888;</code>
     */
    protected $cache_mode = null;
    /**
     * Specifies a separate client (e.g. browser client) maximum TTL for cached
     * content. This is used to clamp the max-age (or Expires) value sent to the
     * client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
     * is used for the response max-age directive, along with a "public"
     * directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
     * clamps the max-age from the origin (if specified), or else sets the
     * response max-age directive to the lesser of the `clientTtl` and
     * `defaultTtl`, and also ensures a "public" cache-control directive is
     * present. The maximum allowed value is 31,622,400s (1 year). If not
     * specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
     * Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
     * `USE_ORIGIN_HEADERS`.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration client_ttl = 29034360;</code>
     */
    protected $client_ttl = null;
    /**
     * Specifies the default TTL for cached content for responses that do not have
     * an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
     * "always revalidate". The value of `defaultTtl` cannot be set to a value
     * greater than that of `maxTtl`. When the `cacheMode` is set to
     * `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
     * responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
     * accessed objects may be evicted from the cache before the defined TTL. If
     * not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
     * `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
     * `USE_ORIGIN_HEADERS`.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration default_ttl = 100253422;</code>
     */
    protected $default_ttl = null;
    /**
     * Specifies the maximum allowed TTL for cached content. Cache directives that
     * attempt to set a max-age or s-maxage higher than this, or an Expires header
     * more than `maxTtl` seconds in the future will be capped at the value of
     * `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
     * Headers sent to the client will not be modified. Setting a TTL of "0" means
     * "always revalidate". The maximum allowed value is 31,622,400s (1 year).
     * Infrequently accessed objects may be evicted from the cache before the
     * defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
     * `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
     * mode.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration max_ttl = 307578001;</code>
     */
    protected $max_ttl = null;
    /**
     * Negative caching allows per-status code TTLs to be set, in order
     * to apply fine-grained caching for common errors or redirects.
     * This can reduce the load on your origin and improve end-user
     * experience by reducing response latency.
     * When the `cacheMode` is set to `CACHE_ALL_STATIC` or
     * `USE_ORIGIN_HEADERS`, negative caching applies to responses with
     * the specified response code that lack any Cache-Control, Expires, or
     * Pragma: no-cache directives. When the `cacheMode` is set to
     * `FORCE_CACHE_ALL`, negative caching applies to all responses
     * with the specified response code, and overrides any caching headers. By
     * default, Cloud CDN applies the following TTLs to these HTTP status codes:
     * * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
     * * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
     * * 405 (Method Not Found), 501 (Not Implemented): 60s
     * These defaults can be overridden in `negativeCachingPolicy`.
     * If not specified, Cloud CDN applies negative caching by default.
     *
     * Generated from protobuf field <code>optional bool negative_caching = 336110005;</code>
     */
    protected $negative_caching = null;
    /**
     * Sets a cache TTL for the specified HTTP status code.
     * `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
     * Omitting the policy and leaving `negativeCaching` enabled will use Cloud
     * CDN's default cache TTLs. Note that when specifying an explicit
     * `negativeCachingPolicy`, you should take care to specify a cache TTL for
     * all response codes that you wish to cache. Cloud CDN will not apply any
     * default negative caching when a policy exists.
     *
     * Generated from protobuf field <code>repeated .google.cloud.compute.v1.CachePolicyNegativeCachingPolicy negative_caching_policy = 155359996;</code>
     */
    private $negative_caching_policy;
    /**
     * If true then Cloud CDN will combine multiple concurrent cache fill
     * requests into a small number of requests to the origin. If not specified,
     * Cloud CDN applies request coalescing by default.
     *
     * Generated from protobuf field <code>optional bool request_coalescing = 532808276;</code>
     */
    protected $request_coalescing = null;
    /**
     * Serve existing content from the cache (if available) when revalidating
     * content with the origin, or when an error is encountered when refreshing
     * the cache.
     * This setting defines the default "max-stale" duration for any cached
     * responses that do not specify a max-stale directive. Stale responses that
     * exceed the TTL configured here will not be served. The default limit
     * (max-stale) is 86400s (1 day), which will allow stale content to be
     * served up to this limit beyond the max-age (or s-maxage) of a cached
     * response.
     * The maximum allowed value is 604800 (1 week).
     * Set this to zero (0) to disable serve-while-stale.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration serve_while_stale = 236682203;</code>
     */
    protected $serve_while_stale = null;

    /**
     * Constructor.
     *
     * @param array $data {
     *     Optional. Data for populating the Message object.
     *
     *     @type string[] $cache_bypass_request_header_names
     *           Bypass the cache when the specified request headers are matched by name,
     *           e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
     *           header names can be specified. The cache is bypassed for all `cacheMode`
     *           values.
     *     @type \Google\Cloud\Compute\V1\CachePolicyCacheKeyPolicy $cache_key_policy
     *           The cache key configuration. If not specified, the default behavior depends
     *           on the backend type: for Backend Services, the complete request URI is
     *           used; for Backend Buckets, the request URI is used without the protocol or
     *           host, and only query parameters known to Cloud Storage are included.
     *     @type string $cache_mode
     *           Specifies the cache setting for all responses from this route. If not
     *           specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
     *           Check the CacheMode enum for the list of possible values.
     *     @type \Google\Cloud\Compute\V1\Duration $client_ttl
     *           Specifies a separate client (e.g. browser client) maximum TTL for cached
     *           content. This is used to clamp the max-age (or Expires) value sent to the
     *           client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
     *           is used for the response max-age directive, along with a "public"
     *           directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
     *           clamps the max-age from the origin (if specified), or else sets the
     *           response max-age directive to the lesser of the `clientTtl` and
     *           `defaultTtl`, and also ensures a "public" cache-control directive is
     *           present. The maximum allowed value is 31,622,400s (1 year). If not
     *           specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
     *           Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
     *           `USE_ORIGIN_HEADERS`.
     *     @type \Google\Cloud\Compute\V1\Duration $default_ttl
     *           Specifies the default TTL for cached content for responses that do not have
     *           an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
     *           "always revalidate". The value of `defaultTtl` cannot be set to a value
     *           greater than that of `maxTtl`. When the `cacheMode` is set to
     *           `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
     *           responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
     *           accessed objects may be evicted from the cache before the defined TTL. If
     *           not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
     *           `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
     *           `USE_ORIGIN_HEADERS`.
     *     @type \Google\Cloud\Compute\V1\Duration $max_ttl
     *           Specifies the maximum allowed TTL for cached content. Cache directives that
     *           attempt to set a max-age or s-maxage higher than this, or an Expires header
     *           more than `maxTtl` seconds in the future will be capped at the value of
     *           `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
     *           Headers sent to the client will not be modified. Setting a TTL of "0" means
     *           "always revalidate". The maximum allowed value is 31,622,400s (1 year).
     *           Infrequently accessed objects may be evicted from the cache before the
     *           defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
     *           `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
     *           mode.
     *     @type bool $negative_caching
     *           Negative caching allows per-status code TTLs to be set, in order
     *           to apply fine-grained caching for common errors or redirects.
     *           This can reduce the load on your origin and improve end-user
     *           experience by reducing response latency.
     *           When the `cacheMode` is set to `CACHE_ALL_STATIC` or
     *           `USE_ORIGIN_HEADERS`, negative caching applies to responses with
     *           the specified response code that lack any Cache-Control, Expires, or
     *           Pragma: no-cache directives. When the `cacheMode` is set to
     *           `FORCE_CACHE_ALL`, negative caching applies to all responses
     *           with the specified response code, and overrides any caching headers. By
     *           default, Cloud CDN applies the following TTLs to these HTTP status codes:
     *           * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
     *           * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
     *           * 405 (Method Not Found), 501 (Not Implemented): 60s
     *           These defaults can be overridden in `negativeCachingPolicy`.
     *           If not specified, Cloud CDN applies negative caching by default.
     *     @type \Google\Cloud\Compute\V1\CachePolicyNegativeCachingPolicy[] $negative_caching_policy
     *           Sets a cache TTL for the specified HTTP status code.
     *           `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
     *           Omitting the policy and leaving `negativeCaching` enabled will use Cloud
     *           CDN's default cache TTLs. Note that when specifying an explicit
     *           `negativeCachingPolicy`, you should take care to specify a cache TTL for
     *           all response codes that you wish to cache. Cloud CDN will not apply any
     *           default negative caching when a policy exists.
     *     @type bool $request_coalescing
     *           If true then Cloud CDN will combine multiple concurrent cache fill
     *           requests into a small number of requests to the origin. If not specified,
     *           Cloud CDN applies request coalescing by default.
     *     @type \Google\Cloud\Compute\V1\Duration $serve_while_stale
     *           Serve existing content from the cache (if available) when revalidating
     *           content with the origin, or when an error is encountered when refreshing
     *           the cache.
     *           This setting defines the default "max-stale" duration for any cached
     *           responses that do not specify a max-stale directive. Stale responses that
     *           exceed the TTL configured here will not be served. The default limit
     *           (max-stale) is 86400s (1 day), which will allow stale content to be
     *           served up to this limit beyond the max-age (or s-maxage) of a cached
     *           response.
     *           The maximum allowed value is 604800 (1 week).
     *           Set this to zero (0) to disable serve-while-stale.
     * }
     */
    public function __construct($data = NULL) {
        \GPBMetadata\Google\Cloud\Compute\V1\Compute::initOnce();
        parent::__construct($data);
    }

    /**
     * Bypass the cache when the specified request headers are matched by name,
     * e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
     * header names can be specified. The cache is bypassed for all `cacheMode`
     * values.
     *
     * Generated from protobuf field <code>repeated string cache_bypass_request_header_names = 197581440;</code>
     * @return RepeatedField<string>
     */
    public function getCacheBypassRequestHeaderNames()
    {
        return $this->cache_bypass_request_header_names;
    }

    /**
     * Bypass the cache when the specified request headers are matched by name,
     * e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
     * header names can be specified. The cache is bypassed for all `cacheMode`
     * values.
     *
     * Generated from protobuf field <code>repeated string cache_bypass_request_header_names = 197581440;</code>
     * @param string[] $var
     * @return $this
     */
    public function setCacheBypassRequestHeaderNames($var)
    {
        $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::STRING);
        $this->cache_bypass_request_header_names = $arr;

        return $this;
    }

    /**
     * The cache key configuration. If not specified, the default behavior depends
     * on the backend type: for Backend Services, the complete request URI is
     * used; for Backend Buckets, the request URI is used without the protocol or
     * host, and only query parameters known to Cloud Storage are included.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.CachePolicyCacheKeyPolicy cache_key_policy = 159263727;</code>
     * @return \Google\Cloud\Compute\V1\CachePolicyCacheKeyPolicy|null
     */
    public function getCacheKeyPolicy()
    {
        return $this->cache_key_policy;
    }

    public function hasCacheKeyPolicy()
    {
        return isset($this->cache_key_policy);
    }

    public function clearCacheKeyPolicy()
    {
        unset($this->cache_key_policy);
    }

    /**
     * The cache key configuration. If not specified, the default behavior depends
     * on the backend type: for Backend Services, the complete request URI is
     * used; for Backend Buckets, the request URI is used without the protocol or
     * host, and only query parameters known to Cloud Storage are included.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.CachePolicyCacheKeyPolicy cache_key_policy = 159263727;</code>
     * @param \Google\Cloud\Compute\V1\CachePolicyCacheKeyPolicy $var
     * @return $this
     */
    public function setCacheKeyPolicy($var)
    {
        GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\CachePolicyCacheKeyPolicy::class);
        $this->cache_key_policy = $var;

        return $this;
    }

    /**
     * Specifies the cache setting for all responses from this route. If not
     * specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
     * Check the CacheMode enum for the list of possible values.
     *
     * Generated from protobuf field <code>optional string cache_mode = 28877888;</code>
     * @return string
     */
    public function getCacheMode()
    {
        return isset($this->cache_mode) ? $this->cache_mode : '';
    }

    public function hasCacheMode()
    {
        return isset($this->cache_mode);
    }

    public function clearCacheMode()
    {
        unset($this->cache_mode);
    }

    /**
     * Specifies the cache setting for all responses from this route. If not
     * specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
     * Check the CacheMode enum for the list of possible values.
     *
     * Generated from protobuf field <code>optional string cache_mode = 28877888;</code>
     * @param string $var
     * @return $this
     */
    public function setCacheMode($var)
    {
        GPBUtil::checkString($var, True);
        $this->cache_mode = $var;

        return $this;
    }

    /**
     * Specifies a separate client (e.g. browser client) maximum TTL for cached
     * content. This is used to clamp the max-age (or Expires) value sent to the
     * client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
     * is used for the response max-age directive, along with a "public"
     * directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
     * clamps the max-age from the origin (if specified), or else sets the
     * response max-age directive to the lesser of the `clientTtl` and
     * `defaultTtl`, and also ensures a "public" cache-control directive is
     * present. The maximum allowed value is 31,622,400s (1 year). If not
     * specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
     * Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
     * `USE_ORIGIN_HEADERS`.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration client_ttl = 29034360;</code>
     * @return \Google\Cloud\Compute\V1\Duration|null
     */
    public function getClientTtl()
    {
        return $this->client_ttl;
    }

    public function hasClientTtl()
    {
        return isset($this->client_ttl);
    }

    public function clearClientTtl()
    {
        unset($this->client_ttl);
    }

    /**
     * Specifies a separate client (e.g. browser client) maximum TTL for cached
     * content. This is used to clamp the max-age (or Expires) value sent to the
     * client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
     * is used for the response max-age directive, along with a "public"
     * directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
     * clamps the max-age from the origin (if specified), or else sets the
     * response max-age directive to the lesser of the `clientTtl` and
     * `defaultTtl`, and also ensures a "public" cache-control directive is
     * present. The maximum allowed value is 31,622,400s (1 year). If not
     * specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
     * Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
     * `USE_ORIGIN_HEADERS`.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration client_ttl = 29034360;</code>
     * @param \Google\Cloud\Compute\V1\Duration $var
     * @return $this
     */
    public function setClientTtl($var)
    {
        GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Duration::class);
        $this->client_ttl = $var;

        return $this;
    }

    /**
     * Specifies the default TTL for cached content for responses that do not have
     * an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
     * "always revalidate". The value of `defaultTtl` cannot be set to a value
     * greater than that of `maxTtl`. When the `cacheMode` is set to
     * `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
     * responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
     * accessed objects may be evicted from the cache before the defined TTL. If
     * not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
     * `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
     * `USE_ORIGIN_HEADERS`.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration default_ttl = 100253422;</code>
     * @return \Google\Cloud\Compute\V1\Duration|null
     */
    public function getDefaultTtl()
    {
        return $this->default_ttl;
    }

    public function hasDefaultTtl()
    {
        return isset($this->default_ttl);
    }

    public function clearDefaultTtl()
    {
        unset($this->default_ttl);
    }

    /**
     * Specifies the default TTL for cached content for responses that do not have
     * an existing valid TTL (max-age or s-maxage). Setting a TTL of "0" means
     * "always revalidate". The value of `defaultTtl` cannot be set to a value
     * greater than that of `maxTtl`. When the `cacheMode` is set to
     * `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
     * responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
     * accessed objects may be evicted from the cache before the defined TTL. If
     * not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
     * `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
     * `USE_ORIGIN_HEADERS`.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration default_ttl = 100253422;</code>
     * @param \Google\Cloud\Compute\V1\Duration $var
     * @return $this
     */
    public function setDefaultTtl($var)
    {
        GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Duration::class);
        $this->default_ttl = $var;

        return $this;
    }

    /**
     * Specifies the maximum allowed TTL for cached content. Cache directives that
     * attempt to set a max-age or s-maxage higher than this, or an Expires header
     * more than `maxTtl` seconds in the future will be capped at the value of
     * `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
     * Headers sent to the client will not be modified. Setting a TTL of "0" means
     * "always revalidate". The maximum allowed value is 31,622,400s (1 year).
     * Infrequently accessed objects may be evicted from the cache before the
     * defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
     * `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
     * mode.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration max_ttl = 307578001;</code>
     * @return \Google\Cloud\Compute\V1\Duration|null
     */
    public function getMaxTtl()
    {
        return $this->max_ttl;
    }

    public function hasMaxTtl()
    {
        return isset($this->max_ttl);
    }

    public function clearMaxTtl()
    {
        unset($this->max_ttl);
    }

    /**
     * Specifies the maximum allowed TTL for cached content. Cache directives that
     * attempt to set a max-age or s-maxage higher than this, or an Expires header
     * more than `maxTtl` seconds in the future will be capped at the value of
     * `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
     * Headers sent to the client will not be modified. Setting a TTL of "0" means
     * "always revalidate". The maximum allowed value is 31,622,400s (1 year).
     * Infrequently accessed objects may be evicted from the cache before the
     * defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
     * `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
     * mode.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration max_ttl = 307578001;</code>
     * @param \Google\Cloud\Compute\V1\Duration $var
     * @return $this
     */
    public function setMaxTtl($var)
    {
        GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Duration::class);
        $this->max_ttl = $var;

        return $this;
    }

    /**
     * Negative caching allows per-status code TTLs to be set, in order
     * to apply fine-grained caching for common errors or redirects.
     * This can reduce the load on your origin and improve end-user
     * experience by reducing response latency.
     * When the `cacheMode` is set to `CACHE_ALL_STATIC` or
     * `USE_ORIGIN_HEADERS`, negative caching applies to responses with
     * the specified response code that lack any Cache-Control, Expires, or
     * Pragma: no-cache directives. When the `cacheMode` is set to
     * `FORCE_CACHE_ALL`, negative caching applies to all responses
     * with the specified response code, and overrides any caching headers. By
     * default, Cloud CDN applies the following TTLs to these HTTP status codes:
     * * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
     * * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
     * * 405 (Method Not Found), 501 (Not Implemented): 60s
     * These defaults can be overridden in `negativeCachingPolicy`.
     * If not specified, Cloud CDN applies negative caching by default.
     *
     * Generated from protobuf field <code>optional bool negative_caching = 336110005;</code>
     * @return bool
     */
    public function getNegativeCaching()
    {
        return isset($this->negative_caching) ? $this->negative_caching : false;
    }

    public function hasNegativeCaching()
    {
        return isset($this->negative_caching);
    }

    public function clearNegativeCaching()
    {
        unset($this->negative_caching);
    }

    /**
     * Negative caching allows per-status code TTLs to be set, in order
     * to apply fine-grained caching for common errors or redirects.
     * This can reduce the load on your origin and improve end-user
     * experience by reducing response latency.
     * When the `cacheMode` is set to `CACHE_ALL_STATIC` or
     * `USE_ORIGIN_HEADERS`, negative caching applies to responses with
     * the specified response code that lack any Cache-Control, Expires, or
     * Pragma: no-cache directives. When the `cacheMode` is set to
     * `FORCE_CACHE_ALL`, negative caching applies to all responses
     * with the specified response code, and overrides any caching headers. By
     * default, Cloud CDN applies the following TTLs to these HTTP status codes:
     * * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
     * * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
     * * 405 (Method Not Found), 501 (Not Implemented): 60s
     * These defaults can be overridden in `negativeCachingPolicy`.
     * If not specified, Cloud CDN applies negative caching by default.
     *
     * Generated from protobuf field <code>optional bool negative_caching = 336110005;</code>
     * @param bool $var
     * @return $this
     */
    public function setNegativeCaching($var)
    {
        GPBUtil::checkBool($var);
        $this->negative_caching = $var;

        return $this;
    }

    /**
     * Sets a cache TTL for the specified HTTP status code.
     * `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
     * Omitting the policy and leaving `negativeCaching` enabled will use Cloud
     * CDN's default cache TTLs. Note that when specifying an explicit
     * `negativeCachingPolicy`, you should take care to specify a cache TTL for
     * all response codes that you wish to cache. Cloud CDN will not apply any
     * default negative caching when a policy exists.
     *
     * Generated from protobuf field <code>repeated .google.cloud.compute.v1.CachePolicyNegativeCachingPolicy negative_caching_policy = 155359996;</code>
     * @return RepeatedField<\Google\Cloud\Compute\V1\CachePolicyNegativeCachingPolicy>
     */
    public function getNegativeCachingPolicy()
    {
        return $this->negative_caching_policy;
    }

    /**
     * Sets a cache TTL for the specified HTTP status code.
     * `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
     * Omitting the policy and leaving `negativeCaching` enabled will use Cloud
     * CDN's default cache TTLs. Note that when specifying an explicit
     * `negativeCachingPolicy`, you should take care to specify a cache TTL for
     * all response codes that you wish to cache. Cloud CDN will not apply any
     * default negative caching when a policy exists.
     *
     * Generated from protobuf field <code>repeated .google.cloud.compute.v1.CachePolicyNegativeCachingPolicy negative_caching_policy = 155359996;</code>
     * @param \Google\Cloud\Compute\V1\CachePolicyNegativeCachingPolicy[] $var
     * @return $this
     */
    public function setNegativeCachingPolicy($var)
    {
        $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Google\Cloud\Compute\V1\CachePolicyNegativeCachingPolicy::class);
        $this->negative_caching_policy = $arr;

        return $this;
    }

    /**
     * If true then Cloud CDN will combine multiple concurrent cache fill
     * requests into a small number of requests to the origin. If not specified,
     * Cloud CDN applies request coalescing by default.
     *
     * Generated from protobuf field <code>optional bool request_coalescing = 532808276;</code>
     * @return bool
     */
    public function getRequestCoalescing()
    {
        return isset($this->request_coalescing) ? $this->request_coalescing : false;
    }

    public function hasRequestCoalescing()
    {
        return isset($this->request_coalescing);
    }

    public function clearRequestCoalescing()
    {
        unset($this->request_coalescing);
    }

    /**
     * If true then Cloud CDN will combine multiple concurrent cache fill
     * requests into a small number of requests to the origin. If not specified,
     * Cloud CDN applies request coalescing by default.
     *
     * Generated from protobuf field <code>optional bool request_coalescing = 532808276;</code>
     * @param bool $var
     * @return $this
     */
    public function setRequestCoalescing($var)
    {
        GPBUtil::checkBool($var);
        $this->request_coalescing = $var;

        return $this;
    }

    /**
     * Serve existing content from the cache (if available) when revalidating
     * content with the origin, or when an error is encountered when refreshing
     * the cache.
     * This setting defines the default "max-stale" duration for any cached
     * responses that do not specify a max-stale directive. Stale responses that
     * exceed the TTL configured here will not be served. The default limit
     * (max-stale) is 86400s (1 day), which will allow stale content to be
     * served up to this limit beyond the max-age (or s-maxage) of a cached
     * response.
     * The maximum allowed value is 604800 (1 week).
     * Set this to zero (0) to disable serve-while-stale.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration serve_while_stale = 236682203;</code>
     * @return \Google\Cloud\Compute\V1\Duration|null
     */
    public function getServeWhileStale()
    {
        return $this->serve_while_stale;
    }

    public function hasServeWhileStale()
    {
        return isset($this->serve_while_stale);
    }

    public function clearServeWhileStale()
    {
        unset($this->serve_while_stale);
    }

    /**
     * Serve existing content from the cache (if available) when revalidating
     * content with the origin, or when an error is encountered when refreshing
     * the cache.
     * This setting defines the default "max-stale" duration for any cached
     * responses that do not specify a max-stale directive. Stale responses that
     * exceed the TTL configured here will not be served. The default limit
     * (max-stale) is 86400s (1 day), which will allow stale content to be
     * served up to this limit beyond the max-age (or s-maxage) of a cached
     * response.
     * The maximum allowed value is 604800 (1 week).
     * Set this to zero (0) to disable serve-while-stale.
     *
     * Generated from protobuf field <code>optional .google.cloud.compute.v1.Duration serve_while_stale = 236682203;</code>
     * @param \Google\Cloud\Compute\V1\Duration $var
     * @return $this
     */
    public function setServeWhileStale($var)
    {
        GPBUtil::checkMessage($var, \Google\Cloud\Compute\V1\Duration::class);
        $this->serve_while_stale = $var;

        return $this;
    }

}