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

选项

  • false

  • true ← (默认)

示例

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

返回值

通用返回值记录在 此处,以下是此模块独有的字段

描述

数据

字典

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)