QueryInstanceBill - - Centre de documentation Alibaba Cloud

Consulte le résumé d'utilisation de toutes les instances de produit ou éléments facturables pour un compte au cours d'un cycle de facturation. Cette opération a été mise à niveau vers DescribeInstanceBill. Cette opération ne permet plus de consulter les données au-delà de la 50 000e ligne.

Description de l'opération

Description de l'API.

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.

bss:DescribeBillList

get

*All Resource

*

bssapi:ProductCode
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. Les données des 18 derniers mois sont prises en charge.	2020-03
ProductCode	string	Non	Le code du produit.	rds
ProductType	string	Non	Le type de produit. Requis lorsque le paramètre ProductCode est défini sur le code d'un produit Alibaba Cloud Marketplace.	rds
SubscriptionType	string	Non	Le type d'abonnement. Valeurs valides :	PayAsYouGo
IsBillingItem	boolean	Non	Indique si les données doivent être requêtées par élément facturable.	false
PageNum	integer	Non	Le numéro de page. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page. Valeur par défaut : 20. Valeur maximale : 300.	20
IsHideZeroCharge	boolean	Non	Indique s'il faut filtrer les factures pour lesquelles le montant brut hors taxes (PretaxGrossAmount) et le montant hors taxes (PretaxAmount) sont tous deux égaux à 0. Valeurs valides :	false
BillingDate	string	Non	La date de facturation. Ce paramètre est requis uniquement lorsque le paramètre Granularity est défini sur DAILY. La valeur doit être au format AAAA-MM-JJ.	2020-03-03
Granularity	string	Non	La granularité à laquelle requêter les factures. Valeurs valides :	MONTHLY
BillOwnerId	integer	Non	L'identifiant du compte qui possède les ressources. Ce compte est l'utilisateur réel des ressources.	122

Éléments de réponse

Élément	Type	Description	Exemple
	object
Code	string	Le code d'état.	Success
Message	string	Le message d'erreur.	Successful!
RequestId	string	L'identifiant de la requête.	79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Success	boolean	Indique si l'appel a réussi.	true
Data	object	Les données renvoyées.
PageNum	integer	Le numéro de page.	1
BillingCycle	string	Le cycle de facturation au format AAAA-MM.	2020-03
AccountID	string	L'identifiant du compte.	185xxxx3489
PageSize	integer	Le nombre d'entrées par page.	20
TotalCount	integer	Le nombre total d'enregistrements.	2
AccountName	string	Le compte utilisateur.	test@test.aliyunid.com
Items	object
Item	array<object>	The bill details.
	object
BillingDate	string	The billing date. This parameter is returned only when the Granularity parameter is set to DAILY. The value is in the YYYY-MM-DD format.	2020-03
InstanceConfig	string	The detailed configuration of the instance.	CPU:12
InternetIP	string	The public IP address.	34.xx.x.x
Item	string	The type of the bill. Valid values: SubscriptionOrder PayAsYouGoBill Refund Adjustment	PayAsYouGoBill
Tag	string	The tag.	tag
InstanceID	string	The instance ID.	i-kjhdskjgshfdlkjfdh
Currency	string	The currency. Valid values: CNY. USD. JPY.	CNY
SubscriptionType	string	The subscription type. Valid values: Subscription: subscription. PayAsYouGo: pay-as-you-go. Remarque This parameter must be used with the ProductCode parameter.	PayAsYouGo
InstanceSpec	string	The instance type.	ecs.sn1ne.3xlarge
DeductedByCoupons	number	The amount deducted using coupons.	0
BillingItem	string	The billable item. This parameter is returned only when IsBillingItem is set to true.	其他
Region	string	The region.	杭州
CostUnit	string	The cost center.	未分配
ListPriceUnit	string	The unit of the list price. This parameter is valid only when isBillingItem is set to true.	元
ResourceGroup	string	The resource group.	默认资源组
PipCode	string	The product code. This is the same as the product code in the bills in the User Center.	rds
ServicePeriodUnit	string	The unit of the service duration.	秒
PretaxAmount	number	The pretax amount.	0
CommodityCode	string	The commodity code. This is the same as the product detail code in the User Center.	rds
ProductName	string	The product name.	云数据库RDS
NickName	string	The instance nickname.	test
ProductDetail	string	The product details.	云数据库RDS
Usage	string	The usage. This parameter is valid only when isBillingItem is set to true.	100
IntranetIP	string	The internal IP address.	192.xx.xx.xx
OwnerID	string	The account ID of the RAM user. This parameter is returned in a multi-account payment scenario.	169***013
UsageUnit	string	The unit of the usage. This parameter is valid only when isBillingItem is set to true.	GB
InvoiceDiscount	number	The discount amount.	0
DeductedByResourcePackage	string	The amount deducted using resource packages.	NULL
ProductType	string	The product type.	rds
ServicePeriod	string	The service duration.	10
Zone	string	The zone.	cn-hangzhou-h
ListPrice	string	The list price. This parameter is valid only when isBillingItem is set to true.	100
PretaxGrossAmount	number	The pretax gross amount.	0
ProductCode	string	The product code.	rds
BillingType	string	The billing method.	其它

Exemples

JSON format

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-03",
    "AccountID": "185xxxx3489",
    "PageSize": 20,
    "TotalCount": 2,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "BillingDate": "2020-03",
          "InstanceConfig": "CPU:12",
          "InternetIP": "34.xx.x.x",
          "Item": "PayAsYouGoBill",
          "Tag": "tag",
          "InstanceID": "i-kjhdskjgshfdlkjfdh",
          "Currency": "CNY",
          "SubscriptionType": "PayAsYouGo",
          "InstanceSpec": "ecs.sn1ne.3xlarge",
          "DeductedByCoupons": 0,
          "BillingItem": "其他",
          "Region": "杭州",
          "CostUnit": "未分配",
          "ListPriceUnit": "元",
          "ResourceGroup": "默认资源组",
          "PipCode": "rds",
          "ServicePeriodUnit": "秒",
          "PretaxAmount": 0,
          "CommodityCode": "rds",
          "ProductName": "云数据库RDS",
          "NickName": "test",
          "ProductDetail": "云数据库RDS",
          "Usage": "100",
          "IntranetIP": "192.xx.xx.xx",
          "OwnerID": "169***013",
          "UsageUnit": "GB",
          "InvoiceDiscount": 0,
          "DeductedByResourcePackage": "NULL",
          "ProductType": "rds",
          "ServicePeriod": "10",
          "Zone": "cn-hangzhou-h",
          "ListPrice": "100",
          "PretaxGrossAmount": 0,
          "ProductCode": "rds",
          "BillingType": "其它"
        }
      ]
    }
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.