跳转至

创建请求参数列表

语法

  params [--name <name>] [--method <method>] [--delete]

示例

创建一个未命名的请求参数列表

  params

使用请求参数列表发起 HTTP POST

  params
  param mac ${net0/mac}
  param uuid ${uuid}
  param asset ${asset}
  chain http://boot.ipxe.org/demo/boot.php##params

发起一个参数列表为空的 HTTP POST

  params --method POST
  imgfetch http://192.168.0.1/testpost##params

发起一个带自定义头部的 HTTP PUT

  params --method PUT
  param --header X-aws-ec2-metadata-token-ttl-seconds 600
  imgfetch http://169.254.169.254/latest/api/token##params

创建并使用命名请求参数列表

  params --name mydata
  param --params mydata username ${username}
  param --params mydata password ${password}
  imgfetch http://192.168.0.1/auth.cgi##params=mydata

删除一个命名请求参数列表

  params --name mydate --delete

描述

创建一个具有指定名称的请求参数列表。如果没有指定名称,则创建默认的(未命名)请求参数列表。

如果指定了 --method 选项,使用该参数列表的请求会使用这个方法名。

如果指定了 --delete 选项,请求参数列表会被删除。

命令状态

成功 请求参数列表创建成功
失败 请求参数列表未能成功创建

另请参阅

构建选项

此命令仅在启用构建选项 PARAM_CMD 时可用。

备注

在 iPXE 命令指定的 URI 后面追加 ##params,即可把未命名的请求参数列表作为 URI 的一部分引用。例如:

  kernel http://192.168.0.1/boot.cgi##params

在 iPXE 命令指定的 URI 后面追加 ##params=<name>,即可引用命名的请求参数列表。例如:

  imgfetch http://my.web.server/boot/test.php##params=mydata

请求参数列表在被 URI 引用后会自动删除。一般情况下你不需要显式删除请求参数列表。