Spec-Zone.ru › Ansible

Модуль openstack.cloud.subnet_pool – Создание, обновление или удаление пула подсетей из OpenStack

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.2.0).

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

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

Для использования в книге задач укажите: openstack.cloud.subnet_pool.

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

Описание

  • Создание, обновление или удаление пула подсетей из OpenStack.

Требования

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

  • python >= 3.6
  • openstacksdk >= 1.0.0

Параметры

Параметр

Комментарии

address_scope

string

ID или имя области адресов, связанной с этим пулом подсетей.

api_timeout

integer

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

auth

dictionary

Словарь, содержащий информацию об аутентификации, необходимую стратегии плагина аутентификации облака. Для плагина password по умолчанию это будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен будет содержать любые параметры, необходимые этому плагину аутентификации. Этот параметр не требуется, если предоставлено имя облака или присутствуют переменные среды OpenStack OS_*.

auth_type

string

Имя плагина аутентификации для использования. Если облако использует что-то другое, кроме парольной аутентификации, имя плагина должно быть указано здесь, и содержимое параметра auth должно быть обновлено соответствующим образом.

ca_cert

aliases: cacert

string

Путь к пакету сертификатов CA, который может использоваться в качестве части проверки запросов SSL API.

client_cert

aliases: cert

string

Путь к клиентскому сертификату, который будет использоваться как часть транзакции SSL.

client_key

aliases: key

string

Путь к клиентскому ключу, который будет использоваться как часть транзакции SSL.

cloud

any

Именованное облако или конфигурация облака для работы. Если cloud — это строка, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если предоставлен auth или если присутствуют переменные среды OpenStack OS_*. Если cloud — это словарь, он содержит полную конфигурацию облака, как это было бы в разделе clouds.yaml.

default_prefix_length

integer

Длина префикса для выделения, когда атрибуты cidr или prefixlen опущены при создании подсети.

default_quota

integer

Квота на проект на пространство префиксов, которое может быть выделено из пула подсетей для подсетей проекта.

description

string

Описание пула подсетей.

extra_specs

dictionary

Словарь с дополнительными парами ключ/значение, передаваемыми в API.

interface

aliases: endpoint_type

string

Тип URL конечной точки для получения из каталога служб.

Варианты:

  • "admin"
  • "internal"
  • "public" ← (по умолчанию)

is_default

boolean

Является ли этот пул подсетей пулом по умолчанию.

Варианты:

  • false
  • true

is_shared

aliases: shared

boolean

Является ли этот пул подсетей общим или нет.

Этот атрибут не может быть обновлен.

Варианты:

  • false
  • true

maximum_prefix_length

integer

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

minimum_prefix_length

integer

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

name

string / required

Имя, которое будет присвоено пулу подсетей.

Этот атрибут не может быть обновлен.

prefixes

list / elements=string

Префиксы пула подсетей в обозначении CIDR.

project

string

Имя или ID проекта.

region_name

string

Имя региона.

sdk_log_level

string

Уровень ведения журнала OpenStackSDK

Выбираемые значения:

  • "INFO" ← (по умолчанию)
  • "DEBUG"

sdk_log_path

string

Путь к файлу журнала OpenStackSDK. Если пусто, журнал не записывается

state

string

Необходимо ли present или absent подсеть.

Выбираемые значения:

  • "present" ← (по умолчанию)
  • "absent"

timeout

integer

Сколько времени Ansible должно ждать запрашиваемого ресурса.

По умолчанию: 180

validate_certs

aliases: verify

boolean

Нужно ли проверять запросы API SSL.

До Ansible 2.3 по умолчанию было true.

Выбираемые значения:

  • false
  • true

wait

boolean

Должен ли Ansible ждать завершения запрашиваемого ресурса.

Выбираемые значения:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Можно использовать стандартные переменные окружения OpenStack, такие как OS_USERNAME, вместо явного указания значений.
  • Информация об авторизации управляется openstacksdk, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в задачах. Дополнительную информацию можно найти на https://docs.openstack.org/openstacksdk/

Примеры

- name: Create an subnet pool.
  openstack.cloud.subnet_pool:
    cloud: mycloud
    state: present
    name: my_subnet_pool
    prefixes:
        - 10.10.10.0/24

- name: Create a subnet pool for a given project.
  openstack.cloud.subnet_pool:
    cloud: mycloud
    state: present
    name: my_subnet_pool
    project: myproj
    prefixes:
        - 10.10.10.0/24

- name: Create a shared and default subnet pool in existing address scope
  openstack.cloud.subnet_pool:
    cloud: mycloud
    state: present
    name: my_subnet_pool
    address_scope: my_adress_scope
    is_default: True
    default_quota: 10
    maximum_prefix_length: 32
    minimum_prefix_length: 8
    default_prefix_length: 24
    is_shared: True
    prefixes:
        - 10.10.10.0/8

- name: Delete subnet poool.
  openstack.cloud.subnet_pool:
    cloud: mycloud
    state: absent
    name: my_subnet_pool

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

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

Ключ

Описание

subnet_pool

dictionary

Словарь, описывающий пул подсетей.

Возвращается: При успехе, когда state равен present.

address_scope_id

string

ID области адресов.

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

Пример: "861174b82b43463c9edc5202aadc60ef"

created_at

string

Метка времени создания пула подсетей.

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

Пример: ""

default_prefix_length

integer

Длина префикса для выделения, когда атрибуты cidr или prefixlen опущены при создании подсети.

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

Пример: 32

default_quota

integer

Квота на проектное пространство префиксов, которое может быть выделено из пула подсетей для подсетей проекта.

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

Пример: 22

description

string

Описание пула подсетей.

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

Пример: "My test subnet pool."

id

string

ID пула подсетей.

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

Пример: "474acfe5-be34-494c-b339-50f06aa143e4"

ip_version

integer

Версия IP пула подсетей 4 или 6.

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

Пример: 4

is_default

boolean

Указывает, является ли это пул подсетей по умолчанию.

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

Пример: false

is_shared

boolean

Указывает, является ли этот пул подсетей общим для всех проектов.

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

Пример: false

maximum_prefix_length

integer

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

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

Пример: 22

minimum_prefix_length

integer

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

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

Пример: 8

name

string

Имя пула подсетей.

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

Пример: "my_subnet_pool"

prefixes

list / elements=string

Список префиксов подсетей, назначенных пулу подсетей.

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

Пример: ["10.10.20.0/24", "10.20.10.0/24"]

project_id

string

ID проекта.

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

Пример: "861174b82b43463c9edc5202aadc60ef"

revision_number

integer

Номер ревизии пула подсетей.

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

Пример: 5

tags

list / elements=string

Список связанных тегов.

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

tenant_id

string

Идентификатор проекта. Устарело.

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

Пример: "861174b82b43463c9edc5202aadc60ef"

updated_at

string

Отметка времени последнего обновления подсети.

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

Авторы

  • OpenStack Ansible SIG

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

  • Система отслеживания ошибок
  • Репозиторий (исходный код)

© 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/openstack/cloud/subnet_pool_module.html

Spec-Zone.ru

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