调用ModifyNatGatewayAttribute修改NAT网关的名称和描述_NAT网关(NAT Gateway)-阿里云帮助中心

调用ModifyNatGatewayAttribute接口修改NAT网关的属性。

接口说明

本接口查询的 NAT 网关包括公网 NAT 网关和 VPC NAT 网关，文中出现的“NAT 网关”不做具体的区分。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vpc:ModifyNatGatewayAttribute	update	NatGateway acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	要修改的 NAT 网关所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-hangzhou
NatGatewayId	string	是	要修改的 NAT 网关的 ID。	ngw-2ze0dcn4mq31qx2jc****
Name	string	否	要修改的 NAT 网关名称。名称长度为 1～128 个字符，不能以`http://`或`https://`开头。	nat123
Description	string	否	要修改的 NAT 网关描述信息。描述长度为 1～128 个字符，不能以`http://`或`https://`开头。	Description
IcmpReplyEnabled	boolean	否	是否开启 ICMP 代回。取值： true（默认值）：开启。 false：不开启。	true
EipBindMode	string	否	修改 NAT 网关的 EIP 绑定模式。取值：可以为空，非空时只允许为 NAT，表示绑定模式为 EIP 普通模式。说明只支持将MULTI_BINDED模式修改为 NAT 模式，不支持将 NAT 模式修改为MULTI_BINDED模式。关于MULTI_BINDED模式的具体信息，请参见 CreateNatGateway 。在 EIP 绑定模式切换过程中网络连接会出现秒级别闪断（闪断时间随着 EIP 数量增加而变长，目前最多支持绑定 5 个 EIP 的 NAT 网关进行配置变更），请您尽量在业务低峰期执行切换操作。 EIP 绑定模式变更为 NAT 后，公网 NAT 网关将兼容 IPv4 网关，但绑定一个公网 EIP 时将占用 NAT 网关所在交换机的一个私网 IP，请确保 NAT 网关所在交换机内私网 IP 地址充足，如果 NAT 网关所在的交换机没有可用的空闲私网地址时，将无法绑定新的 EIP。	NAT
EnableSessionLog	boolean	否	是否开启会话日志，取值： true：已开启会话日志。 false：已关闭会话日志。	true
LogDelivery	object	否	会话日志配置信息。
LogDeliveryType	string	否	会话日志写入类型。取值：sls，阿里云日志服务 SLS。	sls
LogDestination	string	否	会话日志写入地址。取值：acs:log:${regionName}:${projectOwnerAliUid}:project/${projectName}/logstore/${logstoreName}	acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/session_log_test

返回参数

名称	类型	描述	示例值
	object	请求 ID。
RequestId	string	请求 ID。	AB5F62CF-2B60-4458-A756-42C9DFE108D1

示例

正常返回示例

JSON格式

{
  "RequestId": "AB5F62CF-2B60-4458-A756-42C9DFE108D1"
}

错误码

HTTP status code	错误码	错误信息	描述
400	UnsupportedFeature.PrivateLinkMode	The feature of %s is not supported.	暂不支持反向访问特性。
400	IncorrectStatus.NATGW	NATGW status is invalid.	NAT网关的状态不正确。
400	ExclusiveParam.%sAnd%s	The param of %s and %s are mutually exclusive.	参数 %s 和 %s 相互排斥。
400	IncorrectStatus.NatGateway	The status of natgateway is incorrect.	NAT网关的状态不正确。
400	DependencyViolation.PrivateLinkMode	The specified resource of %s depends on %s, so the operation cannot be completed.	%s 资源依赖于 %s，因此本操作不能完成。
400	UnsupportedFeature.IcmpReplyEnabled	The feature of IcmpReplyEnabled is not supported.	Icmp 代答使能功能修改不支持。
400	InvalidParams.NotNull	The parameter must not be null, name or description or icmpReplyEnabled	名称、描述以及icmp代答使能参数不能同时为空。
400	InvalidParameter.Name.Malformed	The specified Name is not valid.	该名称不合法，请您按照正确的格式书写名称。
400	InvalidParameter.Description.Malformed	The specified Description is not valid.	该描述不合法。
400	UnsupportedFeature.IndirectConvertForVpcNat	The VPC NAT gateway is not support to change EIP bond type.	VPC NAT网关不支持修改EIP的绑定类型。
400	UnsupportedFeature.NormalNatModifyEipBindMode	The normal NAT gateway is not support to change EIP bond type.	普通型NAT网关不支持修改EIP绑定类型。
400	OperationDenied.EipBondTypeIsAlreadyNAT	The EIP bond type is already NAT type.	EIP绑定类型已经是NAT类型。
400	UnsupportedFeature.IndirectConvertForFwNat	The security protection enabled NAT gateway is not support change EIP bond type.	开启防护功能的公网NAT不支持修改EIP绑定类型。
400	QuotaExceeded.EipNumForModifyEipBondType	The quota of %s is exceeded, binded: %s, quota: %s.	修改EIP绑定类型时允许的EIP个数超限
400	ResourceNotEnough.SwitchAvailableIps	The available private Ip number is not enough in your subnet.	子网中可用的私网IP不足。
400	UnsupportedFeature.VpcNatSecurityProtectionEnabled	The VPC NAT gateway is not supported to enable security protection.	VPC NAT网关不支持开启安全防护。
400	OperationDenied.NatGatewayStatusInvalid	The NAT gateway status is invalid.	NAT网关的状态无效。
400	OperationDenied.EipStatusInvalid	The NAT gateway has EIP in invalid status.	NAT网关绑定的EIP状态无效。
400	OperationDenied.SnatEntryStatusInvalid	The NAT gateway has SNAT entry in invalid status.	NAT网关配置的SNAT条目状态无效。
400	OperationDenied.DnatEntryStatusInvalid	The NAT gateway has DNAT entry in invalid status.	NAT网关配置的DNAT状态无效。
400	UnsupportedFeature.MutilBindedTypeNatEnableFw	The NAT with Mutil-Binded Eip bind type is not support enable firewall.	以Mutil-Binded方式绑定EIP的NAT不允许开启防火墙。
400	Forbidden.FinancialLocked	The instance is locked due to outstanding payments.	该实例已欠费锁定，无法操作
400	OperationFailed.PrivateLinkMode	The NAT gateway is not support to change PrivateLinkMode.	当前NAT网关不支持修改PrivateLinkMode。
400	IllegalParam.SessionLogDeliveryDestination	The specified Delivery Destination is illegal.	会话日志投递目标参数(SessionLogDeliveryDestination)配置格式无效
400	OperationFailed.LogDeliveryIsUnAuthorized	Operation failed because the user is not authorized to deliver NAT session log.	操作失败因为您未授权NAT会话日志投递权限
400	IllegalParam.SessionLogDeliveryType	The specified Delivery Type is illegal.	会话日志投递目标类型参数SessionLogDeliveryType输入不符合要求
400	UnsupportedFeature.EnableSessionLog	The feature of EnableSessionLog is not supported.	当前实例不支持打开NAT网关会话日志。
403	Forbidden.ModifyEipBondType	Authentication is failed for modify EIP bond type.	不允许修改EIP绑定类型。
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	指定的RegionId不存在。
404	InvalidNatGatewayId.NotFound	The specified NatGatewayId does not exist in our records.	指定的 NatGatewayId 不存在，请您检查填写的 NatGatewayId 是否正确。
500	OperationFailed.ConfigSessionLog	Failed to configure session log due to a temporary failure of the server.	由于内部服务错误引起配置会话日志失败.

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-05-17	OpenAPI 错误码发生变更	查看变更详情
2024-05-07	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2024-01-18	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情
2023-03-01	OpenAPI 错误码发生变更	查看变更详情
2022-10-13	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情