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). Если какие-либо необязательные значения отсутствуют, они будут либо обработаны как нет-операция (т. е. унаследуют то, что уже существует для VPC), либо будут установлены пустые значения. Для удаления существующих параметров при наследовании необходимо передать пустое значение (например, установите ntp_servers в [] если вы хотите удалить их из параметров VPC). Большинство параметров понятны сами по себе.

Требования

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

• 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. [community]

Авторы

• Joel Thompson (@joelthompson)