华为云计算 云知识 批量添加删除私网NAT网关标签BatchCreateDeletePrivateNatTags
批量添加删除私网NAT网关标签BatchCreateDeletePrivateNatTags

 

接口说明
  • 为指定 私网NAT网关 实例批量添加或删除标签
  • 标签管理服务需要使用该接口批量管理私网 NAT网关 实例的标签。
  • 一个私网NAT网关上最多有10个标签。
约束说明

此接口为幂等接口:

  • 创建时如果请求体中存在重复key则报错。
  • 创建时,不允许设置重复key数据,如果 数据库 已存在该key,就覆盖value的值。
  • 删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。
  • 删除时tags结构体不能缺失,key不能为空,或者空字符串。
URL
POST  https://nat.cn-north-4.myhuaweicloud.com/v3/{project_id}/private-nat-gateways/{resource_id}/tags/action 
请求参数
名称 类型 IN 必选 描述
X-Auth-Token
 
string header

用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

project_id
 
string path

项目的ID。

resource_id
 
string path

私网NAT网关的ID。

Body参数
名称 类型 必选 描述
action
 
string

功能说明:操作标识。 取值范围: create(创建) delete(删除)

tags
 
Array of Tag objects

标签列表。

参数:
tags
名称 类型 必选 描述
key
 
string

键。最大长度128个unicode字符。key不能为空。

value
 
string

值。每个值最大长度255个unicode字符。

返回参数
返回码: 204

批量添加或删除操作成功。

请求示例
示例 1

批量添加私网NAT网关标签。

 
"POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/private-nat-gateways/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/action"
 
{ "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
示例 2

批量删除私网NAT网关标签。

 
"POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/private-nat-gateways/3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/action"
 
{ "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
SDK
点击 NAT网关 (NAT) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:添加资源标签CreateResourceTag 下一篇:工业智能体应用场景

NAT网关 NAT 

 

华为云NAT网关(NAT Gateway)提供公网NAT网关(Public NAT Gateway)和私网NAT网关(Private NAT Gateway)两个功能。 公网NAT网关能够为VPC内的弹性云服务器提供SNAT和DNAT功能,通过灵活简易的配置,即可轻松构建VPC的公网出入口。 私网NAT网关能够为虚拟私有云内的云主机提供网络地址转换服务,使多个云主机可以共享私网IP访问用户本地数据中心(IDC)或其他虚拟私有云,同时,也支持云主机面向私网提供服务。