New in version 2.0.
parameter | required | default | choices | comments |
---|---|---|---|---|
api_version |
no | 5.7 | The api version to be used with the vca. | |
gateway_name |
no | gateway | The name of the gateway of the vdc where the rule should be added. | |
host |
no | None | The authentication host to be used when service type is vcd. | |
instance_id |
no | None | The instance id in a vchs environment to be used for creating the vapp. | |
nat_rules |
yes | A list of rules to be added to the gateway, Please see examples on valid entries | ||
org |
no | None | The org to login to for creating vapp. This option is required when the service_type is vdc. | |
password |
no | None | The vca password, if not set the environment variable
VCA_PASS is checked for the password.aliases: pass, pwd | |
purge_rules |
no | If set to true, it will delete all rules in the gateway that are not given as paramter to this module. | ||
service_type |
no | vca |
|
The type of service we are authenticating against. |
state |
no | present |
|
If the object should be added or removed. |
username |
no | None | The vca username or email address, if not set the environment variable
VCA_USER is checked for the username.aliases: user | |
vdc_name |
no | None | The name of the vdc where the gateway is located. | |
verify_certs |
no | True | If the certificates of the authentication is to be verified. |
#An example for a source nat - hosts: localhost connection: local tasks: - vca_nat: instance_id: 'b15ff1e5-1024-4f55-889f-ea0209726282' vdc_name: 'benz_ansible' state: 'present' nat_rules: - rule_type: SNAT original_ip: 192.0.2.42 translated_ip: 203.0.113.23 #example for a DNAT - hosts: localhost connection: local tasks: - vca_nat: instance_id: 'b15ff1e5-1024-4f55-889f-ea0209726282' vdc_name: 'benz_ansible' state: 'present' nat_rules: - rule_type: DNAT original_ip: 203.0.113.23 original_port: 22 translated_ip: 192.0.2.42 translated_port: 22
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.