bucket list

Sergei Tikhomirov

Определение

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

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

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

value

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

prefix

Префикс для фильтрации имен бакетов

startItem

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

limit

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

-a, --all

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

--has-snapshot

Определяет, что следует выводить только те бакеты, у которых есть активный снепшот

-h, --help

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

-V, --version

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

Примеры

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

$ ozone sh bucket list vol1

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

[ {
  "metadata" : { },
  "volumeName" : "vol1",
  "name" : "bucket1",
  "storageType" : "DISK",
  "versioning" : false,
  "usedBytes" : 0,
  "usedNamespace" : 0,
  "creationTime" : "2025-01-22T22:06:04.800Z",
  "modificationTime" : "2025-01-22T22:06:55.834Z",
  "sourcePathExist" : true,
  "quotaInBytes" : -1,
  "quotaInNamespace" : -1,
  "bucketLayout" : "FILE_SYSTEM_OPTIMIZED",
  "owner" : "s_tikhomirov_krb1",
  "replicationConfig" : {
    "replicationFactor" : "ONE",
    "requiredNodes" : 1,
    "replicationType" : "RATIS"
  },
  "link" : false
}, {
  "metadata" : { },
  "volumeName" : "vol1",
  "name" : "bucket2",
  "storageType" : "DISK",
  "versioning" : false,
  "usedBytes" : 0,
  "usedNamespace" : 0,
  "creationTime" : "2025-01-22T22:07:32.541Z",
  "modificationTime" : "2025-01-22T22:07:32.541Z",
  "sourcePathExist" : true,
  "quotaInBytes" : -1,
  "quotaInNamespace" : -1,
  "bucketLayout" : "FILE_SYSTEM_OPTIMIZED",
  "owner" : "s_tikhomirov_krb1",
  "link" : false
} ]

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

$ ozone sh bucket list vol1 -p="new"

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

[ {
  "metadata" : { },
  "volumeName" : "vol1",
  "name" : "newbucket",
  "storageType" : "DISK",
  "versioning" : false,
  "usedBytes" : 0,
  "usedNamespace" : 0,
  "creationTime" : "2025-02-12T22:51:39.876Z",
  "modificationTime" : "2025-02-12T22:51:39.876Z",
  "sourcePathExist" : true,
  "quotaInBytes" : -1,
  "quotaInNamespace" : -1,
  "bucketLayout" : "FILE_SYSTEM_OPTIMIZED",
  "owner" : "s_tikhomirov_krb1",
  "link" : false
} ]
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней