{"base_path":"/","components":null,"consumes":"[\"application/json;charset=UTF-8\"]","definitions":{"RespDedicatedHost":{"description":"专属主机结构体。","properties":{"allocated_at":{"description":"专属主机的分配时间。","type":"string"},"auto_placement":{"description":"在创建云服务器时(未指定专属主机ID),是否允许云服务器自动分配在一台可用的专属主机上。","enum":["on","off"],"type":"string"},"availability_zone":{"description":"专属主机所属的可用区。","type":"string"},"available_memory":{"description":"专属主机可用的内存大小。","format":"int32","type":"integer"},"available_vcpus":{"description":"专属主机可用的vCPU核数。","format":"int32","type":"integer"},"dedicated_host_id":{"description":"专属主机ID。","type":"string"},"host_properties":{"$ref":"#/definitions/RespHostProperty","description":"专属主机属性。"},"instance_total":{"description":"专属主机上的实例总数。","format":"int32","type":"integer"},"instance_uuids":{"description":"专属主机上的实例UUID。\n\n查询专属主机列表接口不显示此参数。","items":{"description":"","type":"string"},"type":"array"},"name":{"description":"专属主机的名称。\n\n长度限制在255个字符以内,并且不能以空格开头或结尾。","maxLength":255,"minLength":1,"type":"string"},"project_id":{"description":"专属主机所属的租户ID。","type":"string"},"released_at":{"description":"专属主机的释放时间。","type":"string"},"state":{"description":"专属主机状态。","enum":["available","released","fault"],"type":"string"},"sys_tags":{"description":"专属主机系统标签。","type":"object"},"tags":{"description":"专属主机标签。","type":"object"}},"required":["allocated_at","auto_placement","availability_zone","available_memory","available_vcpus","dedicated_host_id","host_properties","instance_total","instance_uuids","name","project_id","released_at","state","sys_tags","tags"]},"RespDedicatedHostList":{"description":"专属主机列表响应消息体。","properties":{"dedicated_hosts":{"description":"满足查询条件的专属主机。","items":{"$ref":"#/definitions/RespDedicatedHost","description":""},"type":"array"},"total":{"description":"满足查询条件的专属主机数量。","format":"int32","minimum":0,"type":"integer"}},"required":["dedicated_hosts","total"]},"RespHostProperty":{"description":"专属主机属性。","properties":{"available_instance_capacities":{"description":"专属主机上创建的云服务器规格。","items":{"$ref":"#/definitions/RespInstanceCapacity","description":""},"type":"array"},"cores":{"description":"专属主机的物理核数。","format":"int32","type":"integer"},"host_type":{"description":"专属主机类型。","type":"string"},"host_type_name":{"description":"专属主机类型的名称。","type":"string"},"memory":{"description":"专属主机的物理内存大小。","format":"int32","type":"integer"},"sockets":{"description":"专属主机的物理套接字数量。","format":"int32","type":"integer"},"vcpus":{"description":"专属主机的vCPUs个数。","format":"int32","type":"integer"}},"required":["available_instance_capacities","cores","host_type","host_type_name","memory","sockets","vcpus"]},"RespInstanceCapacity":{"description":"专属主机上创建的云服务器规格。","properties":{"flavor":{"description":"支持创建的云服务器规格。","type":"string"}},"required":["flavor"]}},"description":null,"group_id":"d5f25114875a4aaf874a5fe13e93351c","host":"deh.cn-north-4.myhuaweicloud.com","id":"fb0a4f6e4ce1418a878f6a52dfc438c1","info_version":"v1","method":"get","name":"ListDedicatedHosts","parameters":{},"paths":{"/v1.0/{project_id}/dedicated-hosts":{"get":{"consumes":[],"deprecated":false,"description":"通过该接口查询专属主机列表。","operationId":"ListDedicatedHosts","parameters":[{"description":"项目ID。","in":"path","name":"project_id","required":true,"type":"string","x-order":1},{"description":"专属主机ID。","in":"query","name":"dedicated_host_id","required":false,"type":"string","x-order":2},{"description":"专属主机名称。","in":"query","name":"name","required":false,"type":"string","x-order":3},{"description":"专属主机类型。","in":"query","name":"host_type","required":false,"type":"string","x-order":4},{"description":"专属主机类型的名称。","in":"query","name":"host_type_name","required":false,"type":"string","x-order":5},{"description":"规格ID。","in":"query","name":"flavor","required":false,"type":"string","x-order":6},{"description":"专属主机状态。\n\n取值范围:“available”、“fault”或“released”。","enum":["available","fault","released"],"in":"query","name":"state","required":false,"type":"string","x-admin":"","x-internal":"","x-order":7},{"description":"取值范围:租户ID或“all”。\n\n只有管理员可以指定该参数。","in":"query","name":"tenant","required":false,"type":"string","x-admin":"","x-internal":"","x-order":8},{"description":"专属主机所属AZ。","in":"query","name":"availability_zone","required":false,"type":"string","x-order":9},{"description":"每个页面上显示的条目数。","format":"int32","in":"query","name":"limit","required":false,"type":"integer","x-admin":"","x-internal":"","x-order":10},{"description":"该值是上一页最后一条记录的ID。\n\n如果“marker”取值无效,将会返回“400”错误码。","in":"query","name":"marker","required":false,"type":"string","x-admin":"","x-internal":"","x-order":11},{"description":"专属主机标签。","in":"query","name":"tags","required":false,"type":"string","x-order":12},{"description":"专属主机上的云服务器ID。","in":"query","name":"instance_uuid","required":false,"type":"string","x-order":13},{"description":"专属主机的释放时间。","in":"query","name":"released_at","required":false,"type":"string","x-admin":"","x-internal":"","x-order":14},{"description":"当专属主机更新了状态时,按日期和时间戳过滤响应。为了便于记录更改,还可能返回最近删除的专属主机。\n\n日期和时间戳的格式为ISO 8601:CCYY-MM-DDThh:mm:ss±hh:mm\n\n如果包含“hh:mm”值,则将时区作为UTC的偏移量返回。例如,“2015-08-27T09:49:58-05:00”。如果您省略时区,则假定为UTC时区。","in":"query","name":"changes-since","required":false,"type":"string","x-order":15},{"description":"用户Token。\n\n通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。","in":"header","name":"X-Auth-Token","required":true,"type":"string","x-order":16}],"produces":[],"responses":{"200":{"description":"OK 服务器已成功处理了请求。","examples":{"application/json":{"dedicated_hosts":[{"allocated_at":"2019-06-29T07:50:54Z","auto_placement":"on","availability_zone":"az2.dc2","available_memory":335360,"available_vcpus":71,"dedicated_host_id":"5e296a59-7128-403e-a9c6-50bb82f67525","host_properties":{"available_instance_capacities":[{"flavor":"s1.xlagre"},{"flavor":"m1.medium"},{"flavor":"m1.small"},{"flavor":"m1.large"},{"flavor":"m1.tiny"},{"flavor":"test"},{"flavor":"m1.xlarge"}],"cores":12,"host_type":"general","host_type_name":"General computing","memory":335872,"sockets":2,"vcpus":72},"instance_total":1,"instance_uuids":["18035957-0009-400a-bd76-2b43b496fe39"],"lock":false,"metadata":{},"name":"test","project_id":"5662d7fb3f2a4e2694d7161163a7ffa8","released_at":"","state":"available","sys_tags":{"sys_enterprise_project_id":"0"},"tags":{}}],"total":1}},"schema":{"$ref":"#/definitions/RespDedicatedHostList"}},"400":{"description":"Bad Request 服务器未能处理请求。"},"401":{"description":"Unauthorized 被请求的页面需要用户名和密码。"},"403":{"description":"Forbidden 对被请求页面的访问被禁止。"},"404":{"description":"Not Found 服务器无法找到被请求的页面。"},"500":{"description":"Internal Server Error 请求未完成,服务异常。"}},"summary":"查询专属主机列表","tags":["生命周期管理"],"x-constraint":"","x-first-open-time":"2017-03-30","x-hybridcloud":"false","x-is-registered":"Y","x-name":"查询专属主机列表","x-open-region-cloud":"hc,hk","x-order":2,"x-request-examples-1":"","x-request-examples-description-1":"","x-request-examples-text-1":"","x-request-examples-url-1":"GET /v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts?state=available","x-scope":"Commercial","x-source":"SelfDeveloped","x-support-sdk":"Y"}}},"product_short":"DeH","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"查询专属主机列表","tags":"生命周期管理","uri":null,"version":"2.0"}