Class: Google::Cloud::Compute::V1::Backend

Inherits:

Object

Object
Google::Cloud::Compute::V1::Backend

show all

Extended by:: Protobuf::MessageExts::ClassMethods

Includes:: Protobuf::MessageExts

Defined in:: proto_docs/google/cloud/compute/v1/compute.rb

Overview

Message containing information of one individual backend.

Defined Under Namespace

Modules: BalancingMode, Preference, TrafficDuration

Instance Attribute Summary collapse

#balancing_mode ⇒ ::String
Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded.
#capacity_scaler ⇒ ::Float
A multiplier applied to the backend's target capacity of its balancing mode.
#custom_metrics ⇒ ::Array<::Google::Cloud::Compute::V1::BackendCustomMetric>
List of custom metrics that are used for CUSTOM_METRICS BalancingMode.
#description ⇒ ::String
An optional description of this resource.
#failover ⇒ ::Boolean
This field designates whether this is a failover backend.
#group ⇒ ::String
The fully-qualified URL of aninstance group or network endpoint group (NEG) resource.
#max_connections ⇒ ::Integer
Defines a target maximum number of simultaneous connections.
#max_connections_per_endpoint ⇒ ::Integer
Defines a target maximum number of simultaneous connections.
#max_connections_per_instance ⇒ ::Integer
Defines a target maximum number of simultaneous connections.
#max_in_flight_requests ⇒ ::Integer
Defines a maximum number of in-flight requests for the whole NEG or instance group.
#max_in_flight_requests_per_endpoint ⇒ ::Integer
Defines a maximum number of in-flight requests for a single endpoint.
#max_in_flight_requests_per_instance ⇒ ::Integer
Defines a maximum number of in-flight requests for a single VM.
#max_rate ⇒ ::Integer
Defines a maximum number of HTTP requests per second (RPS).
#max_rate_per_endpoint ⇒ ::Float
Defines a maximum target for requests per second (RPS).
#max_rate_per_instance ⇒ ::Float
Defines a maximum target for requests per second (RPS).
#max_utilization ⇒ ::Float
Optional parameter to define a target capacity for theUTILIZATION balancing mode.
#orchestration_info ⇒ ::Google::Cloud::Compute::V1::BackendBackendOrchestrationInfo
Information about the resource or system that manages the backend.
#preference ⇒ ::String
This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference.
#traffic_duration ⇒ ::String
Check the TrafficDuration enum for the list of possible values.

Instance Attribute Details

#balancing_mode ⇒ `::String`

Returns 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.

Returns:

(::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.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#capacity_scaler ⇒ `::Float`

Returns 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 onbalancingMode). 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 than0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service.

Not available with backends that don't support using abalancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs.

Returns:

(::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 onbalancingMode). 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 than0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service.

Not available with backends that don't support using abalancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#custom_metrics ⇒ `::Array<::Google::Cloud::Compute::V1::BackendCustomMetric>`

Returns List of custom metrics that are used for CUSTOM_METRICS BalancingMode.

Returns:

(::Array<::Google::Cloud::Compute::V1::BackendCustomMetric>) —
List of custom metrics that are used for CUSTOM_METRICS BalancingMode.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#description ⇒ `::String`

Returns An optional description of this resource. Provide this property when you create the resource.

Returns:

(::String) —
An optional description of this resource. Provide this property when you create the resource.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#failover ⇒ `::Boolean`

Returns This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.

Returns:

(::Boolean) —
This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#group ⇒ `::String`

Returns The fully-qualified URL of aninstance 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 withhttps://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported.

If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP.

Returns:

(::String) —
The fully-qualified URL of aninstance 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 withhttps://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported.

If haPolicy is specified, backends must refer to NEG resources of type GCE_VM_IP.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_connections ⇒ `::Integer`

Returns Defines a target maximum number of simultaneous connections. For usage guidelines, seeConnection balancing mode and Utilization balancing mode. Not available if the backend'sbalancingMode is RATE.

Returns:

(::Integer) —
Defines a target maximum number of simultaneous connections. For usage guidelines, seeConnection balancing mode and Utilization balancing mode. Not available if the backend'sbalancingMode is RATE.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_connections_per_endpoint ⇒ `::Integer`

Returns Defines a target maximum number of simultaneous connections. For usage guidelines, seeConnection balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isRATE.

Returns:

(::Integer) —
Defines a target maximum number of simultaneous connections. For usage guidelines, seeConnection balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isRATE.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_connections_per_instance ⇒ `::Integer`

Returns Defines a target maximum number of simultaneous connections. For usage guidelines, seeConnection balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isRATE.

Returns:

(::Integer) —
Defines a target maximum number of simultaneous connections. For usage guidelines, seeConnection balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isRATE.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_in_flight_requests ⇒ `::Integer`

Returns Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode isRATE or CONNECTION.

Returns:

(::Integer) —
Defines a maximum number of in-flight requests for the whole NEG or instance group. Not available if backend's balancingMode isRATE or CONNECTION.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_in_flight_requests_per_endpoint ⇒ `::Integer`

Returns Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.

Returns:

(::Integer) —
Defines a maximum number of in-flight requests for a single endpoint. Not available if backend's balancingMode is RATE or CONNECTION.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_in_flight_requests_per_instance ⇒ `::Integer`

Returns Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.

Returns:

(::Integer) —
Defines a maximum number of in-flight requests for a single VM. Not available if backend's balancingMode is RATE or CONNECTION.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_rate ⇒ `::Integer`

Returns Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, seeRate balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isCONNECTION.

Returns:

(::Integer) —
Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, seeRate balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isCONNECTION.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_rate_per_endpoint ⇒ `::Float`

Returns Defines a maximum target for requests per second (RPS). For usage guidelines, seeRate balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isCONNECTION.

Returns:

(::Float) —
Defines a maximum target for requests per second (RPS). For usage guidelines, seeRate balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isCONNECTION.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_rate_per_instance ⇒ `::Float`

Returns Defines a maximum target for requests per second (RPS). For usage guidelines, seeRate balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isCONNECTION.

Returns:

(::Float) —
Defines a maximum target for requests per second (RPS). For usage guidelines, seeRate balancing mode and Utilization balancing mode.

Not available if the backend's balancingMode isCONNECTION.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#max_utilization ⇒ `::Float`

Returns Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].

For usage guidelines, seeUtilization balancing mode.

Returns:

(::Float) —
Optional parameter to define a target capacity for theUTILIZATION balancing mode. The valid range is[0.0, 1.0].

For usage guidelines, seeUtilization balancing mode.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#orchestration_info ⇒ `::Google::Cloud::Compute::V1::BackendBackendOrchestrationInfo`

Returns Information about the resource or system that manages the backend.

Returns:

(::Google::Cloud::Compute::V1::BackendBackendOrchestrationInfo) —
Information about the resource or system that manages the backend.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#preference ⇒ `::String`

Returns This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are:

PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT.
DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default Check the Preference enum for the list of possible values.

Returns:

(::String) —
This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are:
- PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT.
- DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default Check the Preference enum for the list of possible values.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

#traffic_duration ⇒ `::String`

Returns Check the TrafficDuration enum for the list of possible values.

Returns:

(::String) —
Check the TrafficDuration enum for the list of possible values.

# File 'proto_docs/google/cloud/compute/v1/compute.rb', line 9618

class Backend
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # 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.
  module BalancingMode
    # A value indicating that the enum field is not set.
    UNDEFINED_BALANCING_MODE = 0

    # Balance based on the number of simultaneous connections.
    CONNECTION = 246_311_646

    # Based on custom defined and reported metrics.
    CUSTOM_METRICS = 331_575_765

    # Balance based on the number of in-flight requests.
    IN_FLIGHT = 190_040_266

    # Balance based on requests per second (RPS).
    RATE = 2_508_000

    # Balance based on the backend utilization.
    UTILIZATION = 157_008_386
  end

  # This field indicates whether this backend should be fully utilized before
  # sending traffic to backends with default preference. The possible values
  # are:
  #
  #    - PREFERRED: Backends with this preference level will be
  #    filled up to their capacity limits first, based on RTT.
  #    - DEFAULT:  If preferred backends don't have enough
  #    capacity, backends in this layer would be used and traffic would be
  #    assigned based on the load balancing algorithm you use. This is the
  #    default
  module Preference
    # A value indicating that the enum field is not set.
    UNDEFINED_PREFERENCE = 0

    # No preference.
    DEFAULT = 115_302_945

    # If preference is unspecified, we set it to the DEFAULT value
    PREFERENCE_UNSPECIFIED = 496_219_571

    # Traffic will be sent to this backend first.
    PREFERRED = 418_847_841
  end

  module TrafficDuration
    # A value indicating that the enum field is not set.
    UNDEFINED_TRAFFIC_DURATION = 0

    # Most of the requests are expected to take more than multiple seconds to
    # finish.
    LONG = 2_342_524

    # Most requests are expected to finish with a sub-second latency.
    SHORT = 78_875_740

    # Traffic duration is unspecified.
    TRAFFIC_DURATION_UNSPECIFIED = 265_201_166
  end
end

Class: Google::Cloud::Compute::V1::Backend

Overview

Defined Under Namespace

Instance Attribute Summary collapse

Instance Attribute Details

#balancing_mode ⇒ ::String

#capacity_scaler ⇒ ::Float

#custom_metrics ⇒ ::Array<::Google::Cloud::Compute::V1::BackendCustomMetric>

#description ⇒ ::String

#failover ⇒ ::Boolean

#group ⇒ ::String

#max_connections ⇒ ::Integer

#max_connections_per_endpoint ⇒ ::Integer

#max_connections_per_instance ⇒ ::Integer

#max_in_flight_requests ⇒ ::Integer

#max_in_flight_requests_per_endpoint ⇒ ::Integer

#max_in_flight_requests_per_instance ⇒ ::Integer

#max_rate ⇒ ::Integer

#max_rate_per_endpoint ⇒ ::Float

#max_rate_per_instance ⇒ ::Float

#max_utilization ⇒ ::Float

#orchestration_info ⇒ ::Google::Cloud::Compute::V1::BackendBackendOrchestrationInfo

#preference ⇒ ::String

#traffic_duration ⇒ ::String

#balancing_mode ⇒ `::String`

#capacity_scaler ⇒ `::Float`

#custom_metrics ⇒ `::Array<::Google::Cloud::Compute::V1::BackendCustomMetric>`

#description ⇒ `::String`

#failover ⇒ `::Boolean`

#group ⇒ `::String`

#max_connections ⇒ `::Integer`

#max_connections_per_endpoint ⇒ `::Integer`

#max_connections_per_instance ⇒ `::Integer`

#max_in_flight_requests ⇒ `::Integer`

#max_in_flight_requests_per_endpoint ⇒ `::Integer`

#max_in_flight_requests_per_instance ⇒ `::Integer`

#max_rate ⇒ `::Integer`

#max_rate_per_endpoint ⇒ `::Float`

#max_rate_per_instance ⇒ `::Float`

#max_utilization ⇒ `::Float`

#orchestration_info ⇒ `::Google::Cloud::Compute::V1::BackendBackendOrchestrationInfo`

#preference ⇒ `::String`

#traffic_duration ⇒ `::String`