SumBills - MaxCompute: Central de Documentação do Alibaba Cloud

Descrição da operação

Resume informações de custo por instância ou item faturável.

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.

Sintaxe da solicitação

POST /api/v1/bills/sum HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	Os parâmetros de solicitação para resumir informações de custo por instância ou item faturável. Exemplo: {"startDate":1775714495313,"endDate":1776232895313,"statsType":"FEE_ITEM","topN":8}
projectNames	array	Não	Uma lista de nomes de instâncias. Este parâmetro não é obrigatório se `statsType` estiver definido como `FEE_ITEM`.
	string	Não	O nome da instância.	projectName
startDate	integer	Não	A hora de início do ciclo de faturamento.	1715393576201
endDate	integer	Não	A hora de término do ciclo de faturamento.	1776232895313
statsType	string	Não	A dimensão pela qual resumir os custos. Valores válidos: `PROJECT` (por instância) e `FEE_ITEM` (por item faturável).	PROJECT
topN	integer	Não	O número de resultados principais a serem retornados após a ordenação por custo.	5

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O objeto de resposta.
requestId	string	O ID da solicitação.	BB66A390-4EF7-557E-9489-7F98D6F44002
httpCode	integer	O código de status HTTP.	200
data	object	O resultado retornado.
totalCost	string	O custo total de todos os itens faturáveis retornados.	123.56
currency	string	A moeda utilizada para todos os valores de custo.	CNY
itemBills	array<object>	Uma lista de itens faturáveis.
	object	Um objeto de item faturável.
itemName	string	The item name. When the request's `statsType` is `PROJECT`, this is the instance name. When `statsType` is `FEE_ITEM`, this is the billable item type (for example, `DRStorage`, `ComputationSql`, or `Storage`).	projectName
cost	string	The cost.	123.56
currency	string	The currency.	CNY
percentage	number	The percentage of the total cost that this item represents. The value does not include a percent sign (%).	56.12

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "BB66A390-4EF7-557E-9489-7F98D6F44002",
  "httpCode": 200,
  "data": {
    "totalCost": "123.56",
    "currency": "CNY",
    "itemBills": [
      {
        "itemName": "projectName",
        "cost": "123.56",
        "currency": "CNY",
        "percentage": 56.12
      }
    ]
  }
}

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.