Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

создать-ведро

Описание

Создаёт ведро Amazon Lightsail.

Ведро — это облачное хранилище, доступное в службе объектного хранения Lightsail. Используйте ведра для хранения объектов, таких как данные и метаданные об этих данных. Дополнительную информацию о ведрах см. в разделе «Ведра» в руководстве разработчика Amazon Lightsail.

См. также: Документацию API AWS

Синтаксис

  create-bucket
--bucket-name <value>
--bundle-id <value>
[--tags <value>]
[--enable-object-versioning | --no-enable-object-versioning]
[--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 Lightsail.

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

Идентификатор пакета для использования с ведром.

Пакет ведра определяет ежемесячную стоимость, объём хранилища и квоту на передачу данных для ведра.

Используйте действие GetBucketBundles, чтобы получить список идентификаторов пакетов, которые вы можете указать.

Используйте действие UpdateBucketBundle, чтобы изменить пакет после создания ведра.

--tags (список)

Ключи тегов и необязательные значения, которые нужно добавить к ведру при его создании.

Используйте действие TagResource, чтобы добавить теги к ведру после его создания.

(структура)

Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.

Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.

key -> (строка)

Ключ тега.

Ограничения: ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

value -> (строка)

Значение тега.

Ограничения: значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

Краткая синтаксическая запись:

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--enable-object-versioning | --no-enable-object-versioning (булево)

Булево значение, указывающее, нужно ли включить версионирование объектов в ведре.

Дополнительную информацию о версионировании см. в разделе «Включение и приостановка версионирования объектов в ведре» в руководстве разработчика Amazon Lightsail.

--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
  • текст
  • таблица
  • 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 для вывода.

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

ведро -> (структура)

Объект, описывающий созданное ведро.

типРесурса -> (строка)

Тип ресурса Lightsail для ведра.

правилаДоступа -> (структура)

Объект, описывающий правила доступа к ведру.

получитьОбъект -> (строка)

Указывает анонимный доступ ко всем объектам в ведре.

Можно указать следующие параметры:

  • public - Устанавливает все объекты в ведре как публичные (только для чтения), делая их доступными для чтения всем пользователям. Если значение getObject установлено в public , то все объекты в ведре по умолчанию публичны, независимо от значения allowPublicOverrides .
  • private - Устанавливает все объекты в ведре как частные, делая их доступными только для вас или для тех, кому вы предоставили доступ. Если значение getObject установлено в private , а значение allowPublicOverrides установлено в true , то все объекты в ведре по умолчанию будут частными, если не настроены с помощью ACL public-read. Отдельные объекты с ACL public-read доступны для чтения всем пользователям в мире.

разрешитьНаложениеПубличныхНастроек -> (булево)

Булево значение, указывающее, будут ли разрешения списка управления доступом (ACL), примененные к отдельным объектам, переопределять параметр getObject, который в настоящее время указан.

Если это значение true, вы можете использовать действие API Amazon S3 PutObjectAcl, чтобы установить отдельные объекты в общедоступное (только для чтения) состояние с использованием ACL public-read или в состояние частного с использованием ACL private.

arn -> (строка)

Amazon Resource Name (ARN) ведра.

идентификаторПакеты -> (строка)

Идентификатор пакета, в настоящее время применённого к ведру.

Пакет ведра определяет ежемесячные затраты, объём хранилища и квоту передачи данных для ведра.

Для изменения пакета ведра используйте действие UpdateBucketBundle.

датаСоздание -> (временная метка)

Временная метка создания распределения.

url -> (строка)

URL-адрес ведра.

местоположение -> (структура)

Объект, описывающий расположение ведра, такой как регион и зона доступности Amazon Web Services.

зонаДоступности -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимая).

имяРегиона -> (строка)

Название региона Amazon Web Services.

имя -> (строка)

Имя ведра.

кодПоддержки -> (строка)

Код поддержки для ведра. Включите этот код в своё письмо в службу поддержки, если у вас есть вопросы о ведре Lightsail. Этот код позволяет нашей службе поддержки легче найти вашу информацию Lightsail.

метки -> (список)

Ключи меток и необязательные значения для ведра. Дополнительная информация приведена в разделе Метки в Amazon Lightsail в руководстве по разработке Amazon Lightsail.

(структура)

Описание ключа метки и необязательного значения, назначенного ресурсу Amazon Lightsail.

Дополнительная информация о метках в Lightsail доступна в Руководстве разработчика Amazon Lightsail.

ключ -> (строка)

Ключ метки.

Ограничения: Ключи меток принимают максимум 128 букв, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

значение -> (строка)

Значение метки.

Ограничения: Значения меток принимают максимум 256 букв, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

контрольВерсийОбъектов -> (строка)

Указывает, включён ли контроль версий объектов для ведра.

Можно настроить следующие параметры:

  • Enabled - Контроль версий объектов включён.
  • Suspended - Контроль версий объектов был ранее включен, но сейчас приостановлен. Существующие версии объектов сохраняются.
  • NeverEnabled - Контроль версий объектов никогда не был включён.

можноОбновитьПакет -> (булево)

Указывает, можно ли изменить пакет, который в настоящее время применён к ведру, на другой пакет.

Обновление пакета ведра возможно только один раз в течение ежемесячного платёжного цикла Amazon Web Services.

Для изменения пакета ведра используйте действие UpdateBucketBundle.

аккаунтыСТолькоЧтенияДоступом -> (список)

Массив строк, которые указывают идентификаторы учётных записей Amazon Web Services, имеющие доступ только для чтения к ведру.

(строка)

ресурсыПолучающиеДоступ -> (список)

Массив объектов, описывающих экземпляры Lightsail, имеющие доступ к ведру.

Для обновления экземпляров, имеющих доступ к ведру, используйте действие SetResourceAccessForBucket.

(структура)

Описание экземпляра Amazon Lightsail, имеющего доступ к ведру Lightsail.

имя -> (строка)

Имя экземпляра Lightsail.

типРесурса -> (строка)

Тип ресурса Lightsail (например, Instance).

состояние -> (структура)

Объект, описывающий состояние ведра.

код -> (строка)

Код состояния ведра.

Возможные коды:

  • OK - Ведро находится в рабочем состоянии.
  • Unknown - Создание ведра, возможно, истекло по времени. Возможно, вам нужно удалить ведро и создать новое.

сообщение -> (строка)

Сообщение, описывающее состояние ведра.

настройкаЖурналаДоступа -> (структура)

Объект, описывающий конфигурацию журнала доступа к ведру.

включено -> (булево)

Булево значение, указывающее, включено ли ведение журнала доступа к ведру.

пунктназначения -> (строка)

Имя ведра, в котором сохраняются журналы доступа. Пункт назначения может быть ведром Lightsail в той же учётной записи и в том же регионе Amazon Web Services, что и исходное ведро.

Примечание

Этот параметр обязателен при включении ведения журнала доступа к ведру и должен быть опущен при отключении ведения журнала.

префикс -> (строка)

Необязательный префикс объекта для журнала доступа к ведру.

Префикс - это необязательное дополнение к ключу объекта, которое организует файлы журнала доступа в целевом ведре. Например, если вы укажете префикс logs/, то каждый объект журнала будет начинаться с префикса logs/ в своём ключе (например, logs/2021-11-01-21-32-16-E568B2907131C0C0).

Примечание

Этот параметр можно указать при включении ведения журнала доступа к ведру и должен быть опущен при отключении ведения журнала.

операции -> (список)

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

(структура)

Описание операции API.

идентификатор -> (строка)

Идентификатор операции.

имяРесурса -> (строка)

Имя ресурса.

типРесурса -> (строка)

Тип ресурса.

датаСоздание -> (временная метка)

Временная метка инициализации операции (1479816991.349).

местоположение -> (структура)

Регион и зона доступности Amazon Web Services.

зонаДоступности -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимая).

имяРегиона -> (строка)

Название региона Amazon Web Services.

конечная -> (булево)

Булево значение, указывающее, является ли операция конечной.

деталиОперации -> (строка)

Подробности об операции (Debian-1GB-Ohio-1).

типОперации -> (строка)

Тип операции.

статус -> (строка)

Статус операции.

времяИзмененияСтатуса -> (временная метка)

Временная метка изменения статуса (1479816991.349).

кодОшибки -> (строка)

Код ошибки.

деталиОшибки -> (строка)

Подробности ошибки.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API