使用說明
describePortFwds用於列出一組以上網路地址與連接埠轉換的詳細資訊,有以下幾種方式:
1.不帶任何參數:不會回傳任何資料。
2.帶多個portFwdBusinessServiceId或orderUuid(可混合同時帶入):查詢這兩個參數對應之網路地址與連接埠轉換(無視其他參數),如範例1~3。 注意:此查詢方式不會回傳description、originalIp、translatedIp、originalPort、translatedPort。
3.帶vpcBusinessServiceId:當portFwdBusinessServiceId及orderUuid均為空時,才使用此二參數, 回傳指定VPC平台對應下的網路地址與連接埠轉換,如範例4。注意:此查詢方式不會回傳regionId、businessTag。
Request參數
| 參數 | 說明 | 備註 |
|---|---|---|
| portFwdBusinessServiceId (非必要參數) |
網路地址與連接埠轉換服務識別碼列表 類型 : String 預設值 : 無 是否為複數型態 : 是 |
可支援多值 |
| orderUuid (非必要參數) |
訂單編號 類型 : String 預設值 : 無 是否為複數型態 : 是 |
可支援多值 |
| vpcBusinessServiceId (非必要參數) |
軟體資料中心服務識別碼 類型 : String 預設值 : 無 是否為複數型態 : 否 |
Response參數
| 參數 | 說明 | 備註 |
|---|---|---|
requestId (非必要參數) |
請求識別碼 類型 : JSON value : string 是否為複數型態 : 否 |
系統自動產生 |
| portFwdList |
網路地址與連接埠轉換資訊列表 類型 : JSON value : array 是否為複數型態 : 是 |
PortFwdEntry列表 |
Request範例
範例 1:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describePortFwds
&portFwdBusinessServiceId=VT55020001IOSJ
&portFwdBusinessServiceId=VT55020001IOSW
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
範例 2:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describePortFwds
&orderUuid=031a2e0f-3232-4e9f-9a97-2d50120de7b4
&orderUuid=f51ac698-5f0e-4be5-aa84-9a719b5cfa2d
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
範例 3:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describePortFwds
&portFwdBusinessServiceId=VT55020001IOSJ
&orderUuid=f51ac698-5f0e-4be5-aa84-9a719b5cfa2d
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
範例 4:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describePortFwds
&vpcBusinessServiceId=VV55020001IOSE
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}
Response範例
{
"portFwdList": [
{
"applyDate": "2016-10-01T01:01:01Z",
"businessTag": null,
"description": null,
"endDate": null,
"name": "22",
"orderUuid": "031a2e0f-3232-4e9f-9a97-2d50120de7b4",
"originalIp": "210.61.100.1",
"originalPort": 80,
"portFwdBusinessServiceId": "VT55020001IOSJ",
"provisionMessage": "PROVISION_SUCCESS",
"provisionStatus": "provisionok",
"regionId": null,
"startDate": "2016-10-01T01:01:01Z",
"translatedIp": "192.168.0.1",
"translatedPort": 8080
},
{
"applyDate": "2016-10-01T01:01:01Z",
"businessTag": null,
"description": null,
"endDate": null,
"name": "portFwd_3",
"orderUuid": "f51ac698-5f0e-4be5-aa84-9a719b5cfa2d",
"originalIp": "210.61.100.2",
"originalPort": 90,
"portFwdBusinessServiceId": "VT55020001IOSW",
"provisionMessage": "PROVISION_SUCCESS",
"provisionStatus": "provisionok",
"regionId": null,
"startDate": "2016-10-01T01:01:01Z",
"translatedIp": "172.23.0.2",
"translatedPort": 9090
}
],
"requestId": "2c957f6158674580015867476a020001"
}