Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 24 additions & 6 deletions src/Compute/Backend.php
Original file line number Diff line number Diff line change
Expand Up @@ -70,9 +70,10 @@ class Backend extends \Google\Collection
* handle additional traffic or is fully loaded. For usage guidelines, see
* Connection balancing mode.
*
* Backends must use compatible balancing modes. For more information, see
* Supported balancing modes and target capacity settings and Restrictions and
* guidance for instance groups.
* Backends must use compatible balancing modes. Backends of a backend service
* may use different balancing modes. For more information, see Supported
* balancing modes and target capacity settings and Restrictions and guidance
* for instance groups.
*
* Note: Currently, if you use the API to configure incompatible balancing
* modes, the configuration might be accepted even though it has no impact and
Expand Down Expand Up @@ -112,6 +113,9 @@ class Backend extends \Google\Collection
* This field designates whether this is a failover backend. More than one
* failover backend can be configured for a given BackendService.
*
* This field can only be used for a regional external Passthrough Network
* Load Balancer or a regional internal Passthrough Network Load Balancer.
*
* @var bool
*/
public $failover;
Expand Down Expand Up @@ -226,6 +230,11 @@ class Backend extends \Google\Collection
* would be used and traffic would be assigned based on the load balancing
* algorithm you use. This is the default
*
* For global external Passthrough Network Load Balancers, the following
* restrictions apply: - At most one backend can be marked as
* PREFERRED. - PREFERRED and DEFAULT backends cannot reside in the same
* Cloud region.
*
* @var string
*/
public $preference;
Expand All @@ -239,9 +248,10 @@ class Backend extends \Google\Collection
* handle additional traffic or is fully loaded. For usage guidelines, see
* Connection balancing mode.
*
* Backends must use compatible balancing modes. For more information, see
* Supported balancing modes and target capacity settings and Restrictions and
* guidance for instance groups.
* Backends must use compatible balancing modes. Backends of a backend service
* may use different balancing modes. For more information, see Supported
* balancing modes and target capacity settings and Restrictions and guidance
* for instance groups.
*
* Note: Currently, if you use the API to configure incompatible balancing
* modes, the configuration might be accepted even though it has no impact and
Expand Down Expand Up @@ -327,6 +337,9 @@ public function getDescription()
* This field designates whether this is a failover backend. More than one
* failover backend can be configured for a given BackendService.
*
* This field can only be used for a regional external Passthrough Network
* Load Balancer or a regional internal Passthrough Network Load Balancer.
*
* @param bool $failover
*/
public function setFailover($failover)
Expand Down Expand Up @@ -575,6 +588,11 @@ public function getOrchestrationInfo()
* would be used and traffic would be assigned based on the load balancing
* algorithm you use. This is the default
*
* For global external Passthrough Network Load Balancers, the following
* restrictions apply: - At most one backend can be marked as
* PREFERRED. - PREFERRED and DEFAULT backends cannot reside in the same
* Cloud region.
*
* Accepted values: DEFAULT, PREFERENCE_UNSPECIFIED, PREFERRED
*
* @param self::PREFERENCE_* $preference
Expand Down
12 changes: 6 additions & 6 deletions src/Compute/BackendBucketCdnPolicy.php
Original file line number Diff line number Diff line change
Expand Up @@ -47,14 +47,14 @@ class BackendBucketCdnPolicy extends \Google\Collection
protected $cacheKeyPolicyDataType = '';
/**
* Specifies the cache setting for all responses from this backend. The
* possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid
* possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid
* caching headers to cache content. Responses without these headers will not
* be cached at Google's edge, and will require a full trip to the origin on
* every request, potentially impacting performance and increasing load on the
* origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private",
* origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private",
* "no-store" or "no-cache" directives in Cache-Control response headers.
* Warning: this may result in Cloud CDN caching private, per-user (user
* identifiable) content.CACHE_ALL_STATIC Automatically cache static content,
* identifiable) content. CACHE_ALL_STATIC Automatically cache static content,
* including common image formats, media (video and audio), and web assets
* (JavaScript and CSS). Requests and responses that are marked as
* uncacheable, as well as dynamic content (including HTML), will not be
Expand Down Expand Up @@ -204,14 +204,14 @@ public function getCacheKeyPolicy()
}
/**
* Specifies the cache setting for all responses from this backend. The
* possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid
* possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid
* caching headers to cache content. Responses without these headers will not
* be cached at Google's edge, and will require a full trip to the origin on
* every request, potentially impacting performance and increasing load on the
* origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private",
* origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private",
* "no-store" or "no-cache" directives in Cache-Control response headers.
* Warning: this may result in Cloud CDN caching private, per-user (user
* identifiable) content.CACHE_ALL_STATIC Automatically cache static content,
* identifiable) content. CACHE_ALL_STATIC Automatically cache static content,
* including common image formats, media (video and audio), and web assets
* (JavaScript and CSS). Requests and responses that are marked as
* uncacheable, as well as dynamic content (including HTML), will not be
Expand Down
114 changes: 69 additions & 45 deletions src/Compute/BackendService.php
Original file line number Diff line number Diff line change
Expand Up @@ -419,8 +419,8 @@ class BackendService extends \Google\Collection
public $kind;
/**
* Specifies the load balancer type. A backend service created for one type of
* load balancer cannot be used with another. For more information, refer
* toChoosing a load balancer.
* load balancer cannot be used with another. For more information, refer to
* Backend services product and scheme table.
*
* @var string
*/
Expand Down Expand Up @@ -449,19 +449,32 @@ class BackendService extends \Google\Collection
* Backend reported Custom Metrics. If set, the Backend Service responses
* are expected to contain non-standard HTTP response header field
* Endpoint-Load-Metrics. The reported metrics to use for computing the
* weights are specified via thecustomMetrics field. This field is
* applicable to either: - A regional backend service with the service
* protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme
* set to INTERNAL_MANAGED. - A global backend service with the
* load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
* EXTERNAL_MANAGED. If sessionAffinity is not configured—that is,
* if session affinity remains at the default value of NONE—then the
* default value for localityLbPolicy is ROUND_ROBIN. If session affinity
* is set to a value other than NONE, then the default value for
* localityLbPolicy isMAGLEV. Only ROUND_ROBIN and RING_HASH are
* supported when the backend service is referenced by a URL map that is
* bound to target gRPC proxy that has validateForProxyless field set to
* true. localityLbPolicy cannot be specified with haPolicy.
* weights are specified via thecustomMetrics field. - WEIGHTED_MAGLEV:
* Per-endpoint weighted load balancing via health check reported weights.
* If set, the backend service must configure an HTTP-based Health Check,
* and health check replies are expected to contain the non-standard HTTP
* response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-
* endpoint weights. If set, load balancing is weighted based on the per-
* endpoint weights reported in the last processed health check replies, as
* long as every instance either reported a valid weight or had
* UNAVAILABLE_WEIGHT. Otherwise, load balancing remains equal-weight.
*
* This field is applicable to either: - A regional backend service
* with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
* load_balancing_scheme set to INTERNAL_MANAGED. - A global backend
* service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED,
* INTERNAL_MANAGED, or EXTERNAL_MANAGED.
*
* If sessionAffinity is not configured—that is, if session affinity remains
* at the default value of NONE—then the default value for localityLbPolicy is
* ROUND_ROBIN. If session affinity is set to a value other than NONE, then
* the default value for localityLbPolicy isMAGLEV.
*
* Only ROUND_ROBIN and RING_HASH are supported when the backend service is
* referenced by a URL map that is bound to target gRPC proxy that has
* validateForProxyless field set to true.
*
* localityLbPolicy cannot be specified with haPolicy.
*
* @var string
*/
Expand Down Expand Up @@ -534,10 +547,9 @@ class BackendService extends \Google\Collection
/**
* The protocol this BackendService uses to communicate with backends.
*
* Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC.
* depending on the chosen load balancer or Traffic Director configuration.
* Refer to the documentation for the load balancers or for Traffic Director
* for more information.
* Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
* UNSPECIFIED, depending on the chosen load balancer or Traffic Director
* configuration. Refer to Load balancing features for more information.
*
* Must be set to GRPC when the backend service is referenced by a URL map
* that is bound to target gRPC proxy.
Expand Down Expand Up @@ -969,9 +981,9 @@ public function getExternalManagedMigrationTestingPercentage()
* Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-
* overview) and [external passthrough Network Load
* Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-
* failover-overview).
*
* failoverPolicy cannot be specified with haPolicy.
* failover-overview). failoverPolicy cannot be specified with
* haPolicy.failoverPolicy cannot be used by global external Passthrough
* Network Load Balancers.
*
* @param BackendServiceFailoverPolicy $failoverPolicy
*/
Expand Down Expand Up @@ -1034,10 +1046,10 @@ public function getFingerprint()
*
* haPolicy requires customers to be responsible for tracking backend endpoint
* health and electing a leader among the healthy endpoints. Therefore,
* haPolicy cannot be specified with healthChecks.
*
* haPolicy can only be specified for External Passthrough Network Load
* Balancers and Internal Passthrough Network Load Balancers.
* haPolicy cannot be specified with healthChecks. haPolicy can only be
* specified for External Passthrough Network Load Balancers and Internal
* Passthrough Network Load Balancers.haPolicy cannot be used by global
* external Passthrough Network Load Balancers.
*
* @param BackendServiceHAPolicy $haPolicy
*/
Expand Down Expand Up @@ -1170,8 +1182,8 @@ public function getKind()
}
/**
* Specifies the load balancer type. A backend service created for one type of
* load balancer cannot be used with another. For more information, refer
* toChoosing a load balancer.
* load balancer cannot be used with another. For more information, refer to
* Backend services product and scheme table.
*
* Accepted values: EXTERNAL, EXTERNAL_MANAGED, INTERNAL, INTERNAL_MANAGED,
* INTERNAL_SELF_MANAGED, INVALID_LOAD_BALANCING_SCHEME
Expand Down Expand Up @@ -1238,19 +1250,32 @@ public function getLocalityLbPolicies()
* Backend reported Custom Metrics. If set, the Backend Service responses
* are expected to contain non-standard HTTP response header field
* Endpoint-Load-Metrics. The reported metrics to use for computing the
* weights are specified via thecustomMetrics field. This field is
* applicable to either: - A regional backend service with the service
* protocol set to HTTP, HTTPS, HTTP2 or H2C, and load_balancing_scheme
* set to INTERNAL_MANAGED. - A global backend service with the
* load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or
* EXTERNAL_MANAGED. If sessionAffinity is not configured—that is,
* if session affinity remains at the default value of NONE—then the
* default value for localityLbPolicy is ROUND_ROBIN. If session affinity
* is set to a value other than NONE, then the default value for
* localityLbPolicy isMAGLEV. Only ROUND_ROBIN and RING_HASH are
* supported when the backend service is referenced by a URL map that is
* bound to target gRPC proxy that has validateForProxyless field set to
* true. localityLbPolicy cannot be specified with haPolicy.
* weights are specified via thecustomMetrics field. - WEIGHTED_MAGLEV:
* Per-endpoint weighted load balancing via health check reported weights.
* If set, the backend service must configure an HTTP-based Health Check,
* and health check replies are expected to contain the non-standard HTTP
* response header fieldX-Load-Balancing-Endpoint-Weight to specify the per-
* endpoint weights. If set, load balancing is weighted based on the per-
* endpoint weights reported in the last processed health check replies, as
* long as every instance either reported a valid weight or had
* UNAVAILABLE_WEIGHT. Otherwise, load balancing remains equal-weight.
*
* This field is applicable to either: - A regional backend service
* with the service protocol set to HTTP, HTTPS, HTTP2 or H2C, and
* load_balancing_scheme set to INTERNAL_MANAGED. - A global backend
* service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED,
* INTERNAL_MANAGED, or EXTERNAL_MANAGED.
*
* If sessionAffinity is not configured—that is, if session affinity remains
* at the default value of NONE—then the default value for localityLbPolicy is
* ROUND_ROBIN. If session affinity is set to a value other than NONE, then
* the default value for localityLbPolicy isMAGLEV.
*
* Only ROUND_ROBIN and RING_HASH are supported when the backend service is
* referenced by a URL map that is bound to target gRPC proxy that has
* validateForProxyless field set to true.
*
* localityLbPolicy cannot be specified with haPolicy.
*
* Accepted values: INVALID_LB_POLICY, LEAST_REQUEST, MAGLEV,
* ORIGINAL_DESTINATION, RANDOM, RING_HASH, ROUND_ROBIN,
Expand Down Expand Up @@ -1520,10 +1545,9 @@ public function getPortName()
/**
* The protocol this BackendService uses to communicate with backends.
*
* Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP or GRPC.
* depending on the chosen load balancer or Traffic Director configuration.
* Refer to the documentation for the load balancers or for Traffic Director
* for more information.
* Possible values are HTTP, HTTPS, HTTP2, H2C, TCP, SSL, UDP, GRPC, or
* UNSPECIFIED, depending on the chosen load balancer or Traffic Director
* configuration. Refer to Load balancing features for more information.
*
* Must be set to GRPC when the backend service is referenced by a URL map
* that is bound to target gRPC proxy.
Expand Down
12 changes: 6 additions & 6 deletions src/Compute/BackendServiceCdnPolicy.php
Original file line number Diff line number Diff line change
Expand Up @@ -47,14 +47,14 @@ class BackendServiceCdnPolicy extends \Google\Collection
protected $cacheKeyPolicyDataType = '';
/**
* Specifies the cache setting for all responses from this backend. The
* possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid
* possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid
* caching headers to cache content. Responses without these headers will not
* be cached at Google's edge, and will require a full trip to the origin on
* every request, potentially impacting performance and increasing load on the
* origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private",
* origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private",
* "no-store" or "no-cache" directives in Cache-Control response headers.
* Warning: this may result in Cloud CDN caching private, per-user (user
* identifiable) content.CACHE_ALL_STATIC Automatically cache static content,
* identifiable) content. CACHE_ALL_STATIC Automatically cache static content,
* including common image formats, media (video and audio), and web assets
* (JavaScript and CSS). Requests and responses that are marked as
* uncacheable, as well as dynamic content (including HTML), will not be
Expand Down Expand Up @@ -204,14 +204,14 @@ public function getCacheKeyPolicy()
}
/**
* Specifies the cache setting for all responses from this backend. The
* possible values are:USE_ORIGIN_HEADERS Requires the origin to set valid
* possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid
* caching headers to cache content. Responses without these headers will not
* be cached at Google's edge, and will require a full trip to the origin on
* every request, potentially impacting performance and increasing load on the
* origin server.FORCE_CACHE_ALL Cache all content, ignoring any "private",
* origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private",
* "no-store" or "no-cache" directives in Cache-Control response headers.
* Warning: this may result in Cloud CDN caching private, per-user (user
* identifiable) content.CACHE_ALL_STATIC Automatically cache static content,
* identifiable) content. CACHE_ALL_STATIC Automatically cache static content,
* including common image formats, media (video and audio), and web assets
* (JavaScript and CSS). Requests and responses that are marked as
* uncacheable, as well as dynamic content (including HTML), will not be
Expand Down
Loading
Loading