文档首页> NAT网关 NAT> API参考> 历史API> API v2.0> SNAT规则> 创建SNAT规则
更新时间：2023-12-14 GMT+08:00
在线调试
CLI示例
查看PDF

创建SNAT规则

功能介绍

创建SNAT规则。

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

URI

POST /v2.0/snat_rules

请求消息

请求参数如表1所示。

表1 请求参数

参数

是否必选

参数类型

描述

snat_rule

是

Object

snat_rule对象。详见表2。
表2 snat_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个。

响应消息

响应参数如表3所示。

表3 响应参数

参数

参数类型

描述

snat_rule

Object

snat_rule对象。详见表4。
表4 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
  • 功能说明：弹性公网IP的id，多个弹性公网IP的id使用逗号分隔。
  • 取值范围：最大长度4096字节。

floating_ip_address

String
  • 功能说明：弹性公网IP，多个弹性公网IP使用逗号分隔。
  • 取值范围：最大长度1024字节。

status

String

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"
    }
}
    1. 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"
      }
  }
    1. 专线侧 指定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"
     } 
 }

状态码

请参考状态码。

父主题： SNAT规则