community.digitalocean.digital_ocean_spaces 模块 – 创建和删除 DigitalOcean Spaces。

注意

此模块是 community.digitalocean 集合（版本 1.27.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.digitalocean。您需要进一步的要求才能使用此模块，有关详细信息，请参阅 要求。

要在剧本中使用它，请指定：community.digitalocean.digital_ocean_spaces。

community.digitalocean 1.15.0 中的新功能

概要

  • 创建和删除 DigitalOcean Spaces。

要求

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

  • boto3

参数

参数

注释

aws_access_key_id

别名：AWS_ACCESS_KEY_ID

字符串 / 必需

要使用的 AWS_ACCESS_KEY_ID。

aws_secret_access_key

别名：AWS_SECRET_ACCESS_KEY

字符串 / 必需

要使用的 AWS_SECRET_ACCESS_KEY。

baseurl

字符串

DigitalOcean API 基本 URL。

默认： "https://api.digitalocean.com/v2"

name

字符串 / 必需

要创建或删除的 Spaces 的名称。

oauth_token

别名：api_token

字符串

DigitalOcean OAuth 令牌。

还有其他几个环境变量可用于提供此值。

例如 - DO_API_TOKEN、DO_API_KEY、DO_OAUTH_TOKEN 和 OAUTH_TOKEN。

region

别名：region_id

字符串 / 必需

要在其中创建或删除 Space 的区域。

state

字符串

Space 应该是存在还是不存在。

选择

  • "present" ← (默认)

  • "absent"

timeout

整数

用于轮询 DigitalOcean API 的超时时间（以秒为单位）。

默认： 30

validate_certs

布尔值

如果设置为 no，则不会验证 SSL 证书。

只有在个人控制的使用自签名证书的站点上，才应将其设置为 no。

选择

  • false

  • true ← (默认)

示例

- name: Create a Space in nyc3
  community.digitalocean.digital_ocean_spaces:
    state: present
    name: my-space
    region: nyc3

- name: Delete a Space in nyc3
  community.digitalocean.digital_ocean_spaces:
    state: absent
    name: my-space
    region: nyc3

返回值

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

键

描述

data

字典

DigitalOcean Space

已返回： present

示例： {"space": {"endpoint_url": "https://nyc3.digitaloceanspaces.com", "name": "gh-ci-space-1", "region": "nyc3", "space_url": "https://gh-ci-space-1.nyc3.digitaloceanspaces.com"}}

msg

字符串

信息性消息

已返回： always

示例： "在 nyc3 中创建了 Space gh-ci-space-1"

作者

  • Mark Mercado (@mamercad)