Reference documentation and code samples for the Google Cloud Network Services V1 Client class Destination.
Specifications of a destination to which the request should be routed to.
Generated from protobuf messagegoogle.cloud.networkservices.v1.HttpRoute.Destination
Namespace
Google \ Cloud \ NetworkServices \ V1 \ HttpRoute
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ service_name
string
The URL of a BackendService to route traffic to.
↳ weight
int
Specifies the proportion of requests forwarded to the backend referenced by the serviceName field. This is computed as: - weight/Sum(weights in this destination list). For non-zero values, there may be some epsilon from the exact proportion defined here depending on the precision an implementation supports. If only one serviceName is specified and it has a weight greater than 0, 100% of the traffic is forwarded to that backend. If weights are specified for any one service name, they need to be specified for all of them. If weights are unspecified for all services, then, traffic is distributed in equal proportions to all of them.
Optional. The specification for modifying the headers of a matching request prior to delivery of the request to the destination. If HeaderModifiers are set on both the Destination and the RouteAction, they will be merged. Conflicts between the two will not be resolved on the configuration.
Optional. The specification for modifying the headers of a response prior to sending the response back to the client. If HeaderModifiers are set on both the Destination and the RouteAction, they will be merged. Conflicts between the two will not be resolved on the configuration.
getServiceName
The URL of a BackendService to route traffic to.
Returns
Type
Description
string
setServiceName
The URL of a BackendService to route traffic to.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getWeight
Specifies the proportion of requests forwarded to the backend referenced
by the serviceName field. This is computed as:
weight/Sum(weights in this destination list).
For non-zero values, there may be some epsilon from the exact proportion
defined here depending on the precision an implementation supports.
If only one serviceName is specified and it has a weight greater than 0,
100% of the traffic is forwarded to that backend.
If weights are specified for any one service name, they need to be
specified for all of them.
If weights are unspecified for all services, then, traffic is distributed
in equal proportions to all of them.
Returns
Type
Description
int
setWeight
Specifies the proportion of requests forwarded to the backend referenced
by the serviceName field. This is computed as:
weight/Sum(weights in this destination list).
For non-zero values, there may be some epsilon from the exact proportion
defined here depending on the precision an implementation supports.
If only one serviceName is specified and it has a weight greater than 0,
100% of the traffic is forwarded to that backend.
If weights are specified for any one service name, they need to be
specified for all of them.
If weights are unspecified for all services, then, traffic is distributed
in equal proportions to all of them.
Parameter
Name
Description
var
int
Returns
Type
Description
$this
getRequestHeaderModifier
Optional. The specification for modifying the headers of a matching
request prior to delivery of the request to the destination. If
HeaderModifiers are set on both the Destination and the RouteAction, they
will be merged. Conflicts between the two will not be resolved on the
configuration.
Optional. The specification for modifying the headers of a matching
request prior to delivery of the request to the destination. If
HeaderModifiers are set on both the Destination and the RouteAction, they
will be merged. Conflicts between the two will not be resolved on the
configuration.
Optional. The specification for modifying the headers of a response prior
to sending the response back to the client. If HeaderModifiers are set on
both the Destination and the RouteAction, they will be merged. Conflicts
between the two will not be resolved on the configuration.
Optional. The specification for modifying the headers of a response prior
to sending the response back to the client. If HeaderModifiers are set on
both the Destination and the RouteAction, they will be merged. Conflicts
between the two will not be resolved on the configuration.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Google Cloud Network Services V1 Client - Class Destination (0.6.1)\n\nVersion latestkeyboard_arrow_down\n\n- [0.6.1 (latest)](/php/docs/reference/cloud-networkservices/latest/V1.HttpRoute.Destination)\n- [0.6.0](/php/docs/reference/cloud-networkservices/0.6.0/V1.HttpRoute.Destination)\n- [0.5.0](/php/docs/reference/cloud-networkservices/0.5.0/V1.HttpRoute.Destination)\n- [0.4.0](/php/docs/reference/cloud-networkservices/0.4.0/V1.HttpRoute.Destination)\n- [0.3.0](/php/docs/reference/cloud-networkservices/0.3.0/V1.HttpRoute.Destination)\n- [0.2.3](/php/docs/reference/cloud-networkservices/0.2.3/V1.HttpRoute.Destination)\n- [0.1.1](/php/docs/reference/cloud-networkservices/0.1.1/V1.HttpRoute.Destination) \nReference documentation and code samples for the Google Cloud Network Services V1 Client class Destination.\n\nSpecifications of a destination to which the request should be routed to.\n\nGenerated from protobuf message `google.cloud.networkservices.v1.HttpRoute.Destination`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ NetworkServices \\\\ V1 \\\\ HttpRoute\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getServiceName\n\nThe URL of a BackendService to route traffic to.\n\n### setServiceName\n\nThe URL of a BackendService to route traffic to.\n\n### getWeight\n\nSpecifies the proportion of requests forwarded to the backend referenced\nby the serviceName field. This is computed as:\n\n- weight/Sum(weights in this destination list).\n\nFor non-zero values, there may be some epsilon from the exact proportion\ndefined here depending on the precision an implementation supports.\nIf only one serviceName is specified and it has a weight greater than 0,\n100% of the traffic is forwarded to that backend.\nIf weights are specified for any one service name, they need to be\nspecified for all of them.\nIf weights are unspecified for all services, then, traffic is distributed\nin equal proportions to all of them.\n\n### setWeight\n\nSpecifies the proportion of requests forwarded to the backend referenced\nby the serviceName field. This is computed as:\n\n- weight/Sum(weights in this destination list).\n\nFor non-zero values, there may be some epsilon from the exact proportion\ndefined here depending on the precision an implementation supports.\nIf only one serviceName is specified and it has a weight greater than 0,\n100% of the traffic is forwarded to that backend.\nIf weights are specified for any one service name, they need to be\nspecified for all of them.\nIf weights are unspecified for all services, then, traffic is distributed\nin equal proportions to all of them.\n\n### getRequestHeaderModifier\n\nOptional. The specification for modifying the headers of a matching\nrequest prior to delivery of the request to the destination. If\nHeaderModifiers are set on both the Destination and the RouteAction, they\nwill be merged. Conflicts between the two will not be resolved on the\nconfiguration.\n\n### hasRequestHeaderModifier\n\n### clearRequestHeaderModifier\n\n### setRequestHeaderModifier\n\nOptional. The specification for modifying the headers of a matching\nrequest prior to delivery of the request to the destination. If\nHeaderModifiers are set on both the Destination and the RouteAction, they\nwill be merged. Conflicts between the two will not be resolved on the\nconfiguration.\n\n### getResponseHeaderModifier\n\nOptional. The specification for modifying the headers of a response prior\nto sending the response back to the client. If HeaderModifiers are set on\nboth the Destination and the RouteAction, they will be merged. Conflicts\nbetween the two will not be resolved on the configuration.\n\n### hasResponseHeaderModifier\n\n### clearResponseHeaderModifier\n\n### setResponseHeaderModifier\n\nOptional. The specification for modifying the headers of a response prior\nto sending the response back to the client. If HeaderModifiers are set on\nboth the Destination and the RouteAction, they will be merged. Conflicts\nbetween the two will not be resolved on the configuration."]]
