使用說明
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"
}