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

Consulta faturas divididas.

Descrição da operação

Os resultados da consulta das faturas divididas do mês atual são apenas para referência e não podem ser usados como base para reconciliação. A fatura final do mês atual pode ser consultada após as 12:00 do 4º dia do mês seguinte. Os dados de fatura dividida do mês atual não incluem dados de pay-as-you-go não liquidados (não faturados ou em acumulação).
Os dados de fatura dividida estão disponíveis para os últimos 12 meses.
Os dados de fatura dividida são atualizados com um atraso de 48 horas em relação às despesas reais. Para serviços de nuvem divididos (como CDN, OSS e Internet Shared Bandwidth), as despesas específicas de cada recurso anexado (como nomes de domínio, buckets e EIPs) são atualizadas com um atraso de 72 horas.
Os dados de fatura dividida estão disponíveis somente após você ativar o recurso na página Fatura Dividida no console. Os dados ficam disponíveis 24 horas após a ativação do recurso.
O limite de taxa é de 10 solicitações por segundo por usuário. Se ocorrer um timeout, 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

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

bssapi:DescribeSplitItemBill

get

*All resources.

*

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. Formato: AAAA-MM.	2020-03
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: 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 que especifica a posição a partir da qual a chamada atual começa a ler os dados. O valor deve estar vazio ou ser o valor de NextToken retornado na resposta anterior. Caso contrário, ocorrerá um erro. Um valor vazio indica que a operação de leitura começa do início.	CAESEgoQCg4KCmd
MaxResults	integer	Não	O número máximo de entradas a serem retornadas na chamada atual. 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 recurso anexado.	i-kjhdskjgshfdlkjfdh
Granularity	string	Não	A granularidade na qual as faturas são consultadas. Valores válidos: MONTHLY: mensal. Este valor corresponde às faturas mensais na página Fatura Dividida no User Center. DAILY: diário. Este valor corresponde às faturas diárias na página Fatura Dividida 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 apenas quando Granularity é definido como DAILY. Formato: AAAA-MM-DD.	2020-03-02
TagFilter	array<object>	Não	As condições de filtro de tag. Há suporte para vários conjuntos de condições de consulta TagValues. A relação lógica entre vários conjuntos de condições TagValues é OR.
	object	Não	As condições de filtro de tag.
TagKey	string	Não	TagFilter.N é usado para consultar faturas que correspondem às tags especificadas. Consiste em um par chave-valor. A chave da tag deve ter de 1 a 128 caracteres. Valores válidos de N: 1 a 20. Se você especificar apenas TagFilter.N.TagKey, todas as faturas associadas à chave da tag serão retornadas. Se você especificar vários pares chave-valor de tag, as faturas que correspondem a qualquer um dos pares chave-valor de tag serão retornadas. Se as tags em um recurso forem alteradas, você só poderá consultar as faturas geradas durante o período em que as tags estavam anexadas ao recurso.	TestKey
TagValues	array	Não	TagValues.N é usado para consultar faturas que correspondem aos valores de tag especificados. Consiste em uma lista de strings. O valor da tag deve ter de 1 a 128 caracteres. Valores válidos de N: 1 a 20. Se você especificar TagValues.N, também deverá especificar TagFilter.N.TagKey. Caso contrário, o erro InvalidParameter.TagValues será relatado. Se você especificar vários valores de tag, as faturas que correspondem a qualquer um dos valores de tag serão retornadas.	TestValue
	string	Não	O valor da tag.	TestValue
IsHideZeroCharge	boolean	Não	Especifica se devem ser filtradas as faturas em que tanto o preço original (PretaxGrossAmount) quanto o valor a pagar (PretaxAmount) são 0. Valores válidos: false: não filtra as faturas. true: filtra as faturas.	false
PipCode	string	Não	O código do produto. Este valor é o mesmo que o código do produto nas faturas do User Center.	rds

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status.	Success
Data	object	Os dados da resposta.
AccountID	string	O ID da conta.	185xxxx3489
AccountName	string	A conta de usuário.	test@test.aliyunid.com
BillingCycle	string	O ciclo de faturamento. Formato: AAAA-MM.	2020-03
Items	array<object>	Os detalhes da fatura.
	object
AfterDiscountAmount	number	O valor após o desconto, que inclui o valor a pagar após a dedução do cupom. Regra de cálculo: Valor após o desconto = Preço de lista - Valor do desconto.	0
BillAccountID	string	O ID da conta à qual a fatura pertence.	185xxxx3489
BillAccountName	string	O nome da conta à qual a fatura pertence.	test@test.aliyunid.com
BillingDate	string	A data de faturamento no formato AAAA-MM-DD. Este parâmetro não é suportado.	2020-01-20
BillingItem	string	O item de faturamento.	Bandwidth
BillingItemCode	string	O código do item de faturamento.	disk
BillingType	string	O método de faturamento.	Other
BizType	string	O tipo de negócio.	trusteeship
CommodityCode	string	O código da commodity, que é o mesmo que o código de detalhes do produto no Centro do Usuário.	rds
CostUnit	string	A unidade de custo.	Unallocated
Currency	string	A moeda. Valores válidos: CNY USD JPY	CNY
DeductedByCoupons	number	O valor do desconto do cupom.	0
DeductedByResourcePackage	string	O valor deduzido por planos de recursos.	0
InstanceConfig	string	A configuração detalhada da instância.	CPU:12
InstanceID	string	O ID da instância.	i-kjhdskjgshfdlkjfdh
InstanceSpec	string	As especificações da instância.	ecs.sn1ne.3xlarge
InternetIP	string	O endereço IP público.	34.xx.x.x
IntranetIP	string	O endereço IP interno.	192.xx.xx.xx
InvoiceDiscount	number	O valor do desconto.	0
Item	string	O tipo de fatura. Valores válidos: SubscriptionOrder: Pedido de assinatura. PayAsYouGoBill: Fatura pay-as-you-go. Refund: Reembolso. Adjustment: Ajuste.	PayAsYouGoBill
ItemName	string	O nome do item.	iZ28bycvyb4Z
ListPrice	string	O preço unitário.	0.12
ListPriceUnit	string	A unidade do preço unitário.	CNY/GB
NickName	string	O apelido da instância.	nick
OwnerID	string	O ID da conta do proprietário do recurso em cenários de pagamento com várias contas.	169***013
PipCode	string	O código do produto, que é o mesmo que o código do produto da fatura no Centro do Usuário.	rds
PretaxAmount	number	O valor a pagar.	0
PretaxGrossAmount	number	O valor original.	0
ProductCode	string	O código do produto.	rds
ProductDetail	string	O detalhe do produto.	ApsaraDB RDS
ProductName	string	O nome do produto.	ApsaraDB RDS
ProductType	string	O tipo de produto.	rds
Region	string	A região.	Hangzhou
ResourceGroup	string	O grupo de recursos.	Default resource group
ServicePeriod	string	A duração do serviço.	20
ServicePeriodUnit	string	A unidade da duração do serviço.	Hour
SplitAccountID	string	O ID da conta do recurso anexado.	12**122
SplitAccountName	string	O nome da conta do recurso anexado.	test**1122
SplitBillingCycle	string	O mês da fatura dividida.	2021-06
SplitBillingDate	string	A data da fatura dividida.	2021-06-01
SplitCommodityCode	string	O código da commodity do recurso anexado.	rds
SplitItemID	string	O ID do recurso anexado.	i-28bycvyb4
SplitItemName	string	O nome do recurso anexado.	iZ28bycvyb4Z
SplitProductDetail	string	O nome do detalhe do produto do recurso anexado.	ApsaraDB
SubscriptionType	string	O tipo de assinatura. Valores válidos: Subscription: Assinatura. PayAsYouGo: Pay-as-you-go.	PayAsYouGo
Tag	string	A tag do recurso. Se uma tag em um recurso for alterada, as faturas geradas durante o período de validade incluirão esta tag.	key:testKey value:testValue; key:testKey1 value:testValues1
Usage	string	O uso.	100
UsageUnit	string	A unidade de uso.	GB
Zone	string	A zona.	China North 1
MaxResults	integer	O número máximo de entradas retornadas para a solicitação atual.	20
NextToken	string	O token que indica a posição onde a chamada atual para de ler. Um valor vazio indica que todos os dados foram lidos. Defina este valor para o parâmetro de solicitação NextToken na próxima chamada.	CAESEgoQCg4K
TotalCount	integer	O número total de entradas.	20
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

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Data": {
    "AccountID": "185xxxx3489",
    "AccountName": "test@test.aliyunid.com",
    "BillingCycle": "2020-03",
    "Items": [
      {
        "AfterDiscountAmount": 0,
        "BillAccountID": "185xxxx3489",
        "BillAccountName": "test@test.aliyunid.com",
        "BillingDate": "2020-01-20",
        "BillingItem": "Bandwidth",
        "BillingItemCode": "disk",
        "BillingType": "Other",
        "BizType": "trusteeship",
        "CommodityCode": "rds",
        "CostUnit": "Unallocated",
        "Currency": "CNY",
        "DeductedByCoupons": 0,
        "DeductedByResourcePackage": "0",
        "InstanceConfig": "CPU:12",
        "InstanceID": "i-kjhdskjgshfdlkjfdh",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "InternetIP": "34.xx.x.x",
        "IntranetIP": "192.xx.xx.xx",
        "InvoiceDiscount": 0,
        "Item": "PayAsYouGoBill",
        "ItemName": "iZ28bycvyb4Z",
        "ListPrice": "0.12",
        "ListPriceUnit": "USD/GB",
        "NickName": "nick",
        "OwnerID": "169***013",
        "PipCode": "rds",
        "PretaxAmount": 0,
        "PretaxGrossAmount": 0,
        "ProductCode": "rds",
        "ProductDetail": "ApsaraDB RDS",
        "ProductName": "ApsaraDB RDS",
        "ProductType": "rds",
        "Region": "Hangzhou",
        "ResourceGroup": "Grupo de recursos padrão",
        "ServicePeriod": "20",
        "ServicePeriodUnit": "Hora",
        "SplitAccountID": "12**122",
        "SplitAccountName": "test**1122",
        "SplitBillingCycle": "2021-06",
        "SplitBillingDate": "2021-06-01",
        "SplitCommodityCode": "rds",
        "SplitItemID": "i-28bycvyb4",
        "SplitItemName": "iZ28bycvyb4Z",
        "SplitProductDetail": "ApsaraDB",
        "SubscriptionType": "PayAsYouGo",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Usage": "100",
        "UsageUnit": "GB",
        "Zone": "China North 1"
      }
    ],
    "MaxResults": 20,
    "NextToken": "CAESEgoQCg4K",
    "TotalCount": 20
  },
  "Message": "Bem-sucedido!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "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.