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 и Разработка модулей.