用于管理 Web 网关的统一资源标识语法
IBM® MQ Managed File Transfer 统一资源标识 (URI) 与其他 IBM MQ URI 通过部署时指定的上下文根进行区分。 建议使用上下文根 /wmqfte。 用于管理任务的 URI 与现有 IBM MQ Managed File Transfer URI 通过术语 /admin进行区分。
IBM MQ Managed File Transfer 资源通过其类型相互区分。 资源的地址通过其资源类型和标识标记确定。
IBM MQ Managed File Transfer 管理统一资源标识语法图
参数
- 连接名称
- 必需。 托管 Web 网关的服务器的主机名和(可选)端口。 不区分大小写。
- fte
- 必需。 指示该 URI 指向 Web 网关。 区分大小写。
- admin
- 必需。 指示您正在使用 Web 网关的管理功能。 区分大小写。
- filespace
- 指示您要查找文件空间资源的地址。 有关文件空间的更多信息,请参阅 文件空间。 区分大小写。
参数 filespace 或 user 其中之一是必需的。
- 文件空间名称
- 您要查找其地址的文件空间的名称。 这是与文件空间关联的用户的名称。 file_space_name 值的长度必须不超过 255 个字符。 区分大小写。
仅当指定 filespace 时才适用。 如果使用 HTTP 动词 GET,那么该参数可选;如果使用 POST 或 DELETE,那么该参数是必需的。 如果使用 HTTP 动词 GET,并且未提供 file_space_name 的值,那么 Web 网关将返回所有文件空间的列表。
- user
- 指示您要查找 Web 用户标识和 MQMD 用户标识之间映射集的地址。 有关此映射集的格式的更多信息,请参阅 用于将 Web 用户标识映射到 MQMD 用户标识的 XML 格式。 区分大小写。
参数 filespace 或 user 其中之一是必需的。
示例
例如,要查找用户 sarah 拥有的文件空间资源的地址,请使用以下 URI:
http://example.org/wmqfte/admin/filespace/sarah/
在该示例中:
- http://example.org 是主机系统。
- /wmqfte 指示 URI 是 IBM MQ Managed File Transfer URI。
- /admin 指示您要访问 Web 网关的管理功能。
- /filespace 指示要查找地址的资源是文件空间资源。
- /sarah/ 是标识标记。 该标记是文件空间的名称,同时也是拥有该文件空间的用户的名称。
例如,要查找用户标识和 MQMD 标识之间映射的地址,请使用以下 URI:
http://example.org/wmqfte/admin/user
