DescribeLiveUserBillPrediction - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Obtém a previsão de fatura para um usuário de transmissão ao vivo.

Descrição da operação

Esta operação prevê seus dados de uso para o mês atual. A previsão é baseada no método de cobrança ativo no primeiro dia do mês. Esta operação oferece suporte a previsões apenas para métodos de cobrança mensais e fornece dados no nível do usuário. O intervalo de tempo da consulta começa às 00:00 do primeiro dia do mês e termina duas horas antes do horário atual.

Percentil 95 mensal: O ponto de dados mais alto após a remoção dos 5% superiores dos pontos de dados do intervalo de tempo especificado.
Média mensal do pico de largura de banda diário: A soma dos valores de pico de largura de banda diário dividida pelo número de dias no intervalo de tempo. Os dados do dia atual não estão incluídos.
4º pico mensal: O quarto maior pico de largura de banda no intervalo de tempo especificado. Se o intervalo de tempo for inferior a quatro dias, o valor previsto será 0.
Média mensal do pico do percentil 95 diário: A soma dos valores de pico do percentil 95 diário dividida pelo número de dias no intervalo de tempo. Os dados do dia atual não estão incluídos.
Percentil 95 noturno: O ponto de dados mais alto após a remoção dos 5% superiores dos pontos de dados do intervalo de tempo especificado.

Limite de QPS

O limite de consultas por segundo (QPS) para um único usuário é 1. Se você exceder esse limite, suas chamadas de API serão limitadas, o que pode afetar seus negócios. Faça chamadas de API em uma taxa razoável. Para mais informações, consulte Limites de QPS.

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

live:DescribeLiveUserBillPrediction

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-shanghai
StartTime	string	Não	O horário de início. O horário deve estar em UTC e seguir o formato yyyy-mm-ddThh:mm:ssZ.	2015-12-01T05:40:00Z
EndTime	string	Não	O horário de término. O horário deve estar em UTC e seguir o formato yyyy-MM-ddTHH:mm:ssZ.	2015-12-01T05:45:00Z

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
EndTime	string	O horário de término da consulta. O horário está em UTC e segue o padrão ISO 8601. Formato: YYYY-MM-DDThh:mm:ssZ. O valor padrão é o horário atual.	2018-10-25T10:00:00Z
StartTime	string	O horário de início da consulta. O horário está em UTC e segue o padrão ISO 8601. Formato: YYYY-MM-DDThh:mm:ssZ. O valor padrão é 00:00 no primeiro dia do mês.	2018-09-30T16:00:00Z
RequestId	string	O ID da solicitação.	B95BE680-5A6A-1CAD-8AB1-09DFF5D6****
BillType	string	O método de cobrança. Os seguintes métodos de cobrança são suportados: hour_flow: Pagamento por tráfego por hora. day_bandwidth: Pagamento por largura de banda por dia. month_95: Pagamento pelo pico de largura de banda do percentil 95 mensal. month_avg_day_bandwidth: Pagamento pela média mensal do pico de largura de banda diário. month_4th_day_bandwidth: Pagamento pelo 4º pico de largura de banda mensal. month_avg_day_95: Pagamento pela média mensal do pico do percentil 95 diário. month_95_night_half: Pagamento pelo pico de largura de banda do percentil 95 noturno com 50% de desconto. hour_vas: Pagamento por serviços de valor agregado por hora. day_count: Pagamento pela contagem de solicitações diárias.	day_bandwidth
BillPredictionData	object
BillPredictionDataItem	array<object>	Os dados de previsão de fatura.
	object	Os dados de previsão de fatura.
Value	number	The predicted value.	10000
TimeStp	string	The timestamp of the predicted value. This parameter is returned only for the month_95, month_95_night_half, and month_4th_day_bandwidth billing methods.	2018-10-15T16:00:00Z
Area	string	The region code. Valid values: CN: the Chinese mainland. OverSeas: regions outside China. AP1: Asia Pacific 1. This region includes Hong Kong (China), Macao (China), Taiwan (China), Japan, and Southeast Asian countries except for Vietnam and Indonesia. AP2: Asia Pacific 2. This region includes Indonesia, South Korea, and Vietnam. AP3: Asia Pacific 3. This region includes Australia and New Zealand. NA: North America. This region includes the United States and Canada. SA: South America. This region includes Brazil. EU: Europe. This region includes Ukraine, the United Kingdom, France, the Netherlands, Spain, Italy, Sweden, and Germany. MEAA: Middle East and Africa. This region includes South Africa, Oman, the United Arab Emirates, and Kuwait. If you do not specify this parameter, data from all regions is aggregated and returned.	CN

Exemplos

Resposta de sucesso

JSON formato

{
  "EndTime": "2018-10-25T10:00:00Z",
  "StartTime": "2018-09-30T16:00:00Z",
  "RequestId": "B95BE680-5A6A-1CAD-8AB1-09DFF5D6****",
  "BillType": "day_bandwidth",
  "BillPredictionData": {
    "BillPredictionDataItem": [
      {
        "Value": 10000,
        "TimeStp": "2018-10-15T16:00:00Z",
        "Area": "CN"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	InvalidParameter.
400	InvalidStartTime.Malformed	The specified StartTime parameter is invalid.
400	InvalidEndTime.Malformed	The specified EndTime is invalid.
400	InvalidStartTime.ValueNotSupported	The StartTime cannot exceed 31 days before the current time.
400	InvalidTime.Malformed	Specified Time is malformed.	Invalid time. Check whether the time that you specified is correct.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	The end time does not match the start time. Make sure that the start and end times match.
400	InvalidTimeSpan	The time span exceeds the limit.	The time span exceeds the limit. Please refer to the API documentation to specify a reasonable time span.
400	BillTypeNotFound	User bill type not found or is not monthly bill type.	The bill type does not exist, or your account does not support monthly bills.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.