功能介紹
通過(guò)該接口查詢 專屬主機(jī) 列表。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1.0/{project_id}/dedicated-hosts
參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
|
參數(shù) |
參數(shù)類型 |
是否必選 |
描述 |
|---|---|---|---|
|
project_id |
String |
是 |
項(xiàng)目ID。 獲取方式請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
請(qǐng)求消息
可以在URI中增加如下參數(shù)，來(lái)過(guò)濾查詢結(jié)果：host_type、host_type_name、flavor、dedicated_host_id、state、tenant、availability_zone、name、limit、marker、tags、instance_uuid、released_at、或者changes-since。
例如：/v1.0/{project_id}/dedicated-hosts?host_type={host_type}&state={state}
|
參數(shù) |
位置 |
參數(shù)類型 |
是否必選 |
描述 |
|---|---|---|---|---|
|
dedicated_host_id |
query |
String |
否 |
專屬主機(jī)ID。 |
|
name |
query |
String |
否 |
專屬主機(jī)名稱。 |
|
host_type |
query |
String |
否 |
專屬主機(jī)類型。 |
|
host_type_name |
query |
String |
否 |
專屬主機(jī)類型的名稱。 |
|
flavor |
query |
String |
否 |
規(guī)格ID。 |
|
state |
query |
String |
否 |
專屬主機(jī)狀態(tài)。 取值范圍：“available”、“fault”或“released”。 |
|
tenant |
query |
String |
否 |
取值范圍：租戶ID或“all”。 只有具有DeH管理員權(quán)限的用戶可以指定該參數(shù)。 |
|
availability_zone |
query |
String |
否 |
專屬主機(jī)所屬AZ。 |
|
limit |
query |
String |
否 |
每個(gè)頁(yè)面上顯示的條目數(shù)。 |
|
marker |
query |
String |
否 |
該值是上一頁(yè)最后一條記錄的ID。如果“marker”取值無(wú)效，將會(huì)返回“400”錯(cuò)誤碼。 |
|
tags |
query |
String |
否 |
專屬主機(jī)標(biāo)簽。 |
|
instance_uuid |
query |
String |
否 |
專屬主機(jī)上的 云服務(wù)器 ID。 |
|
released_at |
query |
String |
否 |
專屬主機(jī)的釋放時(shí)間。 |
|
changes-since |
query |
String |
否 |
當(dāng)專屬主機(jī)更新了狀態(tài)時(shí)，按日期和時(shí)間戳過(guò)濾響應(yīng)。為了便于記錄更改，還可能返回最近刪除的專屬主機(jī)。 日期和時(shí)間戳的格式為ISO 8601： CCYY-MM-DDThh:mm:ss±hh:mm 如果包含“hh:mm”值，則將時(shí)區(qū)作為UTC的偏移量返回。例如，“2015-08-27T09:49:58-05:00”。如果您省略時(shí)區(qū)，則假定為UTC時(shí)區(qū)。 |
響應(yīng)消息
|
參數(shù) |
位置 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
dedicated_hosts |
body |
Array of objects |
滿足查詢條件的專屬主機(jī)。 具體請(qǐng)參見(jiàn)表1。 |
|
total |
body |
Integer |
滿足查詢條件的專屬主機(jī)數(shù)量。 |
請(qǐng)求示例
GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts?state=available
響應(yīng)示例
{
"dedicated_hosts": [
{
"dedicated_host_id": "ab910cf0daebca90c4001",
"name": "high performance servers1",
"auto_placement": "off",
"availability_zone": "az1",
"host_properties": {
"vcpus": 36,
"cores": 12,
"sockets": 2,
"memory": 1073741824,
"host_type": "h1",
"host_type_name": "High performance",
"available_instance_capacities": [
{
"flavor": "h1.large"
},
{
"flavor": "h1.2large"
},
{
"flavor": "h1.4large"
},
{
"flavor": "h1.8large"
}
]
},
"state": "available",
"project_id": "9c53a566cb3443ab910cf0daebca90c4",
"available_vcpus": 20,
"available_memory": 1073201821,
"instance_total": 2,
"allocated_at": "2016-10-10T14:35:47Z",
"released_at": null
},
{
"dedicated_host_id": "ab910cf0daebca90c4002",
"name": "high performance servers2",
"auto_placement": "off",
"availability_zone": "az1",
"host_properties": {
"vcpus": 36,
"cores": 12,
"sockets": 2,
"host_type": "h1",
"host_type_name": "High performance",
"memory": 1073741824,
"available_instance_capacities": [
{
"flavor": "h1.large"
},
{
"flavor": "h1.2large"
},
{
"flavor": "h1.4large"
},
{
"flavor": "h1.8large"
}
]
},
"state": "available",
"project_id": "9c53a566cb3443ab910cf0daebca90c4",
"available_vcpus": 20,
"available_memory": 1073101821,
"instance_total": 3,
"allocated_at": "2016-10-10T14:35:47Z",
"released_at": null
},
],
"total": 25
}
返回值
請(qǐng)參見(jiàn)狀態(tài)碼。
