专属主机 DEH-查询专属主机列表:请求消息

时间：2023-12-13 14:20:59

专属主机 DEH API

请求消息

可以在URI中增加如下参数，来过滤查询结果：host_type、host_type_name、flavor、dedicated_host_id、state、tenant、availability_zone、name、limit、marker、tags、instance_uuid、或者changes-since。

例如：/v1.0/{project_id}/dedicated-hosts?host_type={host_type}&state={state}

表2 请求参数
参数	位置	参数类型	是否必选	描述
dedicated_host_id	query	String	否	专属主机ID。
name	query	String	否	专属主机名称。
host_type	query	String	否	专属主机类型。
host_type_name	query	String	否	专属主机类型的名称。
flavor	query	String	否	规格ID。
state	query	String	否	专属主机状态。取值范围：“available”、“fault”或“released”。
tenant	query	String	否	取值范围：租户ID或“all”。只有具有DeH管理员权限的用户可以指定该参数。
availability_zone	query	String	否	专属主机所属AZ。
limit	query	String	否	每个页面上显示的条目数。
marker	query	String	否	该值是上一页最后一条记录的ID。如果“marker”取值无效，将会返回“400”错误码。
tags	query	String	否	专属主机标签。
instance_uuid	query	String	否	专属主机上的云服务器ID。
changes-since	query	String	否	当专属主机更新了状态时，按日期和时间戳过滤响应。为了便于记录更改，还可能返回最近删除的专属主机。日期和时间戳的格式为ISO 8601： CCYY-MM-DDThh:mm:ss±hh:mm 如果包含“hh:mm”值，则将时区作为UTC的偏移量返回。例如，“2015-08-27T09:49:58-05:00”。如果您省略时区，则假定为UTC时区。