community.network.netscaler_cs_policy 模块 – 管理内容切换策略

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.network。您需要满足其他要求才能使用此模块，请参阅 要求 以了解详情。

要在playbook中使用它，请指定： community.network.netscaler_cs_policy。

注意

community.network 集合已弃用，并将从 Ansible 12 中移除。请参阅 讨论主题 以了解更多信息。

已弃用

在以下版本中移除：

6.0.0版本

原因：

此集合及其中的所有内容均未维护且已弃用。

替代方案：

未知。

概要

  • 管理内容切换策略。

  • 此模块旨在运行于 Ansible 控制节点或具有访问实际 Netscaler 实例权限的堡垒机（跳板机）上。

别名：network.netscaler.netscaler_cs_policy

要求

执行此模块的主机需要以下要求。

  • nitro python sdk

参数

参数

注释

action

字符串

内容切换操作，命名将流量切换到的目标负载均衡虚拟服务器。

domain

字符串

域名。字符串值可以长达 63 个字符。

最小长度 = 1

nitro_pass

字符串 / 必需

用于向 Netscaler 节点进行身份验证的密码。

nitro_protocol

字符串

访问 nitro API 对象时使用的协议。

选项

  • "http" ← (默认)

  • "https"

nitro_timeout

浮点数

与 Netscaler 建立新会话时抛出超时错误之前的时间（秒）

默认值： 310.0

nitro_user

字符串 / 必需

用于向 Netscaler 节点进行身份验证的用户名。

nsip

字符串 / 必需

将进行 nitro API 调用的 Netscaler 设备的 IP 地址。

可以使用冒号 (:) 指定端口。例如 192.168.1.1:555。

policyname

字符串

内容切换策略的名称。必须以 ASCII 字母数字或下划线 _ 字符开头，并且只能包含 ASCII 字母数字、下划线、哈希 #、句点 .、空格 、冒号 :、at 符号 @、等号 = 和连字符 - 字符。创建策略后无法更改。

以下要求仅适用于 NetScaler CLI

如果名称包含一个或多个空格，请将名称括在双引号或单引号中（例如，my policy 或 'my policy'）。

最小长度 = 1

rule

字符串

表达式，或命名表达式的名称，根据该表达式评估流量。使用经典或默认语法编写。

注意

表达式中字符串字面量的最大长度为 255 个字符。较长的字符串可以拆分为最多 255 个字符的较小字符串，然后使用 + 运算符将较小字符串连接起来。例如，您可以创建 500 个字符的字符串，如下所示：’“<255 个字符的字符串>” + “<245 个字符的字符串>”’

save_config

布尔值

如果为 yes，则如果模块进行了任何更改，它将保存 Netscaler 节点上的配置。

如果模块没有进行任何更改，则不会保存 Netscaler 节点上的配置。

选项

  • false

  • true ← (默认)

state

字符串

模块在 Netscaler 节点上配置的资源的状态。

如果存在，则根据模块的参数创建所需资源并进行配置。

如果不存在，则将资源从 Netscaler 节点删除。

选项

  • "absent"

  • "present" ← (默认)

url

字符串

与请求 URL 匹配的 URL 字符串。可以包含通配符。请按照以下格式指定字符串值：[[prefix] [*]] [.suffix]。

最小长度 = 1

最大长度 = 208

validate_certs

布尔值

如果为no，则不会验证 SSL 证书。此选项仅应用于使用自签名证书的个人控制站点。

选项

  • false

  • true ← (默认)

备注

注意

示例

- name: Create url cs policy
  delegate_to: localhost
  community.network.netscaler_cs_policy:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot
    validate_certs: false

    state: present

    policyname: policy_1
    url: /example/

返回值

常用返回值已在 此处 记录，以下是此模块特有的字段

键

描述

diff

字典

实际配置对象与模块中指定的配置之间的差异列表

返回：失败

示例：{"url": "difference. ours: (str) example1 other: (str) /example1"}

loglines

列表 / 元素=字符串

模块记录的消息列表

返回：始终

示例：["message 1", "message 2"]

msg

字符串

详细说明失败原因的消息

返回：失败

示例："Could not load nitro python sdk"

状态

  • 此模块将在 6.0.0 版本中移除。[已弃用]

  • 更多信息请参见 已弃用。

作者

  • George Nikolopoulos (@giorgos-nikolopoulos)