dZddlmZddlmZddlmZddlZddlZddlZddlZddl m Z ddl m Z ddlm ZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlm Z ddl!m"Z"ddl#Z#dZ$dZ%dZ&dZ'dZ(dZ)dZ*GddejVZ,GddejZZ.Gdd e/Z0de'dd!d!dfd"Z1de)dd!d!dfd#Z2Gd$d%ejZZ3Gd&d'e4Z5d9d(Z6Gd)d*e4Z7Gd+d,e4Z8Gd-d.e4Z9Gd/d0e4Z:d1Z;d2Zd5Z?d:d6Z@d7ZAd8ZBy);z3Flags and helpers for the compute related commands.)absolute_import)division)unicode_literalsN)filter_rewrite)service)actions) arg_parsers) completers)scope)scope_prompter) exceptions)log) properties) resources) console_io)resource_projection_spec)textz projects/([^/]+)/global/([^/]+)/z!projects/([^/]+)/regions/([^/]+)/zprojects/([^/]+)/zones/([^/]+)/aIf not specified and the ``compute/zone'' property isn't set, you might be prompted to select a zone (interactive mode only). To avoid prompting when this flag is omitted, you can set the ``compute/zone'' property: $ gcloud config set compute/zone ZONE 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''. zIf not specified, you might be prompted to select a zone (interactive mode only). A list of zones can be fetched by running: $ gcloud compute zones list aIf not specified, you might be prompted to select a region (interactive mode only). To avoid prompting when this flag is omitted, you can set the ``compute/region'' property: $ gcloud config set compute/region REGION A list of regions can be fetched by running: $ gcloud compute regions list To unset the property, run: $ gcloud config unset compute/region Alternatively, the region can be stored in the environment variable ``CLOUDSDK_COMPUTE_REGION''. zIf not specified, you might be prompted to select a region (interactive mode only). A list of regions can be fetched by running: $ gcloud compute regions list ceZdZdZdZdZdZy)ScopeFlagsUsagezFEnum representing gcloud flag generation options for ResourceArgument.N)__name__ __module__ __qualname____doc__GENERATE_DEDICATED_SCOPE_FLAGSUSE_EXISTING_SCOPE_FLAGSDONT_USE_SCOPE_FLAGS/lib/googlecloudsdk/command_lib/compute/flags.pyrrpsN#$ r!rc eZdZy)ScopesFetchingExceptionN)rrrr r!r"r$r$wsr!r$ceZdZdZy)BadArgumentExceptionz2Unhandled error for validating function arguments.N)rrrrr r!r"r&r&{s:r!r&Fc jdjtjt|dz|xsd||} d} ||dz| z} |j d| z|t j tjtjjj|xsdj| | y) aGAdds a --zone flag to the given parser. Args: parser: argparse parser. resource_type: str, human readable name for the resource type this flag is qualifying, for example "instance group". operation_type: str, human readable name for the operation, for example "update" or "delete". flag_prefix: str, flag will be named --{flag_prefix}-zone. explanation: str, detailed explanation of the flag. help_text: str, help text will be overridden with this value. hidden: bool, If True, --zone argument help will be hidden. plural: bool, resource_type will be pluralized or not depending on value. custom_plural: str, If plural is True then this string will be used as resource types, otherwise resource_types will be pluralized by appending 's'. zZone of the {0} to {1}.rzoneN---{0} {1})hidden completeractionhelp) formatr Pluralizeint add_argumentr ZonesCompleterr StorePropertyrVALUEScomputer) parser resource_typeoperation_type flag_prefix explanation help_textr-plural custom_plural short_help flag_names r" AddZoneFlagrDs()// nn f+/=.B ?@NP*)c!I-I Y ))  " ":#4#4#<#<#A#A B  A (([A Cr!c jdjtjt|dz|xsd||} d} ||dz| z} |j d| zt j tjtjjj||xsdj| | y) aMAdds a --region flag to the given parser. Args: parser: argparse parser. resource_type: str, human readable name for the resource type this flag is qualifying, for example "instance group". operation_type: str, human readable name for the operation, for example "update" or "delete". flag_prefix: str, flag will be named --{flag_prefix}-region. explanation: str, detailed explanation of the flag. help_text: str, help text will be overridden with this value. hidden: bool, If True, --region argument help will be hidden. plural: bool, resource_type will be pluralized or not depending on value. custom_plural: str, If plural is True then this string will be used as resource types, otherwise resource_types will be pluralized by appending 's'. zRegion of the {0} to {1}.rr(regionNr*r+r,)r.r/r-r0) r1rr2r3r4r RegionsCompleterrr6rr7r8rFr9s r" AddRegionFlagrHs*+11 nn f+/=.B ?@NP*)c!I-I Y++  " ":#4#4#<#<#C#C D   A (([A Cr!c"eZdZdZfdZxZS)UnderSpecifiedResourceErrorzARaised when argument is required additional scope to be resolved.c t|dkDrdnd}tt|dj |ddj t ||ddj |y)Nr)zone of flags)r(flagz8Underspecified resource [{3}]. Specify {0}the [{1}] {2}.rz, )lensuperrJ__init__r1joinsorted)selfunderspecified_names flag_namesphrases __class__s r"rPz$UnderSpecifiedResourceError.__init__s^&)*o&9"|G %t5B   &,-  ./ 12r!)rrrrrP __classcell__)rWs@r"rJrJsI22r!rJceZdZdZddZy) ResourceStubz6Interface used by scope listing to report scope names.Nc ||_||_yN)name deprecated)rSr]r^s r"rPzResourceStub.__init__sDI DOr!r\rrrrrPr r!r"rZrZs >!r!rZc@tjjtjt j |tjjtjtj |tjjdifd}|S)z&Constructs default zone/region lister.ctdgS)Nr()r])rZ)_s r"z'GetDefaultScopeLister..s 21F0Gr!cxs4tjjjj d}i}|D]}||||<|S)NT)required)rr7coreprojectGet)scopesrbprjresultsr rg scope_funcs r"Listerz%GetDefaultScopeLister..ListersV  FZ&&++33777FCG(z%(-gen Nr!) compute_scope ScopeEnumZONE functoolspartial zones_serviceListREGIONregions_serviceGLOBAL)compute_clientrgrmrls ` @r"GetDefaultScopeListerryst""   M.. ?$$   O00. A$$&G * -r!ceZdZdZdZy)ResourceArgScopez2Facilitates mapping of scope, flag and collection.cJ||_|r^|jdd}|tjjur|j dz|z|_n)|dz|j z|_n|j |_d|j jddz|_||_y)Nr*rbr+) scope_enumreplacernrorwrCrM collection)rSr r=rs r"rPzResourceArgScope.__init__sDO''S1k -))00 03.<$s*U__<dnt~~--c377DI DOr!Nr_r r!r"r{r{s : !r!r{cHeZdZdZdZdZdZdZd dZdZ d Z d Z d Z y) ResourceArgScopesz Represents chosen set of scopes.c ||_i|_yr\)r=ri)rSr=s r"rPzResourceArgScopes.__init__s"DDKr!cLt||j||j|<yr\)r{r=ri)rSr rs r"AddScopezResourceArgScopes.AddScopes)%1A1A:NDKKr!ctj|jD]!}t||jd}|||fcSy)z8Given argparse args return selected scope and its value.NNN)six itervaluesrigetattrrC)rSargsresource_scope scope_values r"SpecifiedByArgsz!ResourceArgScopes.SpecifiedByArgssC..5D.":":DAk  {**6 r!ctjt|r)|jtj j dfStjt|r)|jtj jdfStjt|r)|jtj jdfSy)z9Given resource value return selected scope and its value.globalrFr)r) rematch_GLOBAL_RELATIVE_PATH_REGEXrirnrorw_REGIONAL_RELATIVE_PATH_REGEXru_ZONAL_RELATIVE_PATH_REGEXrp)rSvalues r"SpecifiedByValuez"ResourceArgScopes.SpecifiedByValues xx+U3 [[0077 8( BB / 7 [[0077 8( BB ,e 4 [[0055 6 >> r!Nct|jdk(r(ttj|jS|S)zBSee if there is no ambiguity even if scope is not known from args.r)rNrinextrr)rS default_scopes r"GetImplicitScopez"ResourceArgScopes.GetImplicitScopes1 4;;1 #..- .. r!cRttj|jSr\)iterrrrirSs r"__iter__zResourceArgScopes.__iter__s t{{+ ,,r!c||jvSr\rirSr s r" __contains__zResourceArgScopes.__contains__"s DKK r!c |j|Sr\rrs r" __getitem__zResourceArgScopes.__getitem__%s ;;u r!c,t|jSr\)rNrirs r"__len__zResourceArgScopes.__len__(s t{{ r!r\) rrrrrPrrrrrrrrr r!r"rrs3(O - r!rcfeZdZdZdZed dZdZdZ d dZ dZ d Z d d Z dd Z y)ResourceResolveraObject responsible for resolving resources. There are two ways to build an instance of this object: 1. Preferred when you don't have instance of ResourceArgScopes already built, using .FromMap static function. For example: resolver = ResourceResolver.FromMap( 'instance', {compute_scope.ScopeEnum.ZONE: 'compute.instances'}) where: - 'instance' is human readable name of the resource, - dictionary maps allowed scope (in this case only zone) to resource types in those scopes. - optional prefix of scope flags was skipped. 2. Using constructor. Recommended only if you have instance of ResourceArgScopes available. Once you've built the resover you can use it to build resource references (and prompt for scope if it was not specified): resolver.ResolveResources( instance_name, compute_scope.ScopeEnum.ZONE, instance_zone, self.resources, scope_lister=flags.GetDefaultScopeLister( self.compute_client, self.project)) will return a list of instances (of length 0 or 1 in this case, because we pass a name of single instance or None). It will prompt if and only if instance_name was not None but instance_zone was None. scope_lister is necessary for prompting. c ||_||_y)aZInitilize ResourceResolver instance. Prefer building with FromMap unless you have ResourceArgScopes object already built. Args: scopes: ResourceArgScopes, allowed scopes and resource types in those scopes. resource_name: str, human readable name for resources eg "instance group". N)ri resource_name)rSrirs r"rPzResourceResolver.__init__PsDK&Dr!Nct|}tj|D]\}}|j||t ||S)aInitilize ResourceResolver instance. Args: resource_name: str, human readable name for resources eg "instance group". scopes_map: dict, with keys should be instances of ScopeEnum, values should be instances of ResourceArgScope. scope_flag_prefix: str, prefix of flags specyfying scope. Returns: New instance of ResourceResolver. r=)rr iteritemsrr)r scopes_mapscope_flag_prefixrir resources r"FromMapzResourceResolver.FromMap_sA+< =F==4x ooeX&5 FM 22r!cXt|tstdj|y)Nz+Expected names to be a list but it is '{0}') isinstancelistr&r1)rSnamess r"_ValidateNameszResourceResolver._ValidateNamesqs. eT " 7 > >u E GG #r!c |e||jvrVtdj|dj|jDcgc]}|jj c}yycc}w)Nz|jtjjk7r|jjSyy)z#Gets the resource scope parameters.Nrg)paramsr)r}rnrorwCollectionForScopeParseName property_func)rSrrrgapi_resource_registry with_projectrs r"_GetResourceScopeParamz'ResourceResolver._GetResourceScopeParam}s  " "m&=&=&D&D D",,??  % %' &,,W#&-()- / ',,"-==ATV D ^66*44;;<((666<r!cg}g}|D]*} |j|||dg} |j | ,||fS#tjtjtj f$r|r|g} |j | YbwxYw)aKReturns pair of lists: resolved references and unresolved names. Args: names: list of names to attempt resolving params: params given when attempting to resolve references collection: collection for the names scope_defined: bool, whether scope is known api_resource_registry: Registry object Frrenforce_collection)rrUnknownCollectionExceptionRequiredFieldOmittedExceptionrRequiredPropertyErrorappend) rSrrr scope_definedrrefsrTr]refs r"_GetRefsAndUnderspecifiedNamesz/ResourceResolver._GetRefsAndUnderspecifiedNamess D )$**46@>C+EF kk# % %%2255..0)  f##C( )s8A BBctj|}|jD]}|rd|i}ni}|jj||jj <|D]Y} |j | d||jdg} |j| |j| |j| [y#tjtjtjtf$rYwxYw)z:Resolve argument against available scopes of the resource.rgrFrN)copydeepcopyrir}r param_namerrremoverrrrrr ValueError) rSrrgrTrrrr rr]rs r"_ResolveMultiScopez#ResourceResolver._ResolveMultiScopes MM. /E  w ,1,<,<,J,JfU   ( ()$ &,,T!WV8=8H8H@E-GH# ++d  ++c   % %d + 447700    s!AB<<7C65C6c|sy|Dcgc]}|d }}tjs.t||jD cgc]} | jc} t j |j||jD cgc]} | jc} | |jnd|\} } | .t||jD cgc]} | jc} |j| } |rd|i} ni} | jtjjk7r| | | jj<|D]'}|j|d| | jd|d<)ycc}wcc} wcc} wcc} w)aAttempt to resolve scope for unresolved names. If unresolved_names was generated with _GetRefsAndUnderspecifiedNames changing them will change corresponding elements of refs list. Args: underspecified_names: list of one-items lists containing str default_scope: default scope for the resources scope_lister: callback used to list potential scopes for the resources project: str, id of the project api_resource_registry: resources Registry with_project: indicates whether or not project is associated. It should be False for flexible resource APIs Raises: UnderSpecifiedResourceError: when resource scope can't be resolved. NrrgTr)r CanPromptrJrirMr PromptForScoperr}rnrorwrrr)rSrTr scope_listerrgrrnrrresource_scope_enumrrrr]s r"_ResolveUnderspecifiedNamesz,ResourceResolver._ResolveUnderspecifiedNamessr0  / 0/aQqT/E 0    ! ' /L 1 /L MM'5'D'D E$++#F+QALL+#F$1$=   4($" ' /L 1 /L MM[[!45N Wff  M$;$;$B$BB5@f^ & & 1 12$%++ q'#..! ,#d1g%/ 10M$G0Ms E#E( E- E2 c |j||j|||j|}||j|}|#|j|d} | j }d} |r;|xs2t j jjj} d| i} ni} ||jj|}| ri| | } |j||| ||} | | | |jj<|xr |j}|j|| ||du|\}}|r-t!|jdkDr|j#|| ||||j%|||| |||Dcgc]}|d }}|jDcgc]}|j}}|D]W}|j'|vst)j*dj-||j'|j/ |Scc}wcc}w) a@Resolve this resource against the arguments. Args: names: list of str, list of resource names resource_scope: ScopeEnum, kind of scope of resources; if this is not None scope_value should be name of scope of type specified by this argument. If this is None scope_value should be None, in that case if prompting is possible user will be prompted to select scope (if prompting is forbidden it will raise an exception). scope_value: ScopeEnum, scope of resources; if this is not None resource_scope should be type of scope specified by this argument. If this is None resource_scope should be None, in that case if prompting is possible user will be prompted to select scope (if prompting is forbidden it will raise an exception). api_resource_registry: instance of core.resources.Registry. default_scope: ScopeEnum, ZONE, REGION, GLOBAL, or None when resolving name and scope was not specified use this as default. If there is exactly one possible scope it will be used, there is no need to specify default_scope. scope_lister: func(scope, underspecified_names), a callback which returns list of items (with 'name' attribute) for given scope. with_project: indicates whether or not project is associated. It should be False for flexible resource APIs. source_project: indicates whether or not a project is specified. It could be other projects. If it is None, then it will use the current project if with_project is true additional_params: Dict, additional parameters to pass in. Returns: Resource reference or list of references if plural. Raises: BadArgumentException: when names is not a list or default_scope is not one of the configured scopes. UnderSpecifiedResourceError: if it was not possible to resolve given names as resources references. Nzcompute.projectsrrg)rrr,)expectedgotpath)rrrirrrr7rfrg GetOrFailrrr}rrrrNrr Collectionr WrongResourceCollectionExceptionrQSelfLink)rSrrrrrrrsource_projectadditional_paramssource_project_refrgrresource_scope_paramrrrTrr expected_collectionss r"ResolveResourcesz!ResourceResolver.ResolveResourcessR^ }-!{{>2n kk-0m!066 %779)..0nGL*"3"3"8"8"@"@"J"J"Lg Wff{{33MBn.&.-.f66! 7# '5If^ & & 1 12=N$=$=J"&!D!D vz;d#:"D  DKK 01 4 lG5I3T;  $$! %## #dsCFdD #;?++F+E,,+F  !5 588XX23 ! ! K $Gs 5 HH r\)TNNTNN)rrrrrP staticmethodrrrrrrrrr r!r"rr,sd!F '33"G J+/ 76&:@04 7#|&*$($(&*)-tr!rc|eZdZdZddddddddddddddddddej fdZ d dZ d dZdZ y) ResourceArgumentaEncapsulates concept of compute resource as command line argument. Basic Usage: class MyCommand(base.Command): _BACKEND_SERVICE_ARG = flags.ResourceArgument( resource_name='backend service', completer=compute_completers.BackendServiceCompleter, regional_collection='compute.regionBackendServices', global_collection='compute.backendServices') _INSTANCE_GROUP_ARG = flags.ResourceArgument( resource_name='instance group', completer=compute_completers.InstanceGroupsCompleter, zonal_collection='compute.instanceGroups',) @staticmethod def Args(parser): MyCommand._BACKEND_SERVICE_ARG.AddArgument(parser) MyCommand._INSTANCE_GROUP_ARG.AddArgument(parser) def Run(args): api_resource_registry = resources.REGISTRY.CloneAndSwitch( api_tools_client) backend_service_ref = _BACKEND_SERVICE_ARG.ResolveAsResource( args, api_resource_registry, default_scope=flags.ScopeEnum.GLOBAL) instance_group_ref = _INSTANCE_GROUP_ARG.ResolveAsResource( args, api_resource_registry, default_scope=flags.ScopeEnum.ZONE) ... In the above example the following five arguments/flags will be defined: NAME - positional for backend service --region REGION to qualify backend service --global to qualify backend service --instance-group INSTANCE_GROUP name for the instance group --instance-group-zone INSTANCE_GROUP_ZONE further qualifies instance group More generally this construct can simultaneously support global, regional and zonal qualifiers (or any combination of) for each resource. NFTc|xsd|_||_||_||_|jj drkd|_|jddj dd|_|jtjk(rdn|jdd}t||_ n"td|_ |j|_||_ ||_ ||_||_||_|s|s|st#j$d |r5|jj't(j*j,| |r5|jj't(j*j.| |r5|jj't(j*j0| | |_| xsd |_| |_| |_| xsd |_||_||_tA|j||_!y) a Constructor. Args: name: str, argument name. resource_name: str, human readable name for resources eg "instance group". completer: completion_cache.Completer, The completer class type. plural: bool, whether to accept multiple values. required: bool, whether this argument is required. zonal_collection: str, include zone flag and use this collection to resolve it. regional_collection: str, include region flag and use this collection to resolve it. global_collection: str, if also zonal and/or regional adds global flag and uses this collection to resolve as global resource. global_help_text: str, if provided, global flag help text will be overridden with this value. region_explanation: str, long help that will be given for region flag, empty by default. region_help_text: str, if provided, region flag help text will be overridden with this value. region_hidden: bool, Hide region in help if True. zone_explanation: str, long help that will be given for zone flag, empty by default. zone_help_text: str, if provided, zone flag help text will be overridden with this value. zone_hidden: bool, Hide zone in help if True. short_help: str, help for the flag being added, if not provided help text will be 'The name[s] of the ${resource_name}[s].'. detailed_help: str, detailed help for the flag being added, if not provided there will be no detailed help for the flag. custom_plural: str, If plural is True then this string will be used as plural resource name. scope_flags_usage: ScopeFlagsUsage, when set to USE_EXISTING_SCOPE_FLAGS, already existing zone and/or region flags will be used for this argument, GENERATE_DEDICATED_SCOPE_FLAGS, new scope flags will be created, DONT_USE_SCOPE_FLAGS to not generate additional flags and use single argument for all scopes. Raises: exceptions.Error: if there some inconsistency in arguments. r]r+TrNr*rbrzAMust specify at least one resource type zonal, regional or globalrr()"name_arg _short_help_detailed_helpscope_flags_usage startswithis_flagr~r]rrrrirr.r@rArer Errorrrnrorprurw_global_help_text_region_explanation_region_help_text_region_hidden_zone_explanation_zone_help_text _zone_hiddenr_resource_resolver)rSr]rr.r@rezonal_collectionregional_collectionglobal_collectionglobal_help_textregion_explanationregion_help_text region_hiddenzone_explanationzone_help_text zone_hiddenrB detailed_helprArr=s r"rPzResourceArgument.__init__sHNFDM!D'D.D }}%dl--#++C5di!33'@@AT]]12&&+>dk%$7dk--di&DDNDK&DDM  37H   2 33 kk=2277&68 kk=2299&9; kk=2299&79-D17RD-D'D-3D)D#D.t{{MJDr!c t|r|n|jj|j}|jr|j|d<n|j r|j |d<ndj |jrdndtjt|jdz|jxsd|j||d<|jjdr |dxxdz cc<|jd k(r|d k(r |dxxd z cc<|jjd rF|j|d <|js||d<|jrKt!j"d|d<n1|jr|jrd|d<n|jrdnd|d<|xs|j$|jfi||j&t(j*k7ryt-|j.dkDr|j1d||}n|}t2j4j6|j.vrdt9||j.j:|j||j<|j>|j@|j|j t2j4jB|j.vrdtE||j.j:|j||jF|jH|jJ|j|j t2j4jL|j.vrt-|j.dkDr|jsdj |j} nO|jr(|jsdj |j} ndj |j} |j%|j.t2j4jLjNdd|jPxsdj | yyy)z-Add this set of arguments to argparse parser.)metavarr.r0zName{} of the {} to {}.rr(rinstancez For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances DISK_NAMEcreatezy For details on the naming convention for this resource, refer to: https://cloud.google.com/compute/docs/naming-resourcesr+recategory) min_lengthtype+nargs*?NT)mutexrre)r=r;r<r>r?r-r@rAz{} isz{}s arez{} are store_truezIf set, the {0} global.r/defaultr0))dictr]upperr.rrr1r@rr2r3rrArrrer ArgListr4rrrrNri add_grouprnrorprDr=rrrrurHrrrrwrMr) rSr: mutex_groupr< cust_metavarrscope_requiredrr resource_mentions r" AddArgumentzResourceArgument.AddArguments , $))//2C..F  **fVn  ''fVn077#" ..$++"D$6$6$<"   "  fVn   j )v/ 0 k !n&@v. /  }}%==fZ ]]%z $,,:v  ;;&/!%##w([F((A&A !O!OO  4;;!x.ee##t{{2 kk--**',,((""** ,%%4 kk--**'..**$$** ,%%4T[[9IA9M [[">>$*<*<= ;;t11$++D,>,>?#??4+=+=>  ++m--44 5 : :%%$)B 6" # %:N4r!c |j|}|jj|\} } | >|jtj k(r!|jj |d\} } | | j} |js}|s{|jjr1dj|jj| j} nd| z} tjdj| |j|jj!|| | |||||| } |j"r| S| r| dSy)aResolve this resource against the arguments. Args: args: Namespace, argparse.Namespace. api_resource_registry: instance of core.resources.Registry. default_scope: ScopeEnum, ZONE, REGION, GLOBAL, or None when resolving name and scope was not specified use this as default. If there is exactly one possible scope it will be used, there is no need to specify default_scope. scope_lister: func(scope, underspecified_names), a callback which returns list of items (with 'name' attribute) for given scope. with_project: indicates whether or not project is associated. It should be False for flexible resource APIs. source_project: indicates whether or not a project is specified. It could be other projects. If it is None, then it will use the current project if with_project is true additional_params: Dict, additional parameters to pass in. Returns: Resource reference or list of references if plural. Nrz --{0}-{1}r+z5Can't specify {0} without specifying resource via {1})rrr)_GetResourceNamesrirrrrrr}rer=r1rCr rr]rrr@) rSrrrrrrrrrrrMrs r"ResolveAsResourcez"ResourceArgument.ResolveAsResource}s<8  " "4 (E"&++"="=d"CNK  " "o&J&J J$(KK$@$@q$J!nk!%00n ]]5 ;; " "##kk%%~'?'?A$&$ D K Kdii !" "  " " 3 3 !%+ 4 -D {{ k !Wn r!c|jrt||jSt||j}||gSgS)z0Return list of resource names specified by args.)r@rr])rSr name_values r"r%z"ResourceArgument._GetResourceNamess= {{ T499 %%tyy)J\ Ir!)Nz operate onNNFr) rrrrrrrPr#r&r%r r!r"rrs%R  'FF)jKb!f%V'+%)%)'+*.=~r!rc,|jdddy)Nz--regexpz-rz A regular expression to filter the names of the results on. Any names that do not match the entire regular expression will be filtered out. r0r4r:s r" AddRegexArgr-s$  r!c*|jddy)N policy_filez2 JSON or YAML file containing the IAM policy.r*r+r,s r"AddPolicyFileFlagr0sm+67r!cJ|jdddj|y)Nz--storage-locationLOCATIONz Google Cloud Storage location, either regional or multi-regional, where {} content is to be stored. If absent, a nearby regional or multi-regional location is chosen automatically. )r r0r4r1r:rs r"AddStorageLocationFlagr5s,  & r!cddj|}|jddd|r|y|y)Nzd Create an application-consistent {} by informing the OS to prepare for the snapshot process. z --guest-flushrFr)r1r4)r:r custom_helpr?s r"AddGuestFlushFlagr8sJ fX   %; 6,5 6r!c|jdd|jdtjdd|jdtjd d |jd tjd d y)z1Adds the initial state for Shielded instance arg.z--platform-key-filez File path that points to an X.509 certificate in DER format or raw binary file. When you create a Shielded VM instance from this image, this certificate or raw binary file is used as the platform key (PK). r*z--key-exchange-key-file KEK_VALUEa Comma-separated list of file paths that point to X.509 certificates in DER format or raw binary files. When you create a Shielded VM instance from this image, these certificates or files are used as key exchange keys (KEK). )rr r0z--signature-database-fileDB_VALUEa  Comma-separated list of file paths that point to valid X.509 certificates in DER format or raw binary files. When you create a Shielded VM instance from this image, these certificates or files are added to the signature database (db). z--forbidden-database-file DBX_VALUEa Comma-separated list of file paths that point to revoked X.509 certificates in DER format or raw binary files. When you create a Shielded VM instance from this image, these certificates or files are added to the forbidden signature database (dbx). N)r4r rr,s r"%AddShieldedInstanceInitialStateKeyArgr=s           !        !       r!c2|jsy|j}tj|j|j }t j||j|j|\}}tjd||||fS)aARewrites args.filter into client and server filter expression strings. Usage: args.filter, request_filter = flags.RewriteFilter(args) Args: args: The parsed args namespace containing the filter expression args.filter and display_info. message: The response resource message proto for the request. frontend_fields: A set of dotted key names supported client side only. Returns: A (client_filter, server_filter) tuple of filter expression strings. None means the filter does not need to applied on the respective client/server side. r)symbolsaliases)messagefrontend_fields)defaultsz!client_filter=%r server_filter=%r) filterGetDisplayInforProjectionSpec transformsr@rRewriterRewriterinfo)rrArB display_inforC client_filter server_filters r" RewriteFilterrNs$  $$&, % 4 4%%""$("0!8!8"88? ++9@9*-(( . }M  %%r!crttd}|jdtj|dddy)N)diskz csek-key-filez--source-disk-csek-key)specrzPROPERTY=VALUEa Customer-supplied encryption key of the disk attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key. This flag can be repeated to specify multiple attached disks. *disk*::: URL of the disk attached to the source instance. This can be a full or valid partial URL *csek-key-file*::: path to customer-supplied encryption key. )rr/r r0)strr4r ArgDict)r:rQs r"AddSourceDiskCsekKeyArgrT4s@ $    D )   r!cN|jddddj|y)Nz--erase-windows-vss-signaturerFz Specifies whether the disk restored from {resource} should erase Windows specific VSS signature. See https://cloud.google.com/sdk/gcloud/reference/compute/disks/snapshot#--guest-flush )rrr3r4s r"AddEraseVssSignaturerVLs1%  vxv( r!r\r)Cr __future__rrrrenumrqrgooglecloudsdk.api_lib.computer&googlecloudsdk.api_lib.compute.regionsrrv$googlecloudsdk.api_lib.compute.zonesrsgooglecloudsdk.callioperr "googlecloudsdk.command_lib.computer r rnr googlecloudsdk.corer rrrgooglecloudsdk.core.consolergooglecloudsdk.core.resourcergooglecloudsdk.core.utilrrrrrZONE_PROPERTY_EXPLANATION$ZONE_PROPERTY_EXPLANATION_NO_DEFAULTREGION_PROPERTY_EXPLANATION®ION_PROPERTY_EXPLANATION_NO_DEFAULTEnumrrr$rr&rDrHrJobjectrZryr{rrrr-r0r5r8r=rNrTrVr r!r"rhsd :&'  9MI+/9E=*#*)2A) @ C>*($**&diij..: DH5U$CF#9TuD CF 2*"2"2 2!6!$!v!",,^PvPf EvEP  7  6& R&>0 r!