aci_access_port_to_interface_policy_leaf_profile – Manage Fabric interface policy leaf profile interface selectors (infra:HPortS, infra:RsAccBaseGrp, infra:PortBlk)¶
New in version 2.5.
Parameters¶
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| access_port_selector 
                    string
                                             / required                     | The name of the Fabric access policy leaf interface profile access port selector. aliases: name, access_port_selector_name | |
| certificate_name 
                    string
                                                                 | The X.509 certificate name attached to the APIC AAA user used for signature-based authentication. If a  private_keyfilename was provided, this defaults to theprivate_keybasename, without extension.If PEM-formatted content was provided for  private_key, this defaults to theusernamevalue.aliases: cert_name | |
| description 
                    string
                                                                 | The description to assign to the  access_port_selector | |
| from_card 
                    string
                                                                 added in 2.6 | Deprecated Starting with Ansible 2.8 we recommend using the module aci_access_port_block_to_access_port. The parameter will be removed in Ansible 2.12. The beginning (from-range) of the card range block for the leaf access port block. aliases: from_card_range | |
| from_port 
                    string
                                             / required                     | Deprecated Starting with Ansible 2.8 we recommend using the module aci_access_port_block_to_access_port. The parameter will be removed in Ansible 2.12. The beginning (from-range) of the port range block for the leaf access port block. aliases: from, fromPort, from_port_range | |
| host 
                    string
                                             / required                     | IP Address or hostname of APIC resolvable by Ansible control host. aliases: hostname | |
| interface_type 
                    string
                                                                 added in 2.6 | 
 | The type of interface for the static EPG deployment. | 
| leaf_interface_profile 
                    string
                                             / required                     | The name of the Fabric access policy leaf interface profile. aliases: leaf_interface_profile_name | |
| leaf_port_blk 
                    string
                                             / required                     | Deprecated Starting with Ansible 2.8 we recommend using the module aci_access_port_block_to_access_port. The parameter will be removed in Ansible 2.12. The name of the Fabric access policy leaf interface profile access port block. aliases: leaf_port_blk_name | |
| leaf_port_blk_description 
                    string
                                                                 | Deprecated Starting with Ansible 2.8 we recommend using the module aci_access_port_block_to_access_port. The parameter will be removed in Ansible 2.12. The description to assign to the  leaf_port_blk | |
| output_level 
                    string
                                                                 | 
 | Influence the output of this ACI module. normalmeans the standard output, incl.currentdictinfoadds informational output, incl.previous,proposedandsentdictsdebugadds debugging output, incl.filter_string,method,response,statusandurlinformation | 
| password 
                    string
                                             / required                     | The password to use for authentication. This option is mutual exclusive with  private_key. Ifprivate_keyis provided too, it will be used instead. | |
| policy_group 
                    string
                                                                 | The name of the fabric access policy group to be associated with the leaf interface profile interface selector. aliases: policy_group_name | |
| port 
                    integer
                                                                 | Port number to be used for REST connection. The default value depends on parameter  use_ssl. | |
| private_key 
                    string
                                             / required                     | Either a PEM-formatted private key file or the private key content used for signature-based authentication. This value also influences the default  certificate_namethat is used.This option is mutual exclusive with  password. Ifpasswordis provided too, it will be ignored.aliases: cert_key | |
| state 
                    string
                                                                 | 
 | Use  presentorabsentfor adding or removing.Use  queryfor listing an object or multiple objects. | 
| timeout 
                    integer
                                                                 | Default: 30 | The socket level timeout in seconds. | 
| to_card 
                    string
                                                                 added in 2.6 | Deprecated Starting with Ansible 2.8 we recommend using the module aci_access_port_block_to_access_port. The parameter will be removed in Ansible 2.12. The end (to-range) of the card range block for the leaf access port block. aliases: to_card_range | |
| to_port 
                    string
                                             / required                     | Deprecated Starting with Ansible 2.8 we recommend using the module aci_access_port_block_to_access_port. The parameter will be removed in Ansible 2.12. The end (to-range) of the port range block for the leaf access port block. aliases: to, toPort, to_port_range | |
| use_proxy 
                    boolean
                                                                 | 
 | If  no, it will not use a proxy, even if one is defined in an environment variable on the target hosts. | 
| use_ssl 
                    boolean
                                                                 | 
 | If  no, an HTTP connection will be used instead of the default HTTPS connection. | 
| username 
                    string
                                                                 | Default: "admin" | The username to use for authentication. aliases: user | 
| validate_certs 
                    boolean
                                                                 | 
 | If  no, SSL certificates will not be validated.This should only set to  nowhen used on personally controlled sites using self-signed certificates. | 
See Also¶
See also
- APIC Management Information Model reference
- More information about the internal APIC classes infra:HPortS, infra:RsAccBaseGrp and infra:PortBlk.
- 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: Associate an Interface Access Port Selector to an Interface Policy Leaf Profile with a Policy Group
  aci_access_port_to_interface_policy_leaf_profile:
    host: apic
    username: admin
    password: SomeSecretPassword
    leaf_interface_profile: leafintprfname
    access_port_selector: accessportselectorname
    leaf_port_blk: leafportblkname
    from_port: 13
    to_port: 16
    policy_group: policygroupname
    state: present
  delegate_to: localhost
- name: Associate an interface access port selector to an Interface Policy Leaf Profile (w/o policy group) (check if this works)
  aci_access_port_to_interface_policy_leaf_profile:
    host: apic
    username: admin
    password: SomeSecretPassword
    leaf_interface_profile: leafintprfname
    access_port_selector: accessportselectorname
    leaf_port_blk: leafportblkname
    from_port: 13
    to_port: 16
    state: present
  delegate_to: localhost
- name: Remove an interface access port selector associated with an Interface Policy Leaf Profile
  aci_access_port_to_interface_policy_leaf_profile:
    host: apic
    username: admin
    password: SomeSecretPassword
    leaf_interface_profile: leafintprfname
    access_port_selector: accessportselectorname
    state: absent
  delegate_to: localhost
- name: Query Specific access_port_selector under given leaf_interface_profile
  aci_access_port_to_interface_policy_leaf_profile:
    host: apic
    username: admin
    password: SomeSecretPassword
    leaf_interface_profile: leafintprfname
    access_port_selector: accessportselectorname
    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]
Authors¶
- Bruno Calogero (@brunocalogero)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
