ls

Описание

Список объектов S3 и общих префиксов в рамках префикса или всех ведер S3. Обратите внимание, что аргументы –output и –no-paginate игнорируются для этой команды.

Синтаксис

  ls
<S3Uri> or NONE
[--recursive]
[--page-size <value>]
[--human-readable]
[--summarize]
[--request-payer <value>]
[--bucket-name-prefix <value>]
[--bucket-region <value>]
[--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 (строка)

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

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

--human-readable (логическое значение) Отображает размеры файлов в удобочитаемом формате.

--summarize (логическое значение) Отображает сводную информацию (количество объектов, общий размер).

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

--bucket-name-prefix (строка) Ограничивает ответ именами ведер, начинающимися с указанного префикса имени ведра.

--bucket-region (строка) Ограничивает ответ ведрами, расположенными в указанном регионе Amazon Web Services. Регион Amazon Web Services должен быть выражен в соответствии с кодом региона Amazon Web Services, например, us-west-2 для региона США Запад (Орегон). Список допустимых значений для всех регионов Amazon Web Services см. на сайте https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region

Глобальные параметры

--debug (логическое значение)

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

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

• json
• текст
• таблица
• yaml
• yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• вкл
• выкл
• авто

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — 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 (логическое значение)

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Пример 1: Перечисление всех ведер, принадлежащих пользователю

Следующая команда ls перечисляет все ведра, принадлежащие пользователю. В этом примере пользователю принадлежат ведра amzn-s3-demo-bucket и amzn-s3-demo-bucket2. Отметка времени — дата создания ведра, отображенная в часовом поясе вашего компьютера. Эта дата может изменяться при внесении изменений в ведро, например, при редактировании его политики ведра. Обратите внимание, если s3:// используется в качестве аргумента пути <S3Uri>, он перечислит все ведра.

aws s3 ls

Вывод:

2013-07-11 17:08:50 amzn-s3-demo-bucket
2013-07-24 14:55:44 amzn-s3-demo-bucket2

Пример 2: Перечисление всех префиксов и объектов в ведре

Следующая команда ls перечисляет объекты и общие префиксы в указанном ведре и префиксе. В этом примере пользователю принадлежит ведро amzn-s3-demo-bucket с объектами test.txt и somePrefix/test.txt. LastWriteTime и Length — произвольные значения. Обратите внимание, что, поскольку команда ls не взаимодействует с локальной файловой системой, схема URI s3:// не требуется для разрешения неоднозначности и может быть опущена.

aws s3 ls s3://amzn-s3-demo-bucket

Вывод:

                           PRE somePrefix/
2013-07-25 17:06:27         88 test.txt

Пример 3: Перечисление всех префиксов и объектов в определенном ведре и префиксе

Следующая команда ls перечисляет объекты и общие префиксы в указанном ведре и префиксе. Однако в указанном ведре и префиксе нет объектов и общих префиксов.

aws s3 ls s3://amzn-s3-demo-bucket/noExistPrefix

Вывод:

None

Пример 4: Рекурсивное перечисление всех префиксов и объектов в ведре

Следующая команда ls рекурсивно перечислит объекты в ведре. Вместо отображения PRE dirname/ в выводе, будет перечислен весь контент ведра в порядке.

aws s3 ls s3://amzn-s3-demo-bucket \
    --recursive

Вывод:

2013-09-02 21:37:53         10 a.txt
2013-09-02 21:37:53    2863288 foo.zip
2013-09-02 21:32:57         23 foo/bar/.baz/a
2013-09-02 21:32:58         41 foo/bar/.baz/b
2013-09-02 21:32:57        281 foo/bar/.baz/c
2013-09-02 21:32:57         73 foo/bar/.baz/d
2013-09-02 21:32:57        452 foo/bar/.baz/e
2013-09-02 21:32:57        896 foo/bar/.baz/hooks/bar
2013-09-02 21:32:57        189 foo/bar/.baz/hooks/foo
2013-09-02 21:32:57        398 z.txt

Пример 5: Сводка по всем префиксам и объектам в ведре

Следующая команда ls демонстрирует ту же команду с использованием параметров –human-readable и –summarize. –human-readable отображает размер файла в байтах/МБ/КБ/ГБ/ТБ/ПБ/ЭБ. –summarize отображает общее количество объектов и общий размер в конце списка результатов:

aws s3 ls s3://amzn-s3-demo-bucket \
    --recursive \
    --human-readable \
    --summarize

Вывод:

2013-09-02 21:37:53   10 Bytes a.txt
2013-09-02 21:37:53  2.9 MiB foo.zip
2013-09-02 21:32:57   23 Bytes foo/bar/.baz/a
2013-09-02 21:32:58   41 Bytes foo/bar/.baz/b
2013-09-02 21:32:57  281 Bytes foo/bar/.baz/c
2013-09-02 21:32:57   73 Bytes foo/bar/.baz/d
2013-09-02 21:32:57  452 Bytes foo/bar/.baz/e
2013-09-02 21:32:57  896 Bytes foo/bar/.baz/hooks/bar
2013-09-02 21:32:57  189 Bytes foo/bar/.baz/hooks/foo
2013-09-02 21:32:57  398 Bytes z.txt

Total Objects: 10
   Total Size: 2.9 MiB

Пример 6: Перечисление из точки доступа к S3

Следующая команда ls перечисляет объекты из точки доступа (myaccesspoint):

aws s3 ls s3://arn:aws:s3:us-west-2:123456789012:accesspoint/myaccesspoint/

Вывод:

                           PRE somePrefix/
2013-07-25 17:06:27         88 test.txt