cisco.aci.aci_interface_policy_hsrp 模块 – 管理 HSRP 接口策略 (hsrp:IfPol)
注意
此模块是 cisco.aci 集合 (版本 2.10.1) 的一部分。
如果您使用的是 ansible
包,则可能已安装此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install cisco.aci
。
要在 playbook 中使用它,请指定:cisco.aci.aci_interface_policy_hsrp
。
概要
管理 Cisco ACI 结构上的 HSRP 接口策略。
参数
参数 |
注释 |
---|---|
用于注释对象的自定义字符串。 如果任务中未指定此值,则将改用环境变量 如果任务和环境变量 默认值: |
|
附加到用于基于签名的身份验证的 APIC AAA 用户的 X.509 证书名称。 如果提供了 如果为 如果任务中未指定此值,则将改用环境变量 |
|
接口策略控制。 选项
|
|
HSRP 接口策略的管理端口延迟。 这仅在 1 到 10000 之间的范围内有效。 |
|
HSRP 接口的描述。 |
|
Ansible 控制主机可解析的 APIC 的 IP 地址或主机名。 如果任务中未指定此值,则将改用环境变量 |
|
HSRP 接口策略名称。 |
|
影响此 ACI 模块的输出。
如果任务中未指定此值,则将改用环境变量 选项
|
|
将用于转储模块生成的 ACI JSON 配置对象的路径。 如果任务中未指定此值,则将改用环境变量 |
|
ACI 对象的 ownerKey 属性的自定义字符串。 此属性表示一个密钥,用于启用客户端拥有其用于实体关联的数据。 如果任务中未指定此值,则将改用环境变量 |
|
ACI 对象的 ownerTag 属性的自定义字符串。 此属性表示一个标签,用于启用客户端添加自己的数据。 例如,指示谁创建了此对象。 如果任务中未指定此值,则将改用环境变量 |
|
用于身份验证的密码。 此选项与 如果任务中未指定此值,则将改用环境变量 |
|
用于 REST 连接的端口号。 默认值取决于参数 如果任务中未指定此值,则将改用环境变量 |
|
用于基于签名的身份验证的 PEM 格式的私钥文件或私钥内容。 此值还会影响使用的默认 此选项与 如果任务中未指定此值,则将改用环境变量 |
|
HSRP接口策略的重载延迟选项。 这仅在 1 到 10000 之间的范围内有效。 |
|
使用 使用 选项
|
|
如果 如果任务中未指定此值,则将使用环境变量 默认值为 警告 - 这会导致之前的返回值为空。 不会检查对象的先前状态,POST更新将包含所有属性。 选项
|
|
如果 如果任务中未指定此值,则将使用环境变量 默认值为 警告 - 这会导致当前返回值设置为建议值。 包含默认值在内的当前对象在一个任务中将无法验证。 选项
|
|
HSRP接口策略所属的租户名称。 |
|
以秒为单位的套接字级别超时。 如果任务中未指定此值,则将使用环境变量 默认值为30。 |
|
如果 如果任务中未指定此值,则将使用环境变量 默认值为true。 选项
|
|
如果 如果任务中未指定此值,则将使用环境变量 当连接是本地连接时,默认值为true。 选项
|
|
用于身份验证的用户名。 如果任务中未指定此值,则将使用环境变量 默认值为admin。 |
|
如果 只有在使用自签名证书的个人控制站点上时,才应将其设置为 如果任务中未指定此值,则将使用环境变量 默认值为true。 选项
|
注释
注意
在您的playbook中使用此模块之前,必须存在
tenant
。可以使用 cisco.aci.aci_tenant 来实现这一点。
另请参见
另请参见
- aci_tenant
关于 **aci_tenant** 模块的官方文档。
- APIC管理信息模型参考
关于内部APIC类 **hsrp:IfPol** 的更多信息。
- Cisco ACI指南
使用Ansible管理您的ACI基础设施的详细信息。
- 开发Cisco ACI模块
关于如何编写您自己的Cisco ACI模块以进行贡献的详细指南。
示例
- name: Add a HSRP interface policy
cisco.aci.aci_interface_policy_hsrp:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
hsrp: hsrp1
controls: bfd
delay: 50
reload_delay: 100
state: present
delegate_to: localhost
- name: Delete a HSRP interface policy
cisco.aci.aci_interface_policy_hsrp:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
hsrp: hsrp1
state: absent
delegate_to: localhost
- name: Query a HSRP interface policy
cisco.aci.aci_interface_policy_hsrp:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
hsrp: hsrp1
state: query
delegate_to: localhost
register: query_result
- name: Query all HSRP interface policies in tenant production
cisco.aci.aci_interface_policy_hsrp:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
state: query
delegate_to: localhost
register: query_result
返回值
常见的返回值已在此处记录,以下是此模块特有的字段
键 |
描述 |
---|---|
模块完成后的APIC现有配置 返回值:成功 示例: |
|
APIC返回的错误信息 返回值:失败 示例: |
|
用于请求的过滤器字符串 返回值:失败或调试 示例: |
|
用于向APIC发出请求的HTTP方法 返回值:失败或调试 示例: |
|
模块启动前APIC中的原始配置 返回值:信息 示例: |
|
用户提供的参数组装的配置 返回值:信息 示例: |
|
APIC REST API返回的原始输出(xml或json) 返回值:解析错误 示例: |
|
来自APIC的HTTP响应 返回值:失败或调试 示例: |
|
实际/最小配置推送到APIC 返回值:信息 示例: |
|
来自APIC的HTTP状态 返回值:失败或调试 示例: |
|
用于向APIC发出请求的HTTP url 返回值:失败或调试 示例: |