All Products
Search
Document Center

Cloud Firewall:DescribeConfiguredDestinationIP

Last Updated:Jan 07, 2026

Queries the list of configured destination IP addresses for outbound connections.

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

SourceIp

string

No

The source IP address of the visitor.

123.113.99.XXX

Lang

string

No

The language of the response message.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

Lang

string

No

The language of the response message.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

DestinationIP

string

No

The destination IP address.

1.1.1.1

DestinationRegion

string

No

The destination region.

cn-shenzhen

DestinationISP

string

No

The destination ISP.

电信

GroupName

string

Yes

The group name.

Valid values:

  • subscribe :

    subscribe

  • ignore :

    ignore

ignore

PageSize

string

No

The page number to return.

20

CurrentPage

string

No

The page number of the query.

1

Direction

string

Yes

The traffic direction.

Valid values:

  • in :

    Access control for inbound traffic

  • out :

    Access control for outbound traffic

out

SourceCode

string

Yes

The identifier of the source.

yundun

Response elements

Element

Type

Description

Example

object

PageNo

integer

The page number of the returned page.

1

RequestId

string

The ID of the request.

F0AE91F8-E6C5-50D4-983F-FC53672****

PageSize

integer

The number of entries returned per page.

10

TotalCount

integer

The total number of entries.

32

Destinations

array<object>

The list of destination IP addresses.

object

The list of destination IP addresses.

DestinationIP

string

The destination IP address.

1.1.1.1

DestinationRegion

string

The destination region.

cn-shenzhen

OperationTime

integer

The time of the operation.

1534408189

DestinationISP

string

The destination ISP.

电信

Comment

string

The remarks.

测试

Examples

Success response

JSON format

{
  "PageNo": 1,
  "RequestId": "F0AE91F8-E6C5-50D4-983F-FC53672****",
  "PageSize": 10,
  "TotalCount": 32,
  "Destinations": [
    {
      "DestinationIP": "1.1.1.1",
      "DestinationRegion": "cn-shenzhen",
      "OperationTime": 1534408189,
      "DestinationISP": "电信",
      "Comment": "测试"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorSourceCodeError The source code is invalid. The source code is invalid.
400 ErrorAliUid Aliuid invalid. The aliuid is invalid.
400 ErrorObjectOperation The objectOperation is invalid. The objectOperation is invalid.
400 ErrorPageNo Either page number or page size is invalid. Either page number or page size is invalid.
400 ErrorDBSelectError A database select error occurred. The error message returned because an internal error has occurred in querying the database.
400 ErrorMarshalJSON internal error. Internal error.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.