New in version 2.3.
The below requirements are needed on the host that executes this module.
Parameter |
Choices/Defaults |
Comments |
---|---|---|
name
required |
|
Name of Address.
|
region
required |
|
Region to create the address in. Set to 'global' to create a global address.
|
state
|
|
The state the address should be in.
present or absent are the only valid options. |
# Create a Global external IP address
- gce_eip:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
name: my-global-ip
region: global
state: present
# Create a Regional external IP address
- gce_eip:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
name: my-global-ip
region: us-east1
state: present
Common return values are documented here, the following are the fields unique to this module:
Key |
Returned |
Description |
---|---|---|
address
string
|
always |
IP address being operated on
Sample:
35.186.222.233
|
name
string
|
always |
name of the address being operated on
Sample:
my-address
|
region
string
|
always |
Which region an address belongs.
Sample:
global
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.