Queries the information about the domain names in outbound connections.
Debugging
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resourcesis used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| yundun-cloudfirewall:DescribeOutgoingDomain | get | *All Resources * |
| none |
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Lang | string | No | The language of the content within the request. Valid values:
| zh |
| StartTime | string | Yes | The beginning of the time range to query. The value is a UNIX timestamp. Unit: seconds. | 1656664560 |
| EndTime | string | Yes | The end of the time range to query. The value is a UNIX timestamp. Unit: seconds. | 1656750960 |
| PageSize | string | No | The number of entries to return on each page. Default value: 6. Maximum value: 100. | 10 |
| CurrentPage | string | No | The number of the page to return. Default value: 1. | 1 |
| CategoryId | string | No | The type of the service. This parameter is empty by default. Valid values:
| All |
| Domain | string | No | The domain name in outbound connections. | www.aliyundoc.com |
| PublicIP | string | No | The public IP address of the Elastic Compute Service (ECS) instance that initiates outbound connections. | 192.0.XX.XX |
| Sort | string | No | The field based on which you want to sort the query results. Valid values:
| SessionCount |
| Order | string | No | The method that is used to sort the results. Valid values:
| desc |
| TagIdNew | string | No | The ID of the tag. Valid values:
| AliYun |
Response parameters
Examples
Sample success responses
JSONformat
{
"TotalCount": 132,
"RequestId": "F0F82705-CFC7-5F83-86C8-A063892F****",
"DomainList": [
{
"AclCoverage": "Uncovered",
"Domain": "www.aliyundoc.com",
"AclRecommendDetail": "Allows the traffic.\n",
"HasAclRecommend": true,
"InBytes": 3214,
"CategoryName": "Alibaba Cloud services\n",
"RuleName": "Default rule\n",
"RuleId": "add-dfadf-f****",
"SessionCount": 12,
"GroupName": "Group of addresses in outbound connections\n",
"SecuritySuggest": "pass",
"OutBytes": 4582,
"AclStatus": "Normal",
"IsMarkNormal": true,
"CategoryId": "Aliyun",
"AddressGroupUUID": "fdad-fdafa-dafa-dfa****",
"AddressGroupName": "The address book for outbound connections\n",
"CategoryClassId": "Trusted",
"Business": "Alibaba Cloud\n",
"HasAcl": "true",
"Organization": "Alibaba Cloud Computing Co., Ltd.\n",
"SecurityReason": "Intelligent policy: The destination domain name belongs to Alibaba Cloud Computing Co., Ltd. The domain name mainly provides services for Alibaba Cloud. No security risks are found, and you can add the domain name to the whitelist.\n",
"TotalBytes": "800",
"TagList": [
{
"RiskLevel": 3,
"TagName": "Tag indicating that the domain name is added to the whitelist\n",
"TagId": "AliYun",
"TagDescribe": "Tag indicating that the domain name is added to the whitelist\n",
"ClassId": "Trusted"
}
],
"ApplicationNameList": [
"HTTP"
],
"AssetCount": 20,
"PrivateAssetCount": 20
}
]
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | The aliuid is invalid. |
| 400 | ErrorTimeError | The time is invalid. | The time is invalid. |
| 400 | ErrorDBSelectError | A database select error occurred. | The error message returned because an internal error has occurred in querying the database. |
| 400 | ErrorIntervalError | The interval is invalid. | The interval is invalid. |
| 400 | ErrorIpFormat | The IP address is invalid. | The IP address is invalid. |
| 400 | ErrorSecuritySuggest | The security suggest is invalid. | The security suggest is invalid. |
| 400 | ErrorSortError | The sort is invalid. | The sort is invalid. |
| 400 | ErrorOrderFailed | The order is invalid. | The order is invalid. |
| 400 | ErrorPageNo | Either page number or page size is invalid. | Either page number or page size is invalid. |
| 400 | ErrorDomainName | The domain name is invalid. | The domain name is invalid. |
| 400 | ErrorDataTypeError | The data type is invalid. | The data type is invalid. |
| 400 | ErrorMarshalJSON | internal error. | Internal error. |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2024-09-24 | The Error code has changed. The response structure of the API has changed | View Change Details |
| 2024-09-06 | API Description Update. The Error code has changed | View Change Details |
| 2022-09-27 | The request parameters of the API has changed. The response structure of the API has changed | View Change Details |
| 2022-07-07 | Add Operation | View Change Details |