Deletes a DNAT entry.

Description

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 DescribeNatGateways operation to query the status of the DNAT entry. The DNAT entry may be in the one of the following states:

  • 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, and cannot perform other operations.
  • If no DNAT entry is returned in the response, the DNAT entry is deleted.

If a DNAT table has DNAT entries in the Pending state, you cannot delete the DNAT entries.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates a 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.

ForwardEntryId String Yes fwd-8vbn3bc8roygjp0gy****

The ID of the DNAT entry to be deleted.

ForwardTableId String Yes ftb-8vbx8xu2lqj9qb334****

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

RegionId String Yes cn-hangzhou

The ID of the region where the NAT gateway is deployed.

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

Response parameters

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

The ID of the request.

Examples

Sample requests

https://vpc.aliyuncs.com/?Action=DeleteForwardEntry
&ForwardEntryId=fwd-8vbn3bc8roygjp0gy****
&ForwardTableId=ftb-8vbx8xu2lqj9qb334****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DeleteForwardEntryResponse>
      <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteForwardEntryResponse>

JSON format

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

Error codes

HttpCode Error code Error message Description
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. The error message returned because the specified region ID does not exist.
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.
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.
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 required parameters are not set. Check whether you have set all the required parameters before you call this operation.

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