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

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

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

Обзор

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

Требования

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

pyrax
python >= 2.6

Параметры

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

Примечания

Примечание

Следующие переменные среды могут быть использованы, 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"
      rax_files_objects:
        container: testcont
        dest: ~/Downloads/testcont

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

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

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

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

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

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

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

    - name: "Upload one file to test container with metadata"
      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"
      rax_files_objects:
        container: testcont
        method: put
        src: ~/Downloads/testcont/file3
        expires: 60

    - name: "Attempt to get remote object that does not exist"
      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"
      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"
      rax_files_objects:
        container: testcont
        type: meta
        dest: file2

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

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

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

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

    - name: "Get metadata on all objects"
      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.5/modules/rax_files_objects_module.html