- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 常见问题
- 视频帮助
- 产品术语
-
更多文档
- 用户指南(阿布扎比区域)
- API参考(阿布扎比区域)
- 用户指南(巴黎区域)
- API参考 (巴黎区域)
- 用户指南(吉隆坡区域)
- API参考(吉隆坡区域)
- 用户指南(安卡拉区域)
- API参考(安卡拉区域)
- 通用参考
链接复制成功!
创建SNAT规则
功能介绍
创建SNAT规则。
接口约束
创建规则时,要求网关状态status = ACTIVE,要求网关管理员状态admin_state_up = True
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/snat_rules
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目的ID。 最小长度:1 最大长度:36 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度:1 最大长度:10240 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
snat_rule |
是 |
创建SNAT规则的请求体。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
nat_gateway_id |
是 |
String |
公网NAT网关实例的ID。 最小长度:36 最大长度:36 |
cidr |
否 |
String |
cidr,可以是网段或者主机格式,与network_id参数二选一。 Source_type=0时,cidr必须是vpc 子网网段的子集(不能相等); Source_type=1时,cidr必须指定专线侧网段。 最小长度:9 最大长度:18 |
network_id |
否 |
String |
规则使用的网络id。与cidr参数二选一。 最小长度:36 最大长度:36 |
description |
否 |
String |
SNAT规则的描述,长度范围小于等于255个字符,不能包含“<”和“>”。 最小长度:0 最大长度:255 |
source_type |
否 |
Integer |
0:VPC侧,可以指定network_id 或者cidr 1:专线侧,只能指定cidr 不输入默认为0(VPC) 最小值:0 最大值:1 缺省值:0 |
floating_ip_id |
是 |
String |
功能说明:弹性公网IP的id,多个弹性公网IP使用逗号分隔。 约束:弹性公网IP的id个数不能超过20个。 |
global_eip_id |
否 |
String |
全域弹性公网IP的id。 |
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
snat_rule |
创建SNAT规则的响应体。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
SNAT规则的ID。 最小长度:36 最大长度:36 |
tenant_id |
String |
项目的ID。 最小长度:1 最大长度:36 |
nat_gateway_id |
String |
公网NAT网关实例的ID。 最小长度:36 最大长度:36 |
cidr |
String |
cidr,可以是网段或者主机格式,与network_id参数二选一。 Source_type=0时,cidr必须是vpc 子网网段的子集(不能相等); Source_type=1时,cidr必须指定专线侧网段。 最小长度:9 最大长度:18 |
source_type |
Integer |
0:VPC侧,可以指定network_id 或者cidr 1:专线侧,只能指定cidr 不输入默认为0(VPC) 最小值:0 最大值:1 缺省值:0 |
floating_ip_id |
String |
功能说明:弹性公网IP的id,多个弹性公网IP使用逗号分隔。 |
description |
String |
SNAT规则的描述,长度范围小于等于255个字符,不能包含“<”和“>”。 最小长度:0 最大长度:255 |
status |
String |
SNAT规则的状态。 取值为: "ACTIVE": 可用 "PENDING_CREATE":创建中 "PENDING_UPDATE":更新中 "PENDING_DELETE":删除中 "EIP_FREEZED":EIP冻结 "INACTIVE":不可用 枚举值:
|
created_at |
String |
SNAT规则的创建时间,格式是yyyy-mm-dd hh:mm:ss.SSSSSS。 最小长度:1 最大长度:36 |
network_id |
String |
规则使用的网络id。与cidr参数二选一。 最小长度:36 最大长度:36 |
admin_state_up |
Boolean |
解冻/冻结状态。 取值范围:
|
floating_ip_address |
String |
功能说明:弹性公网IP,多个弹性公网IP使用逗号分隔。 |
global_eip_id |
String |
全域弹性公网IP的id。 |
global_eip_address |
String |
全域弹性公网IP的地址。 |
请求示例
SNAT规则创建的请求体。
POST https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/snat_rules { "snat_rule" : { "nat_gateway_id" : "a78fb3eb-1654-4710-8742-3fc49d5f04f8", "cidr" : "172.30.0.0/24", "source_type" : 1, "floating_ip_id" : "bdc10a4c-d81a-41ec-adf7-de857f7c812a", "description" : "my snat rule 01" } }
响应示例
状态码: 201
创建SNAT规则成功。
{ "snat_rule" : { "floating_ip_id" : "bdc10a4c-d81a-41ec-adf7-de857f7c812a", "status" : "PENDING_CREATE", "nat_gateway_id" : "a78fb3eb-1654-4710-8742-3fc49d5f04f8", "admin_state_up" : true, "cidr" : "172.30.0.0/24", "description" : "", "source_type" : 1, "tenant_id" : "27e25061336f4af590faeabeb7fcd9a3", "created_at" : "2017-11-18 07:54:21.665430", "id" : "5b95c675-69c2-4656-ba06-58ff72e1d338", "floating_ip_address" : "5.21.11.226" } }
状态码
状态码 |
描述 |
---|---|
201 |
创建SNAT规则成功。 |
错误码
请参见错误码。