community.general.gcp_target_proxy – Create, Update or Destroy a Target_Proxy.

Note

This plugin is part of the community.general collection (version 1.3.6).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.gcp_target_proxy.

DEPRECATED

Removed in

version 2.0.0

Why

Updated modules released with increased functionality

Alternative

Use google.cloud.gcp_compute_target_http_proxy instead.

Synopsis

Requirements

The below requirements are needed on the host that executes this module.

  • python >= 2.6

  • google-api-python-client >= 1.6.2

  • google-auth >= 0.9.0

  • google-auth-httplib2 >= 0.0.2

Parameters

Parameter Choices/Defaults Comments
credentials_file
string
path to the JSON file associated with the service account email
pem_file
string
path to the pem file associated with the service account email This option is deprecated. Use 'credentials_file'.
project_id
string
your GCE project ID
service_account_email
string
service account email
service_account_permissions
list / elements=string
service account permissions
state
string / required
    Choices:
  • present
  • absent
The state the target proxy should be in. present or absent are the only valid options.
target_proxy_name
string / required
Name of the Target_Proxy.
target_proxy_type
string / required
    Choices:
  • HTTP
Type of Target_Proxy. HTTP, HTTPS or SSL. Only HTTP is currently supported.
url_map_name
string
Name of the Url Map. Required if type is HTTP or HTTPS proxy.

Notes

Note

  • Currently only supports global HTTP proxy.

Examples

- name: Create Minimum HTTP Target_Proxy
  community.general.gcp_target_proxy:
    service_account_email: "{{ service_account_email }}"
    credentials_file: "{{ credentials_file }}"
    project_id: "{{ project_id }}"
    target_proxy_name: my-target_proxy
    target_proxy_type: HTTP
    url_map_name: my-url-map
    state: present

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
state
string
Always.
state of the Target_Proxy

Sample:
present
target_proxy
dictionary
Always. Refer to GCP documentation for detailed field descriptions.
GCP Target_Proxy dictionary

Sample:
{'name': 'my-target-proxy', 'urlMap': '...'}
target_proxy_name
string
Always
Name of the Target_Proxy

Sample:
my-target-proxy
target_proxy_type
string
Always
Type of Target_Proxy. One of HTTP, HTTPS or SSL.

Sample:
HTTP
updated_target_proxy
boolean
if the target_proxy has been updated.
True if the target_proxy has been updated. Will not appear on initial target_proxy creation.

Sample:
True


Status

  • This module will be removed in version 2.0.0. [deprecated]

  • For more information see DEPRECATED.

Authors