register-resource

Описание

Регистрирует ресурс как управляемый Каталогом данных.

Для добавления или обновления данных Lake Formation требует чтение/запись в выбранном месте данных. Выберите роль, у которой есть разрешение на это, или роль AWSServiceRoleForLakeFormationDataAccess, связанную со службой. При регистрации первого пути Amazon S3 создается связанная со службой роль и новая встроенная политика от вашего имени. Lake Formation добавляет первый путь в встроенную политику и прикрепляет ее к связанной со службой роли. При регистрации последующих путей Lake Formation добавляет путь к существующей политике.

Следующий запрос регистрирует новое местоположение и предоставляет Lake Formation разрешение использовать связанную со службой роль для доступа к этому местоположению.

Если UseServiceLinkedRole не установлено в значение true, необходимо предоставить или установить RoleArn :

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

Синтаксис

  register-resource
--resource-arn <value>
[--use-service-linked-role | --no-use-service-linked-role]
[--role-arn <value>]
[--with-federation | --no-with-federation]
[--hybrid-access-enabled | --no-hybrid-access-enabled]
[--with-privileged-access | --no-with-privileged-access]
[--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]

Параметры

--resource-arn (строка)

--use-service-linked-role | --no-use-service-linked-role (логическое значение)

--role-arn (строка)

--with-federation | --no-with-federation (логическое значение)

--hybrid-access-enabled | --no-hybrid-access-enabled (логическое значение)

--with-privileged-access | --no-with-privileged-access (логическое значение)

--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 (строка)

Переопределяет адрес по умолчанию команды указанным адресом.

--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.

Примеры

Пример 1: Регистрация хранилища данных озера с помощью связанной со службой роли

Следующий пример регистрирует ресурс как управляемый Lake Formation с помощью связанной со службой роли.

aws lakeformation register-resource \
    --cli-input-json file://input.json

Содержимое input.json:

{
    "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
    "UseServiceLinkedRole": true
}

Эта команда не выводит никаких результатов.

Дополнительная информация: Добавление места расположения Amazon S3 в озеро данных в Руководстве разработчика AWS Lake Formation.

Пример 2: Регистрация хранилища данных озера с помощью пользовательской роли

Следующий пример регистрирует ресурс как управляемый Lake Formation с помощью пользовательской роли.

aws lakeformation register-resource \
    --cli-input-json file://input.json

Содержимое input.json:

{
    "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
    "UseServiceLinkedRole": false,
    "RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
}

Эта команда не выводит никаких результатов.

Дополнительная информация: Добавление места расположения Amazon S3 в озеро данных в Руководстве разработчика AWS Lake Formation.

Вывод

Нет