CaaS / CVPC API 開發者中心

網路地址轉換

使用說明

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"
}
		

錯誤訊息

OrderProcessFail