调用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 个字符，不能以 | nat123 |
| Description | string | 否 | 要修改的 NAT 网关描述信息。 描述长度为 1～128 个字符，不能以 | Description |
| IcmpReplyEnabled | boolean | 否 | 是否开启 ICMP 代回。取值：
| true |
| EipBindMode | string | 否 | 修改 NAT 网关的 EIP 绑定模式。取值：可以为空，非空时只允许为 NAT，表示绑定模式为 EIP 普通模式。 说明
| NAT |
| EnableSessionLog | boolean | 否 | 是否开启会话日志，取值：
| 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 |
返回参数
示例
正常返回示例
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 入参发生变更 | 查看变更详情 |