получение маршрутов многорегиональной точки доступа
Описание
Примечание
Данная операция не поддерживается для ведер каталога.Возвращает конфигурацию маршрутизации для многорегиональной точки доступа, указывая, какие регионы активны или пассивны.
Для получения изменений в управлении маршрутизацией и запросов резервного копирования используйте конечные точки инфраструктуры резервного копирования Amazon S3 в этих пяти регионах Amazon Web Services:
us-east-1us-west-2ap-southeast-2ap-northeast-1eu-west-1
См. также: Документация API AWS
Синтаксис
get-multi-region-access-point-routes
--account-id <value>
--mrap <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]
Параметры
--account-id (строка)
--mrap (строка)
--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-auto-prompt (булево)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запроса параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для запроса текущей конфигурации маршрута многорегиональной точки доступа
Следующий get-multi-region-access-point-routes пример возвращает текущую конфигурацию маршрутизации для указанной многорегиональной точки доступа.
aws s3control get-multi-region-access-point-routes \
--region Region \
--account-id 111122223333 \
--mrap MultiRegionAccessPoint_ARN
Вывод:
{
"Mrap": "arn:aws:s3::111122223333:accesspoint/0000000000000.mrap",
"Routes": [
{
"Bucket": "amzn-s3-demo-bucket1",
"Region": "ap-southeast-2",
"TrafficDialPercentage": 100
},
{
"Bucket": "amzn-s3-demo-bucket2",
"Region": "us-west-1",
"TrafficDialPercentage": 0
}
]
}
Вывод
Mrap -> (строка)
Маршруты -> (список)
Различные маршруты, составляющие конфигурацию маршрутизации. Активные маршруты возвращают значение 100, а пассивные — значение 0.
(структура)
Структура для многорегиональной точки доступа, указывающая, где Amazon S3-трафик может быть перенаправлен. Маршруты могут быть активными или пассивными. Активные маршруты могут обрабатывать запросы Amazon S3 через многорегиональную точку доступа, но пассивные маршруты не могут обрабатывать запросы Amazon S3.
Каждый маршрут содержит имя ведра Amazon S3 и регион Amazon Web Services, в котором расположено ведро. Маршрут также содержит значение TrafficDialPercentage, которое показывает, являются ли ведро и регион активными (указано значением 100) или пассивными (указано значением 0).
Ведро -> (строка)
Bucket, либо Region. Если оба значения предоставлены, ведро должно находиться в указанном регионе.Регион -> (строка)
Bucket, либо Region. Если оба значения предоставлены, ведро должно находиться в указанном регионе.TrafficDialPercentage -> (целое число)
Состояние трафика для указанного ведра или региона Amazon Web Services.
Значение 0 указывает пассивное состояние, что означает, что новый трафик не будет перенаправлен в регион.
Значение 100 указывает активное состояние, что означает, что трафик будет перенаправлен в указанный регион.
Когда конфигурация маршрутизации для региона изменяется с активной на пассивную, любые операции, выполняемые в данный момент (загрузки, копирования, удаления и т. д.) в ранее активный регион будут продолжены до достижения конечного успешного или неуспешного состояния.
Если все регионы в конфигурации маршрутизации будут обозначены как пассивные, вы получите ошибку InvalidRequest.
© Copyright 2025, Amazon Web Services. Created using Sphinx.