get-bucket-website
Описание
Примечание
Данная операция не поддерживается для ведер-каталогов.Возвращает конфигурацию веб-сайта для ведра. Для размещения веб-сайта в Amazon S3 можно настроить ведро как веб-сайт, добавив конфигурацию веб-сайта. Дополнительную информацию о размещении веб-сайтов см. в разделе Размещение веб-сайтов в Amazon S3.
Для выполнения этого действия GET требуется разрешение S3:GetBucketWebsite. По умолчанию только владелец ведра может читать конфигурацию веб-сайта ведра. Однако владельцы ведер могут разрешить другим пользователям читать конфигурацию веб-сайта, добавив в политику ведра разрешение S3:GetBucketWebsite.
Следующие операции связаны с GetBucketWebsite:
- DeleteBucketWebsite
- PutBucketWebsite
См. также: Документация API AWS
Синтаксис
get-bucket-website
--bucket <value>
[--expected-bucket-owner <value>]
[--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 (строка)
--expected-bucket-owner (строка)
403 Forbidden (доступ запрещён).--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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. Дополнительную информацию см. в разделе Использование кавычек со строками в руководстве пользователя AWS CLI.
Следующая команда извлекает конфигурацию статического веб-сайта для ведра с именем amzn-s3-demo-bucket:
aws s3api get-bucket-website --bucket amzn-s3-demo-bucket
Вывод:
{
"IndexDocument": {
"Suffix": "index.html"
},
"ErrorDocument": {
"Key": "error.html"
}
}
Вывод
RedirectAllRequestsTo -> (структура)
Указывает поведение перенаправления всех запросов на конечную точку веб-сайта в ведре Amazon S3.
HostName -> (строка)
Protocol -> (строка)
IndexDocument -> (структура)
Имя файла-индекса для веб-сайта (например, index.html).
Suffix -> (строка)
Суффикс, добавляемый к запросу для каталога на конечной точке веб-сайта. (Например, если суффикс равен index.html, и вы делаете запрос к samplebucket/images/, данные, которые будут возвращены, будут для объекта с именем ключа images/index.html). Суффикс не должен быть пустым и не должен содержать символ косой черты.
Предупреждение
Необходимо заменить ключи объектов, содержащие специальные символы (например, возврат каретки), при использовании запросов XML. Дополнительную информацию см. в разделе Ограничения ключей объектов, связанных с XML.ErrorDocument -> (структура)
Имя ключа объекта для веб-документа об ошибке, используемого для ошибок класса 4XX.
Key -> (строка)
Имя ключа объекта, используемого при возникновении ошибки класса 4XX.
Предупреждение
Необходимо заменить ключи объектов, содержащие специальные символы (например, возврат каретки), при использовании запросов XML. Дополнительную информацию см. в разделе Ограничения ключей объектов, связанных с XML.RoutingRules -> (список)
Правила, определяющие, когда применяется перенаправление и поведение перенаправления.
(структура)
Указывает поведение перенаправления и условия его применения. Дополнительную информацию о правилах маршрутизации см. в разделе Настройка перенаправлений с условиями в руководстве пользователя Amazon S3.
Condition -> (структура)
Контейнер для описания условия, которое должно быть выполнено для применения указанного перенаправления. Например: 1. Если запрос относится к страницам в папке /docs, перенаправить на папку /documents. 2. Если запрос приводит к ошибке HTTP 4xx, перенаправить запрос на другой хост, где вы можете обработать ошибку.
HttpErrorCodeReturnedEquals -> (строка)
Condition указан, а брат KeyPrefixEquals нет. Если оба указаны, то оба должны быть истинными для применения перенаправления.KeyPrefixEquals -> (строка)
Префикс имени ключа объекта при применении перенаправления. Например, для перенаправления запросов для ExamplePage.html, префикс ключа будет ExamplePage.html. Для перенаправления запроса для всех страниц с префиксом docs/, префикс ключа будет /docs, который идентифицирует все объекты в папке docs/. Требуется, когда родительский элемент Condition указан, а брат HttpErrorCodeReturnedEquals нет. Если оба условия указаны, оба должны быть истинными для применения перенаправления.
Предупреждение
Необходимо заменить ключи объектов, содержащие специальные символы (например, возврат каретки), при использовании запросов XML. Дополнительную информацию см. в разделе Ограничения ключей объектов, связанных с XML.Redirect -> (структура)
Контейнер для информации о перенаправлении. Вы можете перенаправлять запросы на другой хост, на другую страницу или с другим протоколом. В случае ошибки вы можете указать другой код ошибки для возврата.
HostName -> (строка)
HttpRedirectCode -> (строка)
Protocol -> (строка)
ReplaceKeyPrefixWith -> (строка)
Префикс ключа объекта, используемый в запросе перенаправления. Например, для перенаправления запросов для всех страниц с префиксом docs/ (объекты в папке docs/) на documents/, можно установить блок условия с KeyPrefixEquals, установленным на docs/, и в перенаправлении установить ReplaceKeyPrefixWith на /documents. Не требуется, если присутствует один из братьев. Может присутствовать только если ReplaceKeyWith не указан.
Предупреждение
Необходимо заменить ключи объектов, содержащие специальные символы (например, возврат каретки), при использовании запросов XML. Дополнительную информацию см. в разделе Ограничения ключей объектов, связанных с XML.ReplaceKeyWith -> (строка)
Конкретный ключ объекта, используемый в запросе перенаправления. Например, перенаправить запрос на error.html. Не требуется, если присутствует один из братьев. Может присутствовать только если ReplaceKeyPrefixWith не указан.
Предупреждение
Необходимо заменить ключи объектов, содержащие специальные символы (например, возврат каретки), при использовании запросов XML. Дополнительную информацию см. в разделе Ограничения ключей объектов, связанных с XML.
© Copyright 2025, Amazon Web Services. Created using Sphinx.