Spec-Zone.ru › Ansible 2.5

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API