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