community.general.scaleway_sshkey модуль — Управление ключами SSH Scaleway
Примечание
Этот модуль входит в коллекцию community.general (версия 9.5.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.general.
Чтобы использовать её в playbook, укажите: community.general.scaleway_sshkey.
Обзор
- Этот модуль управляет ключами SSH на аккаунте Scaleway https://developer.scaleway.com.
Параметры
Параметр | Комментарии |
|---|---|
api_timeout псевдонимы: timeout целое число | Таймаут HTTP-запросов к API Scaleway в секундах. По умолчанию: |
api_token псевдонимы: oauth_token строка / обязательный | Токен Scaleway OAuth. |
api_url псевдонимы: base_url строка | URL API Scaleway. По умолчанию: |
query_parameters словарь | Список параметров, передаваемых в строку запроса. По умолчанию: |
ssh_pub_key строка / обязательный | Публичный ключ SSH в виде строки для добавления. |
state строка | Указывает желаемое состояние ключа SSH. Варианты:
|
validate_certs булево | Проверять SSL-сертификаты API Scaleway. Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная | Может работать в режиме |
diff_mode | Поддержка: нет | Возвратит детали о том, что изменилось (или, возможно, нужно изменить в |
Примечания
Примечание
- См. также документацию API по https://developer.scaleway.com/.
- Если
api_tokenне задан в модуле, можно использовать следующие переменные окружения в порядке убывания приоритетаSCW_TOKEN,SCW_API_KEY,SCW_OAUTH_TOKENилиSCW_API_TOKEN. - Если нужно использовать другой
api_url, можно также установить переменную окруженияSCW_API_URL.
Примеры
- name: "Add SSH key"
community.general.scaleway_sshkey:
ssh_pub_key: "ssh-rsa AAAA..."
state: "present"
- name: "Delete SSH key"
community.general.scaleway_sshkey:
ssh_pub_key: "ssh-rsa AAAA..."
state: "absent"
- name: "Add SSH key with explicit token"
community.general.scaleway_sshkey:
ssh_pub_key: "ssh-rsa AAAA..."
state: "present"
oauth_token: "6ecd2c9b-6f4f-44d4-a187-61a92078d08c"
Возвращаемые значения
Общие возвращаемые значения описаны в этой статье, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
data словарь | Это присутствует только когда Возвращается: когда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/scaleway_sshkey_module.html