CaaS / CVPC API 開發者中心

網路地址轉換

使用說明

describeNats用於列出一組以上網路地址轉換的詳細資訊,有以下幾種方式:

1.不帶任何參數:不會回傳任何資料。

2.帶多個natBusinessServiceId或orderUuid(可混合同時帶入):查詢這兩個參數對應之網路地址轉換(無視其他參數),如範例1~3。 注意:此查詢方式不會回傳description、originalIp、translatedIp。

3.帶vpcBusinessServiceId:當natBusinessServiceId及orderUuid均為空時,才使用此二參數, 回傳指定VPC平台對應下的網路地址轉換,如範例4。注意:此查詢方式不會回傳regionId、businessTag。

Request參數

參數 說明 備註
natBusinessServiceId

(非必要參數)

網路地址轉換服務識別碼列表
類型 : String
預設值 : 無
是否為複數型態 : 是
可支援多值
orderUuid

(非必要參數)

訂單編號
類型 : String
預設值 : 無
是否為複數型態 : 是
可支援多值
vpcBusinessServiceId

(非必要參數)

軟體資料中心服務識別碼
類型 : String
預設值 : 無
是否為複數型態 : 否

Response參數

參數 說明 備註

requestId

(非必要參數)

請求識別碼
類型 : JSON value : string
是否為複數型態 : 否
系統自動產生
natList 網路地址轉換資訊列表
類型 : JSON value : array
是否為複數型態 : 是
NatEntry列表

Request範例

範例 1:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeNats
&natBusinessServiceId=VT55020001IOST
&natBusinessServiceId=VT55020001IOSU
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

範例 2:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeNats
&orderUuid=977fbd0a-b8a0-4db6-b373-57e9482d8a28
&orderUuid=f21ce881-402c-4c00-bc6b-149d9e4ffafe
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

範例 3:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeNats
&natBusinessServiceId=VT55020001IOST
&orderUuid=f21ce881-402c-4c00-bc6b-149d9e4ffafe
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

範例 4:
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeNats
&vpcBusinessServiceId=VV55020001IOSE
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

		

Response範例

{
    "natList": [
        {
            "applyDate": "2016-10-01T01:01:01Z",
            "businessTag": null,
            "description": null,
            "endDate": null,
            "name": "nat111",
            "natBusinessServiceId": "VT55020001IOST",
            "orderUuid": "977fbd0a-b8a0-4db6-b373-57e9482d8a28",
            "originalIp": "210.61.223.75",
            "provisionMessage": "PROVISION_SUCCESS",
            "provisionStatus": "provisionok",
            "regionId": null,
            "startDate": "2016-10-01T01:01:01Z",
            "translatedIp": "172.23.0.0"
        },
        {
            "applyDate": "2016-10-01T01:01:01Z",
            "businessTag": null,
            "description": null,
            "endDate": null,
            "name": "nat_hws_223_84",
            "natBusinessServiceId": "VT55020001IOSU",
            "orderUuid": "f21ce881-402c-4c00-bc6b-149d9e4ffafe",
            "originalIp": "210.61.223.84",
            "provisionMessage": "PROVISION_SUCCESS",
            "provisionStatus": "provisionok",
            "regionId": null,
            "startDate": "2016-10-01T01:01:01Z",
            "translatedIp": "192.168.88.88"
        }
    ],
    "requestId": "2c957f6158608b790158609f8005000a"
}
		

相關連結

createNat
deleteNat

錯誤訊息

OrderProcessFail