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

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

Описание

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

Требования

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

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Rackspace, переопределяет credentials. псевдонимы: password
auth_endpoint -	По умолчанию: "https://identity.api.rackspacecloud.com/v2.0/"	URI службы аутентификации.
clear_meta логическое значение	Варианты: нет ← да	Необязательно очистить существующие метаданные при применении метаданных к существующим контейнерам. Выбор этого параметра подходит только при установке type=meta
container - / обязательно		Контейнер, используемый для операций с контейнерами или метаданными.
credentials путь		Файл для поиска учетных данных Rackspace. Игнорируется, если указаны api_key и username. псевдонимы: creds_file
env строка		Среда, настроенная в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
identity_type -	По умолчанию: "rackspace"	Используемый механизм аутентификации, например, rackspace или keystone.
meta -		Хэш элементов для установки значений метаданных в контейнере
private логическое значение	Варианты: нет да	Используется для установки контейнера как частного, удаляя его из CDN. Предупреждение! Частные контейнеры, если ранее были общедоступными, могут иметь доступные объекты до истечения срока действия кэшированных объектов
public логическое значение	Варианты: нет да	Используется для установки контейнера как общедоступного, доступного через Cloud Files CDN
region строка	По умолчанию: "DFW"	Регион для создания экземпляра
state -	Варианты: present ← absent	Указывает желаемое состояние ресурса
tenant_id -		Идентификатор арендатора, используемый для аутентификации.
tenant_name -		Имя арендатора, используемое для аутентификации.
ttl -		В секундах, устанавливает временной интервал для всех объектов в контейнере, кэшированных на узлах CDN. Установка TTL подходит только для общедоступных контейнеров.
type -	Варианты: file ← meta	Тип объекта для работы, например, объект метаданных или объект контейнера
username строка		Имя пользователя Rackspace, переопределяет credentials.
validate_certs логическое значение	Варианты: нет да	Требовать ли валидации SSL для конечных точек API. псевдонимы: verify_ssl
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: ""

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.8/modules/rax_files_module.html