community.general.rax_files_objects – Загрузка, скачивание и удаление объектов в Rackspace Cloud Files

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач, укажите: community.general.rax_files_objects.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Загрузка, скачивание и удаление объектов в Rackspace Cloud Files

Требования

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

pyrax
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Rackspace, переопределяет credentials. Псевдонимы: password
auth_endpoint строка		URI службы аутентификации. Если не указан, будет установлен на https://identity.api.rackspacecloud.com/v2.0/
clear_meta булево	Варианты: нет ← да	Необязательно очистить существующие метаданные при применении метаданных к существующим объектам. Выбор этого параметра уместен только при установке type=meta
container строка / обязательно		Контейнер для операций с файловыми объектами.
credentials путь		Файл для поиска учетных данных Rackspace. Игнорируется, если указаны api_key и username. Псевдонимы: creds_file
dest строка		Назначение операции "get"; например, локальный каталог, "/home/user/myfolder". Используется для указания назначения операции над удаленным объектом; например, имя файла, "file1", или список удаленных объектов через запятую, "file1,file2,file17"
env строка		Настройка среды в ~/.pyrax.cfg, см. https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration.
expires целое число		Используется для установки срока действия файла или папки, загружаемой в Cloud Files. Требуется целое число, указывающее срок действия в секундах
identity_type строка	По умолчанию: "rackspace"	Механизм аутентификации, например, rackspace или keystone.
meta словарь		Хэш элементов для установки в качестве значений метаданных загружаемого файла или папки
method строка	Варианты: получить ← отправить удалить	Метод операции. Например, отправка для загрузки файлов в Cloud Files, получение для скачивания файлов из Cloud Files или удаление для удаления удаленных объектов в Cloud Files
region строка		Регион для создания экземпляра.
src строка		Источник для загрузки файлов. Используется для указания удаленного объекта в качестве источника для операции, например, имя файла, "file1", или список удаленных объектов через запятую, "file1,file2,file17". src и dest взаимоисключающие при операциях только с удаленными объектами
structure булево	Варианты: нет да ←	Указывается, сохранять ли вложенную структуру каталога при скачивании объектов из Cloud Files. Установка в значение false скачивает содержимое контейнера в один плоский каталог
tenant_id строка		Идентификатор клиента, используемый для аутентификации.
tenant_name строка		Имя клиента, используемое для аутентификации.
type строка	Варианты: файл ← метаданные	Тип объекта для работы Объект метаданных или объект файла
username строка		Имя пользователя Rackspace, переопределяет credentials.
validate_certs булево	Варианты: нет да	Требовать ли проверку SSL API-точек доступа. Псевдонимы: verify_ssl

Примечания

Примечание

Можно использовать следующие переменные окружения: 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 Objects"
  hosts: local
  gather_facts: False
  tasks:
    - name: "Get objects from test container"
      community.general.rax_files_objects:
        container: testcont
        dest: ~/Downloads/testcont

    - name: "Get single object from test container"
      community.general.rax_files_objects:
        container: testcont
        src: file1
        dest: ~/Downloads/testcont

    - name: "Get several objects from test container"
      community.general.rax_files_objects:
        container: testcont
        src: file1,file2,file3
        dest: ~/Downloads/testcont

    - name: "Delete one object in test container"
      community.general.rax_files_objects:
        container: testcont
        method: delete
        dest: file1

    - name: "Delete several objects in test container"
      community.general.rax_files_objects:
        container: testcont
        method: delete
        dest: file2,file3,file4

    - name: "Delete all objects in test container"
      community.general.rax_files_objects:
        container: testcont
        method: delete

    - name: "Upload all files to test container"
      community.general.rax_files_objects:
        container: testcont
        method: put
        src: ~/Downloads/onehundred

    - name: "Upload one file to test container"
      community.general.rax_files_objects:
        container: testcont
        method: put
        src: ~/Downloads/testcont/file1

    - name: "Upload one file to test container with metadata"
      community.general.rax_files_objects:
        container: testcont
        src: ~/Downloads/testcont/file2
        method: put
        meta:
          testkey: testdata
          who_uploaded_this: someuser@example.com

    - name: "Upload one file to test container with TTL of 60 seconds"
      community.general.rax_files_objects:
        container: testcont
        method: put
        src: ~/Downloads/testcont/file3
        expires: 60

    - name: "Attempt to get remote object that does not exist"
      community.general.rax_files_objects:
        container: testcont
        method: get
        src: FileThatDoesNotExist.jpg
        dest: ~/Downloads/testcont
      ignore_errors: yes

    - name: "Attempt to delete remote object that does not exist"
      community.general.rax_files_objects:
        container: testcont
        method: delete
        dest: FileThatDoesNotExist.jpg
      ignore_errors: yes

- name: "Test Cloud Files Objects Metadata"
  hosts: local
  gather_facts: false
  tasks:
    - name: "Get metadata on one object"
      community.general.rax_files_objects:
        container: testcont
        type: meta
        dest: file2

    - name: "Get metadata on several objects"
      community.general.rax_files_objects:
        container: testcont
        type: meta
        src: file2,file1

    - name: "Set metadata on an object"
      community.general.rax_files_objects:
        container: testcont
        type: meta
        dest: file17
        method: put
        meta:
          key1: value1
          key2: value2
        clear_meta: true

    - name: "Verify metadata is set"
      community.general.rax_files_objects:
        container: testcont
        type: meta
        src: file17

    - name: "Delete metadata"
      community.general.rax_files_objects:
        container: testcont
        type: meta
        dest: file17
        method: delete
        meta:
          key1: ''
          key2: ''

    - name: "Get metadata on all objects"
      community.general.rax_files_objects:
        container: testcont
        type: meta

Авторы

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.10/collections/community/general/rax_files_objects_module.html