创建SNAT规则

功能介绍

创建SNAT规则。

创建规则时，要求网关状态status = "ACTIVE"，要求网关管理员状态admin_state_up = True。

URI

POST /v2/{project_id}/snat_rules

表1 参数说明
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。

请求消息

请求参数如表2所示。

表2 请求参数
参数	是否必选	参数类型	描述
snat_rule	是	Object	snat_rule对象。请参考表3。

表3 snat_rule字段说明
参数	是否必选	参数类型	描述
nat_gateway_id	是	String	NAT网关的id。请参考查询NAT网关列表
network_id	否	String	规则使用的网络id。与cidr参数二选一。
cidr	否	String	可以是网段或者主机格式，与network_id参数二选一。 Source_type=0时，cidr必须是vpc子网网段的子集（不能相等）; Source_type=1时，cidr必须指定专线侧网段。
source_type	否	Integer	0：VPC侧，可以指定network_id或者cidr。 1：专线侧，只能指定cidr。不输入默认为0（VPC）。
floating_ip_id	是	String(4096)	功能说明：弹性公网IP的id，多个弹性公网IP的id使用逗号分隔。取值范围：最大长度4096字节。约束：弹性公网IP的id个数不能超过20个。
description	否	String(255)	SNAT规则的描述。

响应消息

响应参数如表4所示。

表4 响应参数
参数	参数类型	描述
snat_rule	Object	snat_rule对象。请参考表5。

表5 snat_rule字段说明
参数	参数类型	描述
id	String	SNAT规则的id。
tenant_id	String	项目ID。
nat_gateway_id	String	NAT网关的id。
network_id	String	规则使用的网络id。
cidr	String	cidr，vpc子网网段的子集或专线侧网段。
source_type	Integer	0：VPC侧，可以指定network_id或者cidr。 1：专线侧，只能指定cidr。不输入默认为0（VPC）。
floating_ip_id	String(4096)	功能说明：弹性公网IP的id，多个弹性公网IP的id使用逗号分隔。取值范围：最大长度4096字节。
description	String(255)	SNAT规则的描述。
status	String	功能说明：SNAT规则的状态。取值范围：资源状态说明。
admin_state_up	Boolean	解冻/冻结状态。取值范围： “true”：解冻 “false”：冻结
created_at	String	SNAT规则的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss
floating_ip_address	String(1024)	功能说明：弹性公网IP，多个弹性公网IP使用逗号分隔。取值范围：最大长度1024字节。
freezed_ip_address	String(1024)	功能说明：冻结的弹性公网IP，多个冻结的弹性公网IP使用逗号分隔。取值范围：最大长度1024字节。

示例

请求样例

VPC 侧指定network_id

POST https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/snat_rules    
 { 
     "snat_rule": { 
         "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
         "network_id": "eaad9cd6-2372-4be1-9535-9bd37210ae7b", 
         "source_type":0,
         "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
         "description": "my snat rule 01" 
     } 
 }

VPC侧指定CIDR

POST /v2/d199ba7e0ba64899b2e81518104b1526/snat_rules  
 {       
    "snat_rule": { 
          "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
          "cidr": "192.168.1.10/32", 
          "source_type":0, 
          "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
          "description": "my snat rule 01" 
     } 
 }

专线侧指定CIDR

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" 
       } 
   }

响应样例

VPC 侧指定network_id的响应

{ 
     "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, 
         "network_id": "eaad9cd6-2372-4be1-9535-9bd37210ae7b", 
         "description": "",
         "source_type":0, 
         "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"
     } 
 }

VPC 侧指定CIDR的响应

{ 
     "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": "192.168.1.10/32", 
         "description": "",
         "source_type":0, 
         "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"
     } 
 }

专线侧指定CIDR的响应

{ 
     "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"
     } 
 }

状态码

请参考状态码。

父主题： SNAT规则

上一篇：SNAT规则

下一篇：查询SNAT规则列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消