DescribeInstanceBill - - Centre de documentation Alibaba Cloud

Consulte le résumé de consommation de toutes les instances de produit ou éléments facturables pour un utilisateur au cours d'un cycle de facturation spécifique.

Description de l'opération

Les résultats de requête pour le mois en cours sont fournis à titre indicatif uniquement et ne peuvent pas être utilisés comme base de rapprochement. La facture finale du mois en cours peut être consultée ou exportée après 12h00 le 3e jour du mois suivant. Au cours du mois, plusieurs scénarios peuvent se produire, y compris, mais sans s'y limiter, des retards de facturation, des remboursements, des ajustements de facture et des annulations de paiements en souffrance.
Les données de facturation du mois en cours n'incluent pas les données à l'usage non réglées qui ne sont pas encore facturées ou qui sont en cours d'accumulation.
Les données des 18 derniers mois sont prises en charge.
Les données de facturation sont mises à jour avec un délai de 24 heures par rapport à la consommation réelle. Les informations liées à l'identifiant de l'instance, telles que la configuration de l'instance, le type d'instance, l'alias de l'instance, le groupe de ressources, l'adresse IP publique, l'adresse IP privée et la zone, sont mises à jour avec un délai de 48 heures.
Les données de facturation ne fournissent pas les coûts spécifiques des éléments fractionnés individuels, tels que les noms de domaine, les compartiments et les EIP, pour les services cloud de type fractionné, tels que CDN, OSS et la bande passante partagée Internet. Pour consulter les données incluant les éléments fractionnés, accédez à la page des factures fractionnées.
Pour les produits de communication cloud, seules les données détaillées à partir de juin 2020 sont prises en charge. Pour les produits HiChina, y compris les noms de domaine et les marques, seules les données détaillées à partir de novembre 2020 sont prises en charge.
La limite de taux est de 10 requêtes par seconde et par utilisateur. Si un délai d'attente se produit, réessayez la requête.

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.

bssapi:DescribeInstanceBill

get

*All resources.

*

bssapi:ProductCode
bssapi:ProductCode
bssapi:ProductType
bssapi:ProductType

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
BillingCycle	string	Oui	Le cycle de facturation au format AAAA-MM. Seuls les 18 derniers cycles de facturation sont pris en charge.	2020-03
ProductCode	string	Non	Le code du produit.	rds
ProductType	string	Non	Le type de produit.	rds
SubscriptionType	string	Non	Le type d'abonnement. Valeurs valides : Subscription : abonnement. PayAsYouGo : à l'usage.	PayAsYouGo
IsBillingItem	boolean	Non	Indique si les données doivent être récupérées par élément facturable. Valeurs valides : false (par défaut) : les données correspondent aux factures d'instances dans Dépenses et coûts > Factures > Détails de la facture > Factures d'instances. true : les données correspondent aux factures d'éléments facturables dans Dépenses et coûts > Factures > Détails de la facture > Factures d'éléments facturables.	false
NextToken	string	Non	La position à partir de laquelle l'appel actuel commence à lire les données. La valeur doit être vide ou définie sur la valeur NextToken renvoyée dans la réponse précédente. Sinon, une erreur se produit. Une valeur vide indique que la lecture commence depuis le début.	CAESEgoQCg4KCm
MaxResults	integer	Non	Le nombre maximal d'enregistrements de données à lire lors de l'appel actuel. Valeur par défaut : 20. Valeur maximale : 300.	20
IsHideZeroCharge	boolean	Non	Indique si les enregistrements dont le prix d'origine (PretaxGrossAmount) et le montant à payer (PretaxAmount) sont tous deux égaux à 0 doivent être filtrés. Valeurs valides : false true	false
BillingDate	string	Non	La date de facturation. Ce paramètre est requis uniquement lorsque Granularity est défini sur DAILY. Format : AAAA-MM-JJ. Remarque La valeur de BillingDate doit correspondre au même mois que la valeur de BillingCycle. Par exemple, si BillingCycle est défini sur 2020-03, BillingDate doit être défini sur 2020-03-JJ. Si les mois ne correspondent pas, les résultats de la requête sont renvoyés en fonction de l'heure spécifiée par BillingCycle.	2020-03-02
Granularity	string	Non	La granularité à laquelle les factures sont interrogées. Valeurs valides : MONTHLY : mensuelle. Les données correspondent aux factures mensuelles dans Dépenses et coûts > Factures > Détails de la facture > Factures mensuelles. DAILY : quotidienne. Les données correspondent aux factures quotidiennes dans Dépenses et coûts > Factures > Détails de la facture > Factures quotidiennes. Remarque Si vous sélectionnez DAILY, vous devez spécifier BillingDate.	MONTHLY
BillOwnerId	integer	Non	L'identifiant du compte propriétaire de la ressource. Le compte propriétaire de la ressource est le compte qui utilise réellement la ressource.	122
InstanceID	string	Non	L'identifiant de l'instance.	abc
PipCode	string	Non	Le code du produit, qui correspond au code du produit dans les factures du Centre utilisateur.	rds

Éléments de réponse

Élément	Type	Description	Exemple
	object
Code	string	Le code d'état.	Success
Data	object	Les données renvoyées.
AccountID	string	L'identifiant du compte.	122
AccountName	string	Le compte utilisateur.	test@test.aliyunid.com
BillingCycle	string	La date de facturation. Format : AAAA-MM.	2020-03
Items	array<object>	Les détails de la facture.
	object
AfterDiscountAmount	number	Le montant après remise, y compris le montant à payer après déduction du bon de réduction. Règle de calcul : Montant après remise = Prix catalogue - Montant de la remise.	0
BillAccountID	string	L'identifiant du compte auquel la facture appartient.	122
BillAccountName	string	Le nom du compte auquel la facture appartient.	test@test.aliyunid.com
BillingDate	string	La date de facturation. Ce paramètre n'a de valeur que lorsque Granularity est défini sur DAILY. Format : AAAA-MM-JJ.	2020-03-20
BillingItem	string	L'élément facturable. Ce paramètre n'a de valeur que lorsque IsBillingItem est défini sur true.	Bandwidth
BillingItemCode	string	Le code de l'élément facturable.	disk
BillingType	string	La méthode de facturation.	Other
BizType	string	Le type d'activité.	trusteeship
CommodityCode	string	Le code de l'article, qui est identique au code de détail du produit dans le Centre utilisateur.	rds
CostUnit	string	L'unité de coût.	Unallocated
Currency	string	La devise. Valeurs valides : CNY USD JPY	CNY
DeductedByCoupons	number	Le montant de la remise par bon de réduction.	0.1
DeductedByResourcePackage	string	Le montant déduit par les plans de ressources. Ce paramètre n'est valide que lorsque isBillingItem est défini sur true.	0.1
InstanceConfig	string	La configuration détaillée de l'instance.	CPU：12
InstanceID	string	L'identifiant de l'instance.	i-dadada
InstanceSpec	string	Les spécifications de l'instance.	ecs.sn1ne.3xlarge
InternetIP	string	L'adresse IP publique.	34.xx.x.x
IntranetIP	string	L'adresse IP interne.	192.xx.xx.xx
InvoiceDiscount	number	Le montant de la remise.	0.1
Item	string	Le type de facture. Valeurs valides : SubscriptionOrder : commande d'abonnement PayAsYouGoBill : facture à l'usage Refund : remboursement Adjustment : ajustement	PayAsYouGoBill
ItemName	string	Le nom de l'élément.	iZ28bycvyb4Z
ListPrice	string	Le prix unitaire. Ce paramètre n'est valide que lorsque isBillingItem est défini sur true.	100
ListPriceUnit	string	L'unité du prix unitaire. Ce paramètre n'est valide que lorsque isBillingItem est défini sur true.	CNY
NickName	string	Le surnom de l'instance.	test
OwnerID	string	L'identifiant du compte du propriétaire de la ressource dans les scénarios de paiement multi-comptes.	123
PipCode	string	Le code du produit, qui correspond au code du produit dans les factures du Centre utilisateur.	rds
PretaxAmount	number	Le montant à payer.	0.1
PretaxGrossAmount	number	Le montant d'origine.	0.1
ProductCode	string	Le code du produit.	rds
ProductDetail	string	Le détail du produit.	ApsaraDB RDS
ProductName	string	Le nom du produit.	ApsaraDB RDS
ProductType	string	Le type de produit.	rds
Region	string	La région.	Hangzhou
ResourceGroup	string	Le groupe de ressources.	Default resource group
ServicePeriod	string	La durée du service.	3600
ServicePeriodUnit	string	L'unité de la durée du service.	Seconds
SubscriptionType	string	Le type d'abonnement. Valeurs valides : Subscription : abonnement PayAsYouGo : à l'usage	PayAsYouGo
Tag	string	La balise de ressource.	key:testKey value:testValue; key:testKey1 value:testValues1
Usage	string	L'utilisation. Remarque Ce paramètre n'est valide que lorsque isBillingItem est défini sur true. Les données d'utilisation correspondent à la somme de l'utilisation sur toutes les factures du cycle, et non au montant réellement acheté. Par exemple, si 1 Go de stockage est utilisé et facturé à l'heure, l'utilisation horaire est de 1 Go, et l'utilisation quotidienne agrégée de la facture est de 1 Go × 24 = 24 Go.	100
UsageUnit	string	L'unité d'utilisation. Ce paramètre n'est valide que lorsque isBillingItem est défini sur true.	GB
Zone	string	La zone.	Hangzhou Zone 1
MaxResults	integer	Le nombre maximal d'enregistrements renvoyés pour la requête actuelle.	20
NextToken	string	Le jeton qui indique la position à partir de laquelle l'appel actuel reprend la lecture. Une valeur vide indique que toutes les données ont été lues. Pour l'appel suivant, définissez cette valeur sur le paramètre de requête NextToken.	CAESEgoQCg4KCm
TotalCount	integer	Le nombre total d'enregistrements.	20
Message	string	Le message d'erreur.	Successful!
RequestId	string	L'identifiant de la requête.	79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Success	boolean	Indique si la requête a réussi.	true

Exemples

JSON format

{
  "Code": "Succès",
  "Data": {
    "AccountID": "122",
    "AccountName": "test@test.aliyunid.com",
    "BillingCycle": "2020-03",
    "Items": [
      {
        "AfterDiscountAmount": 0,
        "BillAccountID": "122",
        "BillAccountName": "test@test.aliyunid.com",
        "BillingDate": "2020-03-20",
        "BillingItem": "Bandwidth",
        "BillingItemCode": "disk",
        "BillingType": "Autre",
        "BizType": "trusteeship",
        "CommodityCode": "rds",
        "CostUnit": "Non alloué",
        "Currency": "CNY",
        "DeductedByCoupons": 0.1,
        "DeductedByResourcePackage": "0.1",
        "InstanceConfig": "CPU : 12",
        "InstanceID": "i-dadada",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "InternetIP": "34.xx.x.x\t",
        "IntranetIP": "192.xx.xx.xx",
        "InvoiceDiscount": 0.1,
        "Item": "PayAsYouGoBill",
        "ItemName": "iZ28bycvyb4Z",
        "ListPrice": "100",
        "ListPriceUnit": "CNY",
        "NickName": "test",
        "OwnerID": "123",
        "PipCode": "rds",
        "PretaxAmount": 0.1,
        "PretaxGrossAmount": 0.1,
        "ProductCode": "rds",
        "ProductDetail": "ApsaraDB RDS",
        "ProductName": "ApsaraDB RDS",
        "ProductType": "rds",
        "Region": "Hangzhou",
        "ResourceGroup": "Groupe de ressources par défaut",
        "ServicePeriod": "3600",
        "ServicePeriodUnit": "Seconde",
        "SubscriptionType": "PayAsYouGo",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Usage": "100",
        "UsageUnit": "GB",
        "Zone": "Zone 1 de Hangzhou"
      }
    ],
    "MaxResults": 20,
    "NextToken": "CAESEgoQCg4KCm",
    "TotalCount": 20
  },
  "Message": "Réussi !",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.