Deletes a DNAT entry.
Operation description
Description
-
DeleteForwardEntry is an asynchronous operation. After a request is sent, the system returns a request ID and runs the task in the background. You can call the DescribeForwardTableEntries operation to query the status of the task.
-
If the DNAT entry is in the Deleting state, you can only query its status but cannot perform other operations.
-
If the DNAT entry cannot be found, the DNAT entry is deleted.
-
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.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID of the NAT gateway. You can call the DescribeRegions operation to query the most recent region list. |
cn-hangzhou |
| ForwardTableId |
string |
Yes |
The ID of the DNAT table to which the DNAT entry belongs. |
ftb-8vbx8xu2lqj9qb334**** |
| ForwardEntryId |
string |
Yes |
The ID of the DNAT entry to be deleted. |
fwd-8vbn3bc8roygjp0gy**** |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters. Note
If you do not specify this parameter, the system uses the request ID as the client token. The request ID may be different for each request. |
123e4567-e89b-12d3-a456-426655440000 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The request ID. |
||
| RequestId |
string |
The request ID. |
0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
Examples
Success response
JSON format
{
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | IncorretForwardEntryStatus | Some Forward entry status blocked this operation.. | |
| 400 | MissingParameter | Missing mandatory parameter | |
| 400 | IncorrectStatus.NATGW | The status of the specified NAT gateway is abnormal. | The status of the specified NAT gateway is abnormal. |
| 400 | IncorrectStatus.ForwardEntry | The status of %s [%s] is incorrect. | The DNAT entry to be deleted is in an invalid state. |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | |
| 404 | InvalidForwardEntryId.NotFound | Specified forward entry ID does not exist | |
| 404 | InvalidForwardTableId.NotFound | Specified forward table does not exist. | |
| 404 | ResourceNotFound.ForwardEntry | The specified resource of %s is not found. | The specified %s resource does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.