vultr.cloud.object_storage 模块 – 管理 Vultr 上的对象存储

注意

此模块是 vultr.cloud 集合 (版本 1.13.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install vultr.cloud。

要在 playbook 中使用它，请指定： vultr.cloud.object_storage。

vultr.cloud 1.12.0 中的新增功能

概要

  • 管理对象存储。

参数

参数

注释

api_endpoint

字符串

API 端点 URL（不带尾部斜杠）。

回退环境变量 VULTR_API_ENDPOINT。

默认值： "https://api.vultr.com/v2"

api_key

字符串 / 必需

Vultr API 的 API 密钥。

回退环境变量 VULTR_API_KEY。

api_retries

整数

如果 Vultr API 返回 HTTP 错误代码（例如 - 429 请求过多 - 500 内部服务器错误 - 504 网关超时），则重试次数。

回退环境变量 VULTR_API_RETRIES。

默认值： 5

api_retry_max_delay

整数

重试指数退避延迟（秒），最大延迟值（秒）。

回退环境变量 VULTR_API_RETRY_MAX_DELAY。

默认值： 12

api_timeout

整数

对 Vultr API 的 HTTP 超时。

回退环境变量 VULTR_API_TIMEOUT。

默认值： 180

cluster

字符串 / 必需

将创建对象存储的集群主机名。

label

别名：name

字符串 / 必需

对象存储的名称。

state

字符串

对象存储的状态。

选项

  • "present" ← (默认)

  • "absent"

validate_certs

布尔值

验证 Vultr API 的 SSL 证书。

选项

  • false

  • true ← (默认)

备注

注意

示例

---
- name: Ensure an object storage is present
  vultr.cloud.object_storage:
    label: my object storage
    cluster: ewr1.vultrobjects.com

- name: Ensure an object storage is absent
  vultr.cloud.object_storage:
    label: my object storage
    cluster: ewr1.vultrobjects.com
    state: absent

返回值

此处记录了常见的返回值 此处，以下是此模块独有的字段

键

描述

vultr_api

字典

来自 Vultr API 的响应，并进行了一些补充/修改。

返回：成功

api_account

字符串

在 ini 文件中用于选择密钥的帐户。

返回：成功

示例： "default"

api_endpoint

字符串

用于 API 请求的端点。

返回：成功

示例： "https://api.vultr.com/v2"

api_retries

整数

API 请求的最大重试次数。

返回：成功

示例： 5

api_retry_max_delay

整数

重试之间以秒为单位的指数退避延迟，直到此最大延迟值。

返回：成功

示例： 12

api_timeout

整数

用于 API 请求的超时。

返回：成功

示例： 60

vultr_block_storage

字典

来自 Vultr API 的响应。

返回：成功

date_created

字符串

创建对象存储的日期。

返回：成功

示例： "2020-10-10T01:56:20+00:00"

id

字符串

对象存储的唯一 ID。

返回：成功

示例： "cb676a46-66fd-4dfb-b839-443f2e6c0b60"

label

字符串

此对象存储的用户提供的标签。

返回：成功

示例： "my object storage"

region

字符串

此对象存储的区域。

返回：成功

示例： "ews"

s3_access_key

字符串

对象存储访问密钥。

返回：成功

示例： "00example11223344"

s3_hostname

字符串

此对象存储的集群主机名。

返回：成功

示例： "ewr1.vultrobjects.com"

s3_secret_key

字符串

对象存储密钥。

返回：成功

示例： "00example1122334455667788990011"

状态

字符串

此对象存储的状态。

返回：成功

示例： "active"

作者

  • René Moser (@resmo)