amazon.aws.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.
- amazon.aws.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.
- amazon.aws.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
- amazon.aws.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
- amazon.aws.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
- amazon.aws.ec2_vpc_dhcp_option:
    region: us-east-1
    dhcp_options_id: dopt-12345678
    vpc_id: vpc-123456

Значения возврата

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

Авторы

• Joel Thompson (@joelthompson)