DescribeCdnUserBillPrediction - CDN: Central de Documentação do Alibaba Cloud

Prevê os dados de uso do mês atual.

Descrição da operação

Prevê os dados de uso do mês atual. A previsão é calculada com base no método de faturamento no primeiro dia do mês. Apenas métodos de faturamento mensal e previsões no nível do usuário são suportados. A hora de início é 00:00:00 no primeiro dia do mês, e a hora de término é duas horas antes da hora atual.

Percentil 95 mensal: o ponto mais alto após a remoção dos 5% superiores dos pontos de dados entre a hora de início e a hora de término.
Pico de largura de banda média diária mensal: a soma dos picos de largura de banda diários dividida pelo número de dias. Os dados do dia atual não estão incluídos.
Pico de largura de banda do quarto dia mensal: o quarto maior pico de largura de banda dentro do intervalo de tempo solicitado. Se o intervalo de tempo solicitado for menor que 4 dias, o valor previsto será 0.
Percentil 95 médio diário mensal: a soma dos picos de largura de banda do percentil 95 diário dividida pelo número de dias. Os dados do dia atual não estão incluídos.
Percentil 95 com meia tarifa noturna: o ponto mais alto após a remoção dos 5% superiores dos pontos de dados entre a hora de início e a hora de término.

Nota

Limite de taxa por usuário: 1 chamada por segundo.

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

cdn:DescribeCdnUserBillPrediction

none

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
StartTime	string	Não	A hora de início. Valor padrão: 00:00:00 no primeiro dia do mês. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.	2018-09-30T16:00:00Z
EndTime	string	Não	A hora de término. Valor padrão: a hora atual. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Nota A hora de término deve ser posterior à hora de início.	2018-10-25T10:00:00Z
Dimension	string	Não	A dimensão do tipo de faturamento. O valor flow indica transferência de dados e largura de banda.	flow
Area	string	Não	A região de faturamento. Valores válidos: CN: China continental. OverSeas: global (exceto a China continental). AP1: Ásia-Pacífico 1. AP2: Ásia-Pacífico 2. AP3: Ásia-Pacífico 3. NA: América do Norte. SA: América do Sul. EU: Europa. MEAA: Oriente Médio e África. O valor padrão é determinado pelo método de faturamento atual do usuário. Se o método de faturamento for dividido em regiões fora da China continental, o valor padrão será CN e OverSeas. Caso contrário, o valor padrão será CN, AP1, AP2, AP3, NA, SA, EU ou MEAA. Nota Para obter mais informações sobre os países e regiões incluídos em cada área, consulte Visão geral do faturamento.	CN,OverSeas

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
EndTime	string	A hora de término da previsão. A hora está no formato ISO 8601 e em UTC.	2018-10-25T10:00:00Z
StartTime	string	A hora de início da previsão. A hora está no formato ISO 8601 e em UTC.	2018-09-30T16:00:00Z
RequestId	string	O ID da solicitação.	C370DAF1-C838-4288-A1A0-9A87633D248E
BillType	string	O tipo de faturamento do usuário. Nota Um valor com o sufixo _overseas indica que o método de medição não é dividido em regiões fora da China continental. Por exemplo, se o valor for "BillType": "month_avg_day_bandwidth_overseas", isso indica que o método de medição é o pico de largura de banda média diária mensal sem divisão de regiões fora da China continental. Valores válidos: hour_flow: faturado por transferência de dados por hora. day_bandwidth: faturado por largura de banda diária. month_95: faturado por largura de banda do percentil 95 mensal. month_avg_day_bandwidth: faturado por pico de largura de banda média diária mensal. month_4th_day_bandwidth: faturado por pico de largura de banda do quarto dia mensal. month_avg_day_95: faturado por largura de banda do percentil 95 médio diário mensal. month_95_night_half: faturado por largura de banda do percentil 95 com meia tarifa noturna. hour_vas: faturado por serviços de valor agregado por hora. day_count: faturado por solicitações diárias.	month_95_overseas
BillPredictionData	object
BillPredictionDataItem	array<object>	Os dados de previsão de faturamento.
	object
Value	number	O valor previsto.	10000
TimeStp	string	A hora correspondente ao valor previsto. Este campo está disponível apenas para o percentil 95, percentil 95 com meia tarifa noturna e pico de largura de banda do quarto dia mensal.	2018-10-15T16:00:00Z
Area	string	A região de faturamento.	CN

Exemplos

Resposta de sucesso

JSON formato

{
  "EndTime": "2018-10-25T10:00:00Z",
  "StartTime": "2018-09-30T16:00:00Z",
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D248E",
  "BillType": "month_95_overseas",
  "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	The specified parameter is invalid.	Ocorreu uma exceção ao excluir a região de transmissão ao vivo.
400	BillTypeNotFound	The user billing type is not found or the billing type of this user is not the monthly billing type.	O tipo de cobrança da conta do usuário não existe ou o usuário não é um usuário do tipo de cobrança mensal.
400	InvalidStartTime.Malformed	The specified value of parameter StartTime is malformed.
400	InvalidEndTime.Malformed	The specified value of parameter EndTime is malformed.
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.
400	InvalidTime.Malformed	Specified Time is malformed.
400	InvalidEndTime.Mismatch	Specified EndTime does not match the specified StartTime.	Verifique se as configurações de horário estão corretas. A hora de término não pode ser anterior ou igual à hora de início.
400	InvalidTimeSpan	The time span exceeds the limit.	O intervalo de tempo excede o limite. Consulte a documentação da API para configurar um intervalo de tempo de consulta válido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.