华为云用户手册

响应示例 状态码： 200 查询操作成功。 示例1：action为count时的响应体 示例2：action为filter时的响应体 示例 1 { "request_id" : "a67262f6b7242d63d4ae95e41abf2790", "total_count" : 100 } 示例 2 { "resources" : [ { "resource_detail" : null, "resource_id" : "e5ad289f-9c56-4daf-b08b-2e53a983473a", "resource_name" : "nat_gateways", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value1" } ] } ], "request_id" : "a67262f6b7242d63d4ae95e41abf2790", "total_count" : 1 }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 resources Array of Resource objects 资源列表。 数组长度：1 - 2000 request_id String 请求id。 最小长度：1 最大长度：36 total_count Integer 总记录数。 表7 Resource 参数 参数类型 描述 resource_detail Object 资源详情。用于扩展。默认为空。 resource_id String 资源的ID。 最小长度：36 最大长度：36 resource_name String 资源名称，资源没有名称时默认为空字符串。 最小长度：0 最大长度：36 resource_tag Array of ResourceTag objects 标签列表，没有标签默认为空数组。 数组长度：1 - 10 表8 ResourceTag 参数 参数类型 描述 key String 标签key值。 最小长度：1 最大长度：128 value String 标签value。 最小长度：0 最大长度：255

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：1 最大长度：10240 表3 请求Body参数 参数 是否必选 参数类型 描述 offset 否 String 索引位置， 从offset指定的下一条数据开始查询。 查询第一页数据时，不需要传入此参数，查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数（action为count时无此参数）如果action为filter默认为0，必须为数字，不能为负数。 最小长度：0 最大长度：65535 limit 否 String 查询记录数（action为count时无此参数）如果action为filter默认为1000，limit最多为1000,不能为负数，最小值为1。 最小长度：1 最大长度：1000 action 是 String 操作标识（仅限于filter，count）：filter（过滤），count(查询总条数) 如果是filter就是分页查询，如果是count只需按照条件将总条数返回即可。 枚举值： filter count matches 否 Array of Match objects 搜索字段,key为要匹配的字段，如resource_name等。value为匹配的值。此字段为固定字典值。 根据不同的字段确认是否需要模糊匹配，如resource_name默认为模糊搜索（不区分大小写），如果value为空字符串精确匹配。resource_id为精确匹配。第一期只做resource_name，后续在扩展。 not_tags 否 Array of Tags objects 不包含标签，最多包含10个key，每个key下面的value最多10个, 结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回不包含标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。无过滤条件时返回全量数据。 数组长度：1 - 10 tags 否 Array of Tags objects 包含标签，最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回包含所有标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。无tag过滤条件时返回全量数据。 数组长度：1 - 10 tags_any 否 Array of Tags objects 包含任意标签，最多包含10个key，每个key下面的value最多10个,结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回包含任意标签的资源列表，key之间是或的关系，key-value结构中value是或的关系。无过滤条件时返回全量数据。 数组长度：1 - 10 not_tags_any 否 Array of Tags objects 不包含任意标签，最多包含10个key，每个key下面的value最多10个,结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。返回不包含任意标签的资源列表，key之间是或的关系，key-value结构中value是或的关系。无过滤条件时返回全量数据。 数组长度：1 - 10 表4 Match 参数 是否必选 参数类型 描述 key 是 String 搜索条件key值。 最小长度：1 最大长度：128 value 是 String 搜索条件value。 最小长度：0 最大长度：255 表5 Tags 参数 是否必选 参数类型 描述 key 是 String 键。最大长度128个unicode字符。搜索时不对此参数做校验，key不能为空或者空字符串，不能为空格，校验和使用之前先trim 前后空格。 最小长度：1 最大长度：128 values 是 Array of strings 值列表。每个值最大长度255个unicode字符。 最小长度：0 最大长度：255

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 transit_ip TransitIp object 中转子网IP的响应体。 request_id String 请求ID。 最小长度：1 最大长度：36 表4 TransitIp 参数 参数类型 描述 id String 中转IP的ID。 最小长度：36 最大长度：36 project_id String 项目的ID。 最小长度：1 最大长度：36 network_interface_id String 中转IP的网络接口ID。 最小长度：36 最大长度：36 ip_address String 中转IP的地址。 最小长度：7 最大长度：35 created_at String 中转IP的创建时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ 最小长度：1 最大长度：36 updated_at String 中转IP的更新时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ 最小长度：1 最大长度：36 virsubnet_id String 当前租户子网的ID。 最小长度：0 最大长度：36 tags Array of Tag objects 标签列表。 数组长度：1 - 10 gateway_id String 中转IP绑定的 私网NAT网关 实例的ID。 最小长度：36 最大长度：36 enterprise_project_id String 企业项目ID。创建中转IP时，关联的企业项目ID。 最小长度：1 最大长度：36 表5 Tag 参数 参数类型 描述 key String 标签key值。 最小长度：1 最大长度：128 value String 标签value。 最小长度：0 最大长度：255

响应示例 状态码： 200 查询指定中转IP成功。 { "transit_ip" : { "id" : "a2845109-3b2f-4627-b08f-09a726c0a6e7", "project_id" : "da261828016849188f4dcc2ef94d9da9", "network_interface_id" : "adebbdca-8c26-4c14-b34f-3f53cd2c42f2", "ip_address" : "192.168.1.68", "gateway_id" : "521bb3d9-8bed-4c6c-9ee8-669bd0620f76", "enterprise_project_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "created_at" : "2019-04-29T02:16:09", "updated_at" : "2019-04-29T02:16:09", "virsubnet_id" : "49ee5fb5-75bf-4320-946e-b21ef4c9c9c1", "tags" : [ { "key" : "key1", "value" : "value1" } ] }, "request_id" : "747a911c17067a39692f75ac146fb47e" }

响应示例 状态码： 200 查询公网NAT网关实例列表成功 { "nat_gateways" : [ { "id" : "a253be25-ae7c-4013-978b-3c0785eccd63", "router_id" : "b1d81744-5165-48b8-916e-e56626feb88f", "status" : "ACTIVE", "description" : "nat01", "admin_state_up" : true, "tenant_id" : "27e25061336f4af590faeabeb7fcd9a3", "created_at" : "2017-11-15 14:50:39.505112", "spec" : "2", "internal_network_id" : "5930796a-6026-4d8b-8790-6c6bfc9f87e8", "name" : "wj3", "enterprise_project_id" : "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "billing_info" : "", "dnat_rules_limit" : 200, "snat_rule_public_ip_limit" : 20, "ngport_ip_address" : "192.168.0.138" }, { "id" : "e824f1b4-4290-4ebc-8322-cfff370dbd1e", "router_id" : "305dc52f-13dd-429b-a2d4-444a1039ba0b", "status" : "ACTIVE", "description" : "1234", "admin_state_up" : true, "tenant_id" : "27e25061336f4af590faeabeb7fcd9a3", "created_at" : "2017-11-17 07:41:07.538062", "spec" : "2", "internal_network_id" : "fc09463b-4ef8-4c7a-93c8-92d9ca6daf9d", "name" : "lyl001", "enterprise_project_id" : "0", "billing_info" : "", "dnat_rules_limit" : 200, "snat_rule_public_ip_limit" : 20, "ngport_ip_address" : "192.168.5.210" } ] }

URI DELETE /v3/{project_id}/transit-ips/{resource_id}/tags/{key} 表1 路径参数 参数 是否必选 参数类型 描述 key 是 String 标签key。 最小长度：1 最大长度：128 project_id 是 String 项目的ID。 最小长度：1 最大长度：32 resource_id 是 String 中转IP的ID。 最小长度：36 最大长度：36

响应示例 状态码： 200 查询DNAT规则成功。 { "dnat_rule" : { "floating_ip_id" : "bf99c679-9f41-4dac-8513-9c9228e713e1", "status" : "ACTIVE", "nat_gateway_id" : "cda3a125-2406-456c-a11f-598e10578541", "admin_state_up" : true, "port_id" : "9a469561-daac-4c94-88f5-39366e5ea193", "private_ip" : "", "internal_service_port" : 993, "protocol" : "tcp", "tenant_id" : "d199ba7e0ba64899b2e81518104b1526d", "created_at" : "2017-11-15 15:44:42.595173", "id" : "5b95c675-69c2-4656-ba06-58ff72e1d338", "floating_ip_address" : "5.21.11.226", "external_service_port" : 242, "description" : "my dnat rule 01" } }

响应参数 状态码： 201 表6 响应Body参数 参数 参数类型 描述 transit_ip TransitIp object 中转子网IP的响应体。 request_id String 请求ID。 最小长度：1 最大长度：36 表7 TransitIp 参数 参数类型 描述 id String 中转IP的ID。 最小长度：36 最大长度：36 project_id String 项目的ID。 最小长度：1 最大长度：36 network_interface_id String 中转IP的网络接口ID。 最小长度：36 最大长度：36 ip_address String 中转IP的地址。 最小长度：7 最大长度：35 created_at String 中转IP的创建时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ 最小长度：1 最大长度：36 updated_at String 中转IP的更新时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ 最小长度：1 最大长度：36 virsubnet_id String 当前租户子网的ID。 最小长度：0 最大长度：36 tags Array of Tag objects 标签列表。 数组长度：1 - 10 gateway_id String 中转IP绑定的私网NAT网关实例的ID。 最小长度：36 最大长度：36 enterprise_project_id String 企业项目ID。创建中转IP时，关联的企业项目ID。 最小长度：1 最大长度：36 表8 Tag 参数 参数类型 描述 key String 标签key值。 最小长度：1 最大长度：128 value String 标签value。 最小长度：0 最大长度：255

请求示例 创建中转IP，其中，当前项目子网的id为2759da7b-8015-404c-ae0a-a389007b0e2a，中转IP地址为192.168.1.68，创建中转IP时，关联的企业项目id为2759da7b-8015-404c-ae0a-a389007b0e2a。 POST https://{Endpoint}/v3/da261828016849188f4dcc2ef94d9da9/private-nat/transit-ips { "transit_ip" : { "virsubnet_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "enterprise_project_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "ip_address" : "192.168.1.68", "tags" : [ { "key" : "key1", "value" : "value1" } ] } }

响应示例 状态码： 201 创建中转IP成功。 { "transit_ip" : { "id" : "a2845109-3b2f-4627-b08f-09a726c0a6e7", "project_id" : "da261828016849188f4dcc2ef94d9da9", "network_interface_id" : "adebbdca-8c26-4c14-b34f-3f53cd2c42f2", "ip_address" : "192.168.1.68", "gateway_id" : "521bb3d9-8bed-4c6c-9ee8-669bd0620f76", "enterprise_project_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "created_at" : "2019-04-29T02:16:09", "updated_at" : "2019-04-29T02:16:09", "virsubnet_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "tags" : [ { "key" : "key1", "value" : "value1" } ] }, "request_id" : "747a911c17067a39692f75ac146fb47e" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：1 最大长度：512 表3 请求Body参数 参数 是否必选 参数类型 描述 transit_ip 是 CreatTransitIpOption object 创建中转IP的请求体。 表4 CreatTransitIpOption 参数 是否必选 参数类型 描述 virsubnet_id 是 String 当前项目子网的ID。 最小长度：1 最大长度：36 ip_address 否 String 中转IP地址。 最小长度：7 最大长度：35 enterprise_project_id 否 String 企业项目ID。创建中转IP时，关联的企业项目ID。 缺省值：0 最小长度：1 最大长度：36 tags 否 Array of Tag objects 标签 数组长度：0 - 2000 表5 Tag 参数 是否必选 参数类型 描述 key 是 String 标签key值。 最小长度：1 最大长度：128 value 是 String 标签value。 最小长度：0 最大长度：255

响应示例 状态码： 200 查询DNAT规则列表成功。 { "dnat_rules" : [ { "floating_ip_id" : "bf99c679-9f41-4dac-8513-9c9228e713e1", "status" : "ACTIVE", "nat_gateway_id" : "cda3a125-2406-456c-a11f-598e10578541", "admin_state_up" : true, "port_id" : "9a469561-daac-4c94-88f5-39366e5ea193", "private_ip" : "", "internal_service_port" : 993, "protocol" : "tcp", "tenant_id" : "d199ba7e0ba64899b2e81518104b1526d", "created_at" : "2017-11-15 15:44:42.595173", "id" : "79195d50-0271-41f1-bded-4c089b2502ff", "floating_ip_address" : "5.21.11.226", "external_service_port" : 242, "description" : "my dnat rule 01" }, { "floating_ip_id" : "cf99c679-9f41-4dac-8513-9c9228e713e1", "status" : "ACTIVE", "nat_gateway_id" : "dda3a125-2406-456c-a11f-598e10578541", "admin_state_up" : true, "port_id" : "", "private_ip" : "192.168.1.100", "internal_service_port" : 0, "protocol" : "any", "tenant_id" : "d199ba7e0ba64899b2e81518104b1526d", "created_at" : "2017-11-16 15:44:42.595173", "id" : "89195d50-0271-41f1-bded-4c089b2502ff", "floating_ip_address" : "5.21.11.227", "external_service_port" : 0, "description" : "my dnat rule 01" } ] }

响应示例 状态码： 200 查询SNAT规则成功。 { "snat_rule" : { "floating_ip_id" : "bdc10a4c-d81a-41ec-adf7-de857f7c812a", "status" : "ACTIVE", "nat_gateway_id" : "a78fb3eb-1654-4710-8742-3fc49d5f04f8", "admin_state_up" : true, "network_id" : "eaad9cd6-2372-4be1-9535-9bd37210ae7b", "source_type" : 0, "tenant_id" : "d199ba7e0ba64899b2e81518104b1526", "created_at" : "2017-11-18 07:54:21.665430", "id" : "5b95c675-69c2-4656-ba06-58ff72e1d338", "floating_ip_address" : "5.21.11.226", "freezed_ip_address" : "", "description" : "my snat rule 01" } }

请求示例 SNAT规则创建的请求体。 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" } }

响应示例 状态码： 201 创建SNAT规则成功。 { "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" } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：1 最大长度：10240 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 功能说明：操作标识。 取值范围： create（创建） delete（删除） 枚举值： create delete tags 是 Array of Tag objects 标签列表。 数组长度：1 - 10 表4 Tag 参数 是否必选 参数类型 描述 key 是 String 键。最大长度128个unicode字符。key不能为空。 最小长度：1 最大长度：128 value 是 String 值。每个值最大长度255个unicode字符。 最小长度：0 最大长度：255

请求示例 批量添加中转IP标签，其中，操作标识为create，标签列表中包含两个标签，其中第一个标签键为“key1”，对应的值为“value1”，第二个标签键为“key2”，对应的值为“value2”。 POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/transit-ips/56121618-fb0a-4a51-aff0-e2eb9cba4c73/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] } 批量删除中转IP标签，其中，操作标识为delete，标签列表中包含两个标签，其中第一个标签键为“key1”，对应的值为“value1”，第二个标签键为“key2”，对应的值为“value2”。 POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/transit-ips/56121618-fb0a-4a51-aff0-e2eb9cba4c73/tags/action { "action" : "delete", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] }

请求示例 添加中转IP标签，其中，标签键为“key1”，对应的值为“value1”。 POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/transit-ips/56121618-fb0a-4a51-aff0-e2eb9cba4c73/tags { "tag" : { "key" : "key1", "value" : "value1" } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：1 最大长度：10240 表3 请求Body参数 参数 是否必选 参数类型 描述 tag 是 Tag object 标签。 表4 Tag 参数 是否必选 参数类型 描述 key 是 String 键。最大长度128个unicode字符。key不能为空。 最小长度：1 最大长度：128 value 是 String 值。每个值最大长度255个unicode字符。 最小长度：0 最大长度：255

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 transit_ips Array of TransitIp objects 查询中转IP列表的响应体。 数组长度：0 - 2000 page_info PageInfo object 分页信息。 request_id String 请求ID。 最小长度：1 最大长度：36 表5 TransitIp 参数 参数类型 描述 id String 中转IP的ID。 最小长度：36 最大长度：36 project_id String 项目的ID。 最小长度：1 最大长度：36 network_interface_id String 中转IP的网络接口ID。 最小长度：36 最大长度：36 ip_address String 中转IP的地址。 最小长度：7 最大长度：35 created_at String 中转IP的创建时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ 最小长度：1 最大长度：36 updated_at String 中转IP的更新时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ 最小长度：1 最大长度：36 virsubnet_id String 当前租户子网的ID。 最小长度：0 最大长度：36 tags Array of Tag objects 标签列表。 数组长度：1 - 10 gateway_id String 中转IP绑定的私网NAT网关实例的ID。 最小长度：36 最大长度：36 enterprise_project_id String 企业项目ID。创建中转IP时，关联的企业项目ID。 最小长度：1 最大长度：36 表6 Tag 参数 参数类型 描述 key String 标签key值。 最小长度：1 最大长度：128 value String 标签value。 最小长度：0 最大长度：255 表7 PageInfo 参数 参数类型 描述 next_marker String 分页查询结果中最后一条记录的ID。通常用于查询下一页。 最小长度：1 最大长度：36 previous_marker String 分页查询结果中第一条记录的ID。通常用于配合page_reverse=true查询上一页。 最小长度：1 最大长度：36 current_count Integer 分页查询资源时，本页的实例的个数。 最小值：1 最大值：2000

响应示例 状态码： 200 查询中转IP列表成功。 { "transit_ips" : [ { "id" : "3faa719d-6d18-4ccb-a5c7-33e65a09663e", "project_id" : "da261828016849188f4dcc2ef94d9da9", "network_interface_id" : "c91c43fb-8d66-48df-bfa9-b89053ac3737", "enterprise_project_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "gateway_id" : "521bb3d9-8bed-4c6c-9ee8-669bd0620f76", "ip_address" : "192.168.1.68", "created_at" : "2019-04-29T03:41:59", "updated_at" : "2019-04-29T03:41:59", "virsubnet_id" : "49ee5fb5-75bf-4320-946e-b21ef4c9c9c1", "tags" : [ { "key" : "key1", "value" : "value1" } ] }, { "id" : "a2845109-3b2f-4627-b08f-09a726c0a6e7", "project_id" : "da261828016849188f4dcc2ef94d9da9", "network_interface_id" : "adebbdca-8c26-4c14-b34f-3f53cd2c42f2", "enterprise_project_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a", "gateway_id" : "521bb3d9-8bed-4c6c-9ee8-669bd0620f76", "ip_address" : "192.168.1.68", "created_at" : "2019-04-29T02:16:09", "updated_at" : "2019-04-29T02:16:09", "virsubnet_id" : "333e5fb5-75bf-4320-946e-b21ef4c9c2g5", "tags" : [ { "key" : "key1", "value" : "value1" } ] } ], "request_id" : "747a911c17067a39692f75ac146fb47e" }

URI GET /v3/{project_id}/private-nat/transit-ips 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目的ID。 最小长度：1 最大长度：36 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 功能说明：每页返回的个数。 取值范围：0~2000。 默认值：2000。 最小值：1 最大值：2000 缺省值：2000 marker 否 String 功能说明：分页查询起始的资源ID，为空时查询第一页。 值从上一次查询的PageInfo中的next_marker或者previous_marker中获取。 最小长度：36 最大长度：36 page_reverse 否 Boolean 是否查询前一页。 id 否 Array 中转IP的ID。 数组长度：1 - 10 project_id 否 Array 项目的ID。 数组长度：1 - 10 network_interface_id 否 Array 中转IP的网络接口ID。 数组长度：1 - 10 ip_address 否 Array 中转IP地址。 数组长度：1 - 10 gateway_id 否 Array 中转IP绑定的私网NAT网关实例的ID。 数组长度：1 - 10 enterprise_project_id 否 Array 企业项目ID。创建中转IP时，关联的企业项目ID。 数组长度：1 - 10 virsubnet_id 否 Array 当前租户子网的ID。 数组长度：1 - 10

请求示例 PUT https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/dnat_rules/79195d50-0271-41f1-bded-4c089b2502ff { "dnat_rule" : { "nat_gateway_id" : "a78fb3eb-1654-4710-8742-3fc49d5f04f8", "description" : "my dnat-rules" } }

接口约束 更新操作时，要求DNAT规则状态status = ACTIVE，要求网关管理员状态admin_state_up = True。port_id和private_ip不能同时生效。对于all port类型的规则，要求internal_service_port = 0，external_service_port = 0，protocol = ANY。 更新操作涉及以下字段更新时，要求这些字段必须一起更新。包括：port_id、private_ip、internal_service_port、external_service_port、floating_ip_id、protocol、internal_service_port_range、external_service_port_range。

响应示例 状态码： 200 更新DNAT规则成功。 { "dnat_rule" : { "status" : "ACTIVE", "nat_gateway_id" : "a78fb3eb-1654-4710-8742-3fc49d5f04f8", "admin_state_up" : true, "port_id" : "9a469561-daac-4c94-88f5-39366e5ea193", "internal_service_port" : 993, "protocol" : "tcp", "tenant_id" : "d199ba7e0ba64899b2e81518104b1526", "floating_ip_id" : "cf99c679-9f41-4dac-8513-9c9228e713e1", "created_at" : "2017-11-15 15:44:42.595173", "id" : "79195d50-0271-41f1-bded-4c089b2502ff", "floating_ip_address" : "5.21.11.226", "external_service_port" : 242, "description" : "my dnat rule" } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求id。 最小长度：1 最大长度：36 tags Array of Tag objects 标签。 数组长度：1 - 10 表4 Tag 参数 参数类型 描述 key String 键。最大长度128个unicode字符。key不能为空。 最小长度：1 最大长度：128 value String 值。每个值最大长度255个unicode字符。 最小长度：0 最大长度：255

响应示例 状态码： 200 查询操作成功。 { "request_id" : "80ef5f21-b81a-4546-b23d-84272507d330", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" }, { "key" : "key3", "value" : "value3" } ] }

请求示例 SNAT规则更新的请求体。 PUT https://{Endpoint}/v2/27e25061336f4af590faeabeb7fcd9a3/snat_rules/5b95c675-69c2-4656-ba06-58ff72e1d338 { "snat_rule" : { "nat_gateway_id" : "bbe7c2e7-3bad-445b-a067-b30acce66053", "description" : "my_snat_rule_update", "public_ip_address" : "10.15.10.11,10.15.10.12" } }

响应示例 状态码： 200 PUT操作正常返回。 { "snat_rule" : { "floating_ip_id" : " bdc10a4c-d81a-41ec-adf7-de857f7c812a,7a094014-9657-463f-972b-e84d56b931a0", "status" : "ACTIVE", "nat_gateway_id" : "bbe7c2e7-3bad-445b-a067-b30acce66053", "admin_state_up" : true, "network_id" : "eaad9cd6-2372-4be1-9535-9bd37210ae7b", "source_type" : 0, "tenant_id" : "27e25061336f4af590faeabeb7fcd9a3", "created_at" : "2017-11-18 07:54:21.665430", "id" : "5b95c675-69c2-4656-ba06-58ff72e1d338", "public_ip_address" : "10.15.10.11,10.15.10.12", "floating_ip_address" : "10.15.10.11,10.15.10.12", "description" : "my_snat_rule_update" } }