ansible.builtin.uri 测试 - 字符串是否为有效的 URI
注意
此测试插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 uri。但是，我们建议您使用 完全限定的集合名称 (FQCN) ansible.builtin.uri，以方便链接到插件文档，并避免与可能具有相同测试插件名称的其他集合发生冲突。
Ansible 核心 2.14 中的新功能
概要
验证输入字符串是否符合 URI 标准，可选地也在提供的架构列表中。
输入
这描述了测试的输入，即在 is ansible.builtin.uri 或 is not ansible.builtin.uri 之前的值。
参数 |
注释 |
|---|---|
可能的 URI。 |
关键字参数
这描述了测试的关键字参数。这些是在以下示例中 key1=value1、key2=value2 等等的值：input is ansible.builtin.uri(key1=value1, key2=value2, ...) 和 input is not ansible.builtin.uri(key1=value1, key2=value2, ...)
参数 |
注释 |
|---|---|
要验证的 URI 架构子集，否则 **任何** 架构都被认为是有效的。 |
示例
# URLs are URIs
{{ 'http://example.com' is uri }}
# but not all URIs are URLs
{{ 'mailto://[email protected]' is uri }}
# looking only for file transfers URIs
{{ 'mailto://[email protected]' is not uri(schemes=['ftp', 'ftps', 'sftp', 'file']) }}
# make sure URL conforms to the 'special schemas'
{{ 'http://nobody:[email protected]' is uri(['ftp', 'ftps', 'http', 'https', 'ws', 'wss']) }}
返回值
键 |
描述 |
|---|---|
如果字符串不是 URI 或者提取的架构与提供的列表不匹配，则返回 返回：成功 |