DescribeInternetTimeTop - - Centre de documentation Alibaba Cloud

Consulte le trafic Internet Top-N au fil du temps.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

yundun-cloudfirewall:DescribeInternetTimeTop

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SourceIp	string	Non	L'adresse IP source.	60.179.179.XXX
Lang	string	Non	La langue de la réponse. Valeurs valides : en : Anglais. zh : Chinois.	zh
Lang	string	Non	La langue de la réponse. Valeurs valides : en : Anglais. zh : Chinois.	zh
Direction	string	Oui	La direction du trafic. Valeurs valides : in : Entrant. out : Sortant.	out
SourceCode	string	Oui	L'identifiant de la source de trace.	yundun
Sort	string	Non	La métrique selon laquelle trier les résultats. Valeurs valides : out_pps : out_pps. in_bps : in_bps. out_bps : out_bps. in_pps : in_pps.	in_bps
TrafficTime	string	Non	L'horodatage du trafic à interroger, spécifié sous forme d'horodatage Unix en secondes.	1745222880
Limit	string	Non	Le nombre maximal d'entrées à renvoyer. La valeur doit être comprise entre 1 et 50. Valeur par défaut : 50.	5
SrcIP	string	Non	L'adresse IP source.	8.153.18.XX
NatIP	string	Non	L'adresse IP publique NAT. Si elle est omise, les données de trafic de toutes les ressources sont renvoyées.	47.97.66.XXX
Order	string	Non	L'ordre de tri. Valeurs valides : asc : Croissant. desc : Décroissant.	desc
StartTime	string	Non	Le début de la plage de temps de la requête, spécifié sous forme d'horodatage Unix en secondes.	1749434787
EndTime	string	Non	La fin de la plage de temps de la requête, spécifiée sous forme d'horodatage Unix en secondes.	1733796528
TrafficType	string	Non	Le type de trafic.	EIP_TRAFFIC
IPType	string	Non	Le type de réseau de l'adresse IP. Valeurs valides : Private : Réseau privé virtuel. Public : Réseau public.	Public
Interval	integer	Non	L'intervalle de temps en secondes.	60

Éléments de réponse

Élément	Type	Description	Exemple
	object
TrafficTime	integer	L'horodatage des données de trafic. Unité : secondes.	1734399660
RequestId	string	L'identifiant de la requête.	7F2D5C04-731F-50B0-ADE1-01637B3C****
DataCount	integer	Le nombre d'entrées renvoyées.	19
DataList	array<object>	La liste des entrées de données.
	object	L'entrée de données.
ResourceInstanceName	string	Le nom de la ressource.	test
InBps	integer	La bande passante entrante. Unité : bit/s.	187
ResourceInstanceId	string	L'identifiant de l'instance de ressource.	lb-bp14ue2rgktunncq****
NewConn	integer	Le nombre de nouvelles connexions.	27
RegionNo	string	L'identifiant de la région.	cn-shenzhen
OutPps	integer	Le taux de transfert de paquets sortant. Unité : pps.	2
IP	string	L'adresse IP publique.	183.60.164.XXX
OutBps	integer	Le trafic sortant. Unité : bit/s.	45
PrivateIP	string	L'adresse IP privée.	10.21.186.XXX
SessionCount	integer	Le nombre de sessions.	27
ResourceType	string	Le type de l'adresse IP publique. Valeurs valides : EcsEIP : EcsEIP. EcsPublicIP : EcsPublicIP. NatPublicIP : NatPublicIP. NatEIP : NatEIP.	EcsPublicIP
InPps	integer	Le taux de transfert de paquets entrant. Unité : pps.	2
TotalPps	integer	Le nombre total de paquets.	88
TotalBps	integer	La bande passante totale. Unité : bit/s.	232
VpcId	string	L'identifiant du réseau privé virtuel (VPC).	vpc-wz9o0uzfjuj81fx7m****
NatGatewayId	string	L'identifiant de la passerelle NAT.	ngw-wz98eedr5l5hkb8****e7
NatGatewayName	string	Le nom de la passerelle NAT.	ngw-test
NatIP	string	L'adresse IP publique de la passerelle NAT.	47.97.66.XXX

Exemples

JSON format

{
  "TrafficTime": 1734399660,
  "RequestId": "7F2D5C04-731F-50B0-ADE1-01637B3C****",
  "DataCount": 19,
  "DataList": [
    {
      "ResourceInstanceName": "test",
      "InBps": 187,
      "ResourceInstanceId": "lb-bp14ue2rgktunncq****",
      "NewConn": 27,
      "RegionNo": "cn-shenzhen",
      "OutPps": 2,
      "IP": "183.60.164.XXX",
      "OutBps": 45,
      "PrivateIP": "10.21.186.XXX",
      "SessionCount": 27,
      "ResourceType": "EcsPublicIP",
      "InPps": 2,
      "TotalPps": 88,
      "TotalBps": 232,
      "VpcId": "vpc-wz9o0uzfjuj81fx7m****",
      "NatGatewayId": "ngw-wz98eedr5l5hkb8****e7",
      "NatGatewayName": "ngw-test",
      "NatIP": "47.97.66.XXX"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorSourceCodeError	The source code is invalid.	The source code is invalid.
400	ErrorDirectionError	The direction is invalid.	The direction is invalid.
400	ErrorTimeError	The time is invalid.	The time is invalid.
400	ErrorIpFormat	The IP address is invalid.	The IP address is invalid.
400	ErrorParameters	A parameter error occurred.	A parameter error occurred.
400	ErrorDBSelectError	A database select error occurred.	The error message returned because an internal error has occurred in querying the database.
400	ErrorTrafficType	The traffic type is invalid.	The traffic type is invalid.
400	ErrorSortError	The sort is invalid.	The sort is invalid.
400	ErrorLimitFailed	The limit is invalid.	The limit count is invalid.
400	ErrorOrderFailed	The order is invalid.	The order is invalid.
400	ErrorMarshalJSON	internal error.	Internal error.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.