功能介紹
查詢端口詳情。
調試
您可以在API Explorer中調試該接口。
請求參數(shù)
無
請求示例
GET https://{Endpoint}/v2.0/ports/791870bd-36a7-4d9b-b015-a78e9b06af08
響應參數(shù)
|
屬性 |
類型 |
說明 |
|---|---|---|
|
id |
String |
端口的ID,最大長度不超過255 【使用說明】在查詢端口列表時非必選 |
|
name |
String |
端口的名稱 |
|
network_id |
String |
所屬網(wǎng)絡的ID |
|
admin_state_up |
Boolean |
管理狀態(tài) 【使用說明】默認為true |
|
mac_address |
String |
端口MAC地址,例如:"mac_address": "fa:16:3e:9e:ff:55" 【使用說明】只支持系統(tǒng)動態(tài)分配,不支持指定 |
|
fixed_ips |
端口IP,參見表4。例如:"fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}] |
|
|
device_id |
String |
設備ID 【使用說明】不支持設置和更新,由系統(tǒng)自動維護,該字段非空的端口不允許刪除 |
|
device_owner |
String |
設備所屬(DHCP/Router/ Nova等) 【取值范圍】network:dhcp,network:router_interface_distributed,compute:xxx(xxx對應具體的可用區(qū)名稱,例如compute:aa-bb-cc表示是被可用區(qū)aa-bb-cc上的ECS使用),neutron:VIP_PORT 【使用說明】不支持更新,只允許用戶在創(chuàng)建虛擬IP端口時,為虛擬IP端口設置device_owner為neutron:VIP_PORT,當端口的該字段不為空時,僅支持該字段為neutron:VIP_PORT時的端口刪除。 該字段非空的端口不允許刪除。 |
|
tenant_id |
String |
項目ID |
|
status |
String |
端口狀態(tài),可以為ACTIVE,BUILD,DOWN; 【使用說明】Hana硬直通虛擬機端口狀態(tài)總為DOWN |
|
security_groups |
Array of strings |
擴展屬性:安全組的UUID,例如:"security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"] 【使用說明】不支持更新為空。 |
|
allowed_address_pairs |
擴展屬性:IP/Mac對列表,allow_address_pair參見表5 【使用說明】
|
|
|
extra_dhcp_opts |
||
|
binding:vif_details |
||
|
binding:profile |
binding:profile object |
擴展屬性:提供用戶設置自定義信息 【使用說明】
|
|
binding:vnic_type |
String |
綁定的vNIC類型 normal: 軟交換 |
|
port_security_enabled |
Boolean |
端口安全使能標記,如果不使能則安全組和dhcp防欺騙不生效 |
|
dns_assignment |
擴展屬性:主網(wǎng)卡默認內網(wǎng)域名信息 【使用說明】不支持設置和更新,由系統(tǒng)自動維護
|
|
|
dns_name |
String |
擴展屬性:主網(wǎng)卡默認內網(wǎng)DNS名稱 【使用說明】不支持設置和更新,由系統(tǒng)自動維護,訪問該默認內網(wǎng)域名前,請確保子網(wǎng)使用當前系統(tǒng)提供的DNS |
|
project_id |
String |
項目ID,請參見獲取項目ID。 |
|
created_at |
String |
資源創(chuàng)建時間,UTC時間 格式y(tǒng)yyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
資源更新時間,UTC時間 格式y(tǒng)yyy-MM-ddTHH:mm:ss |
|
屬性 |
類型 |
說明 |
|---|---|---|
|
subnet_id |
String |
所屬子網(wǎng)ID 【使用說明】不支持更新 |
|
ip_address |
String |
端口IP地址 【使用說明】不支持更新 |
|
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
|---|---|---|---|
|
ip_address |
是 |
String |
|
|
mac_address |
否 |
String |
MAC地址 |
響應示例
{
"port": {
"id": "791870bd-36a7-4d9b-b015-a78e9b06af08",
"name": "port-test",
"status": "DOWN",
"admin_state_up": true,
"fixed_ips": [],
"mac_address": "fa:16:3e:01:e0:b2",
"network_id": "00ae08c5-f727-49ab-ad4b-b069398aa171",
"tenant_id": "db82c9e1415a464ea68048baa8acc6b8",
"project_id": "db82c9e1415a464ea68048baa8acc6b8",
"device_id": "",
"device_owner": "",
"security_groups": [
"d0d58aa9-cda9-414c-9c52-6c3daf8534e6"
],
"extra_dhcp_opts": [],
"allowed_address_pairs": [],
"binding:vnic_type": "normal",
"binding:vif_details": {},
"binding:profile": {},
"port_security_enabled": true,
"created_at": "2018-09-13T01:43:41",
"updated_at": "2018-09-13T01:43:41"
}
}
狀態(tài)碼
請參見狀態(tài)碼。
錯誤碼
請參見錯誤碼。
