mv

Описание

Перемещает локальный файл или объект S3 в другое место локально или в S3. Команда mv копирует исходный объект или файл в указанное место назначения, а затем удаляет исходный объект или файл.

Синтаксис

  mv
<LocalPath> <S3Uri> or <S3Uri> <LocalPath> or <S3Uri> <S3Uri>
[--dryrun]
[--quiet]
[--include <value>]
[--exclude <value>]
[--acl <value>]
[--follow-symlinks | --no-follow-symlinks]
[--no-guess-mime-type]
[--sse <value>]
[--sse-c <value>]
[--sse-c-key <value>]
[--sse-kms-key-id <value>]
[--sse-c-copy-source <value>]
[--sse-c-copy-source-key <value>]
[--storage-class <value>]
[--grants <value> [<value>...]]
[--website-redirect <value>]
[--content-type <value>]
[--cache-control <value>]
[--content-disposition <value>]
[--content-encoding <value>]
[--content-language <value>]
[--expires <value>]
[--source-region <value>]
[--only-show-errors]
[--no-progress]
[--page-size <value>]
[--ignore-glacier-warnings]
[--force-glacier-transfer]
[--request-payer <value>]
[--checksum-mode <value>]
[--checksum-algorithm <value>]
[--metadata <value>]
[--copy-props <value>]
[--metadata-directive <value>]
[--recursive]
[--validate-same-s3-paths]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

paths (строка)

--dryrun (логическое значение) Отображает операции, которые будут выполнены с помощью указанной команды, но не выполняет их.

--quiet (логическое значение) Не отображает операции, выполняемые из указанной команды.

--include (строка) Не исключать файлы или объекты в команде, соответствующие указанному шаблону. Подробнее см. Использование фильтров исключения и включения.

--exclude (строка) Исключить все файлы или объекты из команды, соответствующие указанному шаблону.

--acl (строка) Устанавливает ACL для объекта при выполнении команды. Если вы используете этот параметр, вы должны иметь разрешение "s3:PutObjectAcl" в списке действий для вашей политики IAM. Принимает только значения private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, bucket-owner-full-control и log-delivery-write. Подробнее см. Стандартные ACL.

--follow-symlinks | --no-follow-symlinks (логическое значение) Символические ссылки отслеживаются только при загрузке в S3 из локальной файловой системы. Обратите внимание, что S3 не поддерживает символические ссылки, поэтому содержимое целевого объекта ссылки загружается под именем ссылки. Если ни --follow-symlinks, ни --no-follow-symlinks не указаны, по умолчанию используются символические ссылки.

--no-guess-mime-type (логическое значение) Не пытаться угадать тип MIME для загружаемых файлов. По умолчанию тип MIME файла определяется при загрузке.

--sse (строка) Указывает шифрование объекта на стороне сервера в S3. Допустимые значения — AES256 и aws:kms. Если параметр указан, но значение не предоставлено, используется AES256.

--sse-c (строка) Указывает шифрование на стороне сервера с использованием ключей, предоставленных клиентом, объекта в S3. AES256 — единственное допустимое значение. Если параметр указан, но значение не предоставлено, используется AES256. Если вы предоставляете это значение, необходимо также указать --sse-c-key.

--sse-c-key (байт) Ключ шифрования, предоставленный клиентом, для шифрования объекта на стороне сервера в S3. Если вы предоставляете это значение, необходимо также указать --sse-c. Предоставляемый ключ не должен быть закодирован в base64.

--sse-kms-key-id (строка) Идентификатор управляемого клиентом ключа AWS Key Management Service (KMS), который следует использовать для шифрования объекта на стороне сервера в S3. Этот параметр следует указывать только при использовании управляемого клиентом мастер-ключа (CMK), а не управляемого AWS KMS CMK.

--sse-c-copy-source (строка) Этот параметр следует указывать только при копировании объекта S3, зашифрованного на стороне сервера с помощью ключа, предоставленного клиентом. Он определяет алгоритм, используемый для дешифрования исходного объекта. AES256 — единственное допустимое значение. Если параметр указан, но значение не предоставлено, используется AES256. Если вы предоставляете это значение, необходимо также указать --sse-c-copy-source-key.

--sse-c-copy-source-key (байт) Этот параметр следует указывать только при копировании объекта S3, зашифрованного на стороне сервера с помощью ключа, предоставленного клиентом. Указывает ключ шифрования, предоставленный клиентом, для использования Amazon S3 для дешифрования исходного объекта. Ключ шифрования, предоставленный, должен быть тем, который использовался при создании исходного объекта. Если вы предоставляете это значение, необходимо также указать --sse-c-copy-source. Предоставляемый ключ не должен быть закодирован в base64.

--storage-class (строка) Тип хранилища, используемого для объекта. Допустимые значения: STANDARD | REDUCED_REDUNDANCY | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | GLACIER_IR. По умолчанию 'STANDARD'

--grants (строка)

--grants Permission=Grantee_Type=Grantee_ID [Permission=Grantee_Type=Grantee_ID ...]

--grants Permission=Grantee_Type=Grantee_ID,Grantee_Type=Grantee_ID,...

--website-redirect (строка) Если ведро настроено как веб-сайт, перенаправляет запросы для этого объекта на другой объект в том же ведре или на внешний URL. Amazon S3 сохраняет значение этого заголовка в метаданных объекта.

--content-type (строка) Укажите явный тип содержимого для данной операции. Это значение переопределяет любые угаданные типы MIME.

--cache-control (строка) Указывает поведение кэширования вдоль цепочки запрос/ответ.

--content-disposition (строка) Указывает презентационную информацию для объекта.

--content-encoding (строка) Указывает, какие кодировки содержимого были применены к объекту, и, следовательно, какие механизмы декодирования необходимо применить для получения типа носителя, указанного в заголовке Content-Type.

--content-language (строка) Язык содержимого.

--expires (строка) Дата и время, когда объект больше не может быть кэширован.

--source-region (строка) При передаче объектов из ведра s3 в ведро s3 это указывает регион исходного ведра. Обратите внимание, что регион, указанный в --region или через конфигурацию CLI, относится к региону целевого ведра. Если --source-region не указан, регион источника будет таким же, как регион целевого ведра.

--only-show-errors (логическое значение) Отображаются только ошибки и предупреждения. Весь остальной вывод подавляется.

--no-progress (логическое значение) Прогресс передачи файлов не отображается. Этот флаг применяется только в том случае, если флаги quiet и only-show-errors не указаны.

--page-size (целое число) Количество результатов, возвращаемых в каждом ответе при операции списка. Значение по умолчанию равно 1000 (максимальное разрешенное значение). Использование меньшего значения может помочь, если операция зависает.

--ignore-glacier-warnings (логическое значение) Отключает предупреждения Glacier. Предупреждения об операции, которая не может быть выполнена, потому что она включает копирование, загрузку или перемещение объекта Glacier, больше не будут выводиться в стандартную ошибку и больше не будут приводить к возвращению кода команды 2.

--force-glacier-transfer (логическое значение) Принудительно запрашивает передачу на все объекты Glacier в синхронизации или рекурсивной копии.

--request-payer (строка) Подтверждает, что запрашивающий знает, что будет взиматься плата за запрос. Владельцам ведер не нужно указывать этот параметр в своих запросах. Документация по загрузке объектов из ведер с оплатой запрашивающим доступна по адресу http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html

--checksum-mode (строка) Для получения контрольной суммы необходимо включить этот режим. Если у объекта есть контрольная сумма, она будет проверена.

--checksum-algorithm (строка) Указывает алгоритм, используемый для создания контрольной суммы объекта.

--metadata (карта) Карта метаданных для хранения с объектами в S3. Это будет применено к каждому объекту, который является частью этого запроса. В синхронизации это означает, что файлы, которые не изменились, не получат новые метаданные. ключ -> (строка)

Укороченная синтаксическая конструкция:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--copy-props (строка) Определяет, какие свойства копируются из исходного объекта S3. Этот параметр применяется только для копирования S3 в S3. Допустимые значения:

--metadata-directive (строка) Устанавливает заголовок x-amz-metadata-directive для операций CopyObject. Рекомендуется использовать параметр --copy-props для управления копированием свойств метаданных. Если --metadata-directive установлен, параметр --copy-props будет отключен и не повлияет на передачу.

--recursive (логическое значение) Команда выполняется для всех файлов или объектов в указанном каталоге или префиксе.

--validate-same-s3-paths (логическое значение) Разрешает исходные и целевые URI S3 до их базовых ведер и проверяет, что файл или объект не перемещаются в себя. Если вы используете какие-либо типы ARN точек доступа или псевдонимов точек доступа в своих URI S3, мы настоятельно рекомендуем использовать этот параметр для предотвращения случайного удаления исходного файла или объекта. Этот параметр разрешает базовые ведра ARN точек доступа S3 и псевдонимов, ARN точек доступа S3 на Outposts и ARN точек доступа в нескольких регионах. Псевдонимы точек доступа S3 на Outposts не поддерживаются. Вместо использования этого параметра вы можете установить переменную среды AWS_CLI_S3_MV_VALIDATE_SAME_S3_PATHS в значение true. ПРИМЕЧАНИЕ: Валидация пути требует дополнительных вызовов API. Будущие обновления механизма валидации пути могут изменить вызываемые API.

Общие параметры

--debug (boolean)

Включить отладку логов.

--endpoint-url (string)

Переопределить URL по умолчанию команды на указанный URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет поведение по умолчанию, проверяющее SSL-сертификаты.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить цветной вывод.

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строки base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается в двоичном блоке, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Пример 1: Перемещение локального файла в указанный бакет

Следующая mv команда перемещает один файл в указанный бакет и ключ.

aws s3 mv test.txt s3://amzn-s3-demo-bucket/test2.txt

Вывод:

move: test.txt to s3://amzn-s3-demo-bucket/test2.txt

Пример 2: Перемещение объекта в указанный бакет и ключ

Следующая mv команда перемещает один объект S3 в указанный бакет и ключ.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt

Вывод:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Пример 3: Перемещение объекта S3 в локальную директорию

Следующая mv команда перемещает один объект в указанный локальный файл.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt test2.txt

Вывод:

move: s3://amzn-s3-demo-bucket/test.txt to test2.txt

Пример 4: Перемещение объекта с исходным именем в указанный бакет

Следующая mv команда перемещает один объект в указанный бакет, сохраняя его исходное имя:

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket2/

Вывод:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket2/test.txt

Пример 5: Перемещение всех объектов и префиксов в бакете в локальную директорию

При передаче параметра --recursive, следующая mv команда рекурсивно перемещает все объекты в указанном префиксе и бакете в указанную директорию. В этом примере, бакет amzn-s3-demo-bucket содержит объекты test1.txt и test2.txt.

aws s3 mv s3://amzn-s3-demo-bucket . \
    --recursive

Вывод:

move: s3://amzn-s3-demo-bucket/test1.txt to test1.txt
move: s3://amzn-s3-demo-bucket/test2.txt to test2.txt

Пример 6: Перемещение всех объектов и префиксов в бакете в локальную директорию, за исключением файлов ``.jpg``

При передаче параметра --recursive, следующая mv команда рекурсивно перемещает все файлы в указанной директории в указанный бакет и префикс, исключая некоторые файлы с помощью параметра --exclude. В этом примере, директория myDir содержит файлы test1.txt и test2.jpg.

aws s3 mv myDir s3://amzn-s3-demo-bucket/ \
    --recursive \
    --exclude "*.jpg"

Вывод:

move: myDir/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Пример 7: Перемещение всех объектов и префиксов в бакете в локальную директорию, за исключением указанного префикса

При передаче параметра --recursive, следующая mv команда рекурсивно перемещает все объекты из указанного бакета в другой бакет, исключая некоторые объекты с помощью параметра --exclude. В этом примере, бакет amzn-s3-demo-bucket содержит объекты test1.txt и another/test1.txt.

aws s3 mv s3://amzn-s3-demo-bucket/ s3://amzn-s3-demo-bucket2/ \
    --recursive \
    --exclude "amzn-s3-demo-bucket/another/*"

Вывод:

move: s3://amzn-s3-demo-bucket/test1.txt to s3://amzn-s3-demo-bucket2/test1.txt

Пример 8: Перемещение объекта в указанный бакет и установка ACL

Следующая mv команда перемещает один объект в указанный бакет и ключ, установив ACL на public-read-write.

aws s3 mv s3://amzn-s3-demo-bucket/test.txt s3://amzn-s3-demo-bucket/test2.txt \
    --acl public-read-write

Вывод:

move: s3://amzn-s3-demo-bucket/test.txt to s3://amzn-s3-demo-bucket/test2.txt

Пример 9: Перемещение локального файла в указанный бакет и предоставление разрешений

Следующий mv пример демонстрирует использование параметра --grants для предоставления права чтения всем пользователям и полного контроля определенному пользователю, идентифицированному по адресу электронной почты.

aws s3 mv file.txt s3://amzn-s3-demo-bucket/ \
    --grants read=uri=http://acs.amazonaws.com/groups/global/AllUsers full=emailaddress=user@example.com

Вывод:

move: file.txt to s3://amzn-s3-demo-bucket/file.txt

Пример 10: Перемещение файла в S3 access point

Следующая mv команда перемещает один файл с именем mydoc.txt в access point с именем myaccesspoint по ключу mykey.

aws s3 mv mydoc.txt s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey

Вывод:

move: mydoc.txt to s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/mykey