可扩展的模块开发argument_spec规范

Question

在阅读Ansible Module Development时，我没有看到任何关于argument_spec规范应该是什么的引用。我想我应该查看代码库，看看argument_spec是否有文档记录，但是GitHub ansible/ansible basic.py文件在参数规范方面没有太多内容。里面应该有什么？我能找到的最接近的地方是一个较旧的文档显示了Ansible 2.3 Dev Guide中的这段代码

module = AnsibleModule(
   argument_spec = dict(
       state     = dict(default='present', choices=['present', 'absent']),
       name      = dict(required=True),
       enabled   = dict(required=True, type='bool'),
       something = dict(aliases=['whatever'])
   )
)

假设完整的argument_spec规范是

module = AnsibleModule(
    argument_spec = {
        default  = 'default_value',
        type     = 'str',
        required = True,
        aliases  = ['dv', 'value'],
        choices  = ['default_value', 'strings', 'test']
    }
)

Answer 1

在文档https://docs.ansible.com/ansible/latest/dev_guide/developing_program_flow_modules.html#argument-spec中有或多或少完整的参数规范描述。

在编写本文时，可用字段有：type, elements, default, fallback, choices, required, no_log, aliases, options, apply_defaults, removed_in_version.