Updated on 2023-07-24 GMT+08:00

Querying SNAT Rules

Function

This API is used to query an SNAT rule list.

URI

GET /v2/{project_id}/snat_rules

You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. All optional parameters can be filtered. For details, see the example request.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

limit

No

Integer

Specifies the number of records displayed on each page.

id

No

String

Specifies the SNAT rule ID.

tenant_id

No

String

Specifies the project ID.

nat_gateway_id

No

String

Specifies the NAT gateway ID.

network_id

No

String

Specifies the network ID used by the SNAT rule.

cidr

No

String

Specifies a subset of the VPC subnet CIDR block or a CIDR block of Direct Connect connection.

source_type

No

Integer

0: Either network_id or cidr can be specified in a VPC.

1: Only cidr can be specified over a Direct Connect connection.

floating_ip_id

No

String

  • Specifies the EIP ID.
  • Maximum length: 4,096 characters

floating_ip_address

No

String

  • Specifies the EIP.
  • Maximum length: 1,024 characters

status

No

String

  • Specifies the status of the SNAT rule.
  • For details about all its values, see Table 1.

admin_state_up

No

Boolean

  • Specifies the unfrozen or frozen state.
  • The value can be:
    • true: indicates the unfrozen state.
    • false: indicates the frozen state.

created_at

No

String

Specifies when the SNAT rule is created (UTC time). Its value rounds to 6 decimal places for seconds. The format is yyyy-mm-dd hh:mm:ss.

Request

None

Response

Table 2 lists response parameters.

Table 2 Response parameter

Parameter

Type

Description

snat_rules

Array(Object)

Specifies the SNAT rule objects. For details, see Table 3.

Table 3 Description of the snat_rule field

Parameter

Type

Description

id

String

Specifies the SNAT rule ID.

tenant_id

String

Specifies the project ID.

nat_gateway_id

String

Specifies the NAT gateway ID.

network_id

String

Specifies the network ID used by the SNAT rule.

cidr

String

Specifies a subset of the VPC subnet CIDR block or a CIDR block of Direct Connect connection.

source_type

Integer

0: Either network_id or cidr can be specified in a VPC.

1: Only cidr can be specified over a Direct Connect connection.

If no value is entered, the default value 0 (VPC) is used.

floating_ip_id

String

  • Specifies the EIP ID. Multiple EIP IDs must be separated using commas (,).
  • The maximum length of the ID is 4096 bytes.

description

String

Provides supplementary information about the SNAT rule. You can enter up to 255 characters.

status

String

admin_state_up

Boolean

  • Specifies the unfrozen or frozen state.
  • The value can be:
    • true: indicates the unfrozen state.
    • false: indicates the frozen state.

created_at

String

Specifies when the SNAT rule is created (UTC time). Its value rounds to 6 decimal places for seconds. The format is yyyy-mm-dd hh:mm:ss.

floating_ip_address

String

  • Specifies the EIP. Multiple EIPs must be separated using commas (,).
  • The maximum length is 1024 bytes.

freezed_ip_address

String

  • Specifies the frozen EIP. Multiple EIPs must be separated using commas (,).
  • The maximum length is 1024 bytes.

Examples

  • Example request
    GET https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/snat_rules?limit=10
  • Example response
    { 
         "snat_rules": [ 
           { 
                 "floating_ip_id": "bf99c679-9f41-4dac-8513-9c9228e713e1", 
                 "status": "ACTIVE", 
                 "nat_gateway_id": "cda3a125-2406-456c-a11f-598e10578541", 
                 "admin_state_up": true, 
                 "network_id": "9a469561-daac-4c94-88f5-39366e5ea193", 
                 "source_type":0,
                 "tenant_id": "d199ba7e0ba64899b2e81518104b1526", 
                 "created_at": "2017-11-15 15:44:42.595173", 
                 "id": "79195d50-0271-41f1-bded-4c089b2502ff", 
                 "floating_ip_address": "5.21.11.242", 
                 "freezed_ip_address": "", 
                 "description": "my snat rule 01" 
             }, 
             { 
                 "floating_ip_id": "6e496fba-abe9-4f5e-9406-2ad8c809ac8c", 
                 "status": "ACTIVE", 
                 "nat_gateway_id": "e824f1b4-4290-4ebc-8322-cfff370dbd1e", 
                 "admin_state_up": true, 
                 "network_id": "97e89905-f9c8-4ae3-9856-392b0b2fbe7f", 
                 "source_type":0,
                 "tenant_id": "d199ba7e0ba64899b2e81518104b1526",
                 "created_at": "2017-11-17 07:43:44.830845", 
                 "id": "4a1a10d7-0d9f-4846-8cda-24cffeffef5c", 
                 "floating_ip_address": "5.21.11.142,5.21.11.143", 
                 "freezed_ip_address": "5.21.11.142", 
                 "description": "my snat rule 01" 
             } 
         ] 
     }

Status Codes

See Status Codes.