如何在Ansible Python模块代码中访问任务参数及检测register？

可以实现，但不能直接访问任务的register参数——因为register是Ansible控制节点处理的任务级关键字，不会被传递到目标主机上执行的模块进程中。不过有两种间接方案满足你的需求：

方法1：新增自定义模块参数显式控制 #

这是最可靠、符合Ansible设计规范的方式：在模块中新增一个标记参数（比如return_full_info），调用模块时手动设置该参数，模块内部根据参数值决定是否返回完整信息集。

示例模块代码片段：

from ansible.module_utils.basic import AnsibleModule

def main():
    module_args = dict(
        # 模块原有业务参数
        target=dict(type='str', required=True),
        # 新增控制返回内容的标记参数
        return_full_info=dict(type='bool', default=False)
    )

    module = AnsibleModule(
        argument_spec=module_args,
        supports_check_mode=True
    )

    result = dict(
        changed=False,
        basic_data="基础返回内容"
    )

    # 根据标记判断是否追加完整信息
    if module.params['return_full_info']:
        result['detailed_data'] = {
            "extra_field1": "详细内容1",
            "extra_field2": "详细内容2"
        }

    module.exit_json(**result)

if __name__ == '__main__':
    main()

调用模块的Playbook示例：

- name: 调用自定义模块并获取完整信息
  custom_module:
    target: test_server
    return_full_info: yes
  register: module_output

方法2：控制端模块读取环境变量（仅限特定场景） #

如果你的模块是在控制节点执行的（比如用local_action或delegate_to: localhost），可以读取环境变量ANSIBLE_MODULE_ARGS——这个变量包含了任务传递给模块的原始参数。但注意：register不属于模块参数，不会出现在这个变量里，只能通过这种方式获取其他任务参数，结合业务场景间接推断是否可能被register。

这种方式依赖控制端环境，不是官方推荐方案，兼容性较差，不建议用于通用模块。

核心说明 #

• register的作用是在控制节点捕获模块返回结果，它本身不会被传递给模块，因此模块无法直接检测任务是否设置了该关键字。
• 优先选择方法1，通过显式参数控制返回内容，代码更清晰、可维护性更强。

内容的提问来源于stack exchange，提问作者mooky