hetzner.hcloud.certificate_info 模块 – 收集关于您的 Hetzner Cloud 证书的信息。

注意

此模块是 hetzner.hcloud 集合 (版本 4.2.2) 的一部分。

如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install hetzner.hcloud。您需要其他要求才能使用此模块,有关详细信息,请参阅 要求

要在剧本中使用它,请指定:hetzner.hcloud.certificate_info

概要

  • 收集关于您的 Hetzner Cloud 证书的事实信息。

别名:hcloud_certificate_info

要求

以下要求是在执行此模块的主机上需要的。

  • python-dateutil >= 2.7.5

  • requests >=2.20

参数

参数

注释

api_endpoint

别名:endpoint

字符串

Hetzner Cloud 的 API 端点。

您也可以使用 HCLOUD_ENDPOINT 环境变量来设置此选项。

默认值: "https://api.hetzner.cloud/v1"

api_token

字符串 / 必需

Hetzner Cloud 的 API 令牌。

您也可以使用 HCLOUD_TOKEN 环境变量来设置此选项。

id

整数

要获取的证书的 ID。

如果提供的 ID 无效,模块将失败。

label_selector

字符串

要获取的证书的标签选择器。

name

字符串

要获取的证书的名称。

另请参阅

另请参阅

Hetzner Cloud API 文档

Hetzner Cloud API 的完整参考。

示例

- name: Gather hcloud certificate infos
  hetzner.hcloud.certificate_info:
  register: output
- name: Print the gathered infos
  debug:
    var: output.hcloud_certificate_info

返回值

常见返回值已记录在 此处,以下是此模块独有的字段

描述

hcloud_certificate_info

复杂类型

证书实例

返回:始终

certificate

字符串

PEM 格式的证书和链

返回:始终

示例: "-----BEGIN CERTIFICATE-----..."

domain_names

字典

证书涵盖的域名和子域名列表

返回:始终

fingerprint

字符串

证书的指纹

返回:始终

示例: "03:c7:55:9b:2a:d1:04:17:09:f6:d0:7f:18:34:63:d4:3e:5f"

id

整数

证书的数字标识符

返回:始终

示例: 1937415

labels

字典

用户定义的标签(键值对)

返回:始终

name

字符串

证书的名称

返回:始终

示例: "my website cert"

not_valid_after

字符串

证书停止有效的时刻(ISO-8601 格式)

返回:始终

not_valid_before

字符串

证书生效的时刻(ISO-8601 格式)

返回:始终

作者

  • Lukas Kaemmerling (@LKaemmerling)