Deletes a specified 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 DNAT entry in the DNAT table:
- Deleting: indicates that the system is deleting the DNAT entry. You can only query the state of the DNAT entry, but cannot perform other operations.
- If no DNAT entry is returned in the response, the DNAT entry is deleted.
Debugging
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 region IDs. |
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. Check whether the region ID is valid. |
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 entry does not exist. Verify 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 the required parameters are missing. 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.