hcloud_ssh_key – Создание и управление ключами SSH на Hetzner Cloud

Новая версия 2.8.

Описание
Требования
Параметры
См. также
Примеры
Значения возврата
Статус

Описание

Создание, обновление и управление ключами SSH на Hetzner Cloud.

Требования

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

hcloud-python >= 1.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token строка / обязательно		Токен API для Hetzner Cloud.
endpoint строка	По умолчанию: "https://api.hetzner.cloud/v1"	Конечная точка API для Hetzner Cloud.
fingerprint строка		Отпечаток ключа SSH Hetzner Cloud для управления. Требуется только если не указан id или name ключа SSH.
id целое число		Идентификатор ключа SSH Hetzner Cloud для управления. Требуется только если не указано name ключа SSH.
labels словарь		Пользовательские метки (пары ключ-значение)
name строка		Имя ключа SSH Hetzner Cloud для управления. Требуется только если не указан id ключа SSH или ключ SSH не существует.
public_key строка		Открытый ключ для добавления. Требуется, если ключ SSH не существует.
state строка	Варианты: absent present ←	Состояние ключа SSH.

См. также

Документация API Hetzner Cloud: Полная справка по API Hetzner Cloud.

Примеры

- name: Create a basic ssh_key
  hcloud_ssh_key:
    name: my-ssh_key
    public_key: "ssh-rsa AAAjjk76kgf...Xt"
    state: present

- name: Create a ssh_key with labels
  hcloud_ssh_key:
    name: my-ssh_key
    public_key: "ssh-rsa AAAjjk76kgf...Xt"
    labels:
        key: value
        mylabel: 123
    state: present

- name: Ensure the ssh_key is absent (remove if needed)
  hcloud_ssh_key:
    name: my-ssh_key
    state: absent

Значения возврата

Общие значения возврата описаны здесь, а следующие — поля, уникальные для этого модуля:

Ключ		Возвращаемое значение	Описание
hcloud_ssh_key сложное		Всегда	Экземпляр ключа SSH
	fingerprint строка	Всегда	Отпечаток ключа SSH Пример: b7:2f:30:a0:2f:6c:58:6c:21:04:58:61:ba:06:3b:2f
	id целое число	Всегда	Идентификатор ключа SSH Пример: 12345
	labels словарь	Всегда	Пользовательские метки (пары ключ-значение) Пример: {'key': 'value', 'mylabel': 123}
	name строка	Всегда	Имя ключа SSH Пример: my-ssh-key
	public_key строка	Всегда	Открытый ключ ключа SSH Пример: ssh-rsa AAAjjk76kgf...Xt

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Lukas Kaemmerling (@LKaemmerling)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/hcloud_ssh_key_module.html