модуль community.general.sl_vm — создание или отмена виртуального экземпляра в SoftLayer

Примечание

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

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

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

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

Краткое описание
Требования
Параметры
Атрибуты
Примечания
См. также
Примеры

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

Создаёт или отменяет экземпляры SoftLayer.
При создании может ожидать, пока экземпляр перейдёт в состояние «работает».

Требования

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

softlayer >= 4.1.1

Параметры

Параметр	Комментарии
cpus integer	Количество процессоров, выделяемых новому виртуальному экземпляру. Варианты: `1` `2` `4` `8` `16` `32` `56`
datacenter string	Центр обработки данных, в котором будет развёрнут виртуальный экземпляр. Варианты: `"ams01"` `"ams03"` `"che01"` `"dal01"` `"dal05"` `"dal06"` `"dal09"` `"dal10"` `"dal12"` `"dal13"` `"fra02"` `"fra04"` `"fra05"` `"hkg02"` `"hou02"` `"lon02"` `"lon04"` `"lon06"` `"mel01"` `"mex01"` `"mil01"` `"mon01"` `"osl01"` `"par01"` `"sao01"` `"sea01"` `"seo01"` `"sjc01"` `"sjc03"` `"sjc04"` `"sng01"` `"syd01"` `"syd04"` `"tok02"` `"tor01"` `"wdc01"` `"wdc04"` `"wdc06"` `"wdc07"`
dedicated boolean	Флаг, определяющий, следует ли развёртывать экземпляр в выделенном пространстве. Варианты: `false` ← (по умолчанию) `true`
disks list / elements=integer	Список размеров дисков, выделяемых новому виртуальному экземпляру. По умолчанию: `[25]`
domain string	Доменное имя, назначаемое виртуальному экземпляру.
flavor string добавлено в community.general 0.2.0	Указывает шаблон конфигурации SoftLayer, который будет использоваться вместо параметров cpus и memory.
hostname string	Имя узла, назначаемое виртуальному экземпляру.
hourly boolean	Флаг, определяющий, должна ли оплата за экземпляр взиматься почасово. Варианты: `false` `true` ← (по умолчанию)
image_id string	Шаблон образа, используемый для нового виртуального экземпляра.
instance_id string	Идентификатор виртуального экземпляра, для которого выполняется действие.
local_disk boolean	Флаг, определяющий, следует ли использовать локальный диск для нового экземпляра. Варианты: `false` `true` ← (по умолчанию)
memory integer	Объём памяти, выделяемой новому виртуальному экземпляру. Варианты: `1024` `2048` `4096` `6144` `8192` `12288` `16384` `32768` `49152` `65536` `131072` `247808`
nic_speed integer	Скорость сетевого интерфейса, назначаемая новому виртуальному экземпляру. Варианты: `10` `100` `1000`
os_code string	Код ОС, используемый для нового виртуального экземпляра.
post_uri string	URL-адрес сценария, который будет загружен и выполнен на виртуальном экземпляре после подготовки.
private boolean	Флаг, определяющий, должен ли экземпляр быть только частным. Варианты: `false` ← (по умолчанию) `true`
private_vlan string	Идентификатор VLAN, назначаемой частному сетевому интерфейсу.
public_vlan string	Идентификатор VLAN, назначаемой общедоступному сетевому интерфейсу.
ssh_keys list / elements=string	Список идентификаторов SSH-ключей, назначаемых виртуальному экземпляру. По умолчанию: `[]`
state string	Создать или отменить виртуальный экземпляр. Для создания укажите `present`, для отмены — `absent`. Варианты: `"absent"` `"present"` ← (по умолчанию)
tags string	Тег или список тегов, назначаемых виртуальному экземпляру.
wait boolean	Флаг, указывающий, нужно ли ожидать активного состояния перед возвратом. Варианты: `false` `true` ← (по умолчанию)
wait_time integer	Время в секундах, по истечении которого ожидание завершится. По умолчанию: `600`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Модуль может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме сравнения возвращает сведения об изменениях (или изменениях, которые, возможно, нужно внести в `check_mode`).

Примечания

Примечание

Библиотека softlayer-python версии 6.2.6 (по состоянию на январь 2025 года) поддерживает только Python версий 3.8, 3.9 и 3.10.

См. также

Клиент SoftLayer API для Python: Для этого модуля требуется клиент SoftLayer API для Python.

Примеры

- name: Build instance
  hosts: localhost
  gather_facts: false
  tasks:
    - name: Build instance request
      community.general.sl_vm:
        hostname: instance-1
        domain: anydomain.com
        datacenter: dal09
        tags: ansible-module-test
        hourly: true
        private: false
        dedicated: false
        local_disk: true
        cpus: 1
        memory: 1024
        disks: [25]
        os_code: UBUNTU_LATEST
        wait: false

- name: Build additional instances
  hosts: localhost
  gather_facts: false
  tasks:
    - name: Build instances request
      community.general.sl_vm:
        hostname: "{{ item.hostname }}"
        domain: "{{ item.domain }}"
        datacenter: "{{ item.datacenter }}"
        tags: "{{ item.tags }}"
        hourly: "{{ item.hourly }}"
        private: "{{ item.private }}"
        dedicated: "{{ item.dedicated }}"
        local_disk: "{{ item.local_disk }}"
        cpus: "{{ item.cpus }}"
        memory: "{{ item.memory }}"
        disks: "{{ item.disks }}"
        os_code: "{{ item.os_code }}"
        ssh_keys: "{{ item.ssh_keys }}"
        wait: "{{ item.wait }}"
      with_items:
        - hostname: instance-2
          domain: anydomain.com
          datacenter: dal09
          tags:
            - ansible-module-test
            - ansible-module-test-replicas
          hourly: true
          private: false
          dedicated: false
          local_disk: true
          cpus: 1
          memory: 1024
          disks:
            - 25
            - 100
          os_code: UBUNTU_LATEST
          ssh_keys: []
          wait: true
        - hostname: instance-3
          domain: anydomain.com
          datacenter: dal09
          tags:
            - ansible-module-test
            - ansible-module-test-replicas
          hourly: true
          private: false
          dedicated: false
          local_disk: true
          cpus: 1
          memory: 1024
          disks:
            - 25
            - 100
          os_code: UBUNTU_LATEST
          ssh_keys: []
          wait: true

- name: Cancel instances
  hosts: localhost
  gather_facts: false
  tasks:
    - name: Cancel by tag
      community.general.sl_vm:
        state: absent
        tags: ansible-module-test

Авторы

Matt Colton (@mcltn)

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

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