DescribeSplitItemBill - Expenses and Costs: Central de Documentação do Alibaba Cloud

Consulta faturas divididas.

Descrição da operação

Os dados de fatura dividida do mês atual são apenas para referência e não podem ser usados para reconciliação. A fatura final do mês atual estará disponível para consulta após as 12:00 (UTC+8) do quarto dia do mês seguinte. Os dados de fatura dividida do mês atual não incluem dados pay-as-you-go não liquidados.
Você pode consultar dados de fatura dividida dos últimos 12 meses.
Os dados de fatura dividida são atualizados com um atraso de 48 horas em relação ao consumo real de recursos. Para produtos que suportam faturamento dividido, como CDN, OSS e Internet Shared Bandwidth, os custos de itens faturáveis individuais, como nomes de domínio, buckets e EIPs, são atualizados com um atraso de 72 horas.
Os dados de fatura dividida estão disponíveis somente após você ativar o recurso de fatura dividida na página Split Bill no console. Os dados ficam disponíveis 24 horas após a ativação do recurso.
Um único usuário pode realizar no máximo 10 consultas por segundo (QPS). Se ocorrer um erro de tempo limite, tente novamente a solicitação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
BillingCycle	string	Sim	O ciclo de faturamento. Formato: YYYY-MM.	2020-03
ProductCode	string	Não	O código do produto.	rds
ProductType	string	Não	O tipo do produto.	rds
SubscriptionType	string	Não	O método de faturamento. Valores válidos: Subscription: assinatura. PayAsYouGo: pay-as-you-go. Nota Este parâmetro deve ser usado em conjunto com o parâmetro ProductCode.	PayAsYouGo
NextToken	string	Não	O token usado para recuperar a próxima página de resultados. Você não precisa especificar este parâmetro para a primeira solicitação. O valor é o valor NextToken retornado na chamada de API anterior. Se um valor for especificado, a nova consulta começa a partir da próxima página. Se você deixar este parâmetro vazio, a consulta começa do início.	CAESEgoQCg4KCmd
MaxResults	integer	Não	O número máximo de entradas a serem retornadas. Valor padrão: 20. Valor máximo: 300.	20
BillOwnerId	integer	Não	O ID da conta proprietária do recurso. A conta proprietária do recurso é a conta que realmente utiliza o recurso.	123
InstanceID	string	Não	O ID da instância.	i-kjhdskjgshfdlkjfdh
SplitItemID	string	Não	O ID do item dividido.	i-kjhdskjgshfdlkjfdh
Granularity	string	Não	A granularidade para consultar faturas. Valores válidos: MONTHLY: consulta faturas por mês. Os dados são consistentes com os dados na aba Ciclo de Faturamento da página Split Bill no User Center. DAILY: consulta faturas por dia. Os dados são consistentes com os dados na aba Por Dia da página Split Bill no User Center. Nota Se você definir este parâmetro como DAILY, deverá especificar o parâmetro BillingDate.	Monthly
BillingDate	string	Não	A data de faturamento. Este parâmetro é obrigatório somente quando o parâmetro Granularity é definido como DAILY. Formato: YYYY-MM-DD.	2020-03-02
TagFilter	array<object>	Não	O filtro de tag. Você pode especificar múltiplos valores de tag para o parâmetro TagValues. A relação entre múltiplos valores de tag é OR.
	object	Não	O filtro de tag.
TagValues	array	Não	Os valores de tag. Uma lista de strings. TagValues.N pode ser de 1 a 20, e de 1 a 128 caracteres de comprimento. Se você especificar o parâmetro TagValues.N, também deverá especificar TagFilter.N.TagKey. Caso contrário, um erro InvalidParameter.TagValues será reportado. Se você especificar múltiplos valores de tag, as faturas que correspondem a qualquer um dos valores de tag serão consultadas.	TestValue
	string	Não	O valor da tag.	TestValue
TagKey	string	Não	Especifica a chave de tag para filtrar dados de alocação de custos ou faturamento. Intervalo válido para N: 1 a 20 (você pode definir até 20 filtros de tag). Comprimento: 1 a 128 caracteres. Comportamento: Se você especificar apenas TagKey (sem TagValue), o sistema retorna faturas de todos os recursos que possuem essa chave de tag atribuída (independentemente do valor). Se você especificar múltiplos pares TagKey+TagValue, o sistema usa lógica OR: as faturas são retornadas se qualquer um dos pares chave-valor corresponder. Os dados de faturamento refletem as tags como existiam durante o período de faturamento. Se uma tag for removida ou alterada, as faturas anteriores não são reavaliadas.	TestKey
IsHideZeroCharge	boolean	Não	Especifica se devem ser filtradas as faturas cujos valores PretaxGrossAmount e PretaxAmount são ambos 0. Valores válidos: false true	false
PipCode	string	Não	O código do produto. Este código é consistente com o código do produto na fatura no User Center.	rds

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status.	Success
Message	string	A mensagem de erro.	Successful!
RequestId	string	O ID da solicitação.	79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Success	boolean	Indica se a solicitação foi bem-sucedida.	true
Data	object	Os dados retornados.
NextToken	string	O token usado para recuperar a próxima página de resultados. Se este parâmetro estiver vazio, todos os resultados foram retornados. Para a próxima consulta, passe o valor deste parâmetro como o parâmetro de solicitação NextToken.	CAESEgoQCg4K
BillingCycle	string	O ciclo de faturamento. Formato: YYYY-MM.	2020-03
MaxResults	integer	O número máximo de entradas retornadas para a solicitação atual.	20
AccountID	string	O ID da conta.	185xxxx3489
TotalCount	integer	O número total de entradas.	20
AccountName	string	O nome da conta.	test@test.aliyunid.com
Items	array<object>	Os detalhes da fatura.
	object
SplitAccountID	string	The ID of the account to which the split item belongs.	12**122
BillAccountName	string	The name of the account to which the bill belongs.	test@test.aliyunid.com
SubscriptionType	string	The billing method. Valid values: Subscription: subscription. PayAsYouGo: pay-as-you-go.	PayAsYouGo
InstanceSpec	string	The instance type.	ecs.sn1ne.3xlarge
DeductedByCoupons	number	The amount deducted with coupons.	0
Region	string	The region.	杭州
PipCode	string	The code of the product. This code is consistent with the product code on the bill in User Center.	rds
CommodityCode	string	The code of the commodity. This code is consistent with the product detail code in User Center.	rds
NickName	string	The nickname of the instance.	nick
ProductDetail	string	The details of the product.	云数据库RDS
Usage	string	The usage.	100
IntranetIP	string	The private IP address.	192.xx.xx.xx
UsageUnit	string	The unit of the usage.	GB
SplitCommodityCode	string	The commodity code of the split item.	rds
BillAccountID	string	The ID of the account to which the bill belongs.	185xxxx3489
ProductType	string	The type of the product.	rds
DeductedByResourcePackage	string	The amount deducted with resource plans.	0
SplitBillingCycle	string	The month of the split bill.	2021-06
ServicePeriod	string	The service duration.	20
SplitItemName	string	The name of the split item.	iZ28bycvyb4Z
ListPrice	string	The unit price.	0.12
Zone	string	The zone.	华北1
PretaxGrossAmount	number	The pretax gross amount.	0
InstanceConfig	string	The instance configuration details.	CPU:12
BillingDate	string	The billing date. Format: YYYY-MM-DD. This parameter is not supported.	2020-01-20
InternetIP	string	The public IP address.	34.xx.x.x
Item	string	The type of the bill. Valid values: SubscriptionOrder: subscription order. PayAsYouGoBill: pay-as-you-go bill. Refund: refund. Adjustment: adjustment.	PayAsYouGoBill
SplitItemID	string	The ID of the split item.	i-28bycvyb4
InstanceID	string	The ID of the instance.	i-kjhdskjgshfdlkjfdh
Tag	string	The tag of the resource. If the tag of a resource is changed, the bill generated for the resource during the lifecycle of the tag contains the tag.	key:testKey value:testValue; key:testKey1 value:testValues1
Currency	string	The currency. Valid values: CNY USD JPY	CNY
BizType	string	The business type.	trusteeship
BillingItem	string	The billable item.	带宽
BillingItemCode	string	The code of the billable item.	disk
CostUnit	string	The cost center.	未分配
ListPriceUnit	string	The unit of the unit price.	元/GB
ResourceGroup	string	The resource group.	默认资源组
PretaxAmount	number	The pretax amount.	0
ServicePeriodUnit	string	The unit of the service duration.	小时
SplitBillingDate	string	The day of the split bill.	2021-06-01
ProductName	string	The name of the product.	云数据库RDS
SplitProductDetail	string	The name of the split item's product detail.	云数据库
OwnerID	string	The ID of the account that owns the resource. This parameter is returned in multi-account payment scenarios.	169***013
InvoiceDiscount	number	The discount.	0
SplitAccountName	string	The name of the account to which the split item belongs.	test**1122
BillingType	string	The billing method.	其它
ProductCode	string	The code of the product.	rds
ItemName	string	The name of the item.	iZ28bycvyb4Z
AfterDiscountAmount	number	The amount after a discount. This is the amount payable after a discount is applied. Formula: Amount after discount = List price - Discount.

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Data": {
    "NextToken": "CAESEgoQCg4K",
    "BillingCycle": "2020-03",
    "MaxResults": 20,
    "AccountID": "185xxxx3489",
    "TotalCount": 20,
    "AccountName": "test@test.aliyunid.com",
    "Items": [
      {
        "SplitAccountID": "12**122",
        "BillAccountName": "test@test.aliyunid.com",
        "SubscriptionType": "PayAsYouGo",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "DeductedByCoupons": 0,
        "Region": "杭州",
        "PipCode": "rds",
        "CommodityCode": "rds",
        "NickName": "nick",
        "ProductDetail": "云数据库RDS",
        "Usage": "100",
        "IntranetIP": "192.xx.xx.xx",
        "UsageUnit": "GB",
        "SplitCommodityCode": "rds",
        "BillAccountID": "185xxxx3489",
        "ProductType": "rds",
        "DeductedByResourcePackage": "0",
        "SplitBillingCycle": "2021-06",
        "ServicePeriod": "20",
        "SplitItemName": "iZ28bycvyb4Z",
        "ListPrice": "0.12",
        "Zone": "华北1",
        "PretaxGrossAmount": 0,
        "InstanceConfig": "CPU:12",
        "BillingDate": "2020-01-20",
        "InternetIP": "34.xx.x.x",
        "Item": "PayAsYouGoBill",
        "SplitItemID": "i-28bycvyb4",
        "InstanceID": "i-kjhdskjgshfdlkjfdh",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Currency": "CNY",
        "BizType": "trusteeship",
        "BillingItem": "带宽",
        "BillingItemCode": "disk",
        "CostUnit": "未分配",
        "ListPriceUnit": "元/GB",
        "ResourceGroup": "默认资源组",
        "PretaxAmount": 0,
        "ServicePeriodUnit": "小时",
        "SplitBillingDate": "2021-06-01",
        "ProductName": "云数据库RDS",
        "SplitProductDetail": "云数据库",
        "OwnerID": "169***013",
        "InvoiceDiscount": 0,
        "SplitAccountName": "test**1122",
        "BillingType": "其它",
        "ProductCode": "rds",
        "ItemName": "iZ28bycvyb4Z",
        "AfterDiscountAmount": 0
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.