community.general.oci_vcn – Управление виртуальными облачными сетями (VCN) в OCI

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

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

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

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

Обзор

Этот модуль позволяет пользователю создавать, удалять и обновлять виртуальные облачные сети (VCN) в OCI. Полный набор модулей Oracle Cloud Infrastructure Ansible можно загрузить по адресу https://github.com/oracle/oci-ansible-modules/releases.

Требования

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

python >= 2.7
Python SDK для Oracle Cloud Infrastructure https://oracle-cloud-infrastructure-python-sdk.readthedocs.io

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_user строка		OCID пользователя, от имени которого вызываются API OCI. Если не задано, используется значение переменной среды OCI_USER_OCID, если она задана. Этот параметр обязателен, если пользователь не указан в файле конфигурации (см. `config_file_location`). Чтобы получить OCID пользователя, см. https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm.
api_user_fingerprint строка		Отпечаток ключа для используемой пары ключей. Если не задано, используется значение переменной среды OCI_USER_FINGERPRINT, если она задана. Этот параметр обязателен, если отпечаток ключа не указан в файле конфигурации (см. `config_file_location`). Чтобы получить значение отпечатка пары ключей, см. https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm.
api_user_key_file строка		Полный путь и имя файла закрытого ключа (в формате PEM). Если не задано, используется значение переменной среды OCI_USER_KEY_FILE, если она задана. Этот параметр обязателен, если закрытый ключ не указан в файле конфигурации (см. `config_file_location`). Если ключ зашифрован с помощью парольной фразы, также необходимо указать параметр `api_user_key_pass_phrase`
api_user_key_pass_phrase строка		Парольная фраза, используемая для ключа, указанного в `api_user_key_file`, если он зашифрован. Если не задано, используется значение переменной среды OCI_USER_KEY_PASS_PHRASE, если она задана. Этот параметр обязателен, если парольная фраза ключа не указана в файле конфигурации (см. `config_file_location`).
auth_type строка	Варианты: api_key ← instance_principal	Тип аутентификации для запросов API. По умолчанию используется аутентификация на основе api_key (см. api_user_key_file) из файла конфигурации. Если этот параметр auth_type не указан, используется значение OCI_ANSIBLE_AUTH_TYPE, если оно задано. Используйте `auth_type="instance_principal"` для использования аутентификации на основе instance principal при выполнении playbook ansible внутри экземпляра OCI compute.
cidr_block строка		Диапазон IP-адресов CIDR для VCN. Требуется при создании VCN со значением state=present.
compartment_id строка		OCID компартмента, содержащего VCN. Требуется при создании VCN со значением state=present. Этот параметр взаимоисключающий с vcn_id.
config_file_location строка		Путь к файлу конфигурации. Если не задан, используется значение переменной среды OCI_CONFIG_FILE, если она задана. В противном случае используется ~/.oci/config.
config_profile_name строка	По умолчанию: "DEFAULT"	Имя профиля для загрузки из файла конфигурации, указанного в `config_file_location`. Если не задан, используется значение переменной среды OCI_CONFIG_PROFILE, если она задана. В противном случае используется профиль "DEFAULT" в `config_file_location`.
defined_tags словарь		Определенные теги для данного ресурса. Каждый ключ предварительно определен и ограничен по имени пространства. Подробнее см. https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/resourcetags.htm.
display_name строка		Пользовательское имя. Не обязательно уникальное и может изменяться. алиасы: name
dns_label строка		Метка DNS для VCN, используемая совместно с именем хоста VNIC и меткой DNS подсети для формирования полного доменного имени (FQDN) каждого VNIC в этой подсети (например, bminstance-1.subnet123.vcn1.oraclevcn.com). Не обязательно уникальное, но рекомендуется устанавливать уникальные метки DNS для VCN в вашем арендаторе. Должно быть строкой из буквенно-цифровых символов, начинающейся с буквы. Значение нельзя изменить.
force_create логическое	Варианты: нет ← да	Определяет, следует ли пытаться выполнить неидемпотентное создание ресурса. По умолчанию создание ресурса является идемпотентным и не создает ресурс, если он уже существует. Установка этого параметра в значение true принудительно создает копию ресурса, даже если он уже существует. Этот параметр взаимоисключающий с key_by.
freeform_tags словарь		Свободные теги для данного ресурса. Каждый тег представляет собой простую пару ключ-значение без предварительно определенного имени, типа или имени пространства. Подробнее см. https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/resourcetags.htm.
key_by список / элементы=строка		Список через запятую атрибутов этого ресурса, которые должны использоваться для уникальной идентификации экземпляра ресурса. По умолчанию используются все атрибуты ресурса, за исключением freeform_tags.
region строка		Регион Oracle Cloud Infrastructure для всех запросов API OCI. Если не задано, используется значение переменной среды OCI_REGION, если она задана. Этот параметр обязателен, если регион не указан в файле конфигурации (см. `config_file_location`). Дополнительную информацию о регионах OCI см. в https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm.
state строка	Варианты: present ← absent	Создать или обновить VCN со значением state=present. Используйте state=absent для удаления VCN.
tenancy строка		OCID вашего арендатора. Если не задано, используется значение переменной среды OCI_TENANCY, если она задана. Этот параметр обязателен, если OCID арендатора не указан в файле конфигурации (см. `config_file_location`). Чтобы получить OCID арендатора, см. https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm
vcn_id строка		OCID VCN. Требуется при удалении VCN со значением state=absent или обновлении VCN со значением state=present. Этот параметр взаимоисключающий с compartment_id. алиасы: id
wait логическое	Варианты: нет да ←	Ожидать завершения операции создания или удаления.
wait_timeout целое число	По умолчанию: 1200	Время ожидания в секундах, когда wait=yes.
wait_until строка		Состояние жизненного цикла, в которое должен перейти ресурс, когда wait=yes. По умолчанию, когда wait=yes, мы ждем, пока ресурс перейдет в состояние ACTIVE/ATTACHED/AVAILABLE/PROVISIONED/ RUNNING при операции создания и в состояние DELETED/DETACHED/ TERMINATED при операции удаления.

Примечания

Примечание

Для конфигурации OCI python sdk см. https://oracle-cloud-infrastructure-python-sdk.readthedocs.io/en/latest/configuration.html

Примеры

- name: Create a VCN
  community.general.oci_vcn:
    cidr_block: '10.0.0.0/16'
    compartment_id: 'ocid1.compartment.oc1..xxxxxEXAMPLExxxxx'
    display_name: my_vcn
    dns_label: ansiblevcn

- name: Updates the specified VCN's display name
  community.general.oci_vcn:
    vcn_id: ocid1.vcn.oc1.phx.xxxxxEXAMPLExxxxx
    display_name: ansible_vcn

- name: Delete the specified VCN
  community.general.oci_vcn:
    vcn_id: ocid1.vcn.oc1.phx.xxxxxEXAMPLExxxxx
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
vcn словарь	При успешной операции создания и обновления	Информация о VCN Пример: {'cidr_block': '10.0.0.0/16', 'compartment_id"': 'ocid1.compartment.oc1..xxxxxEXAMPLExxxxx', 'default_dhcp_options_id': 'ocid1.dhcpoptions.oc1.phx.xxxxxEXAMPLExxxxx', 'default_route_table_id': 'ocid1.routetable.oc1.phx.xxxxxEXAMPLExxxxx', 'default_security_list_id': 'ocid1.securitylist.oc1.phx.xxxxxEXAMPLExxxxx', 'display_name': 'ansible_vcn', 'dns_label': 'ansiblevcn', 'id': 'ocid1.vcn.oc1.phx.xxxxxEXAMPLExxxxx', 'lifecycle_state': 'AVAILABLE', 'time_created': '2017-11-13T20:22:40.626000+00:00', 'vcn_domain_name': 'ansiblevcn.oraclevcn.com'}

Авторы

Rohit Chaware (@rohitChaware)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/oci_vcn_module.html