S r SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSK
J r SS K
J r SS
K
J
r
SS KJr SS KJr SS
KJr SSKJr SSKJr SrS\- S- r0 \ ESSS.Er " S S\5 rg)zCImplementation of Unix-like mv command for cloud storage providers. )absolute_import)print_function)division)unicode_literals)Command)CommandArgument)CP_AND_MV_SHIM_FLAG_MAP) CP_SUB_ARGS)'ShimTranslatePredefinedAclSubOptForCopy) ApiSelector)CommandException)StorageUrlFromString)NO_MAX)GcloudStorageMapzb
gsutil mv [-p] src_url dst_url
gsutil mv [-p] src_url... dst_url
gsutil mv [-p] -I dst_url
z
SYNOPSIS
a
DESCRIPTION
The ``gsutil mv`` command allows you to move data between your local file
system and the cloud, move data within the cloud, and move data between
cloud storage providers. For example, to move all objects from a
bucket to a local directory you could use:
gsutil mv gs://my_bucket/* dir
Similarly, to move all objects from a local directory to a bucket you could
use:
gsutil mv ./dir gs://my_bucket
RENAMING GROUPS OF OBJECTS
You can use the ``gsutil mv`` command to rename all objects with a given
prefix to have a new prefix. For example, the following command renames all
objects under gs://my_bucket/oldprefix to be under gs://my_bucket/newprefix,
otherwise preserving the naming structure:
gsutil mv gs://my_bucket/oldprefix gs://my_bucket/newprefix
If you do a rename as specified above and you want to preserve ACLs, you
should use the ``-p`` option (see OPTIONS).
If you have a large number of files to move you might want to use the
``gsutil -m`` option, to perform a multi-threaded/multi-processing move:
gsutil -m mv gs://my_bucket/oldprefix gs://my_bucket/newprefix
NON-ATOMIC OPERATION
Unlike the case with many file systems, the gsutil mv command does not
perform a single atomic operation. Rather, it performs a copy from source
to destination followed by removing the source for each object.
A consequence of this is that, in addition to normal network and operation
charges, if you move a Nearline Storage, Coldline Storage, or Archive Storage
object, deletion and data retrieval charges apply. See the `documentation
`_ for pricing details.
OPTIONS
All options that are available for the gsutil cp command are also available
for the gsutil mv command (except for the -R flag, which is implied by the
``gsutil mv`` command). Please see the `Options section for cp
`_
for more information.
N)z-r-Rc ^ \ rS rSrSr\R " S/ SQ\S\\ SSS\
R \
R /\
R \
R " 5 /S 9 r\R " SS
S /S S
\0 S9rU 4S jrS rSrU =r$ ) MvCommandc zImplementation of gsutil mv command.
Note that there is no atomic rename operation - this command is simply
a shorthand for 'cp' followed by 'rm'.
mv)moverenrename TFr ) command_name_aliasesusage_synopsismin_argsmax_argssupported_sub_args file_url_okprovider_url_okurls_start_arggs_api_supportgs_default_apiargparse_argumentsr r command_helpzMove/rename objects) help_namehelp_name_aliases help_typehelp_one_line_summary help_textsubcommand_help_textc l > [ U R 5 [ SS/[ S9n[ TU ] U5 $ )Nstorager )gcloud_commandflag_map)r sub_optsr MV_SHIM_FLAG_MAPsuperget_gcloud_storage_args)selfgcloud_storage_map __class__s $platform/gsutil/gslib/commands/mv.pyr3 !MvCommand.get_gcloud_storage_args s8 +DMM:)!4(! 7 *+= >> c
* U R SS Ho n[ U5 nUR 5 ( d M% UR 5 ( d UR 5 ( d MQ [ SU< SU R S < 35 e S/nU R ( a UR S5 UR U R 5 U R R SUU R U R U R U R U R S9 g) z'Command entry point for the mv command.r zYou cannot move a source bucket using the mv command. If you meant to move
all objects in the bucket, you can use a command like:
gsutil mv z/* z-Mr cp)argsheadersdebug trace_token user_projectparallel_operations)r= r
IsCloudUrlIsBucket
IsProviderr
recursion_requestedappendextend
unparsed_argscommand_runnerRunNamedCommandr> r? r@ rA rB )r4 arg_to_checkurlrI s r7
RunCommandMvCommand.RunCommand s !B .c s||~~ 1A1A !-diim = > > ( FM 4 ++,''
jj$$&& 4 4 ( 6
r9 )__name__
__module__ __qualname____firstlineno____doc__r CreateCommandSpec _SYNOPSISr r
r XMLJSONr %MakeZeroOrMoreCloudOrFileURLsArgument command_specHelpSpec_DETAILED_HELP_TEXT help_specr3 rN __static_attributes__
__classcell__)r6 s @r7 r r c s **
4 $!oo{'7'78 %%
?
?
A,$ * 1#
)?
r9 r ) rU
__future__r r r r
gslib.commandr gslib.command_argumentr gslib.commands.cpr r
r gslib.cs_api_mapr gslib.exceptionr
gslib.storage_urlr gslib.utils.constantsr gslib.utils.shim_utilr rW r] r1 r rP r9 r7 rj s{ J & % ' ! 2 5 ) E ( , 2 ( 2
46 r G-FTF K
K
r9