Deletes a DNAT entry.

Usage notes

  • DeleteForwardEntry is an asynchronous operation. After you make a request, the ID of the request is returned but the specified DNAT entry is not deleted. The system deletes the entry in the background. You can call the DescribeForwardTableEntries operation to query the status of a DNAT entry.
    • If the DNAT entry is in the Deleting state, the system is deleting the DNAT entry. In this case, you can only query the status of the DNAT entry, but cannot perform other operations.
    • If the DNAT entry cannot be found, it is deleted.
Note If a DNAT table has DNAT entries in the Pending state, you cannot delete the DNAT entries.
  • You cannot repeatedly call the DeleteForwardEntry operation to delete a DNAT entry within the specified period of time.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteForwardEntry

The operation that you want to perform. Set the value to DeleteForwardEntry.

RegionId String Yes cn-hangzhou

The region ID of the NAT gateway.

You can call the DescribeRegions operation to query the most recent region list.

ForwardTableId String Yes ftb-8vbx8xu2lqj9qb334****

The ID of the DNAT table to which the DNAT entry belongs.

ForwardEntryId String Yes fwd-8vbn3bc8roygjp0gy****

The ID of the DNAT entry to be deleted.

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. The token can contain only ASCII characters.

Note If you do not specify this parameter, the system uses RequestId as ClientToken. RequestId may be different for each API request.

Response parameters

Parameter Type Example Description
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

The ID of the request.


Sample requests

&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"

Error codes

HttpCode Error code Error message Description
400 IncorretForwardEntryStatus Some Forward entry status blocked this operation.. The error message returned because you are not authorized to perform the specified operation. The error message returned because one or more DNAT entries in the DNAT table are in the Pending or Modifying state.
400 IncorretForwardEntryStatus The Specified forwardEntry is not exist The error message returned because the specified DNAT entry does not exist.
400 MissingParameter Missing mandatory parameter The error message returned because one or more required parameters are not set. Check whether you have set all the required parameters before you call this operation.
400 IncorrectStatus.NATGW The status of the specified NAT gateway is abnormal. The error message returned because the NAT gateway is in an invalid state.
400 IncorrectStatus.ForwardEntry The status of %s [%s] is incorrect. The error message returned because the DNAT entry to be deleted is in an invalid state.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. The error message returned because the specified region ID does not exist.
404 InvalidForwardEntryId.NotFound Specified forward entry ID does not exist The error message returned because the specified DNAT entry does not exist.
404 InvalidForwardTableId.NotFound Specified forward table does not exist. The error message returned because the specified DNAT table does not exist. Check the parameter and try again.

For a list of error codes, visit the API Error Center.