bigip_fast_application – Manages FAST application declarations sent to BIG-IP¶
New in version 1.0.0.
Parameters¶
| Parameter | Choices/Defaults | Configuration | Comments |
|---|---|---|---|
|
application
string
|
A FAST application name you want to update or remove.
This parameter is required when
tenant is specified. |
||
|
content
raw
|
Declaration to be configured on the system.
This parameter is most often used along with the
file or template lookup plugins. Refer to the examples section for correct usage.For anything advanced or with formatting, consider using the
template lookup.Additionally, this can be used for specifying application service configurations directly in YAML, however that is not an encouraged practice and, if used at all, should only be used for the absolute smallest of configurations to prevent your Playbooks from becoming too large.
If your
content includes encrypted values (such as ciphertexts, passphrases, etc), the returned changed value is always true.If you are using the
to_nice_json filter, it causes this module to fail because the purpose of that filter is to format the JSON to be human-readable and this process includes inserting extra characters that break JSON validators.This parameter is required when
state is create or present. |
||
|
state
string
|
|
When
state is create, the declaration is used to create a new FAST application.When
state is present, the existing FAST application is updated.When
state is absent, ensures the existing FAST application is removed.When
state is purge, ensures all FAST applications are removed from device. |
|
|
template
string
|
Name of installed FAST template used to create the FAST application.
This parameter is only used when creating a new application, when
state is create. |
||
|
tenant
string
|
A FAST tenant name on which you want to manage the application.
This parameter is required when
state is present or absent. |
||
|
timeout
integer
|
Default: 300
|
The amount of time to wait for the FAST async interface to complete its task, in seconds.
The accepted value range is between
10 and 1800 seconds. |
Examples¶
- name: Create FAST application
bigip_fast_application:
template: "examples/simple_http"
content: "{{ lookup('file', 'simple_http.json') }}"
state: "create"
- name: Update existing FAST application
bigip_fast_application:
tenant: "sample_tenant"
application: "sample_app"
content: "{{ lookup('file', 'simple_http_update.json') }}"
state: "present"
- name: Remove existing FAST application
bigip_fast_application:
tenant: "sample_tenant"
application: "sample_app"
state: "absent"
- name: Remove all existing FAST applications on device
bigip_fast_application:
state: "purge"
Return Values¶
The following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
|
application
string
|
changed |
A FAST application name you want to update or remove.
Sample:
simple_http
|
|
content
dictionary
|
changed |
The declaration sent to the system.
Sample:
hash/dictionary of values
|
|
template
string
|
changed |
Name of the installed FAST template used to create the FAST application.
Sample:
examples/simple_http
|
|
tenant
string
|
changed |
A FAST tenant name on which you want to manage application.
Sample:
example_tenant
|