DescribeSplitItemBill - - Centre de documentation Alibaba Cloud

Consulte les factures réparties.

Description de l'opération

Les résultats de requête pour les factures réparties du mois en cours sont fournis à titre indicatif uniquement et ne peuvent pas servir de base à la réconciliation. La facture finale du mois en cours peut être consultée après 12h00 le 4e jour du mois suivant. Les données de facturation répartie du mois en cours n'incluent pas les données à l'usage non réglées (non facturées ou en cours d'accumulation).
Les données de facturation répartie sont disponibles pour les 12 derniers mois.
Les données de facturation répartie sont mises à jour avec un délai de 48 heures par rapport aux dépenses réelles. Pour les services cloud répartis (tels que CDN, OSS et Internet Shared Bandwidth), les dépenses spécifiques de chaque ressource associée (telles que les noms de domaine, les buckets et les EIP) sont mises à jour avec un délai de 72 heures.
Les données de facturation répartie ne sont disponibles qu'après avoir activé la fonctionnalité sur la page Facture répartie dans la console. Les données deviennent disponibles 24 heures après l'activation de la fonctionnalité.
La limite de fréquence est de 10 requêtes par seconde et par utilisateur. En cas d'expiration du délai, 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:DescribeSplitItemBill

get

*All resources.

*

bssapi:ProductCode
bssapi:ProductType

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
BillingCycle	string	Oui	Le cycle de facturation. Format : AAAA-MM.	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. Remarque Ce paramètre doit être utilisé conjointement avec le paramètre ProductCode.	PayAsYouGo
NextToken	string	Non	Le jeton qui spécifie la position à partir de laquelle l'appel actuel commence à lire les données. La valeur doit être vide ou correspondre à la valeur de NextToken renvoyée dans la réponse précédente. Sinon, une erreur se produit. Une valeur vide indique que l'opération de lecture commence depuis le début.	CAESEgoQCg4KCmd
MaxResults	integer	Non	Le nombre maximal d'entrées à renvoyer dans l'appel actuel. Valeur par défaut : 20. Valeur maximale : 300.	20
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.	123
InstanceID	string	Non	L'identifiant de l'instance.	i-kjhdskjgshfdlkjfdh
SplitItemID	string	Non	L'identifiant de la ressource associée.	i-kjhdskjgshfdlkjfdh
Granularity	string	Non	La granularité à laquelle les factures sont interrogées. Valeurs valides : MONTHLY : mensuelle. Cette valeur correspond aux factures mensuelles sur la page Facture répartie du Centre utilisateur. DAILY : quotidienne. Cette valeur correspond aux factures quotidiennes sur la page Facture répartie du Centre utilisateur. Remarque Si vous définissez ce paramètre sur DAILY, vous devez spécifier le paramètre BillingDate.	Monthly
BillingDate	string	Non	La date de facturation. Ce paramètre n'est requis que lorsque Granularity est défini sur DAILY. Format : AAAA-MM-JJ.	2020-03-02
TagFilter	array<object>	Non	Les conditions de filtrage des balises. Plusieurs ensembles de conditions de requête TagValues sont pris en charge. La relation logique entre plusieurs ensembles de conditions TagValues est OR.
	object	Non	Les conditions de filtrage des balises.
TagKey	string	Non	TagFilter.N est utilisé pour interroger les factures qui correspondent aux balises spécifiées. Il se compose d'une paire clé-valeur. La clé de balise doit comporter entre 1 et 128 caractères. Valeurs valides de N : 1 à 20. Si vous spécifiez uniquement TagFilter.N.TagKey, toutes les factures associées à la clé de balise sont renvoyées. Si vous spécifiez plusieurs paires clé-valeur de balise, les factures correspondant à l'une des paires clé-valeur sont renvoyées. Si les balises d'une ressource changent, vous ne pouvez interroger que les factures générées pendant la période où les balises étaient associées à la ressource.	TestKey
TagValues	array	Non	TagValues.N est utilisé pour interroger les factures qui correspondent aux valeurs de balise spécifiées. Il se compose d'une liste de chaînes. La valeur de balise doit comporter entre 1 et 128 caractères. Valeurs valides de N : 1 à 20. Si vous spécifiez TagValues.N, vous devez également spécifier TagFilter.N.TagKey. Sinon, l'erreur InvalidParameter.TagValues est signalée. Si vous spécifiez plusieurs valeurs de balise, les factures correspondant à l'une des valeurs de balise sont renvoyées.	TestValue
	string	Non	La valeur de la balise.	TestValue
IsHideZeroCharge	boolean	Non	Indique si les factures dont le prix d'origine (PretaxGrossAmount) et le montant à payer (PretaxAmount) sont tous deux égaux à 0 doivent être filtrées. Valeurs valides : false : ne filtre pas les factures. true : filtre les factures.	false
PipCode	string	Non	Le code du produit. Cette valeur est identique 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 de réponse.
AccountID	string	L'identifiant du compte.	185xxxx3489
AccountName	string	Le compte utilisateur.	test@test.aliyunid.com
BillingCycle	string	Le cycle de facturation. Format : AAAA-MM.	2020-03
Items	array<object>	Les détails de la facture.
	object
AfterDiscountAmount	number	Le montant après remise, qui inclut le montant à payer après déduction des coupons. Règle de calcul : Montant après remise = Prix catalogue - Montant de la remise.	0
BillAccountID	string	L'identifiant du compte auquel appartient la facture.	185xxxx3489
BillAccountName	string	Le nom du compte auquel appartient la facture.	test@test.aliyunid.com
BillingDate	string	La date de facturation au format AAAA-MM-JJ. Ce paramètre n'est pas pris en charge.	2020-01-20
BillingItem	string	L'élément de facturation.	Bandwidth
BillingItemCode	string	Le code de l'élément de facturation.	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 du 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 coupon.	0
DeductedByResourcePackage	string	Le montant déduit par les plans de ressources.	0
InstanceConfig	string	La configuration détaillée de l'instance.	CPU:12
InstanceID	string	L'identifiant de l'instance.	i-kjhdskjgshfdlkjfdh
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
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.	0.12
ListPriceUnit	string	L'unité du prix unitaire.	CNY/GB
NickName	string	Le surnom de l'instance.	nick
OwnerID	string	L'identifiant du compte du propriétaire de la ressource dans les scénarios de paiement multi-comptes.	169***013
PipCode	string	Le code du produit, qui est identique au code du produit de facturation dans le Centre utilisateur.	rds
PretaxAmount	number	Le montant à payer.	0
PretaxGrossAmount	number	Le montant d'origine.	0
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.	20
ServicePeriodUnit	string	L'unité de la durée du service.	Hour
SplitAccountID	string	L'identifiant du compte de la ressource rattachée.	12**122
SplitAccountName	string	Le nom du compte de la ressource rattachée.	test**1122
SplitBillingCycle	string	Le mois de la facture fractionnée.	2021-06
SplitBillingDate	string	La date de la facture fractionnée.	2021-06-01
SplitCommodityCode	string	Le code de l'article de la ressource rattachée.	rds
SplitItemID	string	L'identifiant de la ressource associée.	i-28bycvyb4
SplitItemName	string	Le nom de la ressource rattachée.	iZ28bycvyb4Z
SplitProductDetail	string	Le nom du détail du produit de la ressource rattachée.	ApsaraDB
SubscriptionType	string	Le type d'abonnement. Valeurs valides : Subscription : Abonnement. PayAsYouGo : À l'usage.	PayAsYouGo
Tag	string	La balise de la ressource. Si une balise d'une ressource est modifiée, les factures générées pendant la période de validité incluront cette balise.	key:testKey value:testValue; key:testKey1 value:testValues1
Usage	string	L'utilisation.	100
UsageUnit	string	L'unité d'utilisation.	GB
Zone	string	La zone.	China North 1
MaxResults	integer	Le nombre maximal d'entrées renvoyées pour la requête actuelle.	20
NextToken	string	Le jeton qui indique la position où l'appel actuel s'arrête de lire. Une valeur vide indique que toutes les données ont été lues. Définissez cette valeur sur le paramètre de requête NextToken lors du prochain appel.	CAESEgoQCg4K
TotalCount	integer	Le nombre total d'entrées.	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": "Success",
  "Data": {
    "AccountID": "185xxxx3489",
    "AccountName": "test@test.aliyunid.com",
    "BillingCycle": "2020-03",
    "Items": [
      {
        "AfterDiscountAmount": 0,
        "BillAccountID": "185xxxx3489",
        "BillAccountName": "test@test.aliyunid.com",
        "BillingDate": "2020-01-20",
        "BillingItem": "Bandwidth",
        "BillingItemCode": "disk",
        "BillingType": "Other",
        "BizType": "trusteeship",
        "CommodityCode": "rds",
        "CostUnit": "Unallocated",
        "Currency": "CNY",
        "DeductedByCoupons": 0,
        "DeductedByResourcePackage": "0",
        "InstanceConfig": "CPU:12",
        "InstanceID": "i-kjhdskjgshfdlkjfdh",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "InternetIP": "34.xx.x.x",
        "IntranetIP": "192.xx.xx.xx",
        "InvoiceDiscount": 0,
        "Item": "PayAsYouGoBill",
        "ItemName": "iZ28bycvyb4Z",
        "ListPrice": "0.12",
        "ListPriceUnit": "USD/GB",
        "NickName": "nick",
        "OwnerID": "169***013",
        "PipCode": "rds",
        "PretaxAmount": 0,
        "PretaxGrossAmount": 0,
        "ProductCode": "rds",
        "ProductDetail": "ApsaraDB RDS",
        "ProductName": "ApsaraDB RDS",
        "ProductType": "rds",
        "Region": "Hangzhou",
        "ResourceGroup": "Groupe de ressources par défaut",
        "ServicePeriod": "20",
        "ServicePeriodUnit": "Heure",
        "SplitAccountID": "12**122",
        "SplitAccountName": "test**1122",
        "SplitBillingCycle": "2021-06",
        "SplitBillingDate": "2021-06-01",
        "SplitCommodityCode": "rds",
        "SplitItemID": "i-28bycvyb4",
        "SplitItemName": "iZ28bycvyb4Z",
        "SplitProductDetail": "ApsaraDB",
        "SubscriptionType": "PayAsYouGo",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Usage": "100",
        "UsageUnit": "GB",
        "Zone": "China North 1"
      }
    ],
    "MaxResults": 20,
    "NextToken": "CAESEgoQCg4K",
    "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.