hetzner.hcloud.hcloud_ssh_key_info – Gather infos about your Hetzner Cloud ssh_keys.
Note
This plugin is part of the hetzner.hcloud collection (version 1.6.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install hetzner.hcloud
.
To use it in a playbook, specify: hetzner.hcloud.hcloud_ssh_key_info
.
Synopsis
Gather facts about your Hetzner Cloud ssh_keys.
This module was called
hcloud_ssh_key_facts
before Ansible 2.9, returningansible_facts
andhcloud_ssh_key_facts
. Note that the hetzner.hcloud.hcloud_ssh_key_info module no longer returnsansible_facts
and the value was renamed tohcloud_ssh_key_info
!
Requirements
The below requirements are needed on the host that executes this module.
hcloud-python >= 1.0.0
Parameters
Parameter |
Comments |
---|---|
This is the API Token for the Hetzner Cloud. |
|
This is the API Endpoint for the Hetzner Cloud. Default: “https://api.hetzner.cloud/v1” |
|
The fingerprint of the ssh key you want to get. |
|
The ID of the ssh key you want to get. |
|
The label selector for the ssh key you want to get. |
|
The name of the ssh key you want to get. |
See Also
See also
- Documentation for Hetzner Cloud API
Complete reference for the Hetzner Cloud API.
Examples
- name: Gather hcloud sshkey infos
hcloud_ssh_key_info:
register: output
- name: Print the gathered infos
debug:
var: output.hcloud_ssh_key_info
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The ssh key instances Returned: Always |
|
Fingerprint of the ssh key Returned: always Sample: “0e:e0:bd:c7:2d:1f:69:49:94:44:91:f1:19:fd:35:f3” |
|
Numeric identifier of the ssh_key Returned: always Sample: 1937415 |
|
User-defined labels (key-value pairs) Returned: always |
|
Name of the ssh_key Returned: always Sample: “my-ssh-key” |
|
The actual public key Returned: always Sample: “ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGpl/tnk74nnQJxxLAtutUApUZMRJxryKh7VXkNbd4g9 john@example.com” |
Authors
Christopher Schmitt (@cschmitt-hcloud)