Spec-Zone.ru › Ansible

community.general.hwc_ecs_instance модуль — Создает ресурс Ecs/Instance в Huawei Cloud

Примечание

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

У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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 символов. Пароль должен содержать как минимум три из следующих типов символов: «прописные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?)». Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль Windows ECS не может содержать имя пользователя, имя пользователя в обратном порядке или более двух последовательных символов в имени пользователя.

availability_zone

string / required

Указывает имя зоны доступности (AZ), где расположен ECS.

data_volumes

list / elements=dictionary

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

device

string

Указывает имя дискового устройства.

volume_id

string / required

Указывает ID диска.

description

string

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

domain

string / required

Имя домена для ограничения области (Identity v3).

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

eip_id

string

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

enable_auto_recovery

boolean

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

Варианты:

  • false
  • true

enterprise_project_id

string

Указывает ID корпоративного проекта, к которому принадлежит ECS.

flavor_name

string / required

Указывает имя системного образа.

id

string

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

identity_endpoint

string / required

URL-адрес аутентификации Identity.

image_id

string / required

Указывает ID системного образа.

name

string / required

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

nics

list / elements=dictionary / required

Указывает информацию о сетевых интерфейсах (NIC) ECS. Ограничения: сеть NIC должна принадлежать VPC, указанному в vpc_id. К ECS можно подключить максимум 12 сетевых интерфейсов.

ip_address

string / required

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

subnet_id

string / required

Указывает ID подсети.

password

string / required

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

project

string / required

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

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

region

string

Регион, к которому принадлежит проект.

root_volume

dictionary / required

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

size

integer

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

snapshot_id

string

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

volume_type

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

Указывает тип системного диска ECS.

SATA — это общий тип дисков ввода/вывода.

SAS — это тип дисков с высокой скоростью ввода/вывода.

SSD — это тип дисков с очень высокой скоростью ввода/вывода.

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

uh-l1 — тип дисков с очень высокой скоростью ввода/вывода (оптимизированные по задержке).

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

security_groups

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

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

server_metadata

словарь

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

server_tags

словарь

Указывает метки ECS. При создании ECS один ECS поддерживает до 10 меток.

ssh_key_name

строка

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

state

строка

Определяет, должен ли заданный объект существовать в Huawei Cloud.

Варианты:

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

timeouts

словарь

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

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

create

строка

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

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

delete

строка

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

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

update

строка

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

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

user

строка / обязательно

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

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

user_data

строка

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

vpc_id

строка / обязательно

Указывает идентификатор VPC, к которому принадлежит ECS.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

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

diff_mode

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

Возвращает подробности о том, что изменилось (или, возможно, требует изменения в check_mode), когда режим diff включен.

Примечания

Примечание

  • Для аутентификации можно установить 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.
  • Значения переменных среды будут использоваться только в том случае, если значения playbook не заданы.

Примеры

# 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 символов. Пароль должен содержать как минимум три из следующих типов символов: «прописные буквы, строчные буквы, цифры и специальные символы (!@$%^-_=+[{}]:,./?)». Пароль не может содержать имя пользователя или имя пользователя в обратном порядке. Пароль Windows ECS не может содержать имя пользователя, имя пользователя в обратном порядке или более двух последовательных символов в имени пользователя.

Возвращено: success

availability_zone

string

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

Возвращено: success

config_drive

string

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

Возвращено: success

created

string

Указывает время создания ECS.

Возвращено: success

data_volumes

list / elements=string

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

Возвращено: success

device

string

Указывает имя дискового устройства.

Возвращено: success

volume_id

string

Указывает ID диска.

Возвращено: success

description

string

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

Возвращено: success

disk_config_type

string

Указывает тип конфигурации диска. MANUAL — пространство изображения не расширяется. AUTO — пространство образа системного диска будет расширено до размера, равного размеру образа.

Возвращено: success

eip_id

string

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

Возвращено: success

enable_auto_recovery

boolean

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

Возвращено: success

enterprise_project_id

string

Указывает ID корпоративного проекта, к которому принадлежит ECS.

Возвращено: success

flavor_name

string

Указывает имя системного образа.

Возвращено: success

host_name

string

Указывает имя хоста ECS.

Возвращено: success

image_id

string

Указывает ID системного образа.

Возвращено: success

image_name

string

Указывает имя образа ECS.

Возвращено: success

name

string

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

Возвращено: success

nics

list / elements=string

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

Возвращено: success

ip_address

string

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

Возвращено: success

port_id

string

Указывает ID порта, соответствующий IP-адресу.

Возвращено: success

subnet_id

string

Указывает идентификатор подсети.

Возвращаемое значение: success

power_state

integer

Указывает состояние питания ECS.

Возвращаемое значение: success

root_volume

dictionary

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

Возвращаемое значение: success

device

string

Указывает имя устройства диска.

Возвращаемое значение: success

size

integer

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

Возвращаемое значение: success

snapshot_id

string

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

Возвращаемое значение: success

volume_id

string

Указывает идентификатор диска.

Возвращаемое значение: success

volume_type

string

Указывает тип системного диска ECS.

SATA — распространенный тип дисков с I/O.

SAS — тип дисков с высоким I/O.

SSD — тип дисков с очень высоким I/O.

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

uh-l1 — тип дисков с очень высоким I/O (оптимизирован для низкой задержки).

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

Возвращаемое значение: success

security_groups

list / elements=string

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

Возвращаемое значение: success

server_alias

string

Указывает псевдоним ECS.

Возвращаемое значение: success

server_metadata

dictionary

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

Возвращаемое значение: success

server_tags

dictionary

Указывает теги ECS. При создании ECS один ECS поддерживает до 10 тегов.

Возвращаемое значение: success

ssh_key_name

string

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

Возвращаемое значение: success

status

string

Указывает статус ECS. Доступные значения: ACTIVE, REBOOT, HARD_REBOOT, REBUILD, MIGRATING, BUILD, SHUTOFF, RESIZE, VERIFY_RESIZE, ERROR и DELETED.

Возвращаемое значение: success

user_data

string

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

Возвращаемое значение: success

vpc_id

string

Указывает идентификатор VPC, к которому принадлежит ECS.

Возвращаемое значение: success

Авторы

  • Huawei Inc. (@huaweicloud)

Ссылки на сборку

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

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

Spec-Zone.ru

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