New in version 2.4.
- ACI Fabric 1.0(3f)+
parameter | required | default | choices | comments |
---|---|---|---|---|
contract |
no |
The name of the contract.
aliases: contract_name
|
||
filter |
no |
The name of the Filter to bind to the Subject.
|
||
hostname |
yes |
IP Address or hostname of APIC resolvable by Ansible control host.
aliases: host
|
||
log |
no | none |
|
Determines if the binding should be set to log.
The APIC defaults new Subject to Filter bindings to
none .aliases: directive
|
password |
yes |
The password to use for authentication.
|
||
state |
no | present |
|
Use
present or absent for adding or removing.Use
query for listing an object or multiple objects. |
subject |
no |
The name of the Contract Subject.
aliases: contract_subject, subject_name
|
||
tenant |
yes |
The name of the tenant.
aliases: tenant_name
|
||
timeout |
no | 30 |
The socket level timeout in seconds.
|
|
use_proxy |
no | yes |
|
If
no , it will not use a proxy, even if one is defined in an environment variable on the target hosts. |
use_ssl |
no | yes |
|
If
no , an HTTP connection will be used instead of the default HTTPS connection. |
username |
yes | admin |
The username to use for authentication.
aliases: user
|
|
validate_certs |
no | yes |
|
If
no , SSL certificates will not be validated.This should only set to
no used on personally controlled sites using self-signed certificates. |
- aci_subject_filter_binding: hostname: '{{ inventory_hostname }}' username: '{{ username }}' password: '{{ password }}' tenant: '{{ tenant }}' contract: '{{ contract }}' subject: '{{ subject }}' filter: '{{ filter }}' log: '{{ log }}'
Note
tenant
, contract
, subject
, and filter_name
must exist before using this module in your playbook.<protocol>_proxy
is set on the target host, requests will be sent through that proxy. This behaviour can be overridden by setting a variable for this task (see setting the environment), or by using the use_proxy
option.This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.