Authentication

To authenticate the API call against the Hetzner Cloud API when using the hetzner.hcloud collection, you can provide the API token by different means:

You can pass the API token using an environment variable (recommended):

export HCLOUD_TOKEN='LRK9DAWQ1ZAEFSrCNEEzLCUwhYX1U3g7wMg4dTlkkDC96fyDuyJ39nVbVjCKSDfj'

# Verify that your token is working
ansible -m hetzner.hcloud.location_info localhost

Alternatively, you may provide the API token directly as module argument:

- name: Create server
  hetzner.hcloud.server:
    api_token: LRK9DAWQ1ZAEFSrCNEEzLCUwhYX1U3g7wMg4dTlkkDC96fyDuyJ39nVbVjCKSDfj
    name: my-server
    server_type: cx11
    image: debian-12
    state: present

To reduce the duplication of the above solution, you may configure the hetzner.hcloud.* modules using the hetzner.hcloud.all action group, for example if you want to store your API token in a vault:

- name: Demonstrate the usage of the 'hetzner.hcloud.all' module_defaults group
  hosts: localhost
  connection: local

  module_defaults:
    group/hetzner.hcloud.all:
      api_token: "{{ _vault_hcloud_api_token }}"

  tasks:
    - name: Create server
      hetzner.hcloud.server:
        name: my-server
        server_type: cx11
        image: debian-12
        state: present