aws_glue_connection - Управление подключением AWS Glue
Новая версия 2.6.
Обзор
- Управление подключением AWS Glue. Подробности см. на странице https://aws.amazon.com/glue/.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key | Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key | |
| aws_secret_key | Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key | |
| catalog_id | Идентификатор каталога данных Data Catalog, в котором будет создано подключение. Если не указан, по умолчанию используется идентификатор учетной записи AWS. | |
| connection_properties обязательно | Словарь пар ключ-значение, используемых в качестве параметров для этого подключения. | |
| connection_type |
| Тип подключения. В настоящее время поддерживается только JDBC; SFTP не поддерживается. |
| description | Описание подключения. | |
| ec2_url | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где регион является обязательным. Должен быть указан для всех остальных модулей, если регион не используется. Если не указан, используется значение переменной окружения EC2_URL, если она задана. | |
| match_criteria | Список строк UTF-8, определяющих критерии выбора этого подключения. | |
| name обязательно | Имя подключения. | |
| profile (добавлено в 1.6) | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region | Регион AWS. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если она задана. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| security_groups | Список групп безопасности, которые будут использоваться подключением. Используйте либо имя, либо ID группы безопасности. | |
| security_token (добавлено в 1.6) | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token | |
| state обязательно |
| Создание или удаление подключения AWS Glue. |
| subnet_id | Идентификатор подсети, используемой подключением. | |
| validate_certs bool (добавлено в 1.5) |
| При значении "no" сертификаты SSL не будут проверяться для версий boto >= 2.6.0. |
Примечания
Примечание
- Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONобычно используются для указания региона AWS, когда это необходимо, но это также можно настроить в конфигурационном файле boto
Примеры
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Create an AWS Glue connection
- aws_glue_connection:
name: my-glue-connection
connection_properties:
JDBC_CONNECTION_URL: jdbc:mysql://mydb:3306/databasename
USERNAME: my-username
PASSWORD: my-password
state: present
# Delete an AWS Glue connection
- aws_glue_connection:
name: my-glue-connection
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| connection_properties словарь | при состоянии present | Словарь пар ключ-значение, используемых в качестве параметров для этого подключения. Пример: {'JDBC_CONNECTION_URL': 'jdbc:mysql://mydb:3306/databasename', 'USERNAME': 'x', 'PASSWORD': 'y'} |
| connection_type строка | при состоянии present | Тип подключения. Пример: JDBC |
| creation_time строка | при состоянии present | Время создания этого определения подключения. Пример: 2018-04-21T05:19:58.326000+00:00 |
| description строка | при состоянии present | Описание выполняемой задачи. Пример: Мой первый Glue-запрос |
| last_updated_time строка | при состоянии present | Последнее время обновления этого определения подключения. Пример: 2018-04-21T05:19:58.326000+00:00 |
| match_criteria список | при состоянии present | Список критериев, которые могут быть использованы для выбора этого подключения. |
| name строка | при состоянии present | Имя определения подключения. Пример: my-glue-connection |
| physical_connection_requirements словарь | при состоянии present | Словарь требований к физическому подключению, таких как VPC и SecurityGroup, необходимых для успешного установления подключения. Пример: {'subnet-id': 'subnet-aabbccddee'} |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. в разделе Обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Rob White (@wimnat)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/aws_glue_connection_module.html