key list

Sergei Tikhomirov

Определение

Выводит информацию о всех ключах в бакете или томе.

Использование

$ ozone sh key list [-hV] [-p=<prefix>]
                          [-s=<startItem>]
                          [[-l=<limit>] | [-a]]
                          <value>
ПРИМЕЧАНИЕ
В данной команде list можно сократить до ls.
Аргументы
Параметр Описание

value

URI тома или бакета. Может быть как полным URI (начинается с o3://, например, o3://hostname:9862/vol1/bucket1), так и коротким URI (vol1/bucket1). Вся недостающая информация считывается из конфигурационных файлов

prefix

Префикс для фильтрации имен ключей

startItem

Имя элемента, с которого начать вывод. Выбранный элемент не будет отображен в выдаче

limit

Максимальное число элементов для вывода. Значение по умолчанию — 100

-a, --all

Определяет, что следует выводить все результаты (активно по умолчанию). Чтобы изменить поведение, используйте параметр -l

-h, --help

Вывод справочного руководства для данной команды

-V, --version

Вывод информации о версии и завершение работы

Примеры

Пусть в томе vol1 создан бакет bucket1. В этом бакете есть два ключа: key1 и key2. Для получения информации о всех ключах вызовите следующую команду:

$ ozone sh key list vol1/bucket1

Вывод зависит от настроек ключей, но в целом должен быть похож на следующий:

[ {
  "volumeName" : "vol1",
  "bucketName" : "bucket1",
  "name" : "key1",
  "dataSize" : 14,
  "creationTime" : "2025-02-23T21:14:28.098Z",
  "modificationTime" : "2025-02-23T21:17:20.170Z",
  "replicationConfig" : {
    "replicationFactor" : "ONE",
    "requiredNodes" : 1,
    "replicationType" : "RATIS"
  },
  "metadata" : { },
  "file" : true
}, {
  "volumeName" : "vol1",
  "bucketName" : "bucket1",
  "name" : "key2",
  "dataSize" : 14,
  "creationTime" : "2025-02-23T22:16:35.235Z",
  "modificationTime" : "2025-02-23T22:16:36.399Z",
  "replicationConfig" : {
    "replicationFactor" : "ONE",
    "requiredNodes" : 1,
    "replicationType" : "RATIS"
  },
  "metadata" : { },
  "file" : true
} ]

Предположим, что теперь в бакет добавлен новый ключ newkey. Чтобы найти его среди многочисленных ключей командой list, используйте префиксный поиск:

$ ozone sh key list vol1/bucket1 -p="new"

Соответствующий вывод:

[ {
  "volumeName" : "vol1",
  "bucketName" : "bucket1",
  "name" : "newkey",
  "dataSize" : 14,
  "creationTime" : "2025-02-23T22:38:35.625Z",
  "modificationTime" : "2025-02-23T22:38:36.695Z",
  "replicationConfig" : {
    "replicationFactor" : "ONE",
    "requiredNodes" : 1,
    "replicationType" : "RATIS"
  },
  "metadata" : { },
  "file" : true
} ]
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней