solace / solace.pubsub_plus / 1.12.2 / module / solace_vpn vpn Authors: Ricardo Gomez-Ulmke (@rjgu) preview | supported by communitysolace.pubsub_plus.solace_vpn (1.12.2) — module
Install with ansible-galaxy collection install solace.pubsub_plus:==1.12.2
collections: - name: solace.pubsub_plus version: 1.12.2
Allows addition, removal and configuration of VPN objects in an idempotent manner.
Supports Solace Cloud and self-hosted brokers. Splits the settings into two calls, the Solace Cloud API and the SEMP V2 API.
Use B(settings) arguments and values from the SEMP V2 documentation.
host: default: localhost description: Hostname of Solace Broker. required: false type: str name: aliases: - msg_vpn_name description: Name of the vpn. Maps to 'msgVpnName' in the API. required: true type: str port: default: 8080 description: Management port of Solace Broker. required: false type: int state: choices: - present - absent default: present description: Target state. required: false type: str timeout: default: 10 description: Connection timeout in seconds for the http request. required: false type: int password: default: admin description: Administrator password for Solace Broker. required: false type: str username: default: admin description: Administrator username for Solace Broker. required: false type: str x_broker: description: Custom HTTP header with the broker virtual router id, if using a SEMPv2 Proxy/agent infrastructure. required: false type: str reverse_proxy: description: 'Use a reverse proxy / api gateway. Note: B(Experimental. Not permitted for Solace Cloud API).' required: false suboptions: headers: description: 'Additional headers to add to the http call. Example: ''apiKey: {my-api-key}''.' required: false suboptions: x-asc-module: default: false description: Flag for the module to add the header 'x-asc-module:{module-name}' to the http call with it's module name. required: false type: bool x-asc-module-op: default: false description: Flag for the module to add the header 'x-asc-module-op:{module operation}' to the http call with the module's operation. required: false type: bool type: dict query_params: description: 'Additional query paramters to add to the URL. Example: ''apiCode: {my-api-code}''.' required: false type: dict semp_base_path: description: 'Base path prepended to all SEMP calls. Example: ''my/base/path''. Resulting URL will be: http(s)://{host}:{port}/{semp_base_path}/{module-semp-call-path}' required: false type: str use_basic_auth: default: false description: Flag to use basic authentication in the http(s) call or not. Uses 'username'/'password'. required: false type: bool type: dict validate_certs: default: true description: Flag to switch validation of client certificates on/off when using a secure connection. required: false type: bool sempv2_settings: aliases: - settings description: JSON dictionary of additional configuration for the SEMP V2 API. See Reference documentation. required: false type: dict secure_connection: default: false description: If true, use https rather than http. required: false type: bool solace_cloud_home: choices: - us - au - US - AU - '' description: The Solace Cloud home region. required: false type: str solace_cloud_api_token: description: - The API Token. - Generate using Solace Cloud console with the appropriate permissions for the operations you want to enable. - Either both (solace_cloud_api_token AND solace_cloud_service_id) must be provided or none. required: false type: str solace_cloud_service_id: description: - The service id in Solace Cloud. - Click on the service in Solace Cloud - the service id is in the URL. - Either both (solace_cloud_api_token AND solace_cloud_service_id) must be provided or none. required: false type: str
msg: description: The response from the HTTP call in case of error. returned: error type: dict rc: description: Return code. rc=0 on success, rc=1 on error. returned: always sample: error: rc: 1 success: rc: 0 type: int response: description: The responses from the Solace Cloud and/or Sempv2 requests. returned: success type: dict