Spec-Zone.ru › Ansible

Модуль hetzner.hcloud.server_type_info — сбор информации о типах серверов Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

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

Для установки используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.server_type_info.

  • Краткое описание
  • Требования
  • Параметры
  • См. также
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Сбор информации о типах серверов Hetzner Cloud.

Псевдонимы: hcloud_server_type_info

Требования

Следующие требования необходимы на узле, на котором выполняется этот модуль.

  • python-dateutil >= 2.7.5
  • requests >=2.20

Параметры

Параметр

Комментарии

api_endpoint

псевдонимы: endpoint

string

Конечная точка API Hetzner Cloud.

Этот параметр также можно задать с помощью переменной среды HCLOUD_ENDPOINT.

По умолчанию: "https://api.hetzner.cloud/v1"

api_endpoint_hetzner

string

Конечная точка API Hetzner.

Этот параметр также можно задать с помощью переменной среды HETZNER_ENDPOINT.

По умолчанию: "https://api.hetzner.com/v1"

api_token

string / обязательный

Токен для API Hetzner Cloud.

Этот параметр также можно задать с помощью переменной среды HCLOUD_TOKEN.

id

integer

Идентификатор типа сервера, сведения о котором нужно получить.

Модуль завершится с ошибкой, если указанный идентификатор недействителен.

name

string

Название типа сервера, сведения о котором нужно получить.

См. также

См. также

Документация по API Hetzner

Полный справочник по API Hetzner.

Примеры

- name: Gather hcloud server type infos
  hetzner.hcloud.server_type_info:
  register: output

- name: Print the gathered infos
  debug:
    var: output.hcloud_server_type_info

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

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

Ключ

Описание

hcloud_server_type_info

list / elements=string

Сведения о типах серверов в виде списка

Возвращается: всегда

architecture

string

Архитектура процессора

Возвращается: всегда

Пример: "x86"

category

string

Категория типа сервера

Возвращается: всегда

Пример: "Shared vCPU"

cores

integer

Количество ядер процессора у сервера этого типа

Возвращается: всегда

Пример: 1

cpu_type

string

Тип процессора

Возвращается: всегда

Пример: "shared"

deprecation

dictionary

Описывает, отменён ли ресурс, когда и каким образом. Если этому полю присвоено значение None, ресурс не считается устаревшим. Если поле содержит значение, ресурс считается устаревшим. Устарело: это поле устаревает и будет постепенно выведено из использования начиная с 24 сентября 2025 года. Вместо него используйте поле locations. См. https://docs.hetzner.cloud/changelog#2025-09-24-per-location-server-types.

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

announced

string

Дата объявления об устаревании.

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

Пример: "2021-11-09T09:00:00+00:00"

unavailable_after

string

После указанного в этом поле срока ресурс исчезнет из общего списка ресурсов данного типа и не сможет использоваться в новых ресурсах. Например, если это образ, после указанной даты на его основе нельзя будет создавать новые серверы.

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

Пример: "2021-12-01T00:00:00+00:00"

description

string

Подробное описание типа сервера

Возвращается: всегда

Пример: "Falkenstein DC Park 1"

disk

integer

Размер диска сервера этого типа в ГБ

Возвращается: всегда

Пример: 25

id

integer

Числовой идентификатор типа сервера

Возвращается: всегда

Пример: 1937415

included_traffic

integer

Бесплатный трафик в месяц в байтах Устарело: это поле устаревает; 5 августа 2024 года ему будет присвоено значение None. См. https://docs.hetzner.cloud/changelog#2024-07-25-cloud-api-returns-traffic-information-in-different-format.

Возвращается: всегда

Пример: 21990232555520

locations

list / elements=string

Список поддерживаемых локаций

Возвращается: всегда

available

boolean

Доступен ли этот тип сервера в данной локации.

Возвращается: всегда

Пример: true

deprecation

dictionary

Устарел ли этот тип сервера в данной локации.

Возвращается: если тип устарел

announced

string

Дата объявления об устаревании.

Возвращается: если тип устарел

Пример: "2025-09-09T09:00:00Z"

unavailable_after

string

Дата, после которой заказ этого типа сервера будет недоступен.

Возвращается: если тип устарел

Пример: "2025-12-09T09:00:00Z"

id

integer

Числовой идентификатор локации

Возвращается: всегда

Пример: 1

name

string

Название локации

Возвращается: всегда

Пример: "fsn1"

recommended

boolean

Рекомендуется ли этот тип сервера в данной локации.

Возвращается: всегда

Пример: true

memory

integer

Объём памяти сервера этого типа в ГБ

Возвращается: всегда

Пример: 1

name

string

Название типа сервера

Возвращается: всегда

Пример: "fsn1"

storage_type

string

Тип загрузочного диска сервера

Возвращается: всегда

Пример: "local"

Авторы

  • Lukas Kaemmerling (@LKaemmerling)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Справочник по API Hetzner Cloud
  • Список изменений API Hetzner Cloud

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hetzner/hcloud/server_type_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API