s3cmd - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

s3cmd - інструмент для керування простором зберігання Amazon S3 та доставкою вмісту Amazon CloudFront
мережу

СИНТАКСИС

s3cmd [ВАРІАНТИ] КОМАНДА [ПАРАМЕТРИ]

ОПИС

s3cmd — це клієнт командного рядка для копіювання файлів на/з Amazon S3 (Simple Storage
обслуговування) та виконання інших пов'язаних завдань, наприклад створення та видалення відер,
перерахування об’єктів тощо.

КОМАНДИ

s3cmd можна зробити кілька дії визначається наступним Команди.

s3cmd mb s3://ВІДРО
Зробіть відро

s3cmd rb s3://ВІДРО
Зніміть відро

s3cmd ls [s3://BUCKET[/PREFIX]]
Перерахуйте об’єкти або відра

s3cmd la
Перелік усіх об’єктів у всіх відрах

s3cmd put Фото [ФАЙЛ...] s3://BUCKET[/PREFIX]
Покладіть файл у відро

s3cmd отримати s3://ВІДРО/ОБ'ЄКТ LOCAL_FILE
Отримати файл із відра

s3cmd Дель s3://ВІДРО/ОБ'ЄКТ
Видалити файл із корзини

s3cmd rm s3://ВІДРО/ОБ'ЄКТ
Видалити файл із сегмента (псевдонім для del)

s3cmd відновлення s3://ВІДРО/ОБ'ЄКТ
Відновити файл із сховища Glacier

s3cmd синхронізувати LOCAL_DIR s3://BUCKET[/PREFIX] or s3://BUCKET[/PREFIX] LOCAL_DIR
Синхронізувати дерево каталогів із S3 (перевіряє свіжість файлів за допомогою розміру та md5
контрольна сума, якщо не змінено параметрами, див. нижче)

s3cmd du [s3://BUCKET[/PREFIX]]
Використання диска по відрах

s3cmd info s3://ВІДРО[/ОБ'ЄКТ]
Отримайте різну інформацію про сегменти або файли

s3cmd cp s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]
Копіювати об’єкт

s3cmd змінювати s3://BUCKET1/OBJECT
Змінити метадані об’єкта

s3cmd mv s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2]
Перемістити об’єкт

s3cmd setacl s3://ВІДРО[/ОБ'ЄКТ]
Змінити список контролю доступу для сегмента або файлів

s3cmd setpolicy Фото s3://ВІДРО
Змінити політику сегмента

s3cmd delpolicy s3://ВІДРО
Видалити політику сегмента

s3cmd набори Фото s3://ВІДРО
Змінити відро CORS

s3cmd делькори s3://ВІДРО
Видалити відро CORS

s3cmd платити s3://ВІДРО
Змінити політику Bucket Requester Pays

s3cmd багаточастинні s3://ВІДРО [Ідентифікатор]
Показати багатосерійне завантаження

s3cmd abortmp s3://ВІДРО/ОБ'ЄКТ Id
Скасувати багатосерійне завантаження

s3cmd listmp s3://ВІДРО/ОБ'ЄКТ Id
Перелік частин багатосерійного завантаження

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

s3cmd підпис STRING-TO-SIGN
Підпишіть довільний рядок за допомогою секретного ключа

s3cmd signurl s3://ВІДРО/ОБ'ЄКТ
Підпишіть URL-адресу S3, щоб надати обмежений публічний доступ із закінченням терміну дії

s3cmd fixbucket s3://BUCKET[/PREFIX]
Виправити недійсні імена файлів у сегменті

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

s3cmd встановити життєвий цикл Фото s3://ВІДРО
Завантажте політику життєвого циклу для сегмента

s3cmd dellifecycle s3://ВІДРО
Видаліть політику життєвого циклу для сегмента

Команди для конфігурації статичних веб-сайтів

s3cmd ws-створити s3://ВІДРО
Створення веб-сайту з відра

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

s3cmd ws-info s3://ВІДРО
Інформація про веб-сайт

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

s3cmd cflist
Перелік точок розповсюдження CloudFront

s3cmd cfinfo [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

-Дамп-конфіг
Дамп поточної конфігурації після аналізу файлів конфігурації та параметрів командного рядка та
ВХІД.

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

--секретний_ключ=СЕКРЕТНИЙ_КЛЮЧ
Секретний ключ AWS

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

-s, --ssl
Використовуйте з’єднання HTTPS під час спілкування з S3. (за замовчуванням)

--no-ssl
Не використовуйте HTTPS.

-e, --зашифрувати
Шифруйте файли перед завантаженням на S3.

--без шифрування
Не шифруйте файли.

-f, --сила
Примусове перезапис та інші небезпечні операції.

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

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

--upload-id=UPLOAD_ID
UploadId для багатокомпонентного завантаження, якщо ви хочете продовжити існуюче завантаження
(дорівнює --продовжити- put) і є кілька часткових завантажень. Використовуйте s3cmd
multipart [URI], щоб побачити, які ідентифікатори UploadId пов’язані з даним URI.

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

-r, --рекурсивний
Рекурсивне завантаження, завантаження або видалення.

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

--no-check-md5
Не перевіряйте суми MD5 під час порівняння файлів для [синхронізації]. Порівнюватиме лише розмір.
Може значно прискорити передачу, але також може пропустити деякі змінені файли.

-P, --acl-публічний
Зберігайте об’єкти з ACL, що дозволяє читати будь-кому.

--acl-приватний
Зберігайте об’єкти з ACL за замовчуванням, що надає доступ лише вам.

--acl-грант=PERMISSION:EMAIL або USER_CANONICAL_ID
Надати вказаний дозвіл певному користувачеві Amazon. Дозвіл є одним із: читати, писати,
read_acp, write_acp, full_control, все

--acl-revoke=PERMISSION:USER_CANONICAL_ID
Скасувати вказаний дозвіл для даного користувача Amazon. Дозвіл є одним із: прочитати,
write, read_acp, wr ite_acp, full_control, все

-D NUM, -- дні відновлення=NUM
Кількість днів, протягом яких відновлений файл буде доступним (тільки для команди відновлення).

--видалити-видалено
Видалити віддалені об’єкти без відповідного локального файлу [синхронізація]

--no-delete-removed
Не видаляйте віддалені об'єкти.

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

--dey-updates
*ЗАСТАРЕЛО* Розмістіть усі оновлені файли на місці в кінці [синхронізація]

--max-видалити=NUM
Не видаляйте більше ніж NUM файлів. [del] і [sync]

--add-destination=ADDITIONAL_DESTINATIONS
Додаткове призначення для паралельних завантажень, на додаток до останнього аргументу. Можливо
повторюється.

--delete-after-fetch
Видалити віддалені об’єкти після отримання в локальний файл (лише для [get] і [sync]
команди).

-p, --зберігати
Збереження атрибутів файлової системи (режим, право власності, позначки часу). За умовчанням для [синхронізації]
команда

--без консервації
Не зберігайте атрибути FS

--виключити= GLOB
Імена файлів і шляхи, що відповідають GLOB, будуть виключені з синхронізації

--виключити-з=ФАЙЛ
Прочитати --виключити GLOB з FILE

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

--виключити-з=ФАЙЛ
Прочитати --rexclude REGEXP з FILE

--включати= GLOB
Назви файлів і шляхи, що відповідають GLOB, будуть включені, навіть якщо вони були виключені раніше
один з ---(r)виключити(-з) моделі

--include-from=ФАЙЛ
Прочитати --включити GLOB з FILE

--включати=REGEXP
Те саме, що --include, але використовує REGEXP (регулярний вираз) замість GLOB

--include-from=ФАЙЛ
Прочитайте --rinclude REGEXP з FILE

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

--регіон=РЕГІОН, --bucket-location=РЕГІОН
Регіон для створення сегмента. На даний момент регіонами є: us-east-1, us-west-1,
us-weest-2, eu-west-1, eu- центральний-1, ap-північно-схід-1, ap-південно-схід-1, ap-
південний схід-2, са-схід-1

--господар=НАЗВА ХОСТУ
HOSTNAME:PORT для кінцевої точки S3 (за замовчуванням: s3.amazonaws.com, альтернативи, такі як
s3-eu- west-1.amazonaws.com). Ви також повинні встановити --господар- відро.

--host-bucket=HOST_BUCKET
Шаблон bucket+hostname:port у стилі DNS для доступу до сегмента (за замовчуванням:
%(відро)s.s3.amazonaws.com)

--зменшена-надлишкова, --rr
Зберігати об’єкт із «Зменшеною надлишковістю». Нижча ціна за ГБ. [покласти, cp, mv]

--no-reduced-reundancy, --ні-р-р
Зберігати об’єкт без «Зменшеної надмірності». Вища ціна за ГБ. [покласти, cp, mv]

--клас зберігання=КЛАС
Зберігати об’єкт із зазначеним КЛАСОМ (STANDARD, STANDARD_IA або REDUCED_REDUNDANCY).
Нижча ціна за ГБ. [put, cp, mv]

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

--no-access-logging
Вимкнути журналювання доступу (для команд [cfmodify] і [accesslog])

--default-mime-type=DEFAULT_MIME_TYPE
Тип MIME за замовчуванням для збережених об’єктів. За замовчуванням додаток – двійковий/октетний потік.

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

--не-відгадка-мім-типу
Не вгадайте тип MIME, а замість цього використовуйте тип за замовчуванням.

--не-мім-магії
Не використовуйте магію пантоміми, коли вгадуєте MIME-тип.

-m MIME/TYPE, --мім-типу=MIME/ТИП
Примусово MIME-тип. Замінити обидва --default-mime-type та --угадай-мім-типу.

-- add-header=NAME:VALUE
Додайте заданий HTTP-заголовок до запиту на завантаження. Можна використовувати кілька разів. Для
екземпляр встановлює заголовки "Expires" або "Cache-Control" (або обидва), використовуючи цю опцію.

--remove-header=НАЗВА
Видаліть заданий заголовок HTTP. Можна використовувати кілька разів. Наприклад, видалити
Заголовки «Expires» або «Cache-Control» (або обидва) за допомогою цієї опції. [змінити]

--шифрування на стороні сервера
Вказує, що під час розміщення об’єктів використовуватиметься шифрування на стороні сервера. [покласти,
sync, cp, modify]

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

--кодування=КОДИРОВАННЯ
Замінити кодування терміналу та файлової системи (набір символів).
Автоматичне визначення: UTF-8

--add-encoding-exts=Розширення
Додайте кодування до цих розширень, розділених комами, наприклад (css,js,html), під час завантаження
до S3)

-- дослівно
Використовуйте ім’я S3, яке вказано в командному рядку. Без попередньої обробки, кодування тощо.
Використовуйте обережно!

--disable-multipart
Вимкнути багатокомпонентне завантаження для файлів більше ніж --multipart-chunk-size-mb

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

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

-H, -- Людиночитані розміри
Розміри друку в читаній людині формі (наприклад, 1 КБ замість 1234).

--ws-index=ІНДЕКС_ВЕБ-САЙТУ
Назва індексного документа (тільки для команди [ws-create])

--ws-помилка=ПОМИЛКА_ВЕБ-САЙТУ
Назва документа про помилку (лише для команди [ws-create])

--термін придатності= EXPIRY_DATE
Вказує, коли набирає чинності правило закінчення терміну дії. (лише для команди [expire])

--термін дії=EXPIRY_DAYS
Вказує кількість днів після створення об’єкта, на яку діє правило
ефект. (лише для команди [expire])

--префікс терміну дії=EXPIRY_PREFIX
Ідентифікація одного або кількох об’єктів із префіксом, для якого діє правило закінчення терміну дії
застосовується. (лише для команди [expire])

-- прогрес
Відображати індикатор прогресу (за замовчуванням на TTY).

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

--статистика
Надайте деяку статистику передачі файлів.

--увімкнути
Увімкнути заданий розподіл CloudFront (лише для команди [cfmodify])

--вимкнути
Увімкнути заданий розподіл CloudFront (лише для команди [cfmodify])

--cf-invalidate
Визнайте недійсним завантажений файл у CloudFront. Також дивіться команду [cfinval].

--cf-invalidate-default-index
Використовуючи Custom Origin і статичний веб-сайт S3, скасуйте файл індексу за замовчуванням.

--cf-no-invalidate-default-index-root
Використовуючи Custom Origin і статичний веб-сайт S3, не скасовуйте шлях до
індексний файл за замовчуванням.

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

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

--cf-коментар=КОМЕНТАР
Встановити COMMENT для даного дистрибутива CloudFront (лише для [cfcreate] і [cfmodify]
команди)

--cf-default-root-object=DEFAULT_ROOT_OBJECT
Встановіть кореневий об’єкт за замовчуванням для повернення, якщо в URL-адресі не вказано жодний об’єкт. Використовуйте a
відносний шлях, тобто default/index.html замість /default/index.html або
s3://bucket/default/index.html (лише для команд [cfcreate] і [cfmodify])

-v, -багатослівний
Увімкнути докладний вихід.

-d, --відлагоджувати
Увімкнути вихід налагодження.

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

-F, --follow-symlinks
Переходьте за символічними посиланнями, як за звичайними файлами

--кеш-файл=ФАЙЛ
Кеш-файл, що містить локальні вихідні значення MD5

-q, --спокійно
Беззвучний вихід на стандартний вихід

--ca-сертифікати=CA_CERTS_FILE
Шлях до FILE сертифіката CA SSL (замість системного за замовчуванням)

--чек-сертифікат
Перевірте дійсність сертифіката SSL

- не перевірити сертифікат
Не перевіряйте дійсність сертифіката SSL

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

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

--підпис-v2
Використовуйте AWS Signature версії 2 замість новіших методів підпису. Корисно для S3-подібного
системи, які ще не мають AWS Signature v4.

--лімітна ставка=ОБМЕЖЕННЯ
Обмежте швидкість завантаження або завантаження кількістю байтів на секунду. Сума може бути
виражається в байтах, кілобайтах із суфіксом k або мегабайтах із суфіксом m

--запитувач-оплачує
Установіть прапор REQUESTER PAYS для операцій

-l, -- довгий список
Створити довгий список [ls]

--зупинка при помилці
зупинити, якщо помилка передачі

--зміст-диспозиція=CONTENT_DISPOSITION
Надайте Content-Disposition для підписаних URL-адрес, наприклад, "inline; filename=myvideo.mp4"

--тип вмісту=CONTENT_TYPE
Надайте тип вмісту для підписаних URL-адрес, наприклад, "video/mp4"

ПРИКЛАДИ

Одна з найпотужніших команд s3cmd is s3cmd синхронізувати використовується для завершення синхронізації
дерева каталогів до або з віддаленого сховища S3. Певною мірою s3cmd put та s3cmd отримати частка
подібна поведінка з синхронізувати.

Основне використання, поширене в сценаріях резервного копіювання, таке просте, як:
s3cmd sync /local/path/ s3://test-bucket/backup/

Ця команда знайде всі файли в каталозі /local/path і скопіює їх
відповідні шляхи в s3://test-bucket/backup на віддаленому боці. Наприклад:
/локальний/шлях/file1.ext -> s3://bucket/backup/file1.ext
/локальний/шлях/dir123/file2.bin -> s3://bucket/backup/dir123/file2.bin

Однак якщо локальний шлях не закінчується косою рискою, використовується назва останнього каталогу
також віддалена сторона. Порівняйте їх з попереднім прикладом:
s3cmd sync /local/path s3://test-bucket/backup/
буде синхронізовано:
/локальний/шлях/файл1.ext -> s3://bucket/backup/шлях/файл1.ext
/локальний/шлях/dir123/file2.bin -> s3://bucket/backup/шлях/dir123/file2.bin

Щоб отримати файли назад із S3, використовуйте інвертований синтаксис:
s3cmd sync s3://test-bucket/backup/ ~/відновити/
який завантажить файли:
s3://bucket/backup/file1.ext -> ~/відновити/file1.ext
s3://bucket/backup/dir123/file2.bin -> ~/відновити/dir123/file2.bin

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

Усі імена вихідних файлів, виділені жирним шрифтом вище, відповідають виключати правила і ті
цей збіг потім перевіряється включати правила, щоб побачити, чи мають вони бути
виключені або збережені в списку джерел.

З метою --виключити та --включати збігаються лише жирні імена файлів вище
використаний. Тільки для прикладу шлях/файл1.ext перевіряється за шаблонами, ні
/локальний/шлях/файл1.ext

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

Існує лише один набір візерунків, створених з усіх ---(r)виключити(-з) варіанти і подібне
для включеного варіанту. Будь-який файл, виключений, наприклад, --exclude, можна повернути за допомогою шаблону
знайдено в --rinclude-from списку.

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

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

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

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

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

Щоб виключити локальний каталог 'somedir', не забудьте використовувати косу риску в кінці:

--exclude 'somedir/'

Використовуйте s3cmd онлайн за допомогою служб onworks.net