Add network load balancer example for specified internal IP address (#…

…742)

Add network load balancer example for specified internal IP address

SUMMARY
Adds an example to community.aws.elb_network_lb for creating an internally-facing ELB
with a specified internal IP address.
The subnet_mappings dictionary is passed directly through to the AWS ELB API, so the
ability was inherent in the module but wasn't documented.
ISSUE TYPE

Docs Pull Request

COMPONENT NAME
community.aws.elb_network_lb
ADDITIONAL INFORMATION
No module change, just docs. Happy to make any requested changes. Thanks for this module
and for looking at the PR.

Reviewed-by: Markus Bergholz <[email protected]>
Reviewed-by: None <None>

plugins/modules/elb_network_lb.py

@@ -86,7 +86,8 @@
   subnet_mappings:
     description:
       - A list of dicts containing the IDs of the subnets to attach to the load balancer. You can also specify the allocation ID of an Elastic IP
-        to attach to the load balancer. You can specify one Elastic IP address per subnet.
+        to attach to the load balancer or the internal IP address for an internal load balancer. You can specify one Elastic IP address or internal
+        address per subnet.
       - This parameter is mutually exclusive with I(subnets).
     type: list
     elements: dict
@@ -169,6 +170,21 @@
             TargetGroupName: mytargetgroup # Required. The name of the target group
     state: present
 
+- name: Create an internal ELB with a specified IP address
+  community.aws.elb_network_lb:
+    name: myelb
+    scheme: internal
+    subnet_mappings:
+      - SubnetId: subnet-012345678
+        PrivateIPv4Address: 192.168.0.1 # Must be an address from within the CIDR of the subnet.
+    listeners:
+      - Protocol: TCP # Required. The protocol for connections from clients to the load balancer (TCP, TLS, UDP or TCP_UDP) (case-sensitive).
+        Port: 80 # Required. The port on which the load balancer is listening.
+        DefaultActions:
+          - Type: forward # Required. Only 'forward' is accepted at this time
+            TargetGroupName: mytargetgroup # Required. The name of the target group
+    state: present
+
 - name: Remove an ELB
   community.aws.elb_network_lb:
     name: myelb