ec2_vpc_dhcp_option - Управляет параметрами DHCP и может гарантировать, что параметры DHCP для заданной VPC соответствуют запрошенным

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

Обзор

• Этот модуль удаляет или создаёт наборы параметров DHCP и может ассоциировать их с VPC. При необходимости создаётся новый набор параметров DHCP, который объединяет существующий набор параметров DHCP VPC с предоставленными значениями. Если dhcp_options_id указан, модуль будет 1. удалять (со state=«absent») 2. гарантировать применение тегов (если state=«present» и теги указаны 3. присоединять его к VPC (если state=«present» и указан vpc_id). Если любые необязательные значения отсутствуют, они будут либо обрабатываться как no-op (т. е. наследуются из уже существующих для VPC), либо будут пустыми. Для удаления существующих параметров при наследовании следует использовать пустое значение (например, установите ntp_servers в [], если вы хотите удалить их из параметров VPC). Большинство параметров должны быть понятны сами по себе.

Псевдонимы: ec2_vpc_dhcp_options

Требования

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

• boto
• python >= 2.6

Параметры

Примечания

Примеры

# Completely overrides the VPC DHCP options associated with VPC vpc-123456 and deletes any existing
# DHCP option set that may have been attached to that VPC.
- ec2_vpc_dhcp_option:
    domain_name: "foo.example.com"
    region: us-east-1
    dns_servers:
        - 10.0.0.1
        - 10.0.1.1
    ntp_servers:
        - 10.0.0.2
        - 10.0.1.2
    netbios_name_servers:
        - 10.0.0.1
        - 10.0.1.1
    netbios_node_type: 2
    vpc_id: vpc-123456
    delete_old: True
    inherit_existing: False


# Ensure the DHCP option set for the VPC has 10.0.0.4 and 10.0.1.4 as the specified DNS servers, but
# keep any other existing settings. Also, keep the old DHCP option set around.
- ec2_vpc_dhcp_option:
    region: us-east-1
    dns_servers:
      - "{{groups['dns-primary']}}"
      - "{{groups['dns-secondary']}}"
    vpc_id: vpc-123456
    inherit_existing: True
    delete_old: False


## Create a DHCP option set with 4.4.4.4 and 8.8.8.8 as the specified DNS servers, with tags
## but do not assign to a VPC
- ec2_vpc_dhcp_option:
    region: us-east-1
    dns_servers:
      - 4.4.4.4
      - 8.8.8.8
    tags:
      Name: google servers
      Environment: Test

## Delete a DHCP options set that matches the tags and options specified
- ec2_vpc_dhcp_option:
    region: us-east-1
    dns_servers:
      - 4.4.4.4
      - 8.8.8.8
    tags:
      Name: google servers
      Environment: Test
  state: absent

## Associate a DHCP options set with a VPC by ID
- ec2_vpc_dhcp_option:
    region: us-east-1
    dhcp_options_id: dopt-12345678
    vpc_id: vpc-123456

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:

Статус

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

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

Этот модуль помечен как сертифицированный, что означает, что он поддерживается партнёром Ansible. См. Поддержка модулей и техническое обслуживание для получения дополнительной информации.

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

Автор

• Joel Thompson (@joelthompson)