DescribeInternetOpenIp-阿里云帮助中心

Describes a Cloud Firewall access control policy group.

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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-cloudfirewall:DescribeInternetOpenIp

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
Lang	string	No	The language of the response message. zh (default): Chinese en: English	zh
ServiceName	string	No	The name of the application to query.	SSH
RiskLevel	string	No	The risk level. If you leave this parameter empty, all risk levels are queried. Valid values: 3: high 2: medium 1: low 0: none	2
Port	string	No	The port number.	80
AssetsInstanceId	string	No	The instance ID.	i-uf6faknmuby7ezht****
AssetsInstanceName	string	No	The instance name.	launch-advisor-2023****
PublicIp	string	No	The public IP address of the instance.	203.0.113.1
RegionNo	string	No	The region ID of the instance.	cn-shanghai
AssetsType	string	No	The asset type of the instance.	EcsEIP
StartTime	string	No	The start time when the public IP address was exposed. The value is a UNIX timestamp. Unit: seconds.	1681957629
EndTime	string	No	The end time when the public IP address was exposed. The value is a UNIX timestamp. Unit: seconds.	1663640336
CurrentPage	string	Yes	The page number for a paged query.	1
PageSize	string	Yes	The number of entries to return on each page for a paged query.	10

Response elements

Element	Type	Description	Example
	object
RequestId	string	The ID of the request.	6B780BD6-282C-51A9-A8E6-59F636BAFA54
PageInfo	object	The pagination information.
CurrentPage	integer	The page number of the returned page.	1
PageSize	integer	The number of entries returned per page.	10
TotalCount	integer	The total number of entries returned.	40
DataList	array<object>	The list of returned data.
	object	The list of returned data.
RiskLevel	integer	The risk level. Valid values: 3: high 2: medium 1: low 0: none	3
TrafficPercent1Day	string	For details about the traffic, see the TotalBytes field.	0
AclRecommendDetail	string	The reason why no intelligent policy is recommended. Valid values: No intelligent policy is recommended. This feature is available only to specific users. The policy configuration has been modified. No intelligent policy is recommended. An intelligent policy has been configured. No new intelligent policy is recommended.	No recommended intelligent policies are available.
AssetsName	string	The instance name.	launch-advisor-2023****
RegionNo	string	The region ID of the instance.	cn-shenzhen
AssetsType	string	The asset type of the instance.	EcsEIP
HasAclRecommend	boolean	Indicates whether an access control list (ACL) is recommended. Valid values: true: yes false: no	true
DetailNum	integer	The total number of port details.	5
TrafficPercent7Day	string	For details about the traffic, see the TotalBytes field.	0
TrafficPercent30Day	string	For details about the traffic, see the TotalBytes field.	0
PublicIp	string	The public IP address of the instance.	203.0.113.1
RiskReason	string	The reason for the risk.	Previous traffic is all malicious traffic.
AssetsInstanceId	string	The instance ID.	i-bp1ix9w22kv6aew9****
PortList	array	The list of ports.
	string	The list of ports.	["3000","5601","8886,"8887","8889"]
ServiceNameList	array	The list of applications.
	string	The list of applications.	['HTTPS', 'RDP', 'SSL', 'Unknown']
TotalReplyBytes	integer	The total response traffic in the last 7 days.	100000
SrcIpCnt	integer	The number of source IP addresses.	22
MemberUid	integer	The UID of the Cloud Firewall member account.	14151892****7022
InBytes	integer	The inbound network throughput, which indicates the total number of bytes received. Unit: bytes.	235
OutBytes	integer	The outbound network throughput, which indicates the total number of bytes sent. Unit: bytes.	1123
TotalBytes	integer	The total traffic. Unit: bytes.	253023143
UnknownReason	array	The reason why the protocol is not identified when the protocol is Unknown.
	string	The reason why the protocol is not identified when the protocol is Unknown.	no_payload

Examples

Success response

JSON format

{
  "RequestId": "6B780BD6-282C-51A9-A8E6-59F636BAFA54",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 10,
    "TotalCount": 40
  },
  "DataList": [
    {
      "RiskLevel": 3,
      "TrafficPercent1Day": "0",
      "AclRecommendDetail": "No recommended intelligent policies are available.",
      "AssetsName": "launch-advisor-2023****",
      "RegionNo": "cn-shenzhen",
      "AssetsType": "EcsEIP",
      "HasAclRecommend": true,
      "DetailNum": 5,
      "TrafficPercent7Day": "0",
      "TrafficPercent30Day": " 0",
      "PublicIp": "203.0.113.1",
      "RiskReason": "Previous traffic is all malicious traffic.",
      "AssetsInstanceId": "i-bp1ix9w22kv6aew9****",
      "PortList": [
        "[\"3000\",\"5601\",\"8886,\"8887\",\"8889\"]"
      ],
      "ServiceNameList": [
        "['HTTPS', 'RDP', 'SSL', 'Unknown']"
      ],
      "TotalReplyBytes": 100000,
      "SrcIpCnt": 22,
      "MemberUid": 0,
      "InBytes": 235,
      "OutBytes": 1123,
      "TotalBytes": 253023143,
      "UnknownReason": [
        "no_payload"
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.