Spec-Zone.ru › AWS CLI v2

[ aws . s3control ]

create-multi-region-access-point

Описание

Примечание

Данная операция не поддерживается для ведёр каталогов.

Создаёт Многорегиональную точку доступа и связывает её со списком указанных ведёр. Более подробную информацию о создании Многорегиональных точек доступа см. в руководстве пользователя Amazon S3 .

Этот запрос всегда будет перенаправлен в регион США Запад (Орегон). Более подробную информацию о ограничениях работы с Многорегиональными точками доступа см. в руководстве пользователя Amazon S3.

Этот запрос асинхронный, что означает, что вы можете получить ответ, прежде чем команда завершит выполнение. При получении ответа предоставляется маркер, который можно использовать для отслеживания состояния запроса с помощью DescribeMultiRegionAccessPointOperation .

Следующие действия связаны с CreateMultiRegionAccessPoint :

  • DeleteMultiRegionAccessPoint
  • DescribeMultiRegionAccessPointOperation
  • GetMultiRegionAccessPoint
  • ListMultiRegionAccessPoints

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

Синтаксис

  create-multi-region-access-point
--account-id <value>
[--client-token <value>]
--details <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 (строка)

Идентификатор учётной записи Amazon Web Services владельца Многорегиональной точки доступа. Владелец Многорегиональной точки доступа также должен владеть базовыми ведрами.

--client-token (строка)

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

--details (структура)

Элемент контейнера, содержащий информацию о Многорегиональной точке доступа.

Name -> (строка)

Имя Многорегиональной точки доступа, связанной с этим запросом.

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

Настройки PublicAccessBlock, которые вы хотите применить к этой учётной записи Amazon S3. Вы можете активировать параметры конфигурации в любой комбинации. Более подробную информацию о том, когда Amazon S3 считает ведро или объект общедоступным, см. в руководстве пользователя Amazon S3 .

Этот тип данных не поддерживается для Amazon S3 в Outposts.

BlockPublicAcls -> (логическое значение)

Указывает, должна ли Amazon S3 блокировать общедоступные списки управления доступом (ACL) для ведёр в этой учётной записи. Установка этого элемента в значение TRUE приводит к следующему поведению:

  • PutBucketAcl и PutObjectAcl вызовы завершаются ошибкой, если указанный ACL общедоступен.
  • Вызовы PUT Object завершаются ошибкой, если запрос включает общедоступный ACL.
  • Вызовы PUT Bucket завершаются ошибкой, если запрос включает общедоступный ACL.

Включение этого параметра не влияет на существующие политики или ACL.

Этот параметр не поддерживается для Amazon S3 в Outposts.

IgnorePublicAcls -> (логическое значение)

Указывает, должна ли Amazon S3 игнорировать общедоступные ACL для ведёр в этой учётной записи. Установка этого элемента в значение TRUE заставляет Amazon S3 игнорировать все общедоступные ACL для ведёр в этой учётной записи и всех содержащихся в них объектов.

Включение этого параметра не влияет на сохранение существующих ACL и не предотвращает установку новых общедоступных ACL.

Этот параметр не поддерживается для Amazon S3 в Outposts.

BlockPublicPolicy -> (логическое значение)

Указывает, должна ли Amazon S3 блокировать общедоступные политики ведёр для ведёр в этой учётной записи. Установка этого элемента в значение TRUE заставляет Amazon S3 отклонять вызовы PUT Bucket policy, если указанная политика ведра разрешает общедоступный доступ.

Включение этого параметра не влияет на существующие политики ведёр.

Этот параметр не поддерживается для Amazon S3 в Outposts.

RestrictPublicBuckets -> (логическое значение)

Указывает, должна ли Amazon S3 ограничивать общедоступные политики ведёр для ведёр в этой учётной записи. Установка этого элемента в значение TRUE ограничивает доступ к ведрам с общедоступными политиками только для сервисных принципов Amazon Web Services и авторизованных пользователей в рамках этой учётной записи.

Включение этого параметра не влияет на ранее сохранённые политики ведёр, за исключением того, что общедоступный и кросс-учётный доступ в любой общедоступной политике ведра, включая не общедоступную делегацию конкретным учётным записям, заблокирован.

Этот параметр не поддерживается для Amazon S3 в Outposts.

Regions -> (список)

Ведра в разных регионах, которые связаны с Многорегиональной точкой доступа.

(структура)

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

Bucket -> (строка)

Имя связанного ведра для региона.

BucketAccountId -> (строка)

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

Сокращённый синтаксис:

Name=string,PublicAccessBlock={BlockPublicAcls=boolean,IgnorePublicAcls=boolean,BlockPublicPolicy=boolean,RestrictPublicBuckets=boolean},Regions=[{Bucket=string,BucketAccountId=string},{Bucket=string,BucketAccountId=string}]

Синтаксис JSON:

{
  "Name": "string",
  "PublicAccessBlock": {
    "BlockPublicAcls": true|false,
    "IgnorePublicAcls": true|false,
    "BlockPublicPolicy": true|false,
    "RestrictPublicBuckets": true|false
  },
  "Regions": [
    {
      "Bucket": "string",
      "BucketAccountId": "string"
    }
    ...
  ]
}

--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, 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.

Вывод

RequestTokenARN -> (строка)

Маркер запроса, связанный с запросом. Вы можете использовать этот маркер с DescribeMultiRegionAccessPointOperation для определения состояния асинхронных запросов.

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

Spec-Zone.ru

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