aci_contract_subject – Manage initial Contract Subjects (vz:Subj)¶
New in version 2.4.
Synopsis¶
Manage initial Contract Subjects on Cisco ACI fabrics.
Parameters¶
Notes¶
Note
The
tenant
andcontract
used must exist before using this module in your playbook. The aci_tenant and aci_contract modules can be used for this.
See Also¶
See also
- aci_contract – Manage contract resources (vz:BrCP)
The official documentation on the aci_contract module.
- aci_tenant – Manage tenants (fv:Tenant)
The official documentation on the aci_tenant module.
- APIC Management Information Model reference
More information about the internal APIC class vz:Subj.
- Cisco ACI Guide
Detailed information on how to manage your ACI infrastructure using Ansible.
- Developing Cisco ACI modules
Detailed guide on how to write your own Cisco ACI modules to contribute.
Examples¶
- name: Add a new contract subject
aci_contract_subject:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
contract: web_to_db
subject: default
description: test
reverse_filter: yes
priority: level1
dscp: unspecified
state: present
register: query_result
- name: Remove a contract subject
aci_contract_subject:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
contract: web_to_db
subject: default
state: absent
delegate_to: localhost
- name: Query a contract subject
aci_contract_subject:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
contract: web_to_db
subject: default
state: query
delegate_to: localhost
register: query_result
- name: Query all contract subjects
aci_contract_subject:
host: apic
username: admin
password: SomeSecretPassword
state: query
delegate_to: localhost
register: query_result
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Status¶
This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by an Ansible Partner. [certified]