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

Consulta as faturas de liquidação de um usuário dentro de um ciclo de faturamento específico.

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:DescribeBillList

get

*All resources.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
BillingCycle	string	Sim	O ciclo de faturamento. Formato: AAAA-MM.	2018-07
Type	string	Não	O tipo de fatura. Valores válidos: SubscriptionOrder PayAsYouGoBill Refund Adjustment	SubscriptionOrder
ProductCode	string	Não	O código do produto.	rds
ProductType	string	Não	O tipo de produto.	rds
SubscriptionType	string	Não	O tipo de assinatura. Valores válidos: Subscription PayAsYouGo Nota Este parâmetro deve ser usado em conjunto com o parâmetro ProductCode.	Subscription
IsHideZeroCharge	boolean	Não	Especifica se deve filtrar registros cujo preço original (PretaxGrossAmount) seja 0. Valor padrão: false (para compatibilidade com a lógica existente). Valores válidos: true: Sim. false: Não.	true
PageNum	integer	Não	O número da página. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 20. Valor máximo: 300.	20
BillOwnerId	integer	Não	O ID da conta com propriedade do recurso. A conta com propriedade do recurso é a conta que realmente utiliza os recursos.	123

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status.	Success
Data	object	Os dados retornados.
AccountID	string	O ID da conta.	185xxxxx489
AccountName	string	O nome da conta.	test@test.aliyunid.com
BillingCycle	string	O ciclo de faturamento. Formato: AAAA-MM.	2020-02
Items	object
Item	array<object>	Os detalhes da fatura.
	object
AdjustAmount	number	A dedução de reembolso de crédito.	0
AfterTaxAmount	number
CashAmount	number	O valor de pagamento em dinheiro (excluindo deduções de reembolso de crédito).	0
CommodityCode	string	O código da mercadoria.	rds
Currency	string	A moeda. Valores válidos: CNY USD JPY	CNY
DeductedByCoupons	number	O valor deduzido por cupons.	0
InvoiceDiscount	number	O valor do desconto.	0
Item	string	O tipo da fatura. Valores válidos: SubscriptionOrder PayAsYouGoBill Refund Adjustment	SubscriptionOrder
OutstandingAmount	number	O valor pendente.	0
OwnerID	string	O AccountID da conta de membro (em cenários de pagamento de várias contas).	3532535235
PaymentAmount	number	O valor de pagamento em dinheiro (incluindo deduções de reembolso de crédito).	0
PaymentCurrency	string
PaymentTime	string	A hora de pagamento do pedido.	2020-03-11 08:00:00
PaymentTransactionID	string
PipCode	string	O código do produto.	rds
PretaxAmount	number	O valor a pagar.	100
PretaxAmountLocal	number
PretaxGrossAmount	number	O valor original.	0
ProductCode	string	O código do produto.	rds
ProductDetail	string	Os detalhes do produto.	Relational database RDS (Subscription)
ProductName	string	O nome do produto.	ApsaraDB RDS
ProductType	string	O tipo de produto.	rds
RecordID	string	O ID do pedido ou o ID da fatura.	2020xxxx5912
RoundDownDiscount	string	O desconto de arredondamento para baixo.	0
Status	string	O status de pagamento. Valores válidos: PayFinish: Pago. PayUnclear: Pendente. PayUnsettle: Não liquidado. NoSettle: Liquidação não necessária.	PayFinish
SubOrderId	string	O ID do detalhe do pedido correspondente à fatura.	325345254353
SubscriptionType	string	O tipo de assinatura. Valores válidos: Subscription PayAsYouGo	PayAsYouGo
Tax	number
UsageEndTime	string	A hora de término da fatura.	2020-03-11 08:00:00
UsageStartTime	string	A hora de início da fatura.	2020-03-11 07:00:00
PageNum	integer	O número da página.	1
PageSize	integer	O número de entradas por página.	1
TotalCount	integer	O número total de registros.	20
Message	string	A mensagem de erro.	Successful!
RequestId	string	O ID da solicitação.	AE3F4057-DFC9-4B81-8858-F620651010C9
Success	boolean	Indica se a solicitação foi bem-sucedida.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Data": {
    "AccountID": "185xxxxx489",
    "AccountName": "test@test.aliyunid.com",
    "BillingCycle": "2020-02",
    "Items": {
      "Item": [
        {
          "AdjustAmount": 0,
          "AfterTaxAmount": 0,
          "CashAmount": 0,
          "CommodityCode": "rds",
          "Currency": "CNY",
          "DeductedByCoupons": 0,
          "InvoiceDiscount": 0,
          "Item": "SubscriptionOrder",
          "OutstandingAmount": 0,
          "OwnerID": "3532535235",
          "PaymentAmount": 0,
          "PaymentCurrency": "",
          "PaymentTime": "2020-03-11 08:00:00",
          "PaymentTransactionID": "",
          "PipCode": "rds",
          "PretaxAmount": 100,
          "PretaxAmountLocal": 0,
          "PretaxGrossAmount": 0,
          "ProductCode": "rds",
          "ProductDetail": "Relational Database Service (Subscription)",
          "ProductName": "ApsaraDB RDS",
          "ProductType": "rds",
          "RecordID": "2020xxxx5912",
          "RoundDownDiscount": "0",
          "Status": "PayFinish",
          "SubOrderId": "325345254353",
          "SubscriptionType": "PayAsYouGo",
          "Tax": 0,
          "UsageEndTime": "2020-03-11 08:00:00",
          "UsageStartTime": "2020-03-11 07:00:00"
        }
      ]
    },
    "PageNum": 1,
    "PageSize": 1,
    "TotalCount": 20
  },
  "Message": "Successful!",
  "RequestId": "AE3F4057-DFC9-4B81-8858-F620651010C9",
  "Success": true
}

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.