ESrSSKJr SSKJr SSKJr SSKrSSKJr SSKJr SSK J r SS K J r \Rr S rSS jrS rSS jrSSjrSSjrSrSSjrSrSrSrSrSrSSjrSrg)zDFlags and helpers for the compute backend-services backend commands.)absolute_import)division)unicode_literalsN) arg_parsers)base)flags)logc$URSSS9 g)Nz --descriptionz1An optional, textual description for the backend.)help add_argumentparsers Hlib/googlecloudsdk/command_lib/compute/backend_services/backend_flags.pyAddDescriptionr!sOctURSSSS9 UR5n[R"USSR U5S[R S9 U(a&[R "USSR U5S S 9 [R "USSR U5S[RS9 g ) z(Adds arguments to define instance group.z--instance-groupTz1The name or URI of a Google Cloud Instance Group.)requiredr zinstance groupz{0} the backend servicezinstance-group) resource_typeoperation_type flag_prefix explanationz3DEPRECATED, use --instance-group-zone flag instead.)rrrN)r add_mutually_exclusive_groupr AddRegionFlagformat®ION_PROPERTY_EXPLANATION_NO_DEFAULT AddZoneFlag$ZONE_PROPERTY_EXPLANATION_NO_DEFAULT)rrwith_deprecated_zone scope_parsers rAddInstanceGroupr!'s >@ 446,$.55nE">> @  &077GI K $.55nE"<< >rcV[USS5(a[R"S5 gg)NzonezpThe --zone flag is deprecated, please use --instance-group-zone instead. It will be removed in a future release.)getattrr warning)argss rWarnOnDeprecatedFlagsr'Cs' T64  KK <=!rc`SnSnUS- nUS- nSn[R"S5RU5[R"S5RU5[R"S5RU5S S .nU[R:XdU[R :XaS US 'U$) zGReturns the --balancing-modes flag value choices name:description dict.z*--max-rate-per-instance*z *--max-connections-per-instance*z/*--max-rate-per-endpoint*z*--max-max-per-endpoint*z3This is incompatible with --network-endpoint-group.a Available if the backend service's load balancing scheme is either `INTERNAL` or `EXTERNAL`. Available if the backend service's protocol is one of `SSL`, `TCP`, or `UDP`. Spreads load based on how many concurrent connections the backend can handle. For backend services with --load-balancing-scheme `EXTERNAL`, you must specify exactly one of these additional parameters: `--max-connections`, `--max-connections-per-instance`, or `--max-connections-per-endpoint`. For backend services where `--load-balancing-scheme` is `INTERNAL`, you must omit all of these parameters. a Available if the backend service's load balancing scheme is `INTERNAL_MANAGED`, `INTERNAL_SELF_MANAGED`, or `EXTERNAL`. Available if the backend service's protocol is one of HTTP, HTTPS, or HTTP/2. Spreads load based on how many HTTP requests per second (RPS) the backend can handle. You must specify exactly one of these additional parameters: `--max-rate`, `--max-rate-per-instance`, or `--max-rate-per-endpoint`. aT Available if the backend service's load balancing scheme is `INTERNAL_MANAGED`, `INTERNAL_SELF_MANAGED`, or `EXTERNAL`. Available only for managed or unmanaged instance group backends. Spreads load based on the backend utilization of instances in a backend instance group. The following additional parameters may be specified: `--max-utilization`, `--max-rate`, `--max-rate-per-instance`, `--max-connections`, `--max-connections-per-instance`. For valid combinations, see `--max-utilization`. zP Spreads load based on custom defined and reported metrics. ) CONNECTIONRATE UTILIZATIONCUSTOM_METRICSaB Available if the backend service's load balancing scheme is `INTERNAL_MANAGED`, `INTERNAL_SELF_MANAGED`, or `EXTERNAL_MANAGED`. Available if the backend service's protocol is one of HTTP, HTTPS, or HTTP/2. Spreads load based on how many in-flight requests the backend can handle. You must specify exactly one of these additional parameters: `--max-in-flight-requests`, `--max-in-flight-requests-per-instance`, or `--max-in-flight-requests-per-endpoint`, and `--traffic-duration=LONG`. IN_FLIGHT)textwrapdedentr ReleaseTrackALPHABETA) release_trackper_rate_flagsper_connection_flagsutilization_extra_helpbalancing_modess r_GetBalancingModesr8Js..;00.44;OO% vn%oo  v,-__ & v*+U-/\l(((M\=N=N,N $OK  rcSn/nU(aURSS/5 U(aURS5 U(aUSR[U55- nUR S[ U5SUS9 g ) z-Adds balancing mode argument to the argparse.z Defines how to measure whether a backend can handle additional traffic or is fully loaded. For more information, see https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode. INTERNET_IP_PORTINTERNET_FQDN_PORT SERVERLESSzb This cannot be used when the endpoint type of an attached network endpoint group is {0}. z--balancing-modec"UR5$Nupperxs r"AddBalancingMode.. QWWYrchoicestyper N)extendappendr _JoinTypesr r8)rsupport_global_negsupport_region_negr3 help_textincompatible_typess rAddBalancingModerPs) 13GHIl+  z,-. /I   /   rc[U5 URSS9n/nU(aURSS/5 U(aURS5 U(aSR [ U55OSnUR S[S U-S 9 UR S [S U-S 9 UR S [SU-S 9 UR S[SS 9 UR S[SU-S 9 UR S[SS 9 U[R:XdU[R:XaIUR S[SU-S 9 UR S[SU-S 9 UR S[SU-S 9 gg)z3Adds capacity thresholds arguments to the argparse.T)mutexr:r;r<z` This cannot be used when the endpoint type of an attached network endpoint group is {0}. z--max-rate-per-endpointa Only valid for network endpoint group backends. Defines a maximum number of HTTP requests per second (RPS) per endpoint if all endpoints are healthy. When one or more endpoints are unhealthy, an effective maximum rate per healthy endpoint is calculated by multiplying `MAX_RATE_PER_ENDPOINT` by the number of endpoints in the network endpoint group, and then dividing by the number of healthy endpoints. rHr z--max-connections-per-endpointa Only valid for network endpoint group backends. Defines a maximum number of connections per endpoint if all endpoints are healthy. When one or more endpoints are unhealthy, an effective maximum average number of connections per healthy endpoint is calculated by multiplying `MAX_CONNECTIONS_PER_ENDPOINT` by the number of endpoints in the network endpoint group, and then dividing by the number of healthy endpoints. z --max-ratea? Maximum number of HTTP requests per second (RPS) that the backend can handle. Valid for network endpoint group and instance group backends (except for regional managed instance groups). Must not be defined if the backend is a managed instance group using load balancing-based autoscaling. z--max-rate-per-instancea? Only valid for instance group backends. Defines a maximum number of HTTP requests per second (RPS) per instance if all instances in the instance group are healthy. When one or more instances are unhealthy, an effective maximum RPS per healthy instance is calculated by multiplying `MAX_RATE_PER_INSTANCE` by the number of instances in the instance group, and then dividing by the number of healthy instances. This parameter is compatible with managed instance group backends that use autoscaling based on load balancing. z--max-connectionsz Maximum concurrent connections that the backend can handle. Valid for network endpoint group and instance group backends (except for regional managed instance groups). z--max-connections-per-instancea Only valid for instance group backends. Defines a maximum number of concurrent connections per instance if all instances in the instance group are healthy. When one or more instances are unhealthy, an effective average maximum number of connections per healthy instance is calculated by multiplying `MAX_CONNECTIONS_PER_INSTANCE` by the number of instances in the instance group, and then dividing by the number of healthy instances. z--max-in-flight-requestszR Maximum number of in-flight requests that the backend can handle. z%--max-in-flight-requests-per-instancez Only valid for instance group backends. Defines the maximum number of in-flight requests per instance. z%--max-in-flight-requests-per-endpointz Only valid for network endpoint group backends. Defines the maximum number of in-flight requests per endpoint. N) AddMaxUtilization add_grouprIrJrrKr floatintr0r1r2)rrLrMr3capacity_groupcapacity_incompatible_typesappend_help_texts rAddCapacityLimitsr\s F##$#/. "&& 124&&|4 (C  fZ!#$HJ       &                  &    l(((M\=N=N,N"   /   /   !-OrcLURS[R"SSS9SS9 g)z.Adds max utilization argument to the argparse.z--max-utilization? lower_bound upper_bounda Defines the maximum target for average utilization of the backend instance group. Supported values are `0.0` (0%) through `1.0` (100%). This is an optional parameter for the `UTILIZATION` balancing mode. You can use this parameter with other parameters for defining target capacity. For usage guidelines, see [Balancing mode combinations](https://cloud.google.com/load-balancing/docs/backend-service#balancing-mode-combos). rTN)r r BoundedFloatrs rrUrUs-  # # E   rcSn/nU(aURSS/5 U(aURS5 U(aUSR[U55- nUR S[ R "SSS 9US 9 g ) z2Adds capacity thresholds argument to the argparse.a Scales down the target capacity (max utilization, max rate, or max connections) without changing the target capacity. For usage guidelines and examples, see [Capacity scaler](https://cloud.google.com/load-balancing/docs/backend-service#capacity_scaler). r:r;r<zf This cannot be used when the endpoint type of an attached network endpoint group is {0}. z--capacity-scalerr^r_r`rTN)rIrJrrKr rrc)rrLrMrNrOs rAddCapacityScalarre)s ) 13GHIl+  z,-. /I    # # E rc(URSSUSS9 g)z+Adds the failover argument to the argparse.z --failover store_truez Designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService. Not compatible with the --global flag)actiondefaultr Nr )rris r AddFailoverrjDs#  / 0rc`[R"S5[R"S5S.nU$)zBReturns the --preference flag value choices name:description dict.a This is the default setting. If the designated preferred backends don't have enough capacity, backends in the default category are used. Traffic is distributed between default backends based on the load balancing algorithm used. z Backends with this preference setting are used up to their capacity limits first, while optimizing overall network latency. )DEFAULT PREFERREDr.r/) preferencess r_GetPreferencerpPs7" ??$ + rcSn/SQnUSR[U55- nURS[5SUS9 g)z)Adds preference argument to the argparse.z This parameter specifies whether a backend should be fully utilized before sending traffic to backends with the default preference. )r:r;r<z This parameter cannot be used with regional managed instance groups and when the endpoint type of an attached network endpoint group is {0}. z --preferencec"UR5$r>r?rAs rrCAddPreference..orErrFN)rrKr rp)rrNrOs r AddPreferencertasW)P  fZ* +,-)    rc[R"S5[R"S5[R"S5S.nU$)zHReturns the --traffic-duration flag value choices name:description dict.z7 Default value. Defaults to SHORT. zU Most requests are expected to finish with a sub-second latency. ze Most of the requests are expected to take more than multiple seconds to finish. )TRAFFIC_DURATION_UNSPECIFIEDSHORTLONGrn)traffic_durationss r_GetTrafficDurationrzssK'/oo7' oo  rc:URS[5SSS9 g)z/Adds traffic duration argument to the argparse.z--traffic-durationc"UR5$r>r?rAs rrC$AddTrafficDuration..rErz< The expected traffic duration for this service. rFN)r rzrs rAddTrafficDurationr~s&!#  rc UR5nSnURSS[R"[[ [ S.S/SS9[R"5US9 S nURS S[R"[[ [ S.S/SS9[R"5US9 U(aURS S S SSS9 gg)z1Adds a --custom-metrics flag to the given parser.a List of custom metrics that are used for CUSTOM_METRICS balancing mode and WEIGHTED_ROUND_ROBIN locality load balancing policy. Example: $ {command} --custom-metrics='name=my-signal,maxUtilization=0.8,dryRun=true' $ {command} --custom-metrics='name=my-signal,maxUtilization=0.8,dryRun=true' --custom-metrics='name=my-signal2,maxUtilization=0.2' $ {command} --custom-metrics='[{"name" : "my-signal", "maxUtilization" : 0.8, "dryRun" : true}, {"name" : "my-signal2", "maxUtilization" : 0.1}]'z--custom-metricsr,)namemaxUtilizationdryRunrT)spec required_keysrepeated)metavarrHrhr z File path to json file with custom metrics that are used for CUSTOM_METRICS balancing mode and WEIGHTED_ROUND_ROBIN locality load balancing policy. Example: $ {command} --custom-metrics-file='customMetric.json'z--custom-metrics-filez--clear-custom-metricsFrgNz&Clears current list of CUSTOM_METRICS.)rrhrir )rr r ArgObjectstrrWbool FlattenAction)radd_clear_argumentgrouprNhelp_text_files rAddCustomMetricsrs  - - /%Y)   %    & & ( =.   %    & & (    5 rc[U5S:a(SRSRUSS5US/5$SRU5$)Nz, or z, z or )lenjoin)typess rrKrKsOJN tyys,eBi C06 E0BCr)Fr>)FFN)FF)__doc__ __future__rrrr.googlecloudsdk.callioperr"googlecloudsdk.command_lib.computergooglecloudsdk.corer r0rr!r'r8rPr\rUrerjrprtrzr~rrKrrrs"K&'/(4#   >8=CN).=A8*/).$(k\  "*/).6 0"$  8vCr