]/SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr Sr SSjr S r S r SS jr S rS rSSjrSrSrSSjrSrSrSrg)z5Flags and helpers for the firestore related commands.)absolute_import)division)unicode_literalsN) arg_parserscNURSS[R"5SS9 g)z^Adds flag for collection group ids to the given parser. Args: parser: The argparse parser. z--collection-idsCOLLECTION_GROUP_IDSa) List specifying which collection groups will be included in the operation. When omitted, all collection groups are included. For example, to operate on only the `customers` and `orders` collections groups: $ {command} --collection-ids='customers','orders' metavartypehelpN add_argumentrArgListparsers 1lib/googlecloudsdk/command_lib/firestore/flags.pyAddCollectionGroupIdsFlagrs.  $      c `U(dSnOSnURSS[U(dSOSUUUS9 g)zAdds flag for database id to the given parser. Args: parser: The argparse parser. required: Whether the flag must be set for running the command, a bool. hidden: Whether the flag is hidden, a bool. z The database to operate on. The default value is `(default)`. For example, to operate on database `foo`: $ {command} --database='foo' z The database to operate on. For example, to operate on database `foo`: $ {command} --database='foo' z --databaseDATABASEz (default)N)r r defaultrequiredhiddenr rstr)rrr helper_texts rAddDatabaseIdFlagr1sC  K K  !)kt  rcNURSS[R"5SS9 g)z0Adds flag for namespace ids to the given parser.z--namespace-ids NAMESPACE_IDSaI List specifying which namespaces will be included in the operation. When omitted, all namespaces are included. This is only supported for Datastore Mode databases. For example, to operate on only the `customers` and `orders` namespaces: $ {command} --namespaces-ids='customers','orders' r Nr rs rAddNamespaceIdsFlagr Ts,     rc 4URSS[SSSS9 g)zWAdds flag for snapshot time to the given parser. Args: parser: The argparse parser. z--snapshot-time SNAPSHOT_TIMENFa The version of the database to export. The timestamp must be in the past, rounded to the minute and not older than `earliestVersionTime`. If specified, then the exported documents will represent a consistent view of the database at the provided time. Otherwise, there are no guarantees about the consistency of the exported documents. For example, to operate on snapshot time `2023-05-26T10:20:00.00Z`: $ {command} --snapshot-time='2023-05-26T10:20:00.00Z' )r r rrr rrs rAddSnapshotTimeFlagr#gs+    rc 6URSSUU[USS9 g)aAdds flag for location to the given parser. Args: parser: The argparse parser. required: Whether the flag must be set for running the command, a bool. hidden: Whether the flag is hidden in document. a bool. suggestion_aliases: A list of flag name aliases. A list of string. z --locationLOCATIONz The location to operate on. Available locations are listed at https://cloud.google.com/firestore/docs/locations. For example, to operate on location `us-east1`: $ {command} --location='us-east1' )r rrr suggestion_aliasesr Nr)rrrr&s rAddLocationFlagr's.   + rc2URSSS[SS9 g)zPAdds flag for backup to the given parser. Args: parser: The argparse parser. z--backupBACKUPTz The backup to operate on. For example, to operate on backup `cf9f748a-7980-4703-b1a1-d1ffff591db0`: $ {command} --backup='cf9f748a-7980-4703-b1a1-d1ffff591db0' r rr r Nrrs r AddBackupFlagr+s(     rc2URSSS[SS9 g)z\Adds flag for backup schedule id to the given parser. Args: parser: The argparse parser. z--backup-scheduleBACKUP_SCHEDULETz The backup schedule to operate on. For example, to operate on backup schedule `091a49a0-223f-4c98-8c69-a284abbdb26b`: $ {command} --backup-schedule='091a49a0-223f-4c98-8c69-a284abbdb26b' r*Nrrs rAddBackupScheduleFlagr.s(     rc xURSSU[R"5[R"S5S9 g)zAdds flag for retention to the given parser. Args: parser: The argparse parser. required: Whether the flag must be set for running the command, a bool. z --retention RETENTIONa* The rention of the backup. At what relative time in the future, compared to the creation time of the backup should the backup be deleted, i.e. keep backups for 7 days. For example, to set retention as 7 days. $ {command} --retention=7d r*N)rrDurationtextwrapdedent)rrs rAddRetentionFlagr4s=     ! ??  rcURSSS9nSnURS[USS9 SnURS[RR [RR US S 9 g ) zTAdds flag for recurrence to the given parser. Args: parser: The argparse parser. z)Recurrence settings of a backup schedule.T)r ra^ The recurrence settings of a backup schedule. Currently only daily and weekly backup schedules are supported. When a weekly backup schedule is created, day-of-week is needed. For example, to create a weekly backup schedule which creates backups on Monday. $ {command} --recurrence=weekly --day-of-week=MON z --recurrence)r r rz The day of week (UTC time zone) of when backups are created. The available values are: `MON`, `TUE`, `WED`, `THU`, `FRI`, `SAT`,`SUN`. Values are case insensitive. This is required when creating a weekly backup schedule. z --day-of-weekF)choicesr r rN) add_grouprrr DayOfWeekDAYSParse)rgroup help_texts rAddRecurrenceFlagr=s    6  % )^#IM)##((  & &  rc URS[R"[R"S5R US95S9nUR SS[S/SQ[R"S 5S 9 [US 5 g ) zAdds flags for the database's encryption configuration to the given parser. Args: parser: The argparse parser. source_type: "backup" if a restore; "database" if a clone Fa The encryption configuration of the new database being created from the $source_type. If not specified, the same encryption settings as the $source_type will be used. To create a CMEK-enabled database: $$ {command} --encryption-type=customer-managed-encryption --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/CRYPTO_KEY_ID To create a Google-default-encrypted database: $$ {command} --encryption-type=google-default-encryption To create a database using the same encryption settings as the $source_type: $$ {command} --encryption-type=use-source-encryption ) source_type)rr z--encryption-typeENCRYPTION_TYPET)zuse-source-encryptionzcustomer-managed-encryptionzgoogle-default-encryptionzE The encryption type of the destination database. )r r rr6r zWThis flag must only be specified when encryption-type is `customer-managed-encryption`.N) add_argument_groupr2r3stringTemplate substituterrAddKmsKeyNameFlag)rr?encryption_configs rAddEncryptionConfigGrouprG s// ??6??, 4 60&    ?? ! (rc ~[R"S5nU(aUS-U-nURSS[SSUS9 g)zAdds flag for KMS Key Name to the given parser. Args: parser: The argparse parser. additional_help_text: Additional help text to be added to the flag. aL The resource ID of a Cloud KMS key. If set, the database created will be a Customer-Managed Encryption Key (CMEK) database encrypted with this key. This feature is allowlist only in initial launch. Only a key in the same location as this database is allowed to be used for encryption. For Firestore's nam5 multi-region, this corresponds to Cloud KMS location us. For Firestore's eur3 multi-region, this corresponds to Cloud KMS location europe. See https://cloud.google.com/kms/docs/locations. This value should be the KMS key resource ID in the format of `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. z z--kms-key-name KMS_KEY_NAMEFN)r r rrr )r2r3rr)radditional_help_textr<s rrErE:sQoo   )F"%99I   rcURSS[S[R"SUSUSSSS S S S S SUS35S9 g)Nz--destination-databaseDESTINATION_DATABASETz" Destination database to zM to. Destination database will be created in the same location as the source z. This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ with first character a letter and the last a letter or a number. Must not be UUID-like /[0-9a-f]z (-[0-9a-f])z -[0-9a-f] zX/. Using "(default)" database ID is also allowed. For example, to zV to database `testdb`: $ {command} --destination-database=testdb )r r rr )rrr2r3)r action_namer?s rAddDestinationDatabaserS[s~$  ?? ##.-/|~I}JJ%&'Cz!AaS "F'-(    rc URSS[R"5S[R"SUSUS35S9 g)zAdds the --tags flag to the given parser. Args: parser: The parser to add the flag to. resource_type: The resource type to use in the help text (e.g. 'database'). z--tagsz KEY=VALUENz, Tags to attach to the destination zV. Example: --tags=key1=value1,key2=value2 For example, to attach tags to a z8: $ --tags=key1=value1,key2=value2 )r r rr )rrArgDictr2r3)r resource_types rAddTagsrWqsV      ?? --:O<,,9?;    rc0URSS[SS9 g)zaAdds positional arg for user creds id to the given parser. Args: parser: The argparse parser. user_creds USER_CREDSz The user creds to operate on. For example, to operate on user creds `creds-name-1`: $ {command} creds-name-1 r Nrrs rAddUserCredsIdArgr[s%     r)FF)FFN)F)N)__doc__ __future__rrrrBr2googlecloudsdk.callioperrrr r#r'r+r.r4r=rGrErSrWr[rrr`sl<&' /, F&:>B:**0&R,^B,,r