ansible.builtin.url 测试 – 字符串是否为有效的 URL
注意
此测试插件是 ansible-core
的一部分,包含在所有 Ansible 安装中。在大多数情况下,您可以使用简短的插件名称 url
。但是,我们建议您使用 完全限定的集合名称 (FQCN) ansible.builtin.url
,以便轻松链接到插件文档,并避免与可能具有相同测试插件名称的其他集合发生冲突。
ansible-core 2.14 中的新增功能
概要
验证字符串是否符合 URL 标准。
输入
这描述了测试的输入,即 is ansible.builtin.url
或 is not ansible.builtin.url
之前的值。
参数 |
注释 |
---|---|
可能的 URL。 |
关键字参数
这描述了测试的关键字参数。这些是在以下示例中的 key1=value1
、key2=value2
等值:input is ansible.builtin.url(key1=value1, key2=value2, ...)
和 input is not ansible.builtin.url(key1=value1, key2=value2, ...)
参数 |
注释 |
---|---|
要验证的 URI 方案的子集,否则任何方案都被视为有效。 |
示例
# simple URL
{{ 'http://example.com' is url }}
# looking only for file transfers URIs
{{ 'mailto://[email protected]' is not uri(schemes=['ftp', 'ftps', 'sftp', 'file']) }}
# but it is according to standard
{{ 'mailto://[email protected]' is not uri }}
# more complex URL
{{ 'ftp://admin:[email protected]/path/to/myfile.yml' is url }}
返回值
键 |
描述 |
---|---|
如果字符串不是 URL,则返回 返回:成功 |