s3_bucket - Управление S3-бакетами в AWS, Ceph, Walrus и FakeS3

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

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

Обзор

Управление S3-бакетами в AWS, Ceph, Walrus и FakeS3

Требования

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

boto
boto3
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key		Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key
aws_secret_key		Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key
ceph (добавлен в 2.2)		Включить совместимость API с Ceph. Учитывает подмножество S3 API, работающее с Ceph, для обеспечения аналогичного поведения модуля в той мере, в которой это возможно.
ec2_url		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковое имеется.
force bool	Варианты: нет ← да	При попытке удалить бакет, сначала удаляются все ключи в бакете (S3-бакет должен быть пустым для успешного удаления).
name обязательно		Имя S3-бакета
policy		Политика JSON в виде строки.
profile (добавлен в 1.6)		Использует профиль boto. Работает только с boto >= 2.24.0.
region		Регион AWS для использования. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если таковое имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
requester_pays bool	Варианты: нет ← да	В бакетах с оплатой запросчиком вместо владельца бакета оплачивает стоимость запроса и загрузки данных из бакета.
s3_url		Конечная точка URL S3 для использования с Ceph, Eucalypus, fakes3 и т. д. В противном случае предполагается AWS псевдонимы: S3_URL
security_token (добавлен в 1.6)		Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state	Варианты: present ← absent	Создать или удалить S3-бакет
tags		Словарь тегов для применения к бакетам
validate_certs bool (добавлен в 1.5)	Варианты: нет да ←	Если значение "нет", сертификаты SSL не будут проверены для версий boto >= 2.6.0.
versioning bool	Варианты: нет да	Включена или выключена версия (обратите внимание, что после включения версионирования ее можно только приостановить)

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
Ansible использует файл конфигурации boto (обычно ~/.boto), если учетные данные не указаны. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используются для указания региона AWS, когда это необходимо, но это также можно настроить в файле конфигурации boto

Примеры

# Note: These examples do not set authentication details, see the AWS Guide for details.

# Create a simple s3 bucket
- s3_bucket:
    name: mys3bucket

# Create a simple s3 bucket on Ceph Rados Gateway
- s3_bucket:
    name: mys3bucket
    s3_url: http://your-ceph-rados-gateway-server.xxx
    ceph: true

# Remove an s3 bucket and any keys it contains
- s3_bucket:
    name: mys3bucket
    state: absent
    force: yes

# Create a bucket, add a policy from a file, enable requester pays, enable versioning and tag
- s3_bucket:
    name: mys3bucket
    policy: "{{ lookup('file','policy.json') }}"
    requester_pays: yes
    versioning: yes
    tags:
      example: tag1
      another: tag2

Статус

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

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

Этот модуль помечен как core, что означает, что его поддерживает Ansible Core Team. Подробнее см. Техническое обслуживание и поддержка модулей.

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

Поддержка

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний

Автор

Rob White (@wimnat)

Подсказка

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

© 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/s3_bucket_module.html