get-buckets
Описание
Возвращает информацию об одном или нескольких объёмах Amazon Lightsail. Возвращаемая информация включает статус синхронизации функции блокировки публичного доступа к аккаунту Amazon Simple Storage Service (Amazon S3) для ваших объёмов Lightsail.
Дополнительную информацию об объёмах см. в разделе Объёмы в Amazon Lightsail в руководстве разработчика Amazon Lightsail.
См. также: Документацию API AWS
Синтаксис
get-buckets
[--bucket-name <value>]
[--page-token <value>]
[--include-connected-resources | --no-include-connected-resources]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <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]
Параметры
--bucket-name (строка)
Название объёма, для которого требуется вернуть информацию.
Если параметр опущен, ответ включает все ваши объёмы в регионе Amazon Web Services, где выполняется запрос.
--page-token (строка)
Токен для перехода к следующей странице результатов запроса.
Для получения токена страницы выполните начальный запрос GetBuckets. Если результаты запроса постраничные, ответ вернёт токен следующей страницы, который можно указать в качестве токена страницы в последующем запросе.
--include-connected-resources | --no-include-connected-resources (булево)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределяют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, поскольку строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. При отсутствии значения или при значении input выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при значении yaml-input он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. При значении output он валидирует входные данные команды и возвращает пример JSON-вывода для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (булево)
Включить отладку.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (булево)
Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла ключей.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Показать версию этого инструмента.
--color (строка)
Включить/отключить вывод цвета.
- on
- off
- auto
--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.
--cli-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров ввода CLI.
Вывод
buckets -> (список)
Массив объектов, описывающих ведра.
(структура)
Описывает ведро Amazon Lightsail.
resourceType -> (строка)
accessRules -> (структура)
Объект, описывающий правила доступа к ведру.
getObject -> (строка)
Устанавливает анонимный доступ ко всем объектам в ведре.
Можно указать следующие параметры:
-
public- Устанавливает все объекты в ведре как публичные (только для чтения), делая их доступными для чтения всем пользователям. Если значениеgetObjectустановлено вpublic, все объекты в ведре по умолчанию публичные независимо от значенияallowPublicOverrides. -
private- Устанавливает все объекты в ведре как частные, делая их доступными только вам или лицам, которым вы предоставили доступ. Если значениеgetObjectустановлено вprivate, а значениеallowPublicOverridesустановлено вtrue, все объекты в ведре по умолчанию будут частными, если не заданы ACL для отдельных объектов. Индивидуальные объекты с ACLpublic-readбудут доступны для чтения всем пользователям.
allowPublicOverrides -> (булево)
Булево значение, указывающее, будут ли разрешения списка управления доступом (ACL), примененные к отдельным объектам, переопределять текущий параметр getObject.
При значении true вы можете использовать действие PutObjectAcl API Amazon S3 для установки отдельных объектов как публичных (только для чтения) с помощью ACL public-read или как частных с помощью ACL private.
arn -> (строка)
bundleId -> (строка)
Идентификатор пакета, в данный момент применённого к ведру.
Пакет ведра определяет ежемесячные затраты, объём хранилища и квоту на передачу данных для ведра.
Используйте действие UpdateBucketBundle для изменения пакета ведра.
createdAt -> (метка времени)
url -> (строка)
location -> (структура)
Объект, описывающий расположение ведра, такой как регион и зона доступности Amazon Web Services.
availabilityZone -> (строка)
us-east-2a (регистрозависимый).regionName -> (строка)
name -> (строка)
supportCode -> (строка)
tags -> (список)
Ключи тегов и необязательные значения для ведра. Дополнительную информацию см. в разделе Теги в Amazon Lightsail в руководстве разработчика Amazon Lightsail .
(структура)
Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.
Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail .
key -> (строка)
Ключ тега.
Ограничения: Ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @
value -> (строка)
Значение тега.
Ограничения: Значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @
objectVersioning -> (строка)
Указывает, включена ли версия объекта для ведра.
Можно настроить следующие параметры:
-
Enabled- Версии объектов включены. -
Suspended- Версии объектов были ранее включены, но сейчас приостановлены. Существующие версии объектов сохраняются. -
NeverEnabled- Версии объектов никогда не были включены.
ableToUpdateBundle -> (булево)
Указывает, можно ли изменить пакет, который сейчас применен к ведру, на другой.
Вы можете обновить пакет ведра только один раз в месяц в рамках цикла оплаты Amazon Web Services.
Используйте действие UpdateBucketBundle для изменения пакета ведра.
readonlyAccessAccounts -> (список)
Массив строк, которые указывают идентификаторы учетных записей Amazon Web Services, имеющих доступ для чтения только к ведру.
(строка)
resourcesReceivingAccess -> (список)
Массив объектов, описывающих экземпляры Lightsail, имеющие доступ к ведру.
Используйте действие SetResourceAccessForBucket для обновления экземпляров, имеющих доступ к ведру.
(структура)
Описывает экземпляр Amazon Lightsail, имеющий доступ к ведру Lightsail.
name -> (строка)
resourceType -> (строка)
Instance).state -> (структура)
Объект, описывающий состояние ведра.
code -> (строка)
Код состояния ведра.
Возможны следующие коды:
-
OK- Ведро находится в активном состоянии. -
Unknown- Создание ведра, возможно, истекло. Возможно, вам следует удалить ведро и создать новое.
message -> (строка)
accessLogConfig -> (структура)
Объект, описывающий конфигурацию ведения журнала доступа для ведра.
enabled -> (булево)
destination -> (строка)
Имя ведра, в котором сохраняются журналы доступа. Пункт назначения может быть ведром Lightsail в той же учетной записи и в том же регионе Amazon Web Services, что и исходное ведро.
Примечание
Этот параметр обязателен при включении ведения журнала доступа для ведра и должен быть опущен при отключении его.prefix -> (строка)
Необязательный префикс объекта для журнала доступа к ведру.
Префикс — это необязательное дополнение к ключу объекта, которое организует файлы журнала доступа в целевом ведре. Например, если вы укажете префикс logs/, то каждый объект журнала будет начинаться с префикса logs/ в его ключе (например, logs/2021-11-01-21-32-16-E568B2907131C0C0).
Примечание
Этот параметр можно необязательно указать при включении ведения журнала доступа для ведра и следует опустить при отключении его.nextPageToken -> (строка)
Токен для перехода к следующей странице результатов вашего запроса.
Токен следующей страницы не возвращается, если больше результатов отобразить нельзя.
Чтобы получить следующую страницу результатов, выполните еще один запрос GetBuckets и укажите токен следующей страницы с помощью параметра pageToken.
accountLevelBpaSync -> (структура)
Объект, описывающий статус синхронизации функции блокировки публичного доступа к учетной записи Amazon S3 для ваших ведер Lightsail.
Дополнительную информацию об этой функции и о том, как она влияет на ведра Lightsail, см. в разделе Блокировка публичного доступа к ведрам в Amazon Lightsail .
status -> (строка)
Статус синхронизации BPA на уровне учетной записи.
Возможны следующие статусы:
-
InSync- BPA на уровне учетной записи синхронизирован. Настройка BPA на уровне учетной записи Amazon S3 применяется к вашим ведрам Lightsail. -
NeverSynced- Синхронизация еще не произошла. Настройка BPA на уровне учетной записи Amazon S3 не применяется к вашим ведрам Lightsail. -
Failed- Синхронизация завершилась неудачей. Настройка BPA на уровне учетной записи Amazon S3 не применяется к вашим ведрам Lightsail. -
Defaulted- Синхронизация завершилась неудачей, и BPA на уровне учетной записи для ваших ведер Lightsail по умолчанию активна.
Примечание
Возможно, вам потребуется выполнить дополнительные действия, если статус равенFailed или Defaulted. Параметр message предоставляет дополнительную информацию для этих статусов.lastSyncedAt -> (метка времени)
message -> (строка)
Сообщение, объясняющее причину статуса синхронизации Failed или Defaulted.
Возможны следующие сообщения:
-
SYNC_ON_HOLD- Синхронизация еще не произошла. Это сообщение о статусе появляется сразу после создания первого ведра Lightsail. Это сообщение о статусе должно измениться после первой синхронизации, примерно через 1 час после создания первого ведра. -
DEFAULTED_FOR_SLR_MISSING- Синхронизация завершилась неудачей из-за отсутствия необходимого роли service-linked в вашей учетной записи Amazon Web Services. Конфигурация BPA на уровне учетной записи для ваших ведер Lightsail по умолчанию активна, пока не произойдет синхронизация. Это означает, что все ваши ведра частные и не доступны для публичного просмотра. Дополнительную информацию о создании необходимой роли service-linked для разрешения синхронизации см. в разделе Использование ролей service-linked для Amazon Lightsail в руководстве разработчика Amazon Lightsail. -
DEFAULTED_FOR_SLR_MISSING_ON_HOLD- Синхронизация завершилась неудачей из-за отсутствия необходимой роли service-linked в вашей учетной записи Amazon Web Services. BPA на уровне учетной записи еще не настроен для ваших ведер Lightsail. Поэтому к вашим ведрам Lightsail применяются только разрешения доступа к ведру и разрешения доступа к отдельным объектам. Дополнительную информацию о создании необходимой роли service-linked для разрешения синхронизации см. в разделе Использование ролей service-linked для Amazon Lightsail в руководстве разработчика Amazon Lightsail. -
Unknown- Причина завершения синхронизации неудачей неизвестна. Обратитесь в службу поддержки Amazon Web Services для получения дополнительной информации.
bpaImpactsLightsail -> (булево)
© Copyright 2025, Amazon Web Services. Created using Sphinx.