用于管理 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 管理统一资源标识语法图

读取语法图跳过可视语法图CONNECTION_NAME/ fte/ admin/ filespace/ FILE_SPACE_NAMEuser

参数

连接名称
必需。 托管 Web 网关的服务器的主机名和(可选)端口。 不区分大小写。

fte
必需。 指示该 URI 指向 Web 网关。 区分大小写。

admin
必需。 指示您正在使用 Web 网关的管理功能。 区分大小写。

filespace
指示您要查找文件空间资源的地址。 有关文件空间的更多信息,请参阅 文件空间。 区分大小写。

参数 filespaceuser 其中之一是必需的。

文件空间名称
您要查找其地址的文件空间的名称。 这是与文件空间关联的用户的名称。 file_space_name 值的长度必须不超过 255 个字符。 区分大小写。

仅当指定 filespace 时才适用。 如果使用 HTTP 动词 GET,那么该参数可选;如果使用 POST 或 DELETE,那么该参数是必需的。 如果使用 HTTP 动词 GET,并且未提供 file_space_name 的值,那么 Web 网关将返回所有文件空间的列表。

user
指示您要查找 Web 用户标识和 MQMD 用户标识之间映射集的地址。 有关此映射集的格式的更多信息,请参阅 用于将 Web 用户标识映射到 MQMD 用户标识的 XML 格式。 区分大小写。

参数 filespaceuser 其中之一是必需的。

示例

例如,要查找用户 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