mZSrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSK J r SS K J r SS K J r SS KJr SS KJr SS KJr SS KJr SS KJr SrSrSrSrSrS!SjrSrSr S"Sjr!Sr"Sr#Sr$Sr%Sr&Sr'Sr(Sr)"SS \*5r+g)#z6Flags and helpers for compute instances bulk commands.)absolute_import)division)unicode_literalsN) constants)metadata_utils) arg_parsers)base) exceptions) completers)flags) labels_utilc [R"SS9n[R"USS9 [[R "5[[S.nSR U5nURS[R"US9S US 9 g ) z0Adds arguments related to disks for bulk insert.F)container_mount_enabledT enable_kms)namebootz device-namescopea Attaches persistent disks to the instances. The disks specified must already exist. *name*::: The disk to attach to the instances. *boot*::: If ``yes'', indicates that this is a boot disk. The virtual machines will use the first partition of the disk for their root file systems. The default value for this is ``no''. *device-name*::: {} *scope*::: Can be `zonal` or `regional`. If ``zonal'', the disk is interpreted as a zonal disk in the same zone as the instance (default). If ``regional'', the disk is interpreted as a regional disk in the same region as the instance. The default value for this is ``zonal''. --disk)specappend)typeactionhelpN) instances_flagsGetDiskDeviceNameHelpAddBootDiskArgsstrr ArgBooleanformat add_argumentArgDict)parserdisk_device_name_help disk_arg_spec disk_helps >lib/googlecloudsdk/command_lib/compute/instances/bulk/flags.pyAddDiskArgsForBulkr($s*??#!!&T:$$& - && '! $    M 2   cUR=(d /H=nSU;dM [R"SSR[R 55e [R "USS9 [R"USSS9 g)z/Validates the values of all disk-related flags.rrzH[name] is missing in [--disk]. [--disk] value must be of the form [{0}].Tr)enable_snapshotsenable_image_csekN)diskr InvalidArgumentExceptionr r DISK_METAVARValidateDiskBootFlagsValidateCreateDiskFlags)argsr-s r'ValidateBulkDiskFlagsr3Msriio2od T  / /  6/667 ''>)) r)c P[R"SS[RSSSS9$)Nz--source-instance-templatezinstance templateFzcompute.instanceTemplatesz~The name of the instance template that the instance will be created from. Users can override fields by specifying other flags.)r resource_name completerrequiredglobal_collection short_help) compute_flagsResourceArgumentcompute_completersInstanceTemplatesCompleterr)r'!MakeBulkSourceInstanceTemplateArgr?_s/  ' ' ''"==3   r)c8SSSS.nURSSSUSS 9 g ) z4Adds bulk creation target shape arguments to parser.zEnforces VM placement in one allowed zone. Use this to avoid cross-zone network egress or to reduce network latency. This is the default value.zAllows distribution of VMs in zones where resources are available while distributing VMs as evenly as possible across selected zones to minimize the impact of zonal failures. Recommended for highly available serving or batch workloads.zAllows creating VMs in multiple zones if one zone cannot accommodate all the requested VMs. The resulting distribution shapes can vary.)ANY_SINGLE_ZONEBALANCEDANYz--target-distribution-shapeSHAPEc"UR5$)N)upper)xs r'0AddDistributionTargetShapeArgs..s QWWYr)z Specifies whether and how to distribute VMs across multiple zones in a region or to enforce placement of VMs in a single zone. The default shape is `ANY_SINGLE_ZONE`. )metavarrchoicesrN)r!)r# choices_texts r'AddDistributionTargetShapeArgsrMns>   2  ,$ #   r)c \URS[SS9 URS[SS9 URSSS9nURS[R"5S S S 9 URS S S9 U(a0URSSS9nURSSS9 URSSS9 URSS[R "5SS9 U(a%URSS[R "5SS9 U(a.URSS[R "[ [ S9SS9 gg) z0Adds bulk creation specific arguments to parser.--countaN Number of Compute Engine virtual machines to create. If specified, and `--predefined-names` is specified, count must equal the amount of names provided to `--predefined-names`. If not specified, the number of virtual machines created will equal the number of names provided to `--predefined-names`. )rrz --min-counta The minimum number of Compute Engine virtual machines that must be successfully created for the operation to be considered a success. If the operation successfully creates as many virtual machines as specified here they will be persisted, otherwise the operation rolls back and deletes all created virtual machines. If not specified, this value is equal to `--count`.T)mutexr7z--predefined-names INSTANCE_NAMEab List of predefined names for the Compute Engine virtual machines being created. If `--count` is specified alongside this flag, provided count must equal the amount of names provided to this flag. If `--count` is not specified, the number of virtual machines created will equal the number of names provided. rrJrz--name-patterna Name pattern for generating instance names. Specify a pattern with a single sequence of hash (#) characters that will be replaced with generated sequential numbers of instances. E.g. name pattern of 'instance-###' will generate instance names 'instance-001', 'instance-002', and so on, until the number of virtual machines specified using `--count` is reached. If instances matching name pattern exist, the new instances will be assigned names to avoid clashing with the existing ones. E.g. if there exists `instance-123`, the new instances will start at `instance-124` and increment from there. r)r7rP--regionz Region in which to create the Compute Engine virtual machines. Compute Engine will select a zone in which to create all virtual machines. z--zoneag Zone in which to create the Compute Engine virtual machines. A list of zones can be fetched by running: $ gcloud compute zones list To unset the property, run: $ gcloud config unset compute/zone Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. --location-policyz ZONE=POLICYa Policy for which zones to include or exclude during bulk instance creation within a region. Policy is defined as a list of key-value pairs, with the key being the zone name, and value being the applied policy. Available policies are `allow` and `deny`. Default for zones if left unspecified is `allow`. Example: gcloud compute instances bulk create --name-pattern=example-### --count=5 --region=us-east1 --location-policy=us-east1-b=allow,us-east1-c=deny )rJrr--max-count-per-zonezZONE=MAX_COUNT_PER_ZONEax Maximum number of instances per zone specified as key-value pairs. The zone name is the key and the max count per zone is the value in that zone. Example: gcloud compute instances bulk create --name-pattern=example-### --count=5 --region=us-east1 --max-count-per-zone=us-east1-b=2,us-east-1-c=1 --per-instance-hostnameszINSTANCE_NAME=INSTANCE_HOSTNAME)key_type value_typeac Specify the hostname of the instance to be created. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. N)r!int add_grouprArgListr"r)r#add_zone_region_flagssupport_max_count_per_zonesupport_custom_hostnames name_grouplocations r'AddBulkCreateArgsrbs       ( dT:*          T:H    "      "  )  "   "1  ## >  r)cL[[S.nSnX2S'[RUS'SnSUS'US- n[US 'US - n[RUS 'S nUS US3- nU(a[R US'US- nUR S[R"USS9SSUS9 g)z-Adds Networking Args for Bulk Create Command.)networksubnetc|UR5nU[R;aU$[R"SS5e)N--network-interfacezInvalid value for network-tier)rFr!NETWORK_TIER_CHOICES_FOR_INSTANCEr r.)network_tier_input network_tiers r'ValidateNetworkTier8AddBulkCreateNetworkingArgs..ValidateNetworkTiers=%++-LyBBB   / / !A r)z network-tierznic-typea Adds a network interface to the instance. Mutually exclusive with any of these flags: *--network*, *--network-tier*, *--no-address*, *--subnet*, *--stack-type*. This flag can be repeated to specify multiple network interfaces. *network*::: Specifies the network that the interface will be part of. If subnet is also specified it must be subnetwork of this network. If neither is specified, this defaults to the "default" network. *network-tier*::: Specifies the network tier of the interface. ``NETWORK_TIER'' must be one of: `PREMIUM`, `STANDARD`. The default value is `PREMIUM`. *subnet*::: Specifies the subnet that the interface will be part of. If network key is also specified this must be a subnetwork of the specified network. *nic-type*::: Specifies the Network Interface Controller (NIC) type for the interface. ``NIC_TYPE'' must be one of: `GVNIC`, `VIRTIO_NET`. Nz no-addressz *no-address*::: If specified the interface will have no external IP. If not specified instances will get ephemeral IPs. z queue-counta& *queue-count*::: Specifies the networking queue count for this interface. Both Rx and Tx queues will be set to this number. If it's not specified, a default queue count will be assigned. See https://cloud.google.com/compute/docs/network-bandwidth#rx-tx for more details. z stack-typez%`IPV4_ONLY`, `IPV4_IPV6`, `IPV6_ONLY`zl *stack-type*::: Specifies whether IPv6 is enabled on the interface. ``STACK_TYPE'' must be one of: z*. The default value is `IPV4_ONLY`. z igmp-querya *igmp-query*::: Determines if the Compute Engine Instance can receive and respond to IGMP query packets on the specified network interface. ``IGMP_QUERY'' must be one of: `IGMP_QUERY_V2`, `IGMP_QUERY_DISABLED`. It is disabled by default. rgT)rallow_key_onlyrzPROPERTY=VALUE)rrrJr) rrValidateNetworkInterfaceNicTyperZ!ValidateNetworkInterfaceStackType!ValidateNetworkInterfaceIgmpQueryr!rr")r#support_igmp_query%multiple_network_interface_cards_specrknetwork_interface_help stack_typess r'AddBulkCreateNetworkingArgsrus+' ;N755( 3,9=' 5 :=' 677( 58+!$$/=1 99*,7     4  ! r)cUR5nURS[R"5SSS9 URSS[ 5[R "5SS9 g ) z9Adds instance flexibility policy arguments to the parser.z"--instance-selection-machine-types MACHINE_TYPEa\ Specifies a list of machine types to consider for instance creation. The bulk create operation will attempt to create instances from this list based on capacity availability. This flag is only valid when a region is specified. rR--instance-selectionzHname=NAME[,rank=RANK][,machine-type=MACHINE_TYPE]...[,disk=DISK_JSON]...a^\ Specifies a list of machine types to consider for instance creation. The bulk create operation will attempt to create instances from this list based on capacity availability. This flag is only valid when a region is specified. Keys for each instance selection: name: (Required) A unique name for this instance selection group. machine-type: (Required) Repeatable. Specifies a machine type to include in this group (e.g., machine-type=n1-standard-1). rank: (Optional) An integer representing the priority. Lower ranks are preferred. Defaults to 0. disk: (Optional) Repeatable. A JSON string defining a disk to attach or override, conforming to the Compute Engine AttachedDisk API structure. Example: disk='{"deviceName": "boot-disk", "boot": true, "initializeParams": {"sourceImage": "IMAGE_URL"}}' )rJrrrN)add_mutually_exclusive_groupr!rr\ArgMultiValueDict FlattenAction)r# mutex_groups r' AddInstanceFlexibilityPolicyArgsr}psl335+ *      X    & & ( r)c,SS/n/nUH,nURU5(dMURU5 M. U(dgURS5(d[R"SS5eURS5(aUR HnSU;a[R "SS5eS U;d US (d[R "SS 5eS U;dMOUS nUR5(aMk[R "SS 5e gg) z>Validates args supplied to --instance-selection-machine-types. instance_selection_machine_typesinstance_selectionNregionrTzKFlag --region is required for any of the instance flexibility policy flags.rz Missing instance selection name. machine-typez+Missing machine type in instance selection.rankz-Invalid value for rank in instance selection.)IsKnownAndSpecifiedr IsSpecifiedr RequiredArgumentExceptionrr.isdigit)r2flexibility_policy_argsspecified_argsargrrs r'ValidateInstanceFlexibilityArgsrs'). $c $$C %   ( # #  . .    *++"55 ) )11 "D    2 2#N311 "O   % %!&)||~~33"=  6,r)c  [R"U5 [U5 [R"USSSSSU S9 [R "U5 [R "U5 [R"U5 [R"USS9 [R"U5 [R"U5 [R"UU S9 U (a[R"USS9 U(a[R"U5 [R"U5 [R"U5 [R "USSS9 [R""U5 [R$"U5 [R&"U5 [R("U5 [R*"USS 9 [-UU S 9 [R."USU S 9 [R0"U5 [R2"U5 [R4"U5 [R6"U5 [R8"U5 U(a[R:"U5 U(a[R<"U5 [R>"US S US9 [@RB"USS5 [RD"U5 [RF"U5 [HRJ"US5 [LRN"U5 URQSSS9 [RRTRWU5 URXR[S5 [R\"U5 [R^"U5 [R`"U5 [Rb"U5 [eU5 [Rf"USS9 [Rh"X5 [Rj"USS 9 [Rl"USSUS9 [Rn"U5 [qUUUU5 [Rr"U5 U (a[Rt"U5 [Rv"U5 U(a[Rx"U5 U(a [{U5 U(a[R|"U5 gg)z*Register parser args common to all tracks.TF)rr+ image_csek include_name support_bootsupport_source_snapshot_region) deprecate)support_flex_start) is_createaxHowever, if neither `--scopes` nor `--no-scopes` are specified and the project has no default service account, then the instance will be created with no scopes. Note that the level of access that a service account has is determined by a combination of access scopes and IAM roles so you must configure both access scopes and IAM roles for the service account to work properly.)extra_scopes_help)instance)rq)r+rz+Specifies the reservation for the instance.z)The type of reservation for the instance.) group_text affinity_text support_specific_then_x_affinityzadded torz(source snapshots or source machine imagez --descriptionz1Specifies a textual description of the instances.rSz5multi(instances:format="table(name,zone.basename())"))support_ipv6_only)!support_confidential_compute_type%support_confidential_compute_type_tdxsupport_snp_svsmN)?rAddMetadataArgsr(rAddCreateDiskArgsAddCanIpForwardArgsAddAcceleratorArgsAddMachineTypeArgsAddMaintenancePolicyArgsAddNoRestartOnFailureArgsAddPreemptibleVmArgsAddProvisioningModelVmArgsAddGracefulShutdownArgsAddPreemptionNoticeDurationArgs AddNetworkPerformanceConfigsArgs"AddInstanceTerminationActionVmArgsAddServiceAccountAndScopeArgs AddTagsArgsAddCustomMachineTypeArgsAddNoAddressArgAddNetworkArgsAddNetworkTierArgsru AddImageArgsAddShieldedInstanceConfigArgsAddNestedVirtualizationArgsAddThreadsPerCoreArgsAddEnableUefiNetworkingArgsAddResourceManagerTagsArgsAddNumaNodeCountArgsAddDisplayDeviceArgAddReservationAffinityGroupmaintenance_flagsAddResourcePoliciesArgsAddMinNodeCpuArgAddLocationHintArgr:AddEraseVssSignaturer AddCreateLabelsFlagsr!r ASYNC_FLAG AddToParser display_info AddFormatAddVisibleCoreCountArgsAddLocalSsdArgsWithSizeAddMaxRunDurationVmArgsAddDiscardLocalSsdVmArgsrMAddStackTypeArgsAddMinCpuPlatformArgsAddPublicDnsArgsAddConfidentialComputeArgs"AddPostKeyRevocationActionTypeArgsrb AddPerformanceMonitoringUnitArgsAddWatchdogTimerArgAddTurboModeArgsAddSkipGuestOsShutdownArgsr}AddWorkloadIdentityConfigArgs)r# release_tracksupport_display_devicesupport_numa_node_countr]rr^r_rsupport_watchdog_timerrqsupport_graceful_shutdownrrsupport_skip_guest_os_shutdown"support_preemption_notice_duration#support_instance_flexibility_policy support_workload_identity_configs r'AddCommonBulkInsertArgsrs*  (V## %C%%f-$$V,$$V,**6TB++F3&&v.,, +++FdC'33F;226:44V<//    f%**62!!&)  ($$Vd; +  %C //7--f5''/--f5,,V4((0''/-- >?'G ++FJ K""6*$$V,$$ 8""6*O//f%=))&1))&1))&1**62 (""6TB''>""6D9,, (,,0'  44V<   226:''/""6*#..v6($V,%11&9&r)c>URS5(a-URS5(d[R"SS5eURS5(aDURS5(dURS5(d[R"SS 5eg g ) zValidates args for bulk create. name_patterncountrOzYThe `--count` argument must be specified when the `--name-pattern` argument is specified.location_policyzonerrTzaThe `--region` argument must be used alongside the `--location-policy` argument and not `--zone`.Nrr rr2s r'ValidateBulkCreateArgsrXs n%%d.>.>w.G.G  . .g  '(( vd&6&6x&@&@  . .o 'A)r)cURS5(aDURS5(dURS5(d[R"SS5egg)z+Validates target shape arg for bulk create.target_distribution_shaperrrTzkThe `--region` argument must be used alongside the `--target_distribution_shape` argument and not `--zone`.Nrrs r'ValidateBulkTargetShapeArgsrhsY 122 vd&6&6x&@&@  . .y 'A3r)cURS5(aURR5HupURS5n[ U5S:wdUSSR 5(d&[ R"SSRU55eUS;dMn[ R"SS RU55e g g ) z-Validates args supplied to --location-policy.r-rUKey [{}] must be a zone.)allowdenyz'Value [{}] must be one of [allow, deny]N) rritemssplitlenrr r.r )r2rpolicy zone_splits r'ValidateLocationPolicyArgsrss '((,,224 ::c?j j/Q Ar"**,,11 !;!B!B4!H   ( (11  5 < $E$Ed$K  "% ( (11 " ; B B5 I  74r)c<URS5(aURS5(d[R"SS5eURR 5H:upXR ;dM[R "SSRU55e gg)z4Validates args supplied to --per-instance-hostnames.per_instance_hostnamespredefined_namesrWzaThe `--per-instance-hostnames` argument must be used alongside the `--predefined-names` argument.zInstance [{}] missing in predefined_names. Instance names from --per-instance-hostnames must be included in --predefined-names flag.N)rr rrrrr.r )r2 instance_name_s r'ValidateCustomHostnamesrs 677  # #$6 7 7  0 0 $ q !77==? 33 311 & VM*   @ 8r)cz[U5S:=(a' [R"S5RU5SL$)zValidates if zone is valid.@z^\w+-\w+\d+-\w+N)rrecompilematch)rs r'rrs3 $i"nO$67==dC4Or)cP[R"S5RU5SL$)z.Validates if count is positive natural number.z ^[1-9]\d*N)rrr)rs r'rrs! L ! ' ' .d ::r)cT[U5 [U5 [U5 U(a [U5 U(a [ U5 [ U5 [ R"U5 [ R"U5 [ R"U5 [ R"U5 [ R"U5 [ R"U5 [ R"U5 [ R"U5 [ R"USS9 U(a [!U5 gg)z%Validates all bulk and instance args.T)support_max_run_durationN)rrrrrr3rValidateImageFlagsValidateLocalSsdFlagsValidateNicFlags"ValidateServiceAccountAndScopeArgsValidateAcceleratorArgsValidateNetworkTierArgs ValidateReservationAffinityGroup%ValidateNetworkPerformanceConfigsArgsValidateInstanceSchedulingr)r2r^r_rs r'ValidateBulkInsertArgsrsd#T"%D!$$T*''-""4(44T:))$/))$/224877=,, T)#D))r)c$\rSrSrSrSrSrSrg)rzizCustom parser for --instance-selection flag. Parses a comma-separated string of key=value pairs. Special handling for the 'disk' key, where the value is expected to be a single-quoted JSON string. c U(d0$URU5n0nUHnupEUS:Xa8[R"U5nXC;aX4RU5 M<U/X4'MCUS:Xa!XC;aX4RU5 McU/X4'MjXSU'Mp U$![Ra"n[ R "SSUSU35eSnAff=f)Nr-rxzInvalid JSON for disk key: z - Received: r)_SplitArgStringjsonloadsrJSONDecodeErrorr r.)selfargument_valueentriesresultkeyvalue disk_dictes r'__call__ArgMultiValueDict.__call__s  i"">2G F   jj') ] K  y )$+FK . = +  U #&+s '( M## 33$+A3mE7C   s.BBC 'CC cSn[R"X!5n/nUH#upVnU(aUOUnURXX45 M% U$)zTSplits the argument string by commas, respecting single-quoted JSON for disk values.z([\w-]+)=(?:'([^']*)'|([^,]*)))rfindallr) rrpatternmatchesrrsingle_quoted_val unquoted_valrs r'r!ArgMultiValueDict._SplitArgStringsJ 0Gjj1GG07, #4,e nnc\"18 Nr)r>N)__name__ __module__ __qualname____firstlineno____doc__rr__static_attributes__r>r)r'rzrzs: r)rz)F)FFTFFFFFFFFFFFFF),r, __future__rrrrrgooglecloudsdk.api_lib.computerrgooglecloudsdk.callioperr r "googlecloudsdk.command_lib.computer r<r r:,googlecloudsdk.command_lib.compute.instancesr4googlecloudsdk.command_lib.compute.resource_policiesr$googlecloudsdk.command_lib.util.argsr r(r3r?rMrbrur}rrrrrrrrrrobjectrzr>r)r'r6s=&' 49/(.OEQ[<&R$ B@J[| F' Z!!$"%* ##(#(',(-%*%X:v   (   $; *<22r)