All Products
Search

This Product

    NAT Gateway:DeleteSnatEntry

    Document Center

    NAT Gateway:DeleteSnatEntry

    Last Updated:Aug 28, 2026

    Deletes an SNAT entry.

    Operation description

    DeleteSnatEntry is an asynchronous operation. After you send a request, the request ID is returned but the SNAT entry is not immediately deleted. The system deletes the entry in the background. You can call the DescribeSnatTableEntries operation to query the status of the SNAT entry.

    • If the SNAT entries are in the Deleting state, the entries are being deleted. In this case, you can only query the status of the SNAT entries but cannot perform other operations.

    • If no SNAT entry is returned in the response, the SNAT entry is deleted.

    You cannot delete SNAT entries that are in the Pending state.

    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
    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
    SnatTableId

    string

    Yes

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

    stb-bp190wu8io1vgev80****
    SnatEntryId

    string

    Yes

    The ID of the SNAT entry that you want to delete.

    snat-bp1vcgcf8tm0plqcg****
    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 ensure that it is unique across requests. The client token can contain only ASCII characters.

    Note

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

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

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The ID of the request.

    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 IncorretSnatEntryStatus Some Snat entry status blocked this operation..
    400 IncorrectStatus.SnatEntry The Specified SnatEntry is not stable status, can not operation The specified SNAT entries are not in a stable state and cannot be operated.
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 InvalidSnatEntryId.NotFound Specified Snat entry ID does not exist
    404 InvalidSnatTableId.NotFound Specified SNAT table does not exist.
    404 ResourceNotFound.SnatEntry Specified SNAT entry does not exist. The specified SNAT entry does not exist.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.