DescribePrepayBillTotal - - Centre de documentation Alibaba Cloud

Consulte la vue d'ensemble de la facturation d'une instance d'abonnement 2.0.

Description de l'opération

Les statistiques couvrent l'instance Cloud Firewall actuelle de l'utilisateur, y compris toutes les données depuis la date d'achat.

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:DescribePrepayBillTotal

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	La langue. Valeur énumérée. Valeur par défaut : zh. Valeur valide : en.	zh
PageSize	integer	Non	Le nombre d'entrées par page. Valeur par défaut : 10.	10
CurrentPage	integer	Non	Le numéro de page dans une requête paginée. Valeur par défaut : 1.	1
StartTime	string	Oui	L'heure de début de la requête. Spécifiez un horodatage UNIX en secondes. Remarque Étant donné que les données de facturation sont agrégées à l'échelle quotidienne, l'horodatage doit correspondre à 00:00:00 du jour en CST (UTC+8). Si l'horodatage n'est pas aligné sur le début de la journée, aucune donnée ne pourra être renvoyée.	1656750960
EndTime	string	Oui	L'heure de fin. Spécifiez un horodatage UNIX en secondes. Remarque Étant donné que les données de facturation sont agrégées à l'échelle quotidienne, l'horodatage doit correspondre à 00:00:00 du jour en CST (UTC+8). Si l'horodatage n'est pas aligné sur le début de la journée, aucune donnée ne pourra être renvoyée.	1646063922
BillType	string	Oui	Le type de facture de l'utilisateur. Ce paramètre est requis dans la pratique. Une erreur est renvoyée si ce paramètre n'est pas spécifié. Valeurs valides : elastic_traffic : trafic élastique sdl : trafic de détection de fuite de données sensibles Valeurs valides : sdl : Trafic de détection de fuite de données sensibles. elastic_traffic : Trafic élastique.	sdl

Éléments de réponse

Élément	Type	Description	Exemple
	object
TotalCount	integer	Le nombre total d'entrées.	132
RequestId	string	L'identifiant de la requête.	450D47F5-956E-543E-8502-***********
BillList	array<object>	La liste des factures, agrégée par jour.
	object
InternetTrafficBandwidth	number	La bande passante du trafic Internet. Unité : Gbit/s.	10
NatTrafficBandwidth	number	La bande passante du trafic NAT. Unité : Gbit/s.	10
VpcTrafficBandwidth	number	La bande passante du trafic VPC. Unité : Gbit/s.	10
OverflowTime	integer	L'horodatage auquel la bande passante maximale (Internet + VPC + NAT) de la journée a été atteinte.	1761588300
DefaultBandwidth	integer	La bande passante par défaut de l'édition. Unité : Mbit/s.	200
ExtensionBandwidth	integer	La bande passante étendue. Unité : Mbit/s.	10
TemporaryBandwidth	integer	La bande passante de mise à niveau temporaire. Unité : Mbit/s.	0
ElasticBandwidth	integer	La valeur de la bande passante élastique. Unité : Mbit/s.	200
MonthlyRemainingFreeTraffic	number	Le trafic gratuit mensuel pour la détection de données sensibles. Unité : Go.	10
DailyDetectionTraffic	number	Le trafic de détection de données sensibles de la journée.	8
BilledDetectionTraffic	number	Le trafic réellement facturé pour la détection de fuite de données sensibles.	5
StartTime	integer	L'heure de début de la journée. La valeur est un horodatage UNIX en secondes.	1761580800
EndTime	integer	L'heure de fin de la journée. La valeur est un horodatage UNIX en secondes.	1761667200
DailyOverflowTraffic	number	Le trafic élastique total de la journée. Unité : Go.	10

Exemples

JSON format

{
  "TotalCount": 132,
  "RequestId": "450D47F5-956E-543E-8502-***********",
  "BillList": [
    {
      "InternetTrafficBandwidth": 10,
      "NatTrafficBandwidth": 10,
      "VpcTrafficBandwidth": 10,
      "OverflowTime": 1761588300,
      "DefaultBandwidth": 200,
      "ExtensionBandwidth": 10,
      "TemporaryBandwidth": 0,
      "ElasticBandwidth": 200,
      "MonthlyRemainingFreeTraffic": 10,
      "DailyDetectionTraffic": 8,
      "BilledDetectionTraffic": 5,
      "StartTime": 1761580800,
      "EndTime": 1761667200,
      "DailyOverflowTraffic": 10
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorAliUid	The aliuid is invalid.	The aliuid is invalid.
400	ErrorNotPostpayUser	not Postpay User.	Non-pay-as-you-go Users.
400	ErrorTimeError	The time is invalid.	The time 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	ErrorMarshalJSON	internal error.	Internal error.
400	ErrorParamsInvalid	Invalid Params	The parameter is invalid.
400	ErrorDbFailed	Query db failed.	DB access error.

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

Notes de version

Consultez Notes de version pour la liste complète.