community.digitalocean.digital_ocean_spaces_info 模块 – 列出 DigitalOcean Spaces。

注意

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

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

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

要在 playbook 中使用它,请指定:community.digitalocean.digital_ocean_spaces_info

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"

oauth_token

别名: api_token

字符串

DigitalOcean OAuth 令牌。

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

例如, - DO_API_TOKENDO_API_KEYDO_OAUTH_TOKENOAUTH_TOKEN

region

别名: region_id

字符串 / 必需

要从中列出 Spaces 的区域。

state

字符串

仅支持 present。

选择

  • "present" ← (默认)

timeout

整数

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

默认: 30

validate_certs

布尔值

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

仅当在个人控制的站点上使用自签名证书时,才应将其设置为 no

选择

  • true ← (默认)

示例

- name: List all Spaces in nyc3
  community.digitalocean.digital_ocean_spaces_info:
    state: present
    region: nyc3

返回值

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

描述

data

字典

DigitalOcean Spaces 列表

返回: 始终

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

作者

  • Mark Mercado (@mamercad)