Spec-Zone.ru › Ansible

Модуль community.general.hwc_ecs_instance – создание ресурса Ecs/Instance в Huawei Cloud

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: community.general.hwc_ecs_instance.

Добавлено в community.general 0.2.0

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

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

  • Управление экземплярами.

Требования

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

  • keystoneauth1 >= 3.6.0

Параметры

Параметр

Комментарии

admin_pass

string

Задает исходный пароль для входа в учетную запись администратора ECS с использованием аутентификации по паролю. Администратор Linux — root, администратор Windows — Administrator. Требования к сложности пароля: от 8 до 26 символов. Пароль должен содержать не менее трех из следующих типов символов: прописные и строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?). Пароль не может содержать имя пользователя или его запись в обратном порядке. Пароль ECS под управлением Windows не может содержать имя пользователя, его запись в обратном порядке или более двух символов имени пользователя подряд.

availability_zone

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

Задает имя зоны доступности (AZ), в которой находится ECS.

data_volumes

list / elements=dictionary

Задает диски данных экземпляра ECS.

device

string

Задает имя устройства диска.

volume_id

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

Задает идентификатор диска.

description

string

Задает описание ECS. По умолчанию это пустая строка. Может содержать не более 85 символов. Не может содержать специальные символы, такие как < и >.

domain

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

Имя домена, к которому следует привязать область действия (Identity v3).

В настоящее время поддерживаются только имена доменов, идентификаторы доменов не поддерживаются.

eip_id

string

Задает идентификатор эластичного IP-адреса, назначенного ECS. Можно назначить только эластичные IP-адреса в состоянии DOWN.

enable_auto_recovery

boolean

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

Допустимые значения:

  • false
  • true

enterprise_project_id

string

Задает идентификатор корпоративного проекта, к которому относится ECS.

flavor_name

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

Задает имя типа системы.

id

string

Идентификатор управляемого ресурса.

identity_endpoint

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

URL для аутентификации Identity.

image_id

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

Задает идентификатор образа системы.

name

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

Задает имя ECS. Требования к значению: от 1 до 64 символов, включая буквы, цифры, символы подчеркивания (_), дефисы (-) и точки (.).

nics

list / elements=dictionary / обязательный

Задает сведения о сетевых интерфейсах ECS. Сеть сетевого интерфейса должна принадлежать VPC, заданной параметром vpc_id. К ECS можно подключить не более 12 сетевых интерфейсов.

ip_address

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

Задает IP-адрес сетевого интерфейса. Значение должно быть адресом IPv4 и неиспользуемым IP-адресом из диапазона подсети.

subnet_id

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

Задает идентификатор подсети.

password

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

Пароль для входа.

project

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

Имя арендатора (Identity v2) или проекта (Identity v3).

В настоящее время поддерживаются только имена проектов, идентификаторы проектов не поддерживаются.

region

string

Регион, к которому относится проект.

root_volume

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

Задает конфигурацию системных дисков ECS.

size

integer

Задает размер системного диска в ГБ. Допустимый диапазон — от 1 до 1024. Размер системного диска должен быть не меньше минимального размера системного диска, поддерживаемого образом (атрибут min_disk образа). Если параметр не задан или равен 0, по умолчанию используется минимальный размер системного диска в образе (атрибут min_disk образа).

snapshot_id

string

Задает идентификатор снимка или идентификатор исходного диска данных, содержащегося в образе полной копии ECS.

volume_type

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

Задает тип системного диска ECS.

SATA — диск обычного типа ввода-вывода.

SAS — диск с высокой производительностью ввода-вывода.

SSD — диск со сверхвысокой производительностью ввода-вывода.

Co-p1 — диск с высокой производительностью ввода-вывода (оптимизированная производительность I).

Uh-l1 — диск со сверхвысокой производительностью ввода-вывода (оптимизированная задержка).

ПРИМЕЧАНИЕ: для ECS типов HANA, HL1 и HL2 используйте диски co-p1 и uh-l1. Для других ECS не используйте диски co-p1 или uh-l1.

security_groups

list / elements=string

Задает группы безопасности ECS. Если параметр не указан, по умолчанию к ECS привязывается группа безопасности по умолчанию.

server_metadata

dictionary

Задает метаданные создаваемого ECS.

server_tags

dictionary

Задает теги ECS. При создании ECS можно указать не более 10 тегов для одного экземпляра.

ssh_key_name

string

Задает имя ключа SSH, используемого для входа в ECS.

state

string

Должен ли указанный объект существовать в Huawei Cloud.

Допустимые значения:

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

timeouts

dictionary

Тайм-ауты для каждой операции.

По умолчанию: {}

create

string

Тайм-аут операции создания.

По умолчанию: "30m"

delete

string

Тайм-аут операции удаления.

По умолчанию: "30m"

update

string

Тайм-аут операции обновления.

По умолчанию: "30m"

user

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

Имя пользователя для входа.

В настоящее время поддерживаются только имена пользователей, идентификаторы пользователей не поддерживаются.

user_data

string

Задает пользовательские данные, которые будут внедрены в процессе создания ECS. Можно внедрять текст, текстовые файлы и файлы gzip. Внедряемое содержимое должно быть закодировано в base64. Максимальный размер внедряемого содержимого до кодирования — 32 КБ. Для ECS под управлением Linux этот параметр не действует, если используется adminPass.

vpc_id

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

Задает идентификатор VPC, к которой относится ECS.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Может выполняться в режиме check_mode и возвращать прогнозируемый статус изменений без изменения целевого объекта.

diff_mode

Поддержка: нет

В режиме diff возвращает сведения о внесенных изменениях (или изменениях, которые, возможно, необходимо внести в check_mode).

Примечания

Примечание

  • Для аутентификации можно задать identity_endpoint с помощью переменной среды ANSIBLE_HWC_IDENTITY_ENDPOINT.
  • Для аутентификации можно задать user с помощью переменной среды ANSIBLE_HWC_USER.
  • Для аутентификации можно задать password с помощью переменной среды ANSIBLE_HWC_PASSWORD.
  • Для аутентификации можно задать domain с помощью переменной среды ANSIBLE_HWC_DOMAIN.
  • Для аутентификации можно задать project с помощью переменной среды ANSIBLE_HWC_PROJECT.
  • Для аутентификации можно задать region с помощью переменной среды ANSIBLE_HWC_REGION.
  • Значения переменных среды используются только в том случае, если значения не заданы в плейбуке.

Примеры

# create an ecs instance
- name: Create a vpc
  hwc_network_vpc:
    cidr: "192.168.100.0/24"
    name: "ansible_network_vpc_test"
  register: vpc
- name: Create a subnet
  hwc_vpc_subnet:
    gateway_ip: "192.168.100.32"
    name: "ansible_network_subnet_test"
    dhcp_enable: true
    vpc_id: "{{ vpc.id }}"
    cidr: "192.168.100.0/26"
  register: subnet
- name: Create a eip
  hwc_vpc_eip:
    dedicated_bandwidth:
      charge_mode: "traffic"
      name: "ansible_test_dedicated_bandwidth"
      size: 1
    type: "5_bgp"
  register: eip
- name: Create a disk
  hwc_evs_disk:
    availability_zone: "cn-north-1a"
    name: "ansible_evs_disk_test"
    volume_type: "SATA"
    size: 10
  register: disk
- name: Create an instance
  community.general.hwc_ecs_instance:
    data_volumes:
      - volume_id: "{{ disk.id }}"
    enable_auto_recovery: false
    eip_id: "{{ eip.id }}"
    name: "ansible_ecs_instance_test"
    availability_zone: "cn-north-1a"
    nics:
      - subnet_id: "{{ subnet.id }}"
        ip_address: "192.168.100.33"
      - subnet_id: "{{ subnet.id }}"
        ip_address: "192.168.100.34"
    server_tags:
      my_server: "my_server"
    image_id: "8da46d6d-6079-4e31-ad6d-a7167efff892"
    flavor_name: "s3.small.1"
    vpc_id: "{{ vpc.id }}"
    root_volume:
      volume_type: "SAS"

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

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

Ключ

Описание

admin_pass

string

Задает исходный пароль для входа в учетную запись администратора ECS с помощью аутентификации по паролю. Администратор Linux — root, а администратор Windows — Administrator. Пароль должен содержать от 8 до 26 символов. Пароль должен содержать не менее трех из следующих типов символов: «заглавные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?)». Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль ECS под управлением Windows не может содержать имя пользователя, имя пользователя в обратном порядке или более двух идущих подряд символов из имени пользователя.

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

availability_zone

string

Задает имя зоны доступности (AZ), в которой находится ECS.

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

config_drive

string

Задает драйвер конфигурации.

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

created

string

Задает время создания ECS.

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

data_volumes

list / elements=string

Задает диски данных экземпляра ECS.

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

device

string

Задает имя устройства диска.

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

volume_id

string

Задает идентификатор диска.

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

description

string

Задает описание ECS. По умолчанию используется пустая строка. Максимальная длина — 85 символов. Не допускаются специальные символы, такие как < и >.

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

disk_config_type

string

Задает тип конфигурации диска. MANUAL означает, что пространство образа не расширяется. AUTO означает, что пространство образа системного диска расширяется до размера, соответствующего типу ECS.

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

eip_id

string

Задает идентификатор эластичного IP-адреса, назначенного ECS. Назначить можно только эластичные IP-адреса в состоянии DOWN.

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

enable_auto_recovery

boolean

Указывает, включено ли автоматическое восстановление ECS.

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

enterprise_project_id

string

Задает идентификатор корпоративного проекта, которому принадлежит ECS.

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

flavor_name

string

Задает имя типа системы.

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

host_name

string

Задает имя хоста ECS.

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

image_id

string

Задает идентификатор системного образа.

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

image_name

string

Задает имя образа ECS.

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

name

string

Задает имя ECS. Требования к значению: «от 1 до 64 символов, включая буквы, цифры, символы подчеркивания (_), дефисы (-), точки (.).».

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

nics

list / elements=string

Задает сведения о сетевых интерфейсах ECS. Сеть сетевого интерфейса должна принадлежать VPC, указанной в vpc_id. К ECS можно подключить не более 12 сетевых интерфейсов.

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

ip_address

string

Задает IP-адрес сетевого интерфейса. Значение представляет собой IPv4-адрес. Это должен быть неиспользуемый IP-адрес из диапазона подсети.

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

port_id

string

Задает идентификатор порта, соответствующего IP-адресу.

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

subnet_id

string

Задает идентификатор подсети.

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

power_state

integer

Задает состояние питания ECS.

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

root_volume

dictionary

Задает конфигурацию системных дисков ECS.

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

device

string

Задает имя устройства диска.

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

size

integer

Задает размер системного диска в ГБ. Допустимый диапазон — от 1 до 1024. Размер системного диска должен быть не меньше минимального размера системного диска, поддерживаемого образом (атрибут min_disk образа). Если параметр не задан или равен 0, по умолчанию используется минимальный размер системного диска образа (атрибут min_disk образа).

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

snapshot_id

string

Задает идентификатор снимка или идентификатор исходного диска данных, включенного в образ полной ECS.

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

volume_id

string

Задает идентификатор диска.

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

volume_type

string

Задает тип системного диска ECS.

SATA — тип диска с обычным вводом-выводом.

SAS — тип диска с высокой производительностью ввода-вывода.

SSD — тип диска со сверхвысокой производительностью ввода-вывода.

Co-p1 — тип диска с высокой производительностью ввода-вывода (оптимизированный для производительности I).

Uh-l1 — тип диска со сверхвысокой производительностью ввода-вывода (оптимизированный для низкой задержки).

ПРИМЕЧАНИЕ: для ECS HANA, HL1 и HL2 используйте диски co-p1 и uh-l1. Для других ECS не используйте диски co-p1 и uh-l1.

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

security_groups

list / elements=string

Задает группы безопасности ECS. Если параметр не указан, к ECS по умолчанию привязывается группа безопасности по умолчанию.

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

server_alias

string

Задает псевдоним ECS.

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

server_metadata

dictionary

Задает метаданные создаваемой ECS.

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

server_tags

dictionary

Задает теги ECS. При создании ECS для одного экземпляра можно указать не более 10 тегов.

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

ssh_key_name

string

Задает имя SSH-ключа, используемого для входа в ECS.

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

status

string

Задает состояние ECS. Возможные значения: ACTIVE, REBOOT, HARD_REBOOT, REBUILD, MIGRATING, BUILD, SHUTOFF, RESIZE, VERIFY_RESIZE, ERROR и DELETED.

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

user_data

string

Задает пользовательские данные, которые будут переданы во время создания ECS. Можно передавать текст, текстовые файлы и файлы gzip. Передаваемое содержимое должно быть закодировано в base64. Максимальный размер передаваемого содержимого до кодирования — 32 КБ. Для ECS под управлением Linux этот параметр не действует, если используется adminPass.

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

vpc_id

string

Задает идентификатор VPC, которой принадлежит ECS.

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

Авторы

  • Huawei Inc. (@huaweicloud)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Задать вопрос
  • Сообщить об ошибке
  • Предложить новую функцию
  • Связь

© 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/community/general/hwc_ecs_instance_module.html

Spec-Zone.ru

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