rax_cbs_attachments — Управление прикреплениями томов хранилища Rackspace Cloud Block Storage

Новая версия с 1.6.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Обзор

Управление прикреплениями томов хранилища Rackspace Cloud Block Storage.

Требования

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

python >= 2.6
pyrax

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API Rackspace, переопределяет credentials. Псевдонимы: password
auth_endpoint (добавлен в 1.5)	По умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
credentials		Файл, в котором содержатся учетные данные Rackspace. Игнорируется, если указаны api_key и username. Псевдонимы: creds_file
device		Путь к устройству, к которому нужно прикрепить том, например, /dev/xvde. До версии 2.4 это поле было обязательным. Теперь его можно оставить пустым для автоматического назначения имени устройства.
env (добавлен в 1.5)		Настройка среды, как настроено в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type (добавлен в 1.5)	По умолчанию: "rackspace"	Механизм аутентификации, например, rackspace или keystone.
region	По умолчанию: "DFW"	Регион для создания экземпляра.
server обязательно		Имя или идентификатор сервера, к которому нужно прикрепить/открепить том.
state обязательно	Варианты: present ← absent	Указывает желаемое состояние ресурса.
tenant_id (добавлен в 1.5)		Идентификатор арендатора, используемый для аутентификации.
tenant_name (добавлен в 1.5)		Имя арендатора, используемое для аутентификации.
username		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлен в 1.5)		Требовать или нет проверку SSL для конечных точек API.
volume обязательно		Имя или идентификатор тома, который нужно прикрепить/открепить.
wait bool	Варианты: no ← yes	Ожидать, пока том не будет в состоянии 'in-use'/'available', прежде чем возвращать результат.
wait_timeout	По умолчанию: 300	Время ожидания, прежде чем ожидание будет прервано, в секундах.

Примечания

Примечание

Можно использовать следующие переменные среды: RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.
RAX_CREDENTIALS и RAX_CREDS_FILE указывают на файл учетных данных, подходящий для pyrax. См. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticating
RAX_USERNAME и RAX_API_KEY позволяют обойти использование файла учетных данных.
RAX_REGION определяет регион Rackspace Public Cloud (DFW, ORD, LON, …).

Примеры

- name: Attach a Block Storage Volume
  gather_facts: False
  hosts: local
  connection: local
  tasks:
    - name: Storage volume attach request
      local_action:
        module: rax_cbs_attachments
        credentials: ~/.raxpub
        volume: my-volume
        server: my-server
        device: /dev/xvdd
        region: DFW
        wait: yes
        state: present
      register: my_volume

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание модулей и поддержка для получения дополнительной информации.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

Christopher H. Laco (@claco)
Matt Martz (@sivel)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/rax_cbs_attachments_module.html