Reference documentation and code samples for the Compute V1 Client class Backend.
Message containing information of one individual backend.
Generated from protobuf message google.cloud.compute.v1.Backend
Methods
__construct
Constructor.
| Parameters | |
|---|---|
| Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ balancing_mode |
string
Specifies how to determine whether the backend of a load balancer can 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. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected. Check the BalancingMode enum for the list of possible values. |
↳ capacity_scaler |
float
A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. |
↳ description |
string
An optional description of this resource. Provide this property when you create the resource. |
↳ failover |
bool
This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService. |
↳ group |
string
The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the Backend services overview. You must use the fully-qualified URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported. |
↳ max_connections |
int
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. |
↳ max_connections_per_endpoint |
int
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. |
↳ max_connections_per_instance |
int
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE. |
↳ max_rate |
int
Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. |
↳ max_rate_per_endpoint |
float
Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. |
↳ max_rate_per_instance |
float
Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION. |
↳ max_utilization |
float
Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode. |
getBalancingMode
Specifies how to determine whether the backend of a load balancer can 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. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected.
Check the BalancingMode enum for the list of possible values.
Generated from protobuf field optional string balancing_mode = 430286217;
| Returns | |
|---|---|
| Type | Description |
string | |
hasBalancingMode
clearBalancingMode
setBalancingMode
Specifies how to determine whether the backend of a load balancer can 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. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected.
Check the BalancingMode enum for the list of possible values.
Generated from protobuf field optional string balancing_mode = 430286217;
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getCapacityScaler
A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service.
Generated from protobuf field optional float capacity_scaler = 315958157;
| Returns | |
|---|---|
| Type | Description |
float | |
hasCapacityScaler
clearCapacityScaler
setCapacityScaler
A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service.
Generated from protobuf field optional float capacity_scaler = 315958157;
| Parameter | |
|---|---|
| Name | Description |
var |
float
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getDescription
An optional description of this resource. Provide this property when you create the resource.
Generated from protobuf field optional string description = 422937596;
| Returns | |
|---|---|
| Type | Description |
string | |
hasDescription
clearDescription
setDescription
An optional description of this resource. Provide this property when you create the resource.
Generated from protobuf field optional string description = 422937596;
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getFailover
This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
Generated from protobuf field optional bool failover = 138892530;
| Returns | |
|---|---|
| Type | Description |
bool | |
hasFailover
clearFailover
setFailover
This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
Generated from protobuf field optional bool failover = 138892530;
| Parameter | |
|---|---|
| Name | Description |
var |
bool
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getGroup
The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the Backend services overview. You must use the fully-qualified URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported.
Generated from protobuf field optional string group = 98629247;
| Returns | |
|---|---|
| Type | Description |
string | |
hasGroup
clearGroup
setGroup
The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the Backend services overview. You must use the fully-qualified URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported.
Generated from protobuf field optional string group = 98629247;
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxConnections
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
Generated from protobuf field optional int32 max_connections = 110652154;
| Returns | |
|---|---|
| Type | Description |
int | |
hasMaxConnections
clearMaxConnections
setMaxConnections
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
Generated from protobuf field optional int32 max_connections = 110652154;
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxConnectionsPerEndpoint
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
Generated from protobuf field optional int32 max_connections_per_endpoint = 216904604;
| Returns | |
|---|---|
| Type | Description |
int | |
hasMaxConnectionsPerEndpoint
clearMaxConnectionsPerEndpoint
setMaxConnectionsPerEndpoint
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
Generated from protobuf field optional int32 max_connections_per_endpoint = 216904604;
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxConnectionsPerInstance
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
Generated from protobuf field optional int32 max_connections_per_instance = 104671900;
| Returns | |
|---|---|
| Type | Description |
int | |
hasMaxConnectionsPerInstance
clearMaxConnectionsPerInstance
setMaxConnectionsPerInstance
Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.
Generated from protobuf field optional int32 max_connections_per_instance = 104671900;
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxRate
Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
Generated from protobuf field optional int32 max_rate = 408035035;
| Returns | |
|---|---|
| Type | Description |
int | |
hasMaxRate
clearMaxRate
setMaxRate
Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
Generated from protobuf field optional int32 max_rate = 408035035;
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxRatePerEndpoint
Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
Generated from protobuf field optional float max_rate_per_endpoint = 129832283;
| Returns | |
|---|---|
| Type | Description |
float | |
hasMaxRatePerEndpoint
clearMaxRatePerEndpoint
setMaxRatePerEndpoint
Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
Generated from protobuf field optional float max_rate_per_endpoint = 129832283;
| Parameter | |
|---|---|
| Name | Description |
var |
float
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxRatePerInstance
Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
Generated from protobuf field optional float max_rate_per_instance = 17599579;
| Returns | |
|---|---|
| Type | Description |
float | |
hasMaxRatePerInstance
clearMaxRatePerInstance
setMaxRatePerInstance
Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.
Generated from protobuf field optional float max_rate_per_instance = 17599579;
| Parameter | |
|---|---|
| Name | Description |
var |
float
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxUtilization
Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
Generated from protobuf field optional float max_utilization = 148192199;
| Returns | |
|---|---|
| Type | Description |
float | |
hasMaxUtilization
clearMaxUtilization
setMaxUtilization
Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.
Generated from protobuf field optional float max_utilization = 148192199;
| Parameter | |
|---|---|
| Name | Description |
var |
float
|
| Returns | |
|---|---|
| Type | Description |
$this | |