調用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 入參發生變更 | 查看變更詳情 |