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

更新NAT网关

功能介绍

更新NAT网关。

admin_state_up = True & status = "ACTIVE"允许更新,支持更新名称、描述、规格

URI

PUT /v2.0/nat_gateways/{nat_gateway_id}

表1 参数说明

参数

参数类型

是否必选

描述

nat_gateway_id

String

所属NAT网关的id。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

nat_gateway

Object

nat_gateway对象。详见表3

必选字段:无,只有name,description和spec字段允许更新,更新操作时至少指定一项属性。

表3 nat_gateway字段说明

参数

是否必选

参数类型

描述

name

String(64)

NAT网关的名字。

NAT网关的名字仅支持数字、字母、_(下划线)、-(中划线)、中文。

description

String(255)

NAT网关的描述。

spec

String

NAT网关的规格。

取值为:

  • “1”:小型,SNAT最大连接数10000
  • “2”:中型,SNAT最大连接数50000
  • “3”:大型,SNAT最大连接数200000
  • “4”:超大型,SNAT最大连接数1000000

响应消息

响应消息如表4所示。

表4 响应参数

参数

参数类型

描述

nat_gateway

Object

nat_gateway对象。详见表5

表5 nat_gateway字段说明

参数

参数类型

描述

id

String

NAT网关的id。

tenant_id

String

项目的ID。

name

String(64)

NAT网关的名字。

NAT网关的名字仅支持数字、字母、_(下划线)、-(中划线)、中文。

description

String(255)

NAT网关的描述。

spec

String

NAT网关的规格。

取值为:

  • “1”:小型,SNAT最大连接数10000
  • “2”:中型,SNAT最大连接数50000
  • “3”:大型,SNAT最大连接数200000
  • “4”:超大型,SNAT最大连接数1000000

router_id

String

路由器的ID。

internal_network_id

String

NAT网关下行口(DVR的下一跳)所属的network id。

status

String

admin_state_up

Boolean

  • 开启/关闭状态。
  • 取值范围:
    • “true”:NAT网关已启动。
    • “false”:NAT网关已关闭。

created_at

String

NAT网关的创建时间戳,遵循UTC时间,保留小数点后6位,格式是yyyy-mm-dd hh:mm:ss

示例

  • 请求样例
    PUT https://{Endpoint}/v2.0/nat_gateways/a78fb3eb-1654-4710-8742-3fc49d5f04f8 
      {
        "nat_gateway": {
            "name": "new_name",
            "description": "new description",
            "spec": "1"
        }
    }
  • 响应样例
    {
        "nat_gateway": {
            "router_id": "d84f345c-80a1-4fa2-a39c-d0d397c3f09a", 
             "status": "ACTIVE", 
             "description": "new description", 
             "admin_state_up": true, 
             "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
             "created_at": "2017-11-18 07:34:32.203044", 
             "spec": "1", 
             "internal_network_id": "89d66639-aacb-4929-969d-07080b0f9fd9", 
             "id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8",
             "name": "new_name"
        }
    } 

状态码

请参考状态码