New in version 2.4.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
address |
IPv4 or named IP address. Must be of the same scope (regional, global). Reserved addresses can (and probably should) be used for global forwarding rules. You may reserve IPs from the console or via the gce_eip module.
|
|
forwarding_rule_name
required |
Name of the Forwarding_Rule.
|
|
port_range |
For global forwarding rules, must be set to 80 or 8080 for TargetHttpProxy, and 443 for TargetHttpsProxy or TargetSslProxy.
|
|
protocol |
For global forwarding rules, TCP, UDP, ESP, AH, SCTP or ICMP. Default is TCP.
|
|
region |
The region for this forwarding rule. Currently, only 'global' is supported.
|
|
state
required |
|
The state of the Forwarding Rule. 'present' or 'absent'
|
target |
Target resource for forwarding rule. For global proxy, this is a Global TargetProxy resource. Required for external load balancing (including Global load balancing)
|
Note
- name: Create Minimum GLOBAL Forwarding_Rule
gcp_forwarding_rule:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
forwarding_rule_name: my-forwarding_rule
protocol: TCP
port_range: 80
region: global
target: my-target-proxy
state: present
- name: Create Forwarding_Rule w/reserved static address
gcp_forwarding_rule:
service_account_email: "{{ service_account_email }}"
credentials_file: "{{ credentials_file }}"
project_id: "{{ project_id }}"
forwarding_rule_name: my-forwarding_rule
protocol: TCP
port_range: 80
address: my-reserved-static-address-name
region: global
target: my-target-proxy
state: present
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
forwarding_rule
dict
|
Always. Refer to GCP documentation for detailed field descriptions. |
GCP Forwarding_Rule dictionary
Sample:
{'name': 'my-forwarding_rule', 'target': '...'}
|
forwarding_rule_name
str
|
Always |
Name of the Forwarding_Rule
Sample:
my-target-proxy
|
region
bool
|
Always |
Region for Forwarding Rule.
Sample:
True
|
state
str
|
Always. |
state of the Forwarding_Rule
Sample:
present
|
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.