更新时间:2024-03-30 GMT+08:00

创建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使用逗号分隔。

取值范围:最大长度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(4096)

  • 功能说明:弹性IP的id,多个弹性IP使用逗号分隔。
  • 取值范围:最大长度4096字节。

floating_ip_address

String(1024)

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

status

String

admin_state_up

Boolean

  • 解冻/冻结状态。
  • 开启/关闭状态。
  • 取值范围:
    • “true”:SNAT规则已启动。
    • “false”:SNAT规则已关闭。

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

状态码

请参考状态码