get-access-grant

Описание

Получение деталей предоставленного доступа из экземпляра S3 Access Grants.

Разрешения

Для использования этой операции необходимо разрешение s3:GetAccessGrant.

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

Синтаксис

  get-access-grant
--account-id <value>
--access-grant-id <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 экземпляра S3 Access Grants.

--access-grant-id (строка)

Идентификатор предоставленного доступа. S3 Access Grants автоматически генерирует этот идентификатор при создании доступа.

--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
table
yaml
yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включение/отключение цветного вывода.

on
off
auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент предоставлен.

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

Файл с корневыми сертификатами для проверки 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.

Вывод

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

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

AccessGrantId -> (строка)

AccessGrantArn -> (строка)

Amazon Resource Name (ARN) предоставления доступа.

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

Пользователь, группа или роль, которым предоставляется доступ. Вы можете предоставить доступ IAM пользователю или роли. Если вы добавили корпоративную директорию в Amazon Web Services IAM Identity Center и связали этот экземпляр Identity Center с экземпляром S3 Access Grants, получателем доступа также может быть пользователь или группа корпоративной директории.

GranteeType -> (строка)

Тип получателя, которому предоставлен доступ. Может принимать одно из следующих значений:

IAM - IAM пользователь или роль.
DIRECTORY_USER - Ваш пользователь корпоративной директории. Вы можете использовать этот параметр, если вы добавили корпоративную директорию в IAM Identity Center и связали экземпляр IAM Identity Center с вашим экземпляром S3 Access Grants.
DIRECTORY_GROUP - Ваша корпоративная группа. Вы можете использовать этот параметр, если вы добавили корпоративную директорию в IAM Identity Center и связали экземпляр IAM Identity Center с вашим экземпляром S3 Access Grants.

GranteeIdentifier -> (строка)

Уникальный идентификатор Grantee. Если тип получателя - IAM, идентификатор - IAM Amazon Resource Name (ARN) пользователя или роли. Если тип получателя - пользователь или группа директории, идентификатор - 128-битный универсально уникальный идентификатор (UUID) в формате a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. Вы можете получить этот UUID из экземпляра Amazon Web Services IAM Identity Center.

Permission -> (строка)

Тип разрешения, предоставленного в рамках предоставления доступа. Может принимать одно из следующих значений:

READ – Предоставить только чтение данных S3.
WRITE – Предоставить только запись данных S3.
READWRITE – Предоставить чтение и запись данных S3.

AccessGrantsLocationId -> (строка)

Идентификатор зарегистрированного расположения, которому предоставляется доступ. S3 Access Grants присваивает этот идентификатор при регистрации расположения. S3 Access Grants присваивает идентификатор default для расположения по умолчанию s3:// и автоматически генерирует идентификатор для других регистрируемых вами расположений.

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

Настройки конфигурации места предоставления доступа. Место предоставления доступа - это S3 путь к данным, к которым предоставляется доступ.

S3SubPrefix -> (строка)

S3SubPrefix добавляется к области расположения, создавая область предоставления доступа. Используйте этот параметр, чтобы сузить область предоставления доступа до подмножества области расположения. Этот параметр требуется, если область расположения - это расположение по умолчанию s3://, поскольку вы не можете предоставить доступ ко всем данным S3 в регионе и должны сузить область. Например, если область расположения - это расположение по умолчанию s3://, S3SubPrefx может быть <bucket-name>/*, поэтому полным путем предоставления доступа будет s3://<bucket-name>/*. Или S3SubPrefx может быть <bucket-name>/<prefix-name>*, поэтому полным путем предоставления доступа будет s3://<bucket-name>/<prefix-name>*.

Если S3SubPrefix включает префикс, добавьте символ подстановки * после префикса, чтобы указать, что вы хотите включить все имена ключей объектов в ведре, которые начинаются с этого префикса.

GrantScope -> (строка)

S3 путь к данным, которым предоставляется доступ. Это результат добавления Subprefix к области расположения.

ApplicationArn -> (строка)

Amazon Resource Name (ARN) приложения Amazon Web Services IAM Identity Center, связанного с вашим экземпляром Identity Center. Если предоставление доступа включает ARN приложения, получатель может получить доступ к данным S3 только через это приложение.