Модуль community.digitalocean.digital_ocean_droplet_info — Сбор информации о Droplet DigitalOcean

Примечание

Этот модуль входит в коллекцию community.digitalocean (версия 1.27.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для её установки используйте: ansible-galaxy collection install community.digitalocean.

Для использования в playbook укажите: community.digitalocean.digital_ocean_droplet_info.

Добавлена в community.digitalocean 1.4.0

Обзор
Параметры
Примеры
Возвращаемые значения

Обзор

Этот модуль может использоваться для сбора информации о Droplet.

Параметры

Параметр	Комментарии
baseurl строка	Базовый URL API DigitalOcean. По умолчанию: `"https://api.digitalocean.com/v2"`
id строка	Идентификатор Droplet, который используется для идентификации и ссылки на Droplet.
name строка	Имя Droplet, которое используется для идентификации и ссылки на Droplet.
oauth_token алиасы: api_token строка	Токен DigitalOcean OAuth. Существует несколько других переменных среды, которые можно использовать для предоставления этого значения. Например: - `DO_API_TOKEN`, `DO_API_KEY`, `DO_OAUTH_TOKEN` и `OAUTH_TOKEN`.
timeout целое число	Таймаут в секундах, используемый для опроса API DigitalOcean. По умолчанию: `30`
validate_certs булево	Если установлено в `no`, сертификаты SSL не будут проверяться. Это следует устанавливать только в `no` для сайтов, контролируемых лично, используя самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Gather information about all droplets
  community.digitalocean.digital_ocean_droplet_info:
    oauth_token: "{{ oauth_token }}"

- name: Gather information about a specific droplet by name
  community.digitalocean.digital_ocean_droplet_info:
    oauth_token: "{{ oauth_token }}"
    name: my-droplet-name

- name: Gather information about a specific droplet by id
  community.digitalocean.digital_ocean_droplet_info:
    oauth_token: "{{ oauth_token }}"
    id: abc-123-d45

- name: Get information about all droplets to loop through
  community.digitalocean.digital_ocean_droplet_info:
    oauth_token: "{{ oauth_token }}"
  register: droplets

- name: Get number of droplets
  set_fact:
    droplet_count: "{{ droplets.data | length }}"

Возвращаемые значения

Общие возвращаемые значения описаны в этой статье, следующие поля уникальны для этого модуля:

Ключ	Описание
data список / элементы=словарь	Информация о Droplet DigitalOcean Возвращается: успешно Пример: [{"backup_ids": [], "created_at": "2021-04-07T00:44:53Z", "disk": 25, "features": ["private_networking"], "id": 123456789, "image": {"created_at": "2020-10-20T08:49:55Z", "description": "Ubuntu 18.04 x86 image", "distribution": "Ubuntu", "id": 987654321, "min_disk_size": 15, "name": "18.04 (LTS) x64", "public": false, "regions": [], "size_gigabytes": 0.34, "slug": null, "status": "retired", "tags": [], "type": "base"}, "kernel": null, "locked": false, "memory": 1024, "name": "my-droplet-01", "networks": {"v4": [{"gateway": "", "ip_address": "1.2.3.4", "netmask": "255.255.240.0", "type": "private"}, {"gateway": "5.6.7.8", "ip_address": "4.3.2.1", "netmask": "255.255.240.0", "type": "public"}], "v6": []}, "next_backup_window": null, "region": {"available": true, "features": ["backups", "ipv6", "metadata", "install_agent", "storage", "image_transfer"], "name": "New York 1", "sizes": ["s-1vcpu-1gb", "s-1vcpu-1gb-intel", "s-1vcpu-2gb", "s-1vcpu-2gb-intel", "s-2vcpu-2gb", "s-2vcpu-2gb-intel", "s-2vcpu-4gb", "s-2vcpu-4gb-intel", "s-4vcpu-8gb", "c-2", "c2-2vcpu-4gb", "s-4vcpu-8gb-intel", "g-2vcpu-8gb", "gd-2vcpu-8gb", "s-8vcpu-16gb", "m-2vcpu-16gb", "c-4", "c2-4vcpu-8gb", "s-8vcpu-16gb-intel", "m3-2vcpu-16gb", "g-4vcpu-16gb", "so-2vcpu-16gb", "m6-2vcpu-16gb", "gd-4vcpu-16gb", "so1_5-2vcpu-16gb", "m-4vcpu-32gb", "c-8", "c2-8vcpu-16gb", "m3-4vcpu-32gb", "g-8vcpu-32gb", "so-4vcpu-32gb", "m6-4vcpu-32gb", "gd-8vcpu-32gb", "so1_5-4vcpu-32gb", "m-8vcpu-64gb", "c-16", "c2-16vcpu-32gb", "m3-8vcpu-64gb", "g-16vcpu-64gb", "so-8vcpu-64gb", "m6-8vcpu-64gb", "gd-16vcpu-64gb", "so1_5-8vcpu-64gb", "m-16vcpu-128gb", "c-32", "c2-32vcpu-64gb", "m3-16vcpu-128gb", "m-24vcpu-192gb", "g-32vcpu-128gb", "so-16vcpu-128gb", "m6-16vcpu-128gb", "gd-32vcpu-128gb", "m3-24vcpu-192gb", "g-40vcpu-160gb", "so1_5-16vcpu-128gb", "m-32vcpu-256gb", "gd-40vcpu-160gb", "so-24vcpu-192gb", "m6-24vcpu-192gb", "m3-32vcpu-256gb", "so1_5-24vcpu-192gb", "so-32vcpu-256gb", "m6-32vcpu-256gb", "so1_5-32vcpu-256gb"], "slug": "nyc1"}, "size": {"available": true, "description": "Basic", "disk": 25, "memory": 1024, "price_hourly": 0.00744, "price_monthly": 5.0, "regions": ["ams2", "ams3", "blr1", "fra1", "lon1", "nyc1", "nyc2", "nyc3", "sfo1", "sfo3", "sgp1", "tor1"], "slug": "s-1vcpu-1gb", "transfer": 1.0, "vcpus": 1}, "size_slug": "s-1vcpu-1gb", "snapshot_ids": [], "status": "active", "tags": ["tag1"], "vcpus": 1, "volume_ids": [], "vpc_uuid": "123-abc-567a"}]

Ключ

Описание

data

список / элементы=словарь

Информация о Droplet DigitalOcean

Возвращается: успешно

Пример: [{"backup_ids": [], "created_at": "2021-04-07T00:44:53Z", "disk": 25, "features": ["private_networking"], "id": 123456789, "image": {"created_at": "2020-10-20T08:49:55Z", "description": "Ubuntu 18.04 x86 image", "distribution": "Ubuntu", "id": 987654321, "min_disk_size": 15, "name": "18.04 (LTS) x64", "public": false, "regions": [], "size_gigabytes": 0.34, "slug": null, "status": "retired", "tags": [], "type": "base"}, "kernel": null, "locked": false, "memory": 1024, "name": "my-droplet-01", "networks": {"v4": [{"gateway": "", "ip_address": "1.2.3.4", "netmask": "255.255.240.0", "type": "private"}, {"gateway": "5.6.7.8", "ip_address": "4.3.2.1", "netmask": "255.255.240.0", "type": "public"}], "v6": []}, "next_backup_window": null, "region": {"available": true, "features": ["backups", "ipv6", "metadata", "install_agent", "storage", "image_transfer"], "name": "New York 1", "sizes": ["s-1vcpu-1gb", "s-1vcpu-1gb-intel", "s-1vcpu-2gb", "s-1vcpu-2gb-intel", "s-2vcpu-2gb", "s-2vcpu-2gb-intel", "s-2vcpu-4gb", "s-2vcpu-4gb-intel", "s-4vcpu-8gb", "c-2", "c2-2vcpu-4gb", "s-4vcpu-8gb-intel", "g-2vcpu-8gb", "gd-2vcpu-8gb", "s-8vcpu-16gb", "m-2vcpu-16gb", "c-4", "c2-4vcpu-8gb", "s-8vcpu-16gb-intel", "m3-2vcpu-16gb", "g-4vcpu-16gb", "so-2vcpu-16gb", "m6-2vcpu-16gb", "gd-4vcpu-16gb", "so1_5-2vcpu-16gb", "m-4vcpu-32gb", "c-8", "c2-8vcpu-16gb", "m3-4vcpu-32gb", "g-8vcpu-32gb", "so-4vcpu-32gb", "m6-4vcpu-32gb", "gd-8vcpu-32gb", "so1_5-4vcpu-32gb", "m-8vcpu-64gb", "c-16", "c2-16vcpu-32gb", "m3-8vcpu-64gb", "g-16vcpu-64gb", "so-8vcpu-64gb", "m6-8vcpu-64gb", "gd-16vcpu-64gb", "so1_5-8vcpu-64gb", "m-16vcpu-128gb", "c-32", "c2-32vcpu-64gb", "m3-16vcpu-128gb", "m-24vcpu-192gb", "g-32vcpu-128gb", "so-16vcpu-128gb", "m6-16vcpu-128gb", "gd-32vcpu-128gb", "m3-24vcpu-192gb", "g-40vcpu-160gb", "so1_5-16vcpu-128gb", "m-32vcpu-256gb", "gd-40vcpu-160gb", "so-24vcpu-192gb", "m6-24vcpu-192gb", "m3-32vcpu-256gb", "so1_5-24vcpu-192gb", "so-32vcpu-256gb", "m6-32vcpu-256gb", "so1_5-32vcpu-256gb"], "slug": "nyc1"}, "size": {"available": true, "description": "Basic", "disk": 25, "memory": 1024, "price_hourly": 0.00744, "price_monthly": 5.0, "regions": ["ams2", "ams3", "blr1", "fra1", "lon1", "nyc1", "nyc2", "nyc3", "sfo1", "sfo3", "sgp1", "tor1"], "slug": "s-1vcpu-1gb", "transfer": 1.0, "vcpus": 1}, "size_slug": "s-1vcpu-1gb", "snapshot_ids": [], "status": "active", "tags": ["tag1"], "vcpus": 1, "volume_ids": [], "vpc_uuid": "123-abc-567a"}]

Авторы

Tyler Auerbeck (@tylerauerbeck)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/digitalocean/digital_ocean_droplet_info_module.html