4.3 SNAT 规则
4.3.1 查询 SNAT 规则列表
"floating_ip_id" : "cf99c679-9f41-4dac-8513-9c9228e713e1", "status" : "ACTIVE",
"nat_gateway_id" : "dda3a125-2406-456c-a11f-598e10578541", "admin_state_up" : true,
"port_id" : "",
"private_ip" : "192.168.1.100", "internal_service_port" : 0, "protocol" : "any",
"tenant_id" : "d199ba7e0ba64899b2e81518104b1526", "created_at" : "2019-11-15 15:44:42.595173",
"id" : "79195d50-0271-41f1-bded-4c089c2502ff", "floating_ip_address" : "5.21.11.227",
"external_service_port" : 0, "description" : "my dnat rule 01"
} ] }
状态码
状态码 描述
201 POST操作正常返回。
错误码
请参见错误码。
4.3 SNAT 规则
4.3.1 查询 SNAT 规则列表
功能介绍
查询SNAT规则列表。
接口约束
可以在URI后面用'?'和'&'添加不同的查询条件组合。支持参数说明中所有非必选参数过 滤，请参考请求样例。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/{project_id}/snat_rules
表4-53 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目的ID。
最小长度：1 最大长度：36
获取方法详见获取项目ID。
表4-54 Query 参数
参数 是否必选 参数类型 描述
admin_state_
up 否 Boolean 解冻/冻结状态。取值范围：
"true"：解冻 "false"：冻结
cidr 否 String 可以是网段或者主机格式，与
network_id参数二选一。
source_type=0时，cidr必须是 vpc子网网段的子集（不能相 等）; source_type=1时，cidr必 须指定专线侧网段。
limit 否 Integer 功能说明：每页返回的个数。取
值范围：0~2000。默认值：
2000。
最小值：1 最大值：2000 缺省值：2000 floating_ip_ad
dress 否 String 功能说明：弹性公网IP，多个弹
性公网IP使用逗号分隔。取值范 围：最大长度1024字节。
floating_ip_id 否 String 功能说明：弹性公网IP的id，多 个弹性公网IP的id使用逗号分 隔。取值范围：最大长度4096 字节。
id 否 String SNAT规则的ID。
最小长度：1 最大长度：36
description 否 String SNAT规则的描述，长度限制为 255。
参数 是否必选 参数类型 描述
created_at 否 String SNAT规则的创建时间，遵循 UTC时间，格式是yyyy-mm-ddThh:mm:ssZ。
最小长度：1 最大长度：36 nat_gateway_i
d 否 Array 公网NAT网关实例的ID。
network_id 否 String 规则使用的网络id。与cidr参数 二选一。
source_type 否 Integer 0：VPC侧，可以指定 network_id 或者cidr 1：专线侧，只能指定cidr 缺省值：0
status 否 String 功能说明：SNAT规则的状态。
枚举值：
● ACTIVE
● PENDING_CREATE
● PENDING_UPDATE
● PENDING_DELETE
● EIP_FREEZED
● INACTIVE
请求参数
表4-55 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。用户Token也就是 调用获取用户Token获取请求认 证接口的响应值，该接口是唯一 不需要认证的接口。请求响应成 功后在响应消息头中包含的“X-Subject-Token”的值即为Token 值。
最小长度：1 最大长度：10240
响应参数
状态码： 200
表4-56 响应 Body 参数
参数 参数类型 描述
snat_rules Array of NatGateway SnatRuleRes ponseBody objects
查询SNAT规则列表的响应体。
表4-57 NatGatewaySnatRuleResponseBody
参数 参数类型 描述
id String SNAT规则的ID。
长度：36 tenant_id String 项目的ID。
nat_gateway_i
d String 公网NAT网关实例的ID。
长度：36
cidr String cidr，可以是网段或者主机格式，与network_id 参数二选一。source_type=0时，cidr必须是vpc 子网网段的子集（不能相等）;
source_type=1时，cidr必须指定专线侧网段。
最小长度：9 最大长度：39
source_type Integer 0：VPC侧，可以指定network_id 或者cidr 1：专线侧，只能指定cidr
缺省值：0
floating_ip_id String 功能说明：弹性公网IP的id，多个弹性公网IP使用 逗号分隔。取值范围：最大长度4096字节。
description String SNAT规则的描述，长度限制为255。
最大长度：255
参数 参数类型 描述
status String 功能说明：SNAT规则的状态。
枚举值：
● ACTIVE
● PENDING_CREATE
● PENDING_UPDATE
● PENDING_DELETE
● EIP_FREEZED
● INACTIVE
created_at String SNAT规则的创建时间，遵循UTC时间，格式是 yyyy-mm-ddThh:mm:ssZ。
最小长度：1 最大长度：36
network_id String 规则使用的网络id。与cidr参数二选一。
长度：36 admin_state_
up Boolean 解冻/冻结状态。取值范围：
● "true"：解冻
● "false"：冻结 floating_ip_ad
dress String 功能说明：弹性公网IP，多个弹性公网IP使用逗 号分隔。取值范围：最大长度1024字节。
freezed_ip_ad
dress String 功能说明：冻结的弹性公网IP，多个冻结的弹性 公网IP使用逗号分隔。取值范围：最大长度1024 字节。
请求示例
GET https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/snat_rules?limit=2
响应示例
状态码： 200
查询SNAT规则列表成功。
{ "snat_rules" : [ {
"floating_ip_id" : "bf99c679-9f41-4dac-8513-9c9228e713e1", "status" : "ACTIVE",
"nat_gateway_id" : "cda3a125-2406-456c-a11f-598e10578541", "admin_state_up" : true,
"network_id" : "9a469561-daac-4c94-88f5-39366e5ea193", "source_type" : 0,
"tenant_id" : "d199ba7e0ba64899b2e81518104b1526", "created_at" : "2017-11-15 15:44:42.595173",
"id" : "79195d50-0271-41f1-bded-4c089b2502ff",
"floating_ip_address" : "5.21.11.242", "freezed_ip_address" : "",
"description" : "my snat rule 01"
}, {
"floating_ip_id" : "6e496fba-abe9-4f5e-9406-2ad8c809ac8c", "status" : "ACTIVE",
"nat_gateway_id" : "e824f1b4-4290-4ebc-8322-cfff370dbd1e", "admin_state_up" : true,
"network_id" : "97e89905-f9c8-4ae3-9856-392b0b2fbe7f", "source_type" : 0,
"tenant_id" : "d199ba7e0ba64899b2e81518104b1526", "created_at" : "2017-11-17 07:43:44.830845",
"id" : "4a1a10d7-0d9f-4846-8cda-24cffeffef5c", "floating_ip_address" : "5.21.11.142,5.21.11.143", "freezed_ip_address" : "5.21.11.142",
"description" : "my snat rule 01"
} ] }
状态码
状态码 描述
200 查询SNAT规则列表成功。
错误码
请参见错误码。