Google Cloud Compute V1 API - Class Google::Cloud::Compute::V1::CachePolicyCacheKeyPolicy (v3.6.0)

Reference documentation and code samples for the Google Cloud Compute V1 API class Google::Cloud::Compute::V1::CachePolicyCacheKeyPolicy.

Message containing what to include in the cache key for a request for Cache Policy defined on Route Action.

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#excluded_query_parameters

def excluded_query_parameters() -> ::Array<::String>
Returns
  • (::Array<::String>) — Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify excludedQueryParameters or includedQueryParameters, not both. '&' and '=' will be percent encoded and not treated as delimiters.

    Note: This field applies to routes that use backend services. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. For routes that point to a Backend Bucket, use includedQueryParameters to define which parameters should be part of the cache key.

#excluded_query_parameters=

def excluded_query_parameters=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify excludedQueryParameters or includedQueryParameters, not both. '&' and '=' will be percent encoded and not treated as delimiters.

    Note: This field applies to routes that use backend services. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. For routes that point to a Backend Bucket, use includedQueryParameters to define which parameters should be part of the cache key.

Returns
  • (::Array<::String>) — Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify excludedQueryParameters or includedQueryParameters, not both. '&' and '=' will be percent encoded and not treated as delimiters.

    Note: This field applies to routes that use backend services. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. For routes that point to a Backend Bucket, use includedQueryParameters to define which parameters should be part of the cache key.

#include_host

def include_host() -> ::Boolean
Returns
  • (::Boolean) — If true, requests to different hosts will be cached separately.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket, as the host is never included in a Backend Bucket's cache key. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error.

#include_host=

def include_host=(value) -> ::Boolean
Parameter
  • value (::Boolean) — If true, requests to different hosts will be cached separately.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket, as the host is never included in a Backend Bucket's cache key. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error.

Returns
  • (::Boolean) — If true, requests to different hosts will be cached separately.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket, as the host is never included in a Backend Bucket's cache key. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error.

#include_protocol

def include_protocol() -> ::Boolean
Returns
  • (::Boolean) — If true, http and https requests will be cached separately.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket, as the protocol is never included in a Backend Bucket's cache key. Attempting to set on a route that points exclusively to Backend Buckets will result in a configuration error.

#include_protocol=

def include_protocol=(value) -> ::Boolean
Parameter
  • value (::Boolean) — If true, http and https requests will be cached separately.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket, as the protocol is never included in a Backend Bucket's cache key. Attempting to set on a route that points exclusively to Backend Buckets will result in a configuration error.

Returns
  • (::Boolean) — If true, http and https requests will be cached separately.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket, as the protocol is never included in a Backend Bucket's cache key. Attempting to set on a route that points exclusively to Backend Buckets will result in a configuration error.

#include_query_string

def include_query_string() -> ::Boolean
Returns
  • (::Boolean) — If true, include query string parameters in the cache key according to includedQueryParameters and excludedQueryParameters. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

    Note: This field applies to routes that use backend services. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. For routes that point to a Backend Bucket, use includedQueryParameters to define which parameters should be part of the cache key.

#include_query_string=

def include_query_string=(value) -> ::Boolean
Parameter
  • value (::Boolean) — If true, include query string parameters in the cache key according to includedQueryParameters and excludedQueryParameters. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

    Note: This field applies to routes that use backend services. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. For routes that point to a Backend Bucket, use includedQueryParameters to define which parameters should be part of the cache key.

Returns
  • (::Boolean) — If true, include query string parameters in the cache key according to includedQueryParameters and excludedQueryParameters. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

    Note: This field applies to routes that use backend services. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. For routes that point to a Backend Bucket, use includedQueryParameters to define which parameters should be part of the cache key.

#included_cookie_names

def included_cookie_names() -> ::Array<::String>
Returns
  • (::Array<::String>) — Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. Up to 5 cookie names can be specified.

#included_cookie_names=

def included_cookie_names=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. Up to 5 cookie names can be specified.

Returns
  • (::Array<::String>) — Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

    Note: This setting is only applicable to routes that use a Backend Service. It does not affect requests served by a Backend Bucket. Attempting to set it on a route that points exclusively to Backend Buckets will result in a configuration error. Up to 5 cookie names can be specified.

#included_header_names

def included_header_names() -> ::Array<::String>
Returns
  • (::Array<::String>) — Allows HTTP request headers (by name) to be used in the cache key.

#included_header_names=

def included_header_names=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Allows HTTP request headers (by name) to be used in the cache key.
Returns
  • (::Array<::String>) — Allows HTTP request headers (by name) to be used in the cache key.

#included_query_parameters

def included_query_parameters() -> ::Array<::String>
Returns
  • (::Array<::String>) — Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify includedQueryParameters or excludedQueryParameters, not both. '&' and '=' will be percent encoded and not treated as delimiters.

#included_query_parameters=

def included_query_parameters=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify includedQueryParameters or excludedQueryParameters, not both. '&' and '=' will be percent encoded and not treated as delimiters.
Returns
  • (::Array<::String>) — Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify includedQueryParameters or excludedQueryParameters, not both. '&' and '=' will be percent encoded and not treated as delimiters.