cloudfront_invalidation - создание недействительных данных для распределений aws cloudfront
Новое в версии 2.5.
Обзор
- Позволяет аннулировать набор путей для распределения CloudFront.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- boto
- boto3 >= 1.0.0
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| alias | Псевдоним распределения cloudfront, для которого требуется аннулировать пути. Может быть указан вместо distribution_id. | |
| aws_access_key | По умолчанию: None | Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key |
| aws_secret_key | По умолчанию: None | Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key |
| caller_reference | По умолчанию: Текущая метка времени | Уникальный идентификатор для путей аннулирования. |
| distribution_id | Идентификатор распределения cloudfront, для которого требуется аннулировать пути. Может быть указан вместо alias. | |
| ec2_url | По умолчанию: None | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если она существует. |
| profile (добавлено в 1.6) | По умолчанию: None | Использует профиль 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 | |
| security_token (добавлено в 1.6) | По умолчанию: None | Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token |
| target_paths требуется | Список путей в распределении, которые необходимо аннулировать. Каждый путь должен начинаться с '/'. Разрешены шаблоны. Пример: '/foo/bar/*' | |
| validate_certs (добавлено в 1.5) |
| Если установлено «нет», сертификаты SSL для boto версий >= 2.6.0 не будут проверяться. |
Примечания
Примечание
- не поддерживает режим проверки
- Если параметры не заданы в модуле, следующие переменные среды могут использоваться в порядке убывания приоритета
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
Примеры
- name: create a batch of invalidations using a distribution_id for a reference
cloudfront_invalidation:
distribution_id: E15BU8SDCGSG57
caller_reference: testing 123
target_paths:
- /testpathone/test1.css
- /testpathtwo/test2.js
- /testpaththree/test3.ss
- name: create a batch of invalidations using an alias as a reference and one path using a wildcard match
cloudfront_invalidation:
alias: alias.test.com
caller_reference: testing 123
target_paths:
- /testpathone/test4.css
- /testpathtwo/test5.js
- /testpaththree/*
Значения возврата
Общие значения возврата описаны в здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание | |||
|---|---|---|---|---|---|
| invalidation сложный | всегда | Информация об аннулировании. | |||
| status строка | всегда | Статус запроса на аннулирование. Пример: Завершено | |||
| create_time строка | всегда | Дата и время первого запроса аннулирования. Пример: 2018-02-01T15:50:41.159000+00:00 | |||
| id строка | всегда | Идентификатор запроса аннулирования. Пример: I2G9MOWJZFV612 | |||
| invalidation_batch сложный | всегда | Текущая информация об аннулировании для запроса партии. | |||
| paths сложный | всегда | Словарь, содержащий информацию об объектах, которые требуется аннулировать. | |||
| items список | всегда | Список путей, которые необходимо аннулировать. Пример: ['/testpathtwo/test2.js', '/testpathone/test1.css', '/testpaththree/test3.ss'] | |||
| quantity целое | всегда | Количество объектов, которые требуется аннулировать. Пример: 3 | |||
| caller_reference строка | всегда | Значение, используемое для уникальной идентификации запроса аннулирования. Пример: тест 123 | |||
| location строка | всегда | Полный URI распределения и запроса аннулирования партии. Пример: https://cloudfront.amazonaws.com/2017-03-25/distribution/E1ZID6KZJECZY7/invalidation/I2G9MOWJZFV622 | |||
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Willem van Ketwich (@wilvk)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/cloudfront_invalidation_module.html