All Products
Search
Document Center

Cloud Firewall:DescribeConfiguredDomainNames

Last Updated:Jan 07, 2026

Queries the list of domain names 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

Source IP address of the requester.

1.202.149.XXX

Lang

string

No

Language used in the request and response messages.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

Lang

string

No

Language used in the request and response messages.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

DomainName

string

No

Domain name.

example.com

GroupName

string

Yes

Group name.

ignore

PageSize

string

No

Number of entries on the current page.

10

CurrentPage

string

No

Page number of the current page.

1

Direction

string

Yes

Traffic direction.

Valid values:

  • in :

    Inbound traffic

  • out :

    Outbound traffic

out

SourceCode

string

Yes

Traceability code.

yundun

Response elements

Element

Type

Description

Example

object

Module

string

Application module.

sg_server

RequestId

string

Request ID of the response.

09A2D6F1-EA1B-56D9-977D-74878405****

TotalCount

integer

Total number of entries.

16

DomainNames

array<object>

List of domain names.

object

List of domain names.

IsMalicious

boolean

Indicates whether the domain name is a malicious domain name.

0

OperationTime

integer

Operation time.

1534408189

DomainName

string

Domain name.

example.com

Comment

string

Remarks.

test

Examples

Success response

JSON format

{
  "Module": "sg_server",
  "RequestId": "09A2D6F1-EA1B-56D9-977D-74878405****",
  "TotalCount": 16,
  "DomainNames": [
    {
      "IsMalicious": true,
      "OperationTime": 1534408189,
      "DomainName": "example.com",
      "Comment": "test"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorSourceCodeError The source code is invalid. The source code 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 ErrorAliUid Aliuid invalid. The aliuid is invalid.
400 ErrorMarshalJSON internal error. Internal error.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.