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), либо будут рассматриваться как нет необходимости в выполнении (т. е. унаследуют то, что уже существует для 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)