s3cmd - Онлайн в облаке

ПРОГРАММА:

ИМЯ

s3cmd - инструмент для управления пространством хранения Amazon S3 и доставки контента Amazon CloudFront
сеть

СИНТАКСИС

s3cmd [ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ] КОМАНДА [ПАРАМЕТРЫ]

ОПИСАНИЕ

s3cmd - это клиент командной строки для копирования файлов в / из Amazon S3 (Simple Storage
Service) и выполнение других связанных задач, например, создание и удаление корзин,
перечисление объектов и т. д.

КОМАНДЫ

s3cmd может сделать несколько действия определяется следующими команды.

s3cmd mb s3: // ВЕДРО
Сделать ведро

s3cmd rb s3: // ВЕДРО
Удалить ведро

s3cmd ls [s3: // ВЕДРО [/ PREFIX]]
Список объектов или сегментов

s3cmd la
Перечислить все объекты во всех сегментах

s3cmd положил ФАЙЛОВ [ФАЙЛ...] s3: // ВЕДРО [/ ПРЕФИКС]
Положить файл в ведро

s3cmd получить s3: // ВЕДРО / ОБЪЕКТ ЛОКАЛЬНЫЙ_ФАЙЛ
Получить файл из корзины

s3cmd из s3: // ВЕДРО / ОБЪЕКТ
Удалить файл из корзины

s3cmd rm s3: // ВЕДРО / ОБЪЕКТ
Удалить файл из корзины (псевдоним для del)

s3cmd восстановление s3: // ВЕДРО / ОБЪЕКТ
Восстановить файл из хранилища Glacier

s3cmd синхронизировать ЛОКАЛЬНЫЙ_КАТАЛОГ s3: // ВЕДРО [/ ПРЕФИКС] or s3: // ВЕДРО [/ ПРЕФИКС] ЛОКАЛЬНЫЙ_КАТАЛОГ
Синхронизируйте дерево каталогов с S3 (проверяет актуальность файлов по размеру и md5).
контрольная сумма, если она не отменена параметрами, см. ниже)

s3cmd du [s3: // ВЕДРО [/ PREFIX]]
Использование диска по корзинам

s3cmd info s3: // ВЕДРО [/ ОБЪЕКТ]
Получите различную информацию о сегментах или файлах

s3cmd cp s3: // ВЕДРО1 / ОБЪЕКТ1 s3: // BUCKET2 [/ OBJECT2]
Копировать объект

s3cmd изменять s3: // ВЕДРО1 / ОБЪЕКТ
Изменить метаданные объекта

s3cmd mv s3: // ВЕДРО1 / ОБЪЕКТ1 s3: // BUCKET2 [/ OBJECT2]
Переместить объект

s3cmd Setacl s3: // ВЕДРО [/ ОБЪЕКТ]
Изменить список управления доступом для сегмента или файлов

s3cmd установка политики ФАЙЛОВ s3: // ВЕДРО
Изменить политику сегмента

s3cmd деловая политика s3: // ВЕДРО
Удалить политику сегмента

s3cmd сеткор ФАЙЛОВ s3: // ВЕДРО
Изменить ковш CORS

s3cmd делькор s3: // ВЕДРО
Удалить корзину CORS

s3cmd платить s3: // ВЕДРО
Изменить политику "Платежи, запрашивающие сегмент"

s3cmd многочастному s3: // ВЕДРО [Идентификатор]
Показать многокомпонентные загрузки

s3cmd прерывание s3: // ВЕДРО / ОБЪЕКТ Id
Прервать многокомпонентную загрузку

s3cmd списокmp s3: // ВЕДРО / ОБЪЕКТ Id
Список частей составной загрузки

s3cmd журнал доступа s3: // ВЕДРО
Включение / отключение ведения журнала доступа к корзине

s3cmd подпись СТРОКА ДО ЗНАКА
Подписать произвольную строку с помощью секретного ключа

s3cmd подписать s3: // ВЕДРО / ОБЪЕКТ
Подпишите URL-адрес S3, чтобы обеспечить ограниченный публичный доступ с истечением срока действия

s3cmd Fixbucket s3: // ВЕДРО [/ ПРЕФИКС]
Исправить недопустимые имена файлов в корзине

s3cmd истекать s3: // ВЕДРО
Установить или удалить правило истечения срока для сегмента

s3cmd установить жизненный цикл ФАЙЛОВ s3: // ВЕДРО
Загрузите политику жизненного цикла для корзины

s3cmd жизненный цикл s3: // ВЕДРО
Удаление политики жизненного цикла для корзины

Команды для настройки статических веб-сайтов

s3cmd ws-создать s3: // ВЕДРО
Создать сайт из корзины

s3cmd ws-удалить s3: // ВЕДРО
Удалить веб-сайт

s3cmd ws-информация s3: // ВЕДРО
Информация о веб-сайте

Команды для управления CloudFront

s3cmd cflist
Список точек распространения CloudFront

s3cmd cinfo [cf: // DIST_ID]
Отображение параметров точки распространения CloudFront

s3cmd cfcreate s3: // ВЕДРО
Создать точку распространения CloudFront

s3cmd cfdelete cf: // DIST_ID
Удалить точку распространения CloudFront

s3cmd cfmodify cf: // DIST_ID
Изменить параметры точки распространения CloudFront

s3cmd cfinvalinfo cf: // DIST_ID [/ INVAL_ID]
Отображение статуса запросов на аннулирование CloudFront

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Некоторые из указанных ниже параметров могут иметь значения по умолчанию, установленные в s3cmd файл конфигурации
(по умолчанию $ HOME / .s3cmd). Поскольку это простой текстовый файл, не стесняйтесь открывать его с помощью
любимый текстовый редактор и вносите любые изменения, которые вам нравятся.

-h, --Помогите
показать это справочное сообщение и выйти

--конфигурировать
Вызов интерактивного инструмента (повторного) конфигурирования. Необязательно использовать как '--конфигурировать
s3: // some-bucket 'для проверки доступа к конкретному ведру вместо попытки перечислить
торговый центр.

-c ФАЙЛ, --config= ФАЙЛ
Имя файла конфигурации. По умолчанию $ HOME / .s3cfg.

--dump-config
Дамп текущей конфигурации после анализа файлов конфигурации и параметров командной строки и
Выход.

--ключ доступа= ACCESS_KEY
Ключ доступа к AWS

--Секретный ключ= SECRET_KEY
Секретный ключ AWS

-n, --прогон, репетиция
Показывать только то, что должно быть загружено или загружено, но не делайте этого на самом деле. Может еще
выполнять запросы S3, чтобы получить списки корзин и другую информацию (только для
команды передачи файлов)

-s, --ssl
Используйте HTTPS-соединение при связи с S3. (дефолт)

--no-ssl
Не используйте HTTPS.

-e, --шифровать
Зашифруйте файлы перед загрузкой на S3.

--no-шифровать
Не шифруйте файлы.

-f, --сила
Принудительная перезапись и другие опасные операции.

--Продолжить
Продолжить получение частично загруженного файла (только для команды [get]).

--продолжить-положить
Продолжайте загружать частично загруженные файлы или составные части загрузки.
Перезапускает / разделяет файлы, у которых нет подходящего размера, и md5. Пропускает файлы / части,
делать. Примечание: проверки md5sum не всегда достаточны для проверки (частичного) равенства файлов.
Включите это на свой страх и риск.

--upload-id= UPLOAD_ID
UploadId для многокомпонентной загрузки, если вы хотите продолжить существующую загрузку
(эквивалентно --Продолжить- поставил) и есть несколько частичных загрузок. Используйте s3cmd
multipart [URI], чтобы узнать, какие UploadIds связаны с данным URI.

- пропустить существующий
Пропускать файлы, существующие в месте назначения (только для команд [get] и [sync]).

-r, - рекурсивный
Рекурсивная загрузка, загрузка или удаление.

--check-md5
Проверяйте суммы MD5 при сравнении файлов для [синхронизации]. (дефолт)

--нет-проверить-md5
Не проверяйте суммы MD5 при сравнении файлов для [синхронизации]. Сравнивается только размер.
Может значительно ускорить передачу, но может также пропустить некоторые измененные файлы.

-P, --acl-public
Храните объекты с ACL, разрешающим чтение для всех.

--acl-частный
Храните объекты со списком контроля доступа по умолчанию, разрешающим доступ только вам.

--acl-грант= РАЗРЕШЕНИЕ: EMAIL или USER_CANONICAL_ID
Предоставить заявленное разрешение данному пользователю Amazon. Доступно одно из следующих разрешений: чтение, запись,
read_acp, write_acp, full_control, все

--acl-отозвать= РАЗРЕШЕНИЕ: USER_CANONICAL_ID
Отозвать заявленное разрешение для данного пользователя Amazon. Разрешение одно из: читать,
запись, read_acp, wr ite_acp, full_control, все

-D ЧИСЛО, - восстановительные дни= ЧИСЛО
Количество дней, в течение которых восстановленный файл будет доступен (только для команды «восстановить»).

--delete-удалено
Удалить удаленные объекты без соответствующего локального файла [синхронизация]

--no-delete-удалено
Не удаляйте удаленные объекты.

--delete-после
Выполнять удаление после новых загрузок [синхронизация]

--delay-обновления
* УСТАРЕЛО * Поместите все обновленные файлы на место в конце [синхронизация]

--max-удалить= ЧИСЛО
Не удаляйте более NUM файлов. [del] и [синхронизация]

--добавить-пункт назначения= ADDITIONAL_DESTINATIONS
Дополнительное место назначения для параллельной загрузки в дополнение к последнему аргументу. Может быть
повторяется.

--удалить-после-выборки
Удалять удаленные объекты после загрузки в локальный файл (только для [get] и [sync]
команды).

-p, - сохранить
Сохранять атрибуты файловой системы (режим, владение, временные метки). По умолчанию для [синхронизация]
команда.

- не сохранять
Не храните атрибуты FS

--исключать= ГЛОБ
Имена файлов и пути, соответствующие GLOB, будут исключены из синхронизации.

- исключить из= ФАЙЛ
Читать - исключить глобальные объекты из ФАЙЛА

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

--rexclude-от= ФАЙЛ
Читать - исключить REGEXP из ФАЙЛА

--включают= ГЛОБ
Имена файлов и пути, соответствующие GLOB, будут включены, даже если ранее были исключены
один из - (r) исключить (-from) паттеранами

--include-от= ФАЙЛ
Читать - включить глобальные объекты из ФАЙЛА

--include= REGEXP
То же, что --include, но использует REGEXP (регулярное выражение) вместо GLOB

--rinclude-от= ФАЙЛ
Читать - включить REGEXP из ФАЙЛА

--файлы-из= ФАЙЛ
Прочитать список имен исходных файлов из ФАЙЛА. Используйте - для чтения из стандартного ввода.

--область= РЕГИОН, --bucket-location= РЕГИОН
Регион для создания корзины. На данный момент это следующие регионы: us-east-1, us-west-1,
сша-запад-2, ес-запад-1, ес-центр-1, ап-северо-восток-1, ап-юго-восток-1, ап-
юго-восток-2, ю-восток-1

--хозяин= HOSTNAME
HOSTNAME: ПОРТ для конечной точки S3 (по умолчанию: s3.amazonaws.com, альтернативы, такие как
s3-eu- west-1.amazonaws.com). Вы также должны установить --хозяин- ведро.

- хост-ведро= HOST_BUCKET
Корзина в стиле DNS + имя хоста: шаблон порта для доступа к корзине (по умолчанию:
% (bucket) s.s3.amazonaws.com)

--редуцированная избыточность, --рр
Хранить объект с пониженной избыточностью. Более низкая цена за гигабайт. [положить, cp, mv]

--no-redundancy, --но-рр
Хранить объект без «Сниженной избыточности». Более высокая цена за гигабайт. [положить, cp, mv]

--storage-класс= КЛАСС
Сохранить объект с указанным КЛАССОМ (STANDARD, STANDARD_IA или REDUCED_REDUNDANCY).
Более низкая цена за гигабайт. [положить, cp, mv]

--access-loging-target-prefix= LOG_TARGET_PREFIX
Целевой префикс для журналов доступа (S3 URI) (для команд [cfmodify] и [accesslog])

--нет-доступа-логгирования
Отключить ведение журнала доступа (для команд [cfmodify] и [accesslog])

- по умолчанию-mime-type= DEFAULT_MIME_TYPE
MIME-тип по умолчанию для хранимых объектов. По умолчанию для приложения используется двоичный / октетный поток.

-M, - угадай-мим-тип
Угадайте MIME-тип файлов по их расширению или магии mime. Вернуться к значениям по умолчанию
MIME-тип, как указано - по умолчанию-mime-type вариант

--не-угадай-мим-тип
Не угадывайте MIME-тип и используйте вместо него тип по умолчанию.

- без мима-магии
Не используйте магию пантомимы при угадывании MIME-типа.

-m MIME / ТИП, - пантомима= MIME / ТИП
Принудительно использовать MIME-тип. Отменить оба - по умолчанию-mime-type и - угадай-мим-тип.

--добавить заголовок= ИМЯ: ЗНАЧЕНИЕ
Добавьте заданный HTTP-заголовок в запрос на загрузку. Можно использовать несколько раз. Для
Экземпляр устанавливает заголовки Expires или Cache-Control (или оба), используя эту опцию.

--удалить-заголовок= ИМЯ
Удалить заданный HTTP-заголовок. Можно использовать несколько раз. Например, удалить
Заголовки Expires или Cache-Control (или оба) с использованием этой опции. [изменить]

- шифрование на стороне сервера
Указывает, что при размещении объектов будет использоваться шифрование на стороне сервера. [положил,
синхронизировать, cp, изменить]

--server-side-encryption-kms-id= KMS_KEY
Задает идентификатор ключа, используемый для шифрования на стороне сервера с помощью ключей, управляемых AWS KMS.
(SSE-KMS) при размещении объектов. [положить, синхронизировать, cp, изменить]

- кодирование= КОДИРОВАНИЕ
Переопределить автоматически определенную кодировку терминала и файловой системы (набор символов).
Обнаружено автоматически: UTF-8

--add-encoding-exts= РАСШИРЕНИЯ
Добавьте кодировку к этим расширениям с разделителями-запятыми, например (css, js, html) при загрузке
к S3)

--дословно
Используйте имя S3, указанное в командной строке. Без предварительной обработки, кодирования и т. Д.
Используйте с осторожностью!

--disable-многочастный
Отключить многостраничную загрузку файлов размером более --multipart-chunk-size-mb

--multipart-chunk-size-mb= РАЗМЕР
Размер каждого фрагмента многокомпонентной загрузки. Файлы размером больше SIZE автоматически
загружаются как многопоточные - многостраничные файлы меньшего размера загружаются с использованием
традиционный метод. РАЗМЕР в мегабайтах, размер блока по умолчанию - 15 МБ, минимум.
допустимый размер блока - 5 МБ, максимальный - 5 ГБ.

--список-md5
Включать суммы MD5 в списки сегментов (только для команды ls).

-H, - удобочитаемые размеры
Размеры печати в удобочитаемой форме (например, 1 КБ вместо 1234).

--ws-индекс= WEBSITE_INDEX
Имя индексного документа (только для команды [ws-create])

--ws-ошибка= WEBSITE_ERROR
Имя документа-ошибки (только для команды [ws-create])

--Дата истечения срока действия= EXPIRY_DATE
Указывает, когда вступает в силу правило истечения срока. (только для команды [expire])

- срок годности= EXPIRY_DAYS
Указывает количество дней после создания объекта, через которое истекает срок действия правила.
эффект. (только для команды [expire])

--expiry-префикс= EXPIRY_PREFIX
Идентификация одного или нескольких объектов с префиксом, для которого действует правило истечения срока действия.
применяется. (только для команды [expire])

--прогресс
Отображать индикатор выполнения (по умолчанию для TTY).

--Нет прогресса
Не отображать индикатор выполнения (по умолчанию для не-TTY).

--статистика
Приведите некоторую статистику передачи файлов.

--включить
Включить данную раздачу CloudFront (только для команды [cfmodify])

--запрещать
Включить данную раздачу CloudFront (только для команды [cfmodify])

--cf-недействительный
Сделать недействительным загруженное поле в CloudFront. См. Также команду [cfinval].

--cf-invalidate-default-index
При использовании Custom Origin и статического веб-сайта S3 сделайте недействительным индексный файл по умолчанию.

--cf-no-invalidate-default-index-root
При использовании Custom Origin и статического веб-сайта S3 не аннулируйте путь к
индексный файл по умолчанию.

--cf-добавить-имя= CNAME
Добавить указанный CNAME в дистрибутив CloudFront (только для [cfcreate] и [cfmodify]
команды)

--cf-remove-имя= CNAME
Удалить указанный CNAME из дистрибутива CloudFront (только для команды [cfmodify])

--cf-комментарий= КОММЕНТАРИЙ
Установите КОММЕНТАРИЙ для данного дистрибутива CloudFront (только для [cfcreate] и [cfmodify]
команды)

--cf-default-root-объект= DEFAULT_ROOT_OBJECT
Установите корневой объект по умолчанию для возврата, если в URL-адресе не указан объект. Использовать
относительный путь, т.е. default / index.html вместо /default/index.html или
s3: //bucket/default/index.html (только для команд [cfcreate] и [cfmodify])

-v, --подробный
Включить подробный вывод.

-d, --отлаживать
Включить вывод отладки.

--версия
Показать версию s3cmd (1.6.1) и выйти.

-F, --follow-символические ссылки
Переходите по символическим ссылкам, как если бы они были обычными файлами

--cache-файл= ФАЙЛ
Кэш-ФАЙЛ, содержащий локальные исходные значения MD5

-q, --тихий
Вывод тишины на стандартный вывод

- сертификаты= CA_CERTS_FILE
Путь к ФАЙЛУ сертификата ЦС SSL (вместо системного по умолчанию)

--check-сертификат
Проверить действительность SSL-сертификата

--no-check-сертификат
Не проверять действительность SSL-сертификата

--check-имя хоста
Проверить действительность имени хоста SSL-сертификата

--no-check-имя хоста
Не проверять действительность имени хоста SSL-сертификата

--подпись-v2
Используйте AWS Signature версии 2 вместо более новых методов подписи. Полезно для S3-подобных
системы, в которых еще нет AWS Signature v4.

--limit-ставка= ОГРАНИЧИТЕЛЬ
Ограничьте скорость загрузки или выгрузки до количества байтов в секунду. Сумма может быть
выражается в байтах, килобайтах с суффиксом k или мегабайтах с суффиксом m

--requester-платит
Установите флаг REQUESTER PAYS для операций

-l, --длинный список
Создать длинный список [ls]

- остановка при ошибке
остановить, если произошла ошибка при передаче

- содержание-диспозиция= CONTENT_DISPOSITION
Предоставьте Content-Disposition для подписанных URL-адресов, например, "inline; filename = myvideo.mp4"

--Тип содержимого= CONTENT_TYPE
Укажите Content-Type для подписанных URL-адресов, например, "видео / mp4".

ПРИМЕРЫ

Одна из самых сильных команд s3cmd is s3cmd синхронизировать используется для полной синхронизации
деревья каталогов в удаленное хранилище S3 или из него. В некоторой степени s3cmd положил и s3cmd получить Share
аналогичное поведение с синхронизировать.

Базовое использование, распространенное в сценариях резервного копирования, очень просто:
s3cmd синхронизация / локальный / путь / s3: // тест-ведро / резервное копирование /

Эта команда найдет все файлы в каталоге / local / path и скопирует их в
соответствующие пути в s3: // test-bucket / backup на удаленной стороне. Например:
/ местный / путь /файл1.ext -> s3: // ведро / резервное копирование /файл1.ext
/ местный / путь /dir123 / file2.bin -> s3: // ведро / резервное копирование /dir123 / file2.bin

Однако, если локальный путь не заканчивается косой чертой, используется последнее имя каталога.
удаленная сторона тоже. Сравните это с предыдущим примером:
s3cmd синхронизация / локальный / путь s3: // тест-ведро / резервное копирование /
будет синхронизировать:
/местный/путь / file1.ext -> s3: // ведро / резервное копирование /путь / file1.ext
/местный/путь / dir123 / file2.bin -> s3: // ведро / резервное копирование /путь / dir123 / file2.bin

Чтобы получить файлы обратно из S3, используйте инвертированный синтаксис:
s3cmd sync s3: // тестовый сегмент / резервное копирование / ~ / восстановить /
который загрузит файлы:
s3: // ведро / резервное копирование /файл1.ext -> ~ / восстановить /файл1.ext
s3: // ведро / резервное копирование /dir123 / file2.bin -> ~ / восстановить /dir123 / file2.bin

Без завершающей косой черты в исходном тексте поведение похоже на то, что было
продемонстрировано с загрузкой:
s3cmd синхронизация s3: // тестовое ведро / резервное копирование ~ / восстановить /
загрузит файлы как:
s3: // ведро /резервная копия / file1.ext -> ~ / восстановить /резервная копия / file1.ext
s3: // ведро /резервная копия / dir123 / file2.bin -> ~ / восстановить /резервная копия / dir123 / file2.bin

Все имена исходных файлов, выделенные жирным шрифтом выше, сравниваются с исключать правила и те
это совпадение затем повторно проверяется на включают правила, чтобы увидеть, должны ли они быть
исключены или сохранены в списке источников.

С целью --исключать и --включают совпадающие только с указанными выше полужирными именами файлов
использовал. Например только путь / file1.ext проверяется на соответствие шаблонам, а не
/местный/путь / file1.ext

Оба формата --исключать и --включают работать с подстановочными знаками в стиле оболочки (также известными как GLOB). Для большего
гибкость s3cmd предоставляет версии с регулярным выражением для двух опций исключения, названных
- исключить и --include. Варианты с ...-от суффикс (например, --rinclude-from) ожидать
имя файла в качестве аргумента. Каждая строка такого файла рассматривается как один шаблон.

Есть только один набор шаблонов, построенных из всех - (r) исключить (-from) варианты и аналогично
для варианта включения. Любой файл, исключенный, например, --exclude, может быть возвращен с шаблоном
находится в списке --rinclude-from.

Запустите s3cmd с --прогон, репетиция чтобы убедиться, что ваши правила работают должным образом. Используйте вместе с
--отлаживать получить подробную информацию о сопоставлении имен файлов с исключаемыми и включенными
правила.

Например, чтобы исключить все файлы с расширением ".jpg" loading = "lazy", кроме файлов, начинающихся с
использование номера:

--exclude '* .jpg' --rinclude '[0-9]. *. jpg'

Чтобы исключить все файлы, кроме расширения "* .jpg" loading = "lazy", используйте:

--exclude '*' --include '* .jpg'

Чтобы исключить локальный каталог somedir, обязательно используйте косую черту в конце как таковую:

- исключить somedir /

Используйте s3cmd онлайн с помощью сервисов onworks.net