All Products
Search
Document Center

NAT Gateway:ModifyFullNatEntryAttribute

Last Updated:Aug 28, 2026

Modifies the attributes of a FULLNAT entry in a VPC NAT gateway.

Operation description

  • ModifyFullNatEntryAttribute is an asynchronous operation. The system returns a request ID immediately and runs the task in the background. Call ListFullNatEntries to query the FULLNAT entry status:

    • Modifying: the entry is being modified. You can query but not modify it.

    • Available: the modification is complete.

  • You cannot call ModifyFullNatEntryAttribute repeatedly to modify the same FULLNAT entry within a short period of time.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ClientToken

string

No

Client token for request idempotence. Must be unique across requests and contain only ASCII characters.

Note

If not specified, the system uses the request ID as the client token. The request ID may differ for each request.

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

FullNatTableId

string

Yes

ID of the FULLNAT table to modify.

fulltb-gw88z7hhlv43rmb26****

FullNatEntryId

string

Yes

ID of the FULLNAT entry to modify.

fullnat-gw8fz23jezpbblf1j****

NetworkInterfaceId

string

No

ID of the elastic network interface (ENI) to modify.

eni-gw8g131ef2dnbu3k****

NatIp

string

No

NAT IP address to modify.

192.168.XX.XX

NatIpPort

string

No

Frontend port for FULLNAT port mapping. Valid values: 1 to 65535.

80

AccessIp

string

No

Backend IP address for FULLNAT address translation.

192.168.XX.XX

AccessPort

string

No

Backend port for FULLNAT port mapping. Valid values: 1 to 65535.

80

IpProtocol

string

No

Protocol for port forwarding. Valid values:

  • TCP

  • UDP

TCP

FullNatEntryName

string

No

New name for the FULLNAT entry. 2 to 128 characters. Must start with a letter and cannot start with http:// or https://.

modify

FullNatEntryDescription

string

No

New description for the FULLNAT entry. Optional. If specified, must be 2 to 256 characters and cannot start with http:// or https://.

abcd

DryRun

boolean

No

Whether to perform a dry run without executing the request. Valid values:

  • true: performs a dry run. The system validates the request for missing parameters, syntax errors, and service limits. If validation fails, an error message is returned. If validation passes, the DryRunOperation error code is returned.

  • false: performs validation and executes the request. If validation passes, a 2xx HTTP status code is returned.

false

RegionId

string

Yes

Region ID of the VPC NAT gateway that contains the FULLNAT entry. Call DescribeRegions to query available regions.

eu-central-1

AccessDomain

string

No

Backend domain name for FULLNAT address translation.

xxx.com

Response elements

Element

Type

Description

Example

object

The request ID.

RequestId

string

The request ID.

2315DEB7-5E92-423A-91F7-4C1EC9AD97C3

Examples

Success response

JSON format

{
  "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ResourceNotFound.NetworkInterfaceId The specified resource is not found. The specified resource is not found.
400 ResourceAlreadyExist.FullNatEntry The specified resource of %s is already exist. The FULLNAT rule already exists.
400 IncorrectStatus.NatIp The status of %s [%s] is incorrect. The status of NatIp is incorrect.
400 UnsupportedFeature.PrivateLinkMode The feature of %s is not supported. The feature of reverse access is not supported.
400 DependencyViolation.PrivateLinkMode The specified resource of %s depends on %s, so the operation cannot be completed. The %s resource depends on %s.
400 IllegalParam.AccessDomain The request parameter AccessDomain is illegal. The AccessDomain parameter in the request parameter is invalid.
400 ExclusiveParam.AccessIpAndAccessDomain The specified AccessIp and AccessDomain are mutually exclusive. The specified input AccessIp conflicts with the AccessDomain.
400 InstanceUnsupported.FullNatDomain The current instance does not support the configuration of the FullNat rule domain name. The current instance does not support the configuration of the FullNat rule domain name.
400 ZoneUnsupported.FullNatDomain The current zone does not support the configuration of the FullNat rule domain name. The current zone does not support the configuration of the FullNat rule domain name.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.