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

Consulta o resumo de uso de todas as instâncias de produto ou itens faturáveis de uma conta em um ciclo de faturamento. Esta operação foi atualizada para DescribeInstanceBill. Esta operação não consulta mais dados além da 50.000ª linha.

Descrição da operação

Descrição da API

Observe o seguinte ao chamar esta operação:

A API para faturas de instâncias foi atualizada. Recomendamos que você use a nova operação DescribeInstanceBill. Esta operação não oferece mais suporte à consulta de dados além da 50.000ª linha.
As faturas de instâncias são geradas com base em dados de faturamento divididos. Pode ocorrer um atraso de cerca de um dia.
As informações da instância podem mudar dentro de um ciclo de faturamento. A Configuração e a Especificação da instância no resumo mensal refletem as informações no momento em que o registro foi gerado. Para obter mais informações, consulte a fatura detalhada correspondente.
Os dados dos produtos Alibaba Cloud Communications estão disponíveis a partir de junho de 2020. Os dados dos produtos HiChina estão disponíveis a partir de novembro de 2020.
Para o site internacional (alibabacloud.com), selecione Singapura como o endpoint.

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 Resource

*

bssapi:ProductCode
bssapi:ProductType

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
BillingCycle	string	Sim	O ciclo de faturamento no formato AAAA-MM. Há suporte para dados dos últimos 18 meses.	2020-03
ProductCode	string	Não	O código do produto.	rds
ProductType	string	Não	O tipo do produto. Obrigatório quando o parâmetro ProductCode é definido como o código de um produto do Alibaba Cloud Marketplace.	rds
SubscriptionType	string	Não	O tipo de assinatura. Valores válidos: Subscription: assinatura. PayAsYouGo: pay-as-you-go. Nota Este parâmetro deve ser usado com o parâmetro ProductCode.	PayAsYouGo
IsBillingItem	boolean	Não	Especifica se os dados devem ser consultados por item faturável. false: Os dados são consistentes com os detalhes da fatura na guia Instância da página Faturas no User Center. true: Os dados são consistentes com os detalhes da fatura na guia Item faturável da página Faturas no User Center. Valor padrão: false.	false
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
IsHideZeroCharge	boolean	Não	Especifica se devem ser filtradas as faturas nas quais o valor bruto antes de impostos (PretaxGrossAmount) e o valor antes de impostos (PretaxAmount) são ambos 0. Valores válidos: false. true.	false
BillingDate	string	Não	A data de faturamento. Este parâmetro é obrigatório apenas quando o parâmetro Granularity é definido como DAILY. O valor deve estar no formato AAAA-MM-DD.	2020-03-03
Granularity	string	Não	A granularidade na qual as faturas são consultadas. Valores válidos: MONTHLY: consulta faturas por mês. Os dados são consistentes com os detalhes da fatura na guia Ciclo de faturamento da página Faturas no User Center. DAILY: consulta faturas por dia. Os dados são consistentes com os detalhes da fatura na guia Por dia da página Faturas no User Center. Se você definir este parâmetro como DAILY, também deverá especificar o parâmetro BillingDate.	MONTHLY
BillOwnerId	integer	Não	O ID da conta proprietária dos recursos. Esta conta é o usuário real dos recursos.	122

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 chamada foi bem-sucedida.	true
Data	object	Os dados retornados.
PageNum	integer	O número da página.	1
BillingCycle	string	O ciclo de faturamento no formato AAAA-MM.	2020-03
AccountID	string	O ID da conta.	185xxxx3489
PageSize	integer	O número de entradas por página.	20
TotalCount	integer	O número total de registros.	2
AccountName	string	A conta de usuário.	test@test.aliyunid.com
Items	object
Item	array<object>	The bill details.
	object
BillingDate	string	The billing date. This parameter is returned only when the Granularity parameter is set to DAILY. The value is in the YYYY-MM-DD format.	2020-03
InstanceConfig	string	The detailed configuration of the instance.	CPU:12
InternetIP	string	The public IP address.	34.xx.x.x
Item	string	The type of the bill. Valid values: SubscriptionOrder PayAsYouGoBill Refund Adjustment	PayAsYouGoBill
Tag	string	The tag.	tag
InstanceID	string	The instance ID.	i-kjhdskjgshfdlkjfdh
Currency	string	The currency. Valid values: CNY. USD. JPY.	CNY
SubscriptionType	string	The subscription type. Valid values: Subscription: subscription. PayAsYouGo: pay-as-you-go. Nota This parameter must be used with the ProductCode parameter.	PayAsYouGo
InstanceSpec	string	The instance type.	ecs.sn1ne.3xlarge
DeductedByCoupons	number	The amount deducted using coupons.	0
BillingItem	string	The billable item. This parameter is returned only when IsBillingItem is set to true.	其他
Region	string	The region.	杭州
CostUnit	string	The cost center.	未分配
ListPriceUnit	string	The unit of the list price. This parameter is valid only when isBillingItem is set to true.	元
ResourceGroup	string	The resource group.	默认资源组
PipCode	string	The product code. This is the same as the product code in the bills in the User Center.	rds
ServicePeriodUnit	string	The unit of the service duration.	秒
PretaxAmount	number	The pretax amount.	0
CommodityCode	string	The commodity code. This is the same as the product detail code in the User Center.	rds
ProductName	string	The product name.	云数据库RDS
NickName	string	The instance nickname.	test
ProductDetail	string	The product details.	云数据库RDS
Usage	string	The usage. This parameter is valid only when isBillingItem is set to true.	100
IntranetIP	string	The internal IP address.	192.xx.xx.xx
OwnerID	string	The account ID of the RAM user. This parameter is returned in a multi-account payment scenario.	169***013
UsageUnit	string	The unit of the usage. This parameter is valid only when isBillingItem is set to true.	GB
InvoiceDiscount	number	The discount amount.	0
DeductedByResourcePackage	string	The amount deducted using resource packages.	NULL
ProductType	string	The product type.	rds
ServicePeriod	string	The service duration.	10
Zone	string	The zone.	cn-hangzhou-h
ListPrice	string	The list price. This parameter is valid only when isBillingItem is set to true.	100
PretaxGrossAmount	number	The pretax gross amount.	0
ProductCode	string	The product code.	rds
BillingType	string	The billing method.	其它

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-03",
    "AccountID": "185xxxx3489",
    "PageSize": 20,
    "TotalCount": 2,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "BillingDate": "2020-03",
          "InstanceConfig": "CPU:12",
          "InternetIP": "34.xx.x.x",
          "Item": "PayAsYouGoBill",
          "Tag": "tag",
          "InstanceID": "i-kjhdskjgshfdlkjfdh",
          "Currency": "CNY",
          "SubscriptionType": "PayAsYouGo",
          "InstanceSpec": "ecs.sn1ne.3xlarge",
          "DeductedByCoupons": 0,
          "BillingItem": "其他",
          "Region": "杭州",
          "CostUnit": "未分配",
          "ListPriceUnit": "元",
          "ResourceGroup": "默认资源组",
          "PipCode": "rds",
          "ServicePeriodUnit": "秒",
          "PretaxAmount": 0,
          "CommodityCode": "rds",
          "ProductName": "云数据库RDS",
          "NickName": "test",
          "ProductDetail": "云数据库RDS",
          "Usage": "100",
          "IntranetIP": "192.xx.xx.xx",
          "OwnerID": "169***013",
          "UsageUnit": "GB",
          "InvoiceDiscount": 0,
          "DeductedByResourcePackage": "NULL",
          "ProductType": "rds",
          "ServicePeriod": "10",
          "Zone": "cn-hangzhou-h",
          "ListPrice": "100",
          "PretaxGrossAmount": 0,
          "ProductCode": "rds",
          "BillingType": "其它"
        }
      ]
    }
  }
}

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.