SrSSKrSSKJr SSKJr SSKJr SSKJr SSK J r SSK J r SSKJr SS KJr SS KJr SS KJr S rS rSrSrSrSrSr\4Sjr\4Sjr"SS\R85r"SS\5r"SS\5r"SS\5r"SS\5r "SS \5r!"S!S"\"5r#"S#S$\"5r$"S%S&\$5r%"S'S(\%5r&\4S)jr'g)*z=Useful commands for interacting with the Cloud Filestore API.N) list_pager)utils)apis)waiter)util) exceptions)log) properties) resourcesfilev1 v1p1alpha1v1beta1z!file.projects.locations.instanceszfile.projects.locationsz"file.projects.locations.operationsc8[R"[U5$)zImport and return the appropriate Cloud Filestore client. Args: version: str, the version of the API desired. Returns: Cloud Filestore client for the appropriate release track. )rGetClientInstanceAPI_NAMEversions 8lib/googlecloudsdk/api_lib/filestore/filestore_client.py GetClientr's   ' 22c8[R"[U5$)z>rctURRUR5US9nURX$5$)z-Deletes an existing Cloud Filestore instance.)rcforcerK+FileProjectsLocationsInstancesDeleteRequestre_DeleteInstance)rBrgasync_rr\s rDeleteInstanceFilestoreClient.DeleteInstances=mmGG  & & (HG    00rcrURRUR5S9nURX#5$)z,Delete an existing Cloud Filestore instance.rbr)rBrgrr\s rDeleteInstanceAlpha#FilestoreClient.DeleteInstanceAlphas;mmGG  & & (HG    00rcURRRU5nU(aU$[RR UR [S9nURU5$)N collection) rGrVDeleter REGISTRYParseRelativeNamercOPERATIONS_COLLECTIONWaitForOperation)rBrr\ delete_op operation_refs rrFilestoreClient._DeleteInstances] 88??HI &&88#89M   //rcURRUR5S9nURRR U5$)zGets description of a long-running operation. Args: operation_ref: the operation reference. Returns: messages.GoogleLongrunningOperation, the operation. rb)rK)FileProjectsLocationsOperationsGetRequestrerGprojects_locations_operationsrfrBrr\s r GetOperationFilestoreClient.GetOperationsGmmEE  ' ' )FG ;; 4 4 8 8 AArc[R"[R"URR5USR UR 555$)zWaits on the long-running operation until the done field is True. Args: operation_ref: the operation reference. Raises: waiter.OperationError: if the operation contains an error. Returns: the 'response' field of the Operation. zWaiting for [{0}] to finish)rWaitForCloudOperationPollerNoResourcesrGrrAName)rBrs rr FilestoreClient.WaitForOperationsL >>.. KK 5 5  %,,]-?-?-AB  rcURRUR5S9nURRR U5$)zwCancels a long-running operation. Args: operation_ref: the operation reference. Returns: Empty response message. rb)rK,FileProjectsLocationsOperationsCancelRequestrerGrCancelrs rCancelOperationFilestoreClient.CancelOperationsGmmHH  ' ' )IG ;; 4 4 ; ;G DDrcbURRUR5R5UR 5US9nUR R RU5nU(aU$[RRUR[S9nURU5$)z"Create a Cloud Filestore instance.)rN instanceIdinstancer)rK+FileProjectsLocationsInstancesCreateRequestParentrerrGrVCreater rrrcrr)rBrgrconfigr\ create_oprs rCreateInstanceFilestoreClient.CreateInstancesmmGG""$113$$&HG  88??HI &&88#89M   //rc~URRUS9nURRR U5$)Nrb)rKFileProjectsLocationsGetRequestrGprojects_locationsrf)rBr[r\s r GetLocationFilestoreClient.GetLocations4mm;;;NG ;; ) ) - -g 66rcURRUR5S9n[R"UR R USUSS9$)Nrb locationsrPrQ)rK FileProjectsLocationsListRequestrerrZrGr)rB project_refrSr\s r ListLocationsFilestoreClient.ListLocationssUmm<<  % % '=G  # # &&'  rcURRUS9n[R"URR USUSS9$)a]Make API calls to List active Cloud Filestore operations. Args: operation_ref: The parsed location of the listed Filestore instances. limit: The number of Cloud Filestore instances to limit the results to. This limit is passed to the server and the server does the limiting. Returns: Generator that yields the Cloud Filestore instances. rb operationsrPrQ)rK*FileProjectsLocationsOperationsListRequestrrZrGr)rBrrSr\s rListOperationsFilestoreClient.ListOperationssOmmFF GG  # # 11'  rcURR5nUUlU(aUUlU(aUUlU(aUUlU (aUR RUU 5 U (aUR RUU 5 U(aUR RUU5 U(aUR RUU5 UUl U (aU Ul U(aUUl U (aXS'UR RUXI5 U(Ga/UlURR!5nUR#S5UlSU;a USUlSU;a8URR R(R+US5/UlUR#SS5nUR R/UU5 UR#S5nU(aUR R1UU5 URR3U5 UbUUlUbUUlU$)a=Parses the command line arguments for Create into a config. Args: tier: The tier. protocol: The protocol values are NFS_V3 (default) or NFS_V4_1. description: The description of the instance. file_share: The config for the file share. network: The network for the instance. performance: The performance configuration for the instance. labels: The parsed labels value. tags: The parsed tags value. zone: The parsed zone of the instance. nfs_export_options: The nfs export options for the file share. kms_key_name: The kms key for instance encryption. managed_ad: The Managed Active Directory settings of the instance. ldap: The LDAPS configuration of the instance. source_instance: The replication source of the instance. deletion_protection_enabled: bool, whether to enable deletion protection. deletion_protection_reason: The reason for enabling deletion protection. backend_type: The backend type of the instance (Compute or Filestore). Returns: The configuration that will be used as the request body for creating a Cloud Filestore instance. nfs_export_optionsrczreserved-ip-rangez address-modez connect-modeDIRECT_PEERINGzpsc-endpoint-project)rKInstancetiertagsprotocol backendTyper;ParseManagedADIntoInstanceParseLdapIntoInstanceParseSourceInstanceIntoInstanceParsePerformanceIntoInstancelabels kmsKeyName descriptionParseFileShareIntoInstancenetworks NetworkConfiggetnetworkreservedIpRangeModesValueListEntryValuesEnumlookup_by_namemodesParseConnectModeParsePscEndpointProjectappenddeletionProtectionEnableddeletionProtectionReason)rBrrr file_sharer performancerrzoner kms_key_name managed_adldapsource_instancedeletion_protection_enableddeletion_protection_reason backend_typernetwork_config connect_modepsc_endpoint_projects rParseFilestoreConfig$FilestoreClient.ParseFilestoreConfigsZ}}%%'HHM hm"h)h mm..xD  mm))(D9 mm33HoN mm00;GHO(h(h);%&MM,,XzHh}}224n&{{62n  ')01D)E& 7 " MM ' ' E E T T'   [[1ABl mm$$^\B%[[)?@  -- . ~.".+Fh(!-*Dh' Orc NURRUUUUUUUUU U U U S9 n U $)aParses updates into an instance config. Args: instance_config: The Instance message to update. description: str, a new description, if any. labels: LabelsValue message, the new labels value, if any. file_share: dict representing a new file share config, if any. performance: The performance configuration for the instance. managed_ad: The Managed Active Directory settings of the instance. disconnect_managed_ad: Disconnect from Managed Active Directory. ldap: The LDAP configuration of the instance. disconnect_ldap: Disconnect from LDAP. clear_nfs_export_options: bool, whether to clear the NFS export options. deletion_protection_enabled: bool, whether to enable deletion protection. deletion_protection_reason: The reason for enabling deletion protection. Raises: InvalidCapacityError, if an invalid capacity value is provided. InvalidNameError, if an invalid file share name is provided. Returns: The instance message. ) rrrrrdisconnect_managed_adrdisconnect_ldapclear_nfs_export_optionsrr)r;ParseUpdatedInstanceConfig)rBinstance_configrrrrrrrrrrrrs rr*FilestoreClient.ParseUpdatedInstanceConfigsIN}}773 '!9$?#=8 H OrcURRXU5nU(aU$[RR UR [ S9nURU5$)a0Updates an instance. Args: instance_ref: the reference to the instance. instance_config: Instance message, the updated instance. update_mask: str, a comma-separated list of updated fields. async_: bool, if False, wait for the operation to complete. Returns: an Operation or Instance message. r)r;UpdateInstancer rrrcrr)rBrgr update_maskr update_oprs rrFilestoreClient.UpdateInstances` ,,{I &&88#89M   //rc SnSnSnSnSn/nUc/$UHnURRRURSU55n URRRURSU55n URSS5U:Xa%URSU5n URS U5n OSn Sn URURS /5U U U U S 9n UR U 5 M U$) a3Creates an NfsExportOptions message. Args: messages: The messages module. nfs_export_options: list, containing NfsExportOptions dictionary. Returns: File share message populated with values, filled with defaults. In case no nfs export options are provided we rely on the API to apply a default. READ_WRITE ROOT_SQUASHNO_ROOT_SQUASHN access-mode squash-modeanon_uidanon_gid ip-ranges)ipRangesanonUidanonGid accessMode squashMode)NfsExportOptionsAccessModeValueValuesEnumrrSquashModeValueValuesEnumr)rKr read_write root_squashno_root_squash anonimous_uid anonimous_gidnfs_export_configsnfs_export_option access_mode squash_moderrnfs_export_configs rMakeNFSExportOptionsMsg'FilestoreClient.MakeNFSExportOptionsMsgs)JK%NMM! i/  # # = = L L##M:>   # # = = L L##M>B    }d 3{ B$((]C$((]C"33$((b9  4 12102 rc SnSnSnSnSn/nUc/$UGHDnURRRURSU55n URRRURSU55n URSS5U:Xa%URSU5n URS U5n OSn Sn /n URS /5nUH7nU R URR RU55 M9 URURS /5U U U U U URS S5S 9nUR U5 GMG U$)aCreates an MakeNFSExportOptionsMsgBeta message. This function is a copy MakeNFSExportOptionsMsg with addition of handling the SecurityFlavors for NFSv41. Args: messages: The messages module. nfs_export_options: list, containing NfsExportOptions dictionary. Returns: File share message populated with values, filled with defaults. In case no nfs export options are provided we rely on the API to apply a default. rrrrNrrrrzsecurity-flavorsrr)rrrrrsecurityFlavorsr)rrrrrr'SecurityFlavorsValueListEntryValuesEnum)rKrrr r r r r rrrrrsecurity_flavors_listflavorsflavorrs rMakeNFSExportOptionsMsgBeta+FilestoreClient.MakeNFSExportOptionsMsgBetas"JK%NMM! i/  # # = = L L##M:>   # # = = L L##M>B    }d 3{ B$((]C$((]C !%%&8"=g&$$  % % M M \ \   #33$((b9  /#'' 484 12G0H rcUcgSU;a+URURURS5S9S9$SU;a+URURURS5S9S9$[ S5e) a)Creates a PerformanceConfig message. Args: messages: The messages module. performance_config: A dictionary containing performance configuration, if any. Returns: The PerformanceConfig message. Raises: InvalidArgumentError: If performance_config argument constraints are violated. Nzmax-iops)maxIops) fixedIopszmax-iops-per-tb) maxIopsPerTb) iopsPerTbzNInvalid performance configuration. Must be one of max-iops or max-iops-per-gb.)PerformanceConfig FixedIOPSr IOPSPerTBr')rKperformance_configs rMakePerformanceConfigMsg(FilestoreClient.MakePerformanceConfigMsgFs ! ''  ' '&&(,,Z8' ( 0 0  ' '&&-112CD' ( !  r)r;rF)F)NNNNNNNNNNNNNNNNN NNNNNNNNFNN)!r r!r"r#r$r>rCpropertyrGrKr_rhrqrvr|rrrrrrrrrrrrr staticmethodrrr%r%rrrr6r6Ps..+K     " "4AAK?110 B( E 07 0     "&!%%oh  $"&!%5n0,..`==~""rr6cb\rSrSrSrSrS SjrSrS SjrSr S r S r S r g)r:ilz$Adapter for the alpha filestore API.cL[[S9Ul[[S9UlgNr)rr9rGrrKrHs rrCAlphaFilestoreAdapter.__init__os$56DK(9:DMrNc@URc/UlU(GaSnSnSnURVs/sH%owRURS5:wdM#UPM' snUlSU;az[RR R RSS9nURS5=(d Un[RRXURS55nSU;aq[RR R RSS9nURS5n[RRXURS55nSXE4;a [S 5eUbUc [S 5e[RUR URS /55n UR R#URS5[$R&"URS 55UUU S 9n URR)U 5 ggs snf)a Parse specified file share configs into an instance message. Args: instance: The Filestore instance object. file_share: File share configuration. instance_zone: The instance zone. Raises: InvalidArgumentError: If file_share argument constraints are violated. Nrczsource-snapshotTrequiredzsource-snapshot-region source-backupsource-backup-regionzEAt most one of ['source-snapshot', 'source-backup'] can be specified.OIf 'source-backup' is specified, 'source-backup-region' must also be specified.nfs-export-optionscapacity)rc capacityGbsourceSnapshot sourceBackupnfsExportOptions) fileSharesrcrr VALUEScoreprojectrf snapshot_utilSNAPSHOT_NAME_TEMPLATErA backup_utilBACKUP_NAME_TEMPLATEr'r6rrKFileShareConfigr BytesToGbr) rBrr instance_zonesource_snapshot source_backupr^fsr=rfile_share_configs rr0AlphaFilestoreAdapter.ParseFileShareIntoInstancess"homh ***gg9O.O"*h j (##((0044d4C>>":;L}'>>EE z~~.?@  J &##((0044d4C>>"89#88?? z~~o>  o5 5"     "x'7"   +BB --(> 9  228&!&& v(>3  :rcURRUUR5US9nURRR U5nU$)z6Send a Patch request for the Cloud Filestore instance.)rrc updateMask)rK*FileProjectsLocationsInstancesPatchRequestrerGrVPatch)rBrgrrupdate_requestrs rr$AlphaFilestoreAdapter.UpdateInstancesP]]MM  & & (NN  88>>~NI rcURRRRU5nX1lg![ a [ SRU55ef=f)z-Parse and match the supplied connection mode.zZ[{}] is not a valid connect-mode. Must be one of DIRECT_PEERING or PRIVATE_SERVICE_ACCESS.N)rKrConnectModeValueValuesEnumr connectModeKeyErrorr'rA)rBrkeyvalues rr&AlphaFilestoreAdapter.ParseConnectMode#sa ) -- % % @ @ O O  $)    $$*F3K s /8%ArGrKrFr') r r!r"r#r$rCrrMrrRrrr%rrrr:r:lsS,; 15:4x  $"&!%JX4)rr:ch^\rSrSrSrU4SjrSrSrSrSr Sr S r S r SS jr S rS rU=r$)r=i5z#Adapter for the beta filestore API.cr>[[U] 5 [[S9Ul[ [S9Ulgr,)superr=rCrr<rGrrKrB __class__s rrCBetaFilestoreAdapter.__init__8s+ .0$45DK(89DMrcSU;ag[RRRR SS9nUR S5nUc [ S5e[RRX#UR S55$)Nr1Tr/r2r3) r r;r<r=rfrr'r@rArA)rBrr=r^s r_ParseSourceBackupFromFileshare4BetaFilestoreAdapter._ParseSourceBackupFromFileshare=sj( $$,,00$0?G~~45H     + + 2 2:>>/: rcURS5nU(dgSn[R"X25(d [S5eU$)zDParses and validates the sourceBackupdrBackup field from file_share.zsource-backupdr-backupNzR^projects/[^/]+/locations/[^/]+/backupVaults/[^/]+/dataSources/[^/]+/backups/[^/]+zInvalid 'source-backupdr-backup' format. Expected format: projects/{project_id}/locations/{location_id}/backupVaults/{backupvault_id}/dataSources/{datasource_id}/backups/{backup_id})rrematchr')rBrsource_backupdr_backuppatterns r!_ParseSourceBackupdrFromFileshare6BetaFilestoreAdapter._ParseSourceBackupdrFromFileshareKsG'^^,DE ! cG 88G 4 4  H  "!rcURS5nUc [S5eURS5nUc [S5eURRURR X4S9S9UlgzParses managed-ad configs into an instance message. Args: instance: The filestore instance struct. managed_ad: The --managed-ad flag value. Raises: InvalidArgumentError: If managed_ad argument constraints are violated. domainNz,Domain parameter is missing in --managed-ad.computerz.Computer parameter is missing in --managed-ad.)r{r|)rQrr'rKDirectoryServicesConfigManagedActiveDirectoryConfigrTrBrrr{r|s rr/BetaFilestoreAdapter.ParseManagedADIntoInstanceY^^H %F ~ !O PP~~j)H : "&!F!F#}}II J "G"Hrc VURS5nUc [S5eURS5nUc [S5eURS5nURS5nURS5nURR URR UUUUS 9S 9Ulg zParses ldap configs into an instance message. Args: instance: The filestore instance struct. ldap: The ldap cli parameters Raises: InvalidArgumentError: If ldap argument constraints are violated. r{Nz(Domain parameter is missing in `--ldap`.serversz)Servers parameter is missing in `--ldap`.,zusers-ouz groups-ou)r{rusersOugroupsOu)rrr'splitrKr~ LdapConfigrTrBrrr{rusersougroupsous rr*BetaFilestoreAdapter.ParseLdapIntoInstancerXXh F ~ !K LLhhy!G !L MMmmC Ghhz"Gxx $H"&!F!F ]] % % & "G"Hrc@URRUS9Ulg)z(Parse and match the supplied PSC config.)endpointProjectN)rK PscConfig pscConfig)rBrrs rr,BetaFilestoreAdapter.ParsePscEndpointProjects!#}}66, 7 NrcURRRRS5n/nUR URR US95 URRX4S9Ulg)zParses source_instance into a replication config and into an instance message. Args: instance: The filestore instance struct. source_instance: The source_instance cli param. STANDBY) peerInstance)rolereplicasN)rK ReplicationRoleValueValuesEnumrr ReplicaConfig replication)rBrrrrs rr4BetaFilestoreAdapter.ParseSourceInstanceIntoInstancesk == $ $ 8 8 G G DH OODMM//_/MN==44 5HrcN[RURU5Ulg)zParses performance into performance config message and assigns to instance. Args: instance: The filestore instance struct. performance: The performance cli param. N)r6r%rKperformanceConfig)rBrrs rr1BetaFilestoreAdapter.ParsePerformanceIntoInstances "1!I!I {"HrcAURc/UlU(GajSnSnURVs/sH%ofRURS5:wdM#UPM' snUlSU;aP[RR R RSS9nURS5nUc [S5eURU5nURU5nUbUb [S5e[RURURS /55n URRURS5[R "URS 55UUU S 9n URR#U 5 ggs snf) >"89  $$  :::Fm#EE    "'='I"   +FF --([[U] 5 [[S9Ul[ [S9Ulgr,)rkr?rCrr>rGrrKrls rrCFilestoreAdapter.__init__s) D*,N3DK7DMrchAURc/UlU(GaURVs/sH%oDRURS5:wdM#UPM' snUlURU5nUR U5nUbUb [ S5e[ RURURS/55nURRURS5[R"URS55UUUS9nURRU5 ggs snf)rNrcrr4r5r) r:rcrrprwr'r6rrKrBrrCr) rBrrrDrGrFrurrHs rr+FilestoreAdapter.ParseFileShareIntoInstances* "h ***gg9O.O"*h:::Fm#EE    "'='I"   +BB --(googlecloudsdk.corerr r r rr>r9r<INSTANCES_COLLECTIONLOCATIONS_COLLECTIONrrrrr'r*r-r0r3objectr6r:r=r?rrrrrsD '0,.LP*#*)  :0<% 3'3 2J  2D5D;5;BuBHeH77YfYxF)FF)Ro0oda+aF&4r