Spec-Zone.ru › AWS CLI v2

[ aws . s3control ]

get-access-point

Описание

Возвращает конфигурационную информацию о заданном точке доступа.

Все запросы Amazon S3 на Outposts REST API для этого действия требуют дополнительного параметра x-amz-outpost-id, который необходимо передать вместе с запросом. Кроме того, вы должны использовать префикс имени узла конечной точки S3 на Outposts вместо s3-control. Пример синтаксиса запроса для Amazon S3 на Outposts, использующего префикс имени узла конечной точки S3 на Outposts и x-amz-outpost-id, полученную с помощью ARN точки доступа, см. в разделе Примеры.

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

  • CreateAccessPoint
  • DeleteAccessPoint
  • ListAccessPoints

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

Синтаксис

  get-access-point
--account-id <value>
--name <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 для учетной записи, владеющей указанной точкой доступа.

--name (строка)

Имя точки доступа, конфигурационную информацию о которой вы хотите получить.

Для использования этого параметра с Amazon S3 на Outposts с REST API, необходимо указать имя и x-amz-outpost-id.

Для использования этого параметра с S3 на Outposts с Amazon Web Services SDK и CLI, необходимо указать ARN точки доступа, доступной в формате arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/accesspoint/<my-accesspoint-name>. Например, чтобы получить доступ к точке доступа reports-ap через Outpost my-outpost, принадлежащей учетной записи 123456789012 в регионе us-west-2, используйте кодировку URL для arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/accesspoint/reports-ap. Значение должно быть закодировано в URL.

--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
  • таблица
  • 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-access-point извлекает сведения о конфигурации точки доступа с именем finance-ap в учетной записи 123456789012. Перед запуском этого примера замените имя точки доступа и номер учетной записи соответствующими значениями для вашего случая.

aws s3control get-access-point \
    --account-id 123456789012 \
    --name finance-ap

Вывод:

{
    "Name": "finance-ap",
    "Bucket": "business-records",
    "NetworkOrigin": "Internet",
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": false,
        "IgnorePublicAcls": false,
        "BlockPublicPolicy": false,
        "RestrictPublicBuckets": false
    },
    "CreationDate": "2020-01-01T00:00:00Z"
}

Дополнительную информацию см. в разделе Управление доступом к данным с помощью точек доступа Amazon S3 в Руководстве разработчика Amazon Simple Storage Service.

Вывод

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

Имя указанной точки доступа.

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

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

NetworkOrigin -> (строка)

Указывает, разрешен ли доступ из открытого интернета к этой точке доступа. Если VpcConfiguration указано для этой точки доступа, то NetworkOrigin равно VPC, и доступ к точке доступа из открытого интернета не разрешен. В противном случае, NetworkOrigin равно Internet, и доступ к точке доступа из открытого интернета разрешен, в зависимости от политик доступа к точке доступа и ведру.

Это всегда будет истинно для точки доступа Amazon S3 на Outposts.

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

Содержит конфигурацию виртуальной частной сети (VPC) для указанной точки доступа.

Примечание

Этот элемент пуст, если эта точка доступа — это точка доступа Amazon S3 на Outposts, используемая другими службами Amazon Web Services.

VpcId -> (строка)

Если этот параметр указан, к этой точке доступа будут разрешены только подключения из указанного ID VPC.

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

Конфигурация 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.

CreationDate -> (метка времени)

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

Alias -> (строка)

Имя или псевдоним точки доступа.

AccessPointArn -> (строка)

ARN точки доступа.

Endpoints -> (карта)

Конечная точка VPC для точки доступа.

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

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

BucketAccountId -> (строка)

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

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

Spec-Zone.ru

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