Модуль community.hashi_vault.vault_database_role_read — запрашивает определение динамической роли
Примечание
Этот модуль входит в коллекцию community.hashi_vault (версия 7.1.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.hashi_vault. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в сценарии, укажите: community.hashi_vault.vault_database_role_read.
Добавлено в community.hashi_vault 6.2.0
Обзор
-
Запрашивает определение роли, заданной значением
role_name.
Требования
Следующие требования необходимы на хосте, который выполняет этот модуль.
-
hvac(библиотека Python) - Подробные сведения о требованиях см. на странице требований коллекции.
Параметры
Параметр | Комментарии |
|---|---|
auth_method string | Метод аутентификации. Метод аутентификации Метод аутентификации
Метод аутентификации Метод аутентификации Варианты:
|
aws_access_key псевдонимы: aws_access_key_id string | Ключ доступа AWS. |
aws_iam_server_id string добавлено в community.hashi_vault 0.2.0 | Если указано, задаёт значение для заголовка |
aws_profile псевдонимы: boto_profile string | Профиль AWS |
aws_secret_key псевдонимы: aws_secret_access_key string | Секретный ключ AWS, соответствующий ключу доступа. |
aws_security_token string | Токен безопасности AWS при использовании временных ключей доступа и секретных ключей. |
azure_client_id string добавлено в community.hashi_vault 3.2.0 | Идентификатор клиента (также известный как идентификатор приложения) субъекта-службы Azure AD или управляемого удостоверения. Должен быть UUID. Если не указан, будет использоваться назначенное системой управляемое удостоверение. |
azure_client_secret string добавлено в community.hashi_vault 3.2.0 | Секрет клиента субъекта-службы Azure AD. |
azure_resource string добавлено в community.hashi_vault 3.2.0 | URL ресурса для приложения, зарегистрированного в Azure Active Directory. Обычно это значение не следует менять. По умолчанию: |
azure_tenant_id string добавлено в community.hashi_vault 3.2.0 | Идентификатор клиента Azure Active Directory (также известный как идентификатор каталога) субъекта-службы. Должен быть UUID. Обязателен при аутентификации в Vault с помощью субъекта-службы, например, когда указаны и azure_client_id, и azure_client_secret. Необязателен при аутентификации в Vault с помощью управляемого удостоверения. |
ca_cert псевдонимы: cacert string | Путь к сертификату для аутентификации. Если значение не указано другим способом, будет использоваться переменная окружения |
cert_auth_private_key path добавлено в community.hashi_vault 1.4.0 | Для аутентификации |
cert_auth_public_key path добавлено в community.hashi_vault 1.4.0 | Для аутентификации |
engine_mount_point string | Путь, по которому подключён серверный модуль секретов. |
jwt string | JSON Web Token (JWT) для аутентификации в Vault с помощью JWT. |
mount_point string | Точка подключения Vault. Если не указана, используется точка подключения по умолчанию для выбранного метода аутентификации. Не применяется к аутентификации по токену. |
namespace string | Пространство имён Vault, в котором находятся секреты. Для этого параметра требуются HVAC 0.7.0+ и Vault 0.11+. Также можно добавить пространство имён в начало точки подключения аутентификации и/или пути к секрету (например, Если задана переменная окружения |
password string | Пароль для аутентификации. |
proxies any добавлено в community.hashi_vault 1.1.0 | URL прокси-серверов для доступа к службе Vault. Значением может быть строка или словарь. Если это словарь, укажите схему (например, Если это строка, укажите один URL, который будет использоваться как прокси для схем Строка, которую можно интерпретировать как словарь, будет преобразована в словарь (см. примеры). Можно указать разные прокси-серверы для ресурсов HTTP и HTTPS. Если значение не указано, используются переменные окружения библиотеки Requests. |
region string | Регион AWS, для которого создаётся подключение. |
retries any добавлено в community.hashi_vault 1.3.0 | Позволяет повторять запросы при ошибках на основе класса Retry библиотеки urllib3. В этой коллекции заданы рекомендуемые параметры для повторных подключений к Vault. Значением этого параметра может быть положительное целое число или словарь. Если параметр не указан или его значение равно Число задаёт общее количество повторов; для остальных параметров используются значения коллекции по умолчанию. Словарь используется напрямую для инициализации класса Подробные сведения о повторах см. в руководстве пользователя коллекции. |
retry_action string добавлено в community.hashi_vault 1.3.0 | Определяет, нужно ли выводить сообщения о повторных попытках и каким образом. Не влияет на запросы, которые не повторяются. Варианты:
|
role_id string | Идентификатор или имя роли Vault. Используется в методах аутентификации При аутентификации При аутентификации |
role_name string / обязательный | Имя роли, которую необходимо прочитать из Hashicorp Vault. |
secret_id string | Идентификатор секрета для аутентификации в Vault с помощью AppRole. |
timeout integer добавлено в community.hashi_vault 1.3.0 | Задаёт время ожидания подключения в секундах. Если параметр не задан, используется значение по умолчанию библиотеки |
token string | Токен Vault. Токен можно указать явно, через перечисленные переменные [env], а также через переменную окружения Если токен не указан явно или через переменные окружения, плагин проверит наличие файла токена, путь к которому определяется параметрами token_path и token_file. Токен загружается в следующем порядке (используется первый найденный): |
token_file string | Если токен не указан, будет предпринята попытка прочитать его из этого файла в каталоге token_path. По умолчанию: |
token_path string | Если токен не указан, будет предпринята попытка прочитать файл token_file из этого каталога. |
token_validate boolean добавлено в community.hashi_vault 0.2.0 | При аутентификации по токену перед его использованием выполняется операция Отключите этот параметр, если у токена нет возможности Варианты:
|
url string | URL службы Vault. Если значение не указано другим способом, будет использоваться значение переменной окружения Если |
username string | Имя пользователя для аутентификации. |
validate_certs boolean | Управляет проверкой и подтверждением сертификатов SSL; отключать её обычно следует только для самоподписанных сертификатов. Если задана переменная Если не заданы ни validate_certs, ни Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
action_group | Группа действий: community.hashi_vault.vault | Используйте |
check_mode | Поддержка: полная Этот модуль предназначен только для чтения и работает одинаково независимо от режима проверки. | Модуль может работать в |
Примечания
Примечание
- Этот модуль всегда возвращает
changedсо значением False, так как операция чтения не изменяет данные. - Используйте
changed_when, чтобы управлять этим поведением в случаях, когда известно, что операция не изменяет состояние.
Примеры
- name: Read Role with a default mount point
community.hashi_vault.vault_database_role_read:
url: https://vault:8201
auth_method: userpass
username: '{{ user }}'
password: '{{ passwd }}'
role_name: SomeRole
register: result
- name: Display the result of the operation
ansible.builtin.debug:
msg: "{{ result }}"
- name: Read Static Role with a custom moint point
community.hashi_vault.vault_database_role_read:
url: https://vault:8201
auth_method: userpass
username: '{{ user }}'
password: '{{ passwd }}'
engine_mount_point: db1
role_name: SomeRole
register: result
- name: Display the result of the operation
ansible.builtin.debug:
msg: "{{ result }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
data dictionary | Поле Возвращается: при успехе Пример: |
raw dictionary | Необработанный результат операции. Возвращается: при успехе Пример: |
|
data dictionary |
Поле Возвращается: при успехе Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/hashi_vault/vault_database_role_read_module.html