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

Consulta os gastos da conta dentro de um ciclo de faturamento e agrega os dados por proprietário do recurso.

Descrição da operação

Os dados do mês atual são apenas para referência. Não os utilize para reconciliação. A fatura final do mês atual fica disponível para visualização ou exportação após as 12:00 do terceiro dia do mês seguinte. Esse atraso considera eventos de meio de mês, como faturamento atrasado, reembolsos, ajustes de fatura e baixas de pagamentos em atraso.
Os dados dos últimos 18 meses estão disponíveis.
Os dados de faturamento são atualizados 24 horas após o consumo real do recurso. As informações relacionadas aos IDs das instâncias, como configurações de instância, tipos de instância, apelidos de instância, grupos de recursos, endereços IP públicos, endereços IP privados e zonas, são atualizadas com um atraso de 48 horas.
Os dados de faturamento não incluem os custos de recursos anexados, como nomes de domínio, buckets e endereços IP elásticos (EIPs), para produtos como CDN, OSS e Internet Shared Bandwidth. Para visualizar estatísticas que incluam dados de recursos anexados, acesse Split Bill.
Para os produtos do Alibaba Cloud Communications, os dados detalhados estão disponíveis apenas a partir de junho de 2020. Para os produtos da HiChina, como Nomes de Domínio e marcas registradas, os dados detalhados estão disponíveis apenas a partir de novembro de 2020.
Cada conta está limitada a 10 consultas por segundo. Se ocorrer um tempo limite, tente repetir 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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

bss:QueryAccountBill

get

*All Resource

*

bssapi:ProductCode
bssapi:ProductType

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
BillingCycle	string	Sim	A data de faturamento. Formato: AAAA-MM.	2018-07
PageNum	integer	Não	O número da página. O valor padrão é 1.	1
PageSize	integer	Não	O número de entradas por página. O valor padrão é 20. O valor máximo é 300.	20
IsGroupByProduct	boolean	Não	Especifica se os resultados devem ser agregados por código do produto. true: Os resultados são agregados por código do produto. false: Os resultados não são agregados por código do produto. Valor padrão: false.	false
ProductCode	string	Não	O código do produto.	rds
BillOwnerId	integer	Não	O ID da conta que possui e realmente utiliza o recurso.	122
Granularity	string	Não	A granularidade para consultar a fatura. Valores válidos: MONTHLY: Consulta faturas mensalmente. Corresponde às faturas mensais em Despesas e Custos > Faturas > Detalhes da Fatura . DAILY: Consulta faturas diariamente. Corresponde às faturas diárias em Despesas e Custos > Faturas > Detalhes da Fatura . Nota Se você definir `Granularity` como `DAILY`, também deverá especificar o parâmetro `BillingDate`.	MONTHLY
BillingDate	string	Não	A data de faturamento. Este parâmetro é obrigatório apenas quando você define Granularity como DAILY. Formato: AAAA-MM-DD.	2021-06-01

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.	3BFC23FE-A182-4D96-A1E4-7521B30B8E43
Success	boolean	Indica se a solicitação foi bem-sucedida.	true
Data	object	Os dados retornados.
PageNum	integer	O número da página.	1
BillingCycle	string	O ciclo de faturamento. Formato: AAAA-MM.	2020-03
AccountID	string	O ID da conta.	1857xxxxx489
PageSize	integer	O número de entradas exibidas por página.	20
TotalCount	integer	O número total de registros.	1
AccountName	string	O nome da conta.	test@test.aliyunid.com
Items	object
Item	array<object>	The bill details.
	object
PipCode	string	The product code. This is the same as the product code in the User Center.	rds
BillingDate	string	The billing date.	2021-03-01
ProductName	string	The product name. Nota This parameter is returned only when IsGroupByProduct is set to true.	rds
OwnerName	string	The AccountName of the resource owner. This is used in multi-account payment scenarios.	aligzncloudtest2
Currency	string	The currency. Valid values: CNY USD JPY	CNY
BillAccountName	string	The name of the account to which the bill belongs.	test@test.aliyunid.com
SubscriptionType	string	The subscription type of the product. Subscription: subscription PayAsYouGo: pay-as-you-go Nota This parameter is returned only when IsGroupByProduct is set to true.	PayAsYouGo
BizType	string	The business type.	trusteeship
OwnerID	string	The AccountID of the resource owner. This is used in multi-account payment scenarios.	325434254
DeductedByCoupons	number	The amount deducted by coupons.	0
BillAccountID	string	The ID of the account to which the bill belongs.	1857xxxxx489
InvoiceDiscount	number	The discount amount.	0
CostUnit	string	The cost center.	未分配
PretaxGrossAmount	number	The pretax gross amount.	0
ProductCode	string	The product code. Nota This parameter is returned only when IsGroupByProduct is set to true.	rds

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "3BFC23FE-A182-4D96-A1E4-7521B30B8E43",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-03",
    "AccountID": "1857xxxxx489",
    "PageSize": 20,
    "TotalCount": 1,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "PipCode": "rds",
          "BillingDate": "2021-03-01",
          "ProductName": "rds",
          "OwnerName": "aligzncloudtest2",
          "Currency": "CNY",
          "BillAccountName": "test@test.aliyunid.com",
          "SubscriptionType": "PayAsYouGo",
          "BizType": "trusteeship",
          "OwnerID": "325434254",
          "DeductedByCoupons": 0,
          "BillAccountID": "1857xxxxx489",
          "InvoiceDiscount": 0,
          "CostUnit": "未分配",
          "PretaxGrossAmount": 0,
          "ProductCode": "rds"
        }
      ]
    }
  }
}

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.