All Products
Search
Document Center

Cloud Firewall:DescribeOutgoingTag

Last Updated:Dec 30, 2025

Queries outbound connection tags.

Operation description

QPS limit

The queries per second (QPS) limit for this operation is 10 per user. If you exceed the limit, API calls are throttled, which may affect your business. We recommend that you call this operation at a reasonable rate.

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.

60.179.226.XXX

Lang

string

No

The language of the content. Valid values:

  • zh (default): Chinese.

  • en: English.

zh

Lang

string

No

The language of the content. Valid values:

  • zh (default): Chinese.

  • en: English.

zh

StartTime

string

Yes

The beginning of the time range to query. This value is a UNIX timestamp. Unit: seconds.

1743646544

EndTime

string

Yes

The end of the time range to query. This value is a UNIX timestamp. Unit: seconds.

1749003483

DstType

string

No

The type of the destination. Valid values:

  • Domain: domain name.

  • DstIP: IP address.

Domain

TagId

string

No

The ID of the tag.

103208

Response elements

Element

Type

Description

Example

object

TotalCount

integer

The total number of entries.

1

RequestId

string

The ID of the request.

B532203E-813B-5BEB-B75B-315E1D08****

TagList

array<object>

The list of tags.

object

A list of tag objects.

RiskLevel

integer

The risk assessment level. Valid values:

  • 0: no threat.

  • 1: low threat.

  • 2: medium threat.

  • 3: high threat.

0

TagName

string

The name of the tag.

test tag

TagId

string

The ID of the tag.

tag-6833388d18cc****

TagDescribe

string

The description of the tag.

test describe

ClassId

string

The classification. Valid values:

  • Suspicious: suspicious.

  • Malicious: malicious.

  • Trusted: trusted.

Trusted

Examples

Success response

JSON format

{
  "TotalCount": 1,
  "RequestId": "B532203E-813B-5BEB-B75B-315E1D08****",
  "TagList": [
    {
      "RiskLevel": 0,
      "TagName": "test tag",
      "TagId": "tag-6833388d18cc****",
      "TagDescribe": "test describe",
      "ClassId": "Trusted"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorAliUid Aliuid invalid. The aliuid 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 An error occurred while encoding JSON. An error occurred while encoding JSON.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.