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_key filename was provided, this defaults to the private_key basename, without extension.If PEM-formatted content was provided for
private_key , this defaults to the username value.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.
normal means the standard output, incl. current dictinfo adds informational output, incl. previous , proposed and sent dictsdebug adds debugging output, incl. filter_string , method , response , status and url information |
password
string
/ required
|
The password to use for authentication.
This option is mutual exclusive with
private_key . If private_key is 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_name that is used.This option is mutual exclusive with
password . If password is provided too, it will be ignored.aliases: cert_key |
|
state
string
|
|
Use
present or absent for adding or removing.Use
query for 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
no when 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.