# 创建SNAT规则 #### 功能介绍 创建SNAT规则。 ![](https://support.huaweicloud.com/api-natgateway/public_sys-resources/note_3.0-zh-cn.png) 创建规则时，要求网关状态status = "ACTIVE"，要求网关管理员状态admin_state_up = True。 #### URI POST /v2.0/snat_rules #### 请求消息 请求参数如[表1]所示。 表1请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | snat_rule | 是 | Object | snat_rule对象。详见[表2]。 | 表2snat_rule字段说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | nat_gateway_id | 是 | String | 所属公网NAT网关的id。 | | network_id | 否 | String | 规则使用的网络id。与cidr参数二选一。 | | cidr | 否 | String | cidr，可以是网段或者主机格式，与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 | 功能说明：弹性公网IP的id，多个弹性公网IP的id使用逗号分隔。 取值范围：最大长度4096字节。 约束：弹性公网IP的id个数不能超过20个。 获取弹性公网IP的id的方法请参考[查询弹性公网IP列表](https://support.huaweicloud.com/api-eip/eip_api_0003.html)。 | #### 响应消息 响应参数如[表3]所示。 表3响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | snat_rule | Object | snat_rule对象。详见[表4]。 | 表4snat_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 | - 功能说明：弹性公网IP的id，多个弹性公网IP的id使用逗号分隔。 - 取值范围：最大长度4096字节。 | | floating_ip_address | String | - 功能说明：弹性公网IP，多个弹性公网IP使用逗号分隔。 - 取值范围：最大长度1024字节。 | | status | String | - 功能说明：SNAT规则的状态。 - 取值范围：[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html#nat_api_0042__table1390614366107)。 | | admin_state_up | Boolean | - 解冻/冻结状态。 - 取值范围： - "true"：解冻 - "false"：冻结 | | created_at | String | SNAT规则的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss | #### 示例 - 请求样例 1. VPC 侧指定network_id ``` POST https://{Endpoint}/v2.0/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" } } ``` 2. VPC侧指定CIDR ``` POST https://{Endpoint}/v2.0/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" } } ``` 3. 专线侧 指定CIDR ``` POST https://{Endpoint}/v2.0/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" } } ``` - 响应样例 1. 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", "cidr": null, "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" } } ``` 2. 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", "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" } } ``` 3. 专线侧指定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", "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" } } ``` #### 状态码 请参考[状态码](https://support.huaweicloud.com/api-natgateway/nat_api_0038.html)。