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)