1. 接口描述
本接口(DescribeNatGateway)用于查询 NAT 网关。
接口请求域名:
vpc.api.qcloud.com
2. 输入参数
参数名称 | 必选 | 类型 | 描述 |
natId | 否 | String | NAT网关统一 ID,例如:nat-xx454 |
natName | 否 | String | NAT网关名称 (支持模糊查找) |
vpcId | 否 | String | 私有网络 ID 或统一 ID,建议使用统一 ID,例如:vpc-dfdg42d |
offset | 否 | Int | 初始行的偏移量,默认为0 |
limit | 否 | Int | 每页行数,默认为20,最大支持50 |
orderField | 否 | String | 按某个字段排序,默认不排序。 支持字段:natId |
orderDirection | 否 | String | 升序(asc)或降序(desc),默认:desc |
3. 输出参数
参数名称 | 类型 | 描述 |
code | int | 错误码,0:成功,其他值:失败 |
message | string | 错误信息 |
totalCount | int | 查询的 NAT 网关总数 |
data.n | array | 查询的 NAT 网关信息数组 |
data数据结构如下:
参数名称 | 类型 | 描述 |
data.n.natId | string | NAT网关统一ID,例如:nat-xx454 |
data.n.vpcId | string | 私有网络统一ID,例如:vpc-xgfd55d |
data.n.natName | string | NAT网关名称 |
data.n.state | int | NAT网关状态,0:运行中, 1:不可用, 2:欠费停服 |
data.n.maxConcurrent | int | |
data.n.bandwidth | int | |
data.n.eipCount | string | 弹性 IP 的个数,例如:nat-xx454 |
data.n.eipSet | array | 网关所有弹性IP信息,例如:[183.60.249.11] |
data.n.createTime | string | NAT网关创建时间,例如:2016-06-21 12:01:23 |
data.n.productionStatus | int | NAT网关的生产状态, 0: 创建中, 1: 创建成功, 2: 创建失败, 3: 变更中, 4: 变更失败, 5: 删除中, 6: 删除失败 |
4. 错误码表
错误码 | 描述 |
InvalidVpc.NotFound | |
InvalidNatGatewayId.NotFound |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=DescribeNatGateway&vpcId=vpc-8e0ypm3z
输出
{"code":"0","message":"","totalCount":1,"data": [{"appId": "1351000042","vpcId": "vpc-8e0ypm3z","vpcName": "alblack.bbb1","natId": "nat-dhfpwhtm","natName": "apollan","maxConcurrent": 0,"eipCount": 1,"createTime": "2016-06-21 12:01:23","state": 1,"bandwidth": 90000,"productionStatus": 1,"eipSet": ["183.60.249.11"]}]}