rax_files - Управление контейнерами Rackspace Cloud Files

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

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

Обзор

Управление контейнерами Rackspace Cloud Files

Требования

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

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API Rackspace, переопределяет credentials. Псевдонимы: password
auth_endpoint (добавлено в 1.5)	По умолчанию: https://identity.api.rackspacecloud.com/v2.0/	URI службы аутентификации.
clear_meta	Варианты: да нет ←	При необходимости очистить существующие метаданные при применении метаданных к существующим контейнерам. Этот параметр подходит только при type=meta.
container обязательно		Контейнер для операций с контейнерами или метаданными.
credentials	По умолчанию: None	Файл для поиска учетных данных Rackspace. Игнорируется, если указаны api_key и username. Псевдонимы: creds_file
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.
meta		Хэш элементов, которые будут установлены в качестве значений метаданных в контейнере.
private		Используется для установки контейнера в частный режим, удаляя его из CDN. Предупреждение! Частные контейнеры, если ранее были общедоступными, могут содержать доступные объекты до истечения срока действия кэшированных объектов.
public		Используется для установки контейнера в общедоступный режим, доступный через Cloud Files CDN.
region	По умолчанию: DFW	Регион для создания экземпляра.
state	Варианты: present ← absent	Указывает желаемое состояние ресурса.
tenant_id (добавлено в 1.5)		Идентификатор клиента, используемый для аутентификации.
tenant_name (добавлено в 1.5)		Имя клиента, используемое для аутентификации.
ttl		В секундах, устанавливает срок действия для всех объектов в контейнере, кэшированных на узлах CDN. Установка TTL подходит только для общедоступных контейнеров.
type	Варианты: file ← meta	Тип объекта, для работы с которым предназначен модуль, т.е. объект метаданных или объект контейнера.
username		Имя пользователя Rackspace, переопределяет credentials.
verify_ssl (добавлено в 1.5)		Требовать проверку SSL для API-точек доступа.
web_error		Устанавливает объект, который будет представлен как страница HTTP-ошибки при обращении к URL CDN.
web_index		Устанавливает объект, который будет представлен как страница HTTP-индекса при обращении к URL CDN.

Примечания

Примечание

Можно использовать следующие переменные среды: 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, ...).
Можно использовать следующие переменные среды: 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: "Test Cloud Files Containers"
  hosts: local
  gather_facts: no
  tasks:
    - name: "List all containers"
      rax_files:
        state: list

    - name: "Create container called 'mycontainer'"
      rax_files:
        container: mycontainer

    - name: "Create container 'mycontainer2' with metadata"
      rax_files:
        container: mycontainer2
        meta:
          key: value
          file_for: someuser@example.com

    - name: "Set a container's web index page"
      rax_files:
        container: mycontainer
        web_index: index.html

    - name: "Set a container's web error page"
      rax_files:
        container: mycontainer
        web_error: error.html

    - name: "Make container public"
      rax_files:
        container: mycontainer
        public: yes

    - name: "Make container public with a 24 hour TTL"
      rax_files:
        container: mycontainer
        public: yes
        ttl: 86400

    - name: "Make container private"
      rax_files:
        container: mycontainer
        private: yes

- name: "Test Cloud Files Containers Metadata Storage"
  hosts: local
  gather_facts: no
  tasks:
    - name: "Get mycontainer2 metadata"
      rax_files:
        container: mycontainer2
        type: meta

    - name: "Set mycontainer2 metadata"
      rax_files:
        container: mycontainer2
        type: meta
        meta:
          uploaded_by: someuser@example.com

    - name: "Remove mycontainer2 metadata"
      rax_files:
        container: "mycontainer2"
        type: meta
        state: absent
        meta:
          key: ""
          file_for: ""

Статус

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

Автор

Paul Durivage (@angstwad)

Подсказка

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

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