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

Estima o uso de recursos do mês atual.

Descrição da operação

Estima o uso de recursos do mês atual com base no método de medição especificado no primeiro dia do mês atual. Esta operação estima o uso de recursos apenas do mês atual na sua conta Alibaba Cloud. O intervalo de tempo usado para a estimativa começa às 00:00 do primeiro dia do mês atual e termina 2 horas antes do horário atual.

Pagamento pelo percentil 95 mensal: os 5% maiores valores entre a hora de início e a hora de fim são excluídos. O valor estimado é o maior valor entre os valores restantes.
Pagamento pela média diária de largura de banda de pico por mês: Valor estimado = Soma dos valores diários de largura de banda de pico/Número de dias. O dia atual é excluído.
Pagamento pela 4ª largura de banda de pico por mês: o valor estimado é o 4º valor de largura de banda de pico entre a hora de início e a hora de fim. Se o intervalo de tempo for inferior a quatro dias, o valor estimado será 0.
Pagamento pela média diária de largura de banda do percentil 95 por mês: Valor estimado = Soma dos valores diários de largura de banda do percentil 95/Número de dias. O dia atual é excluído.
Pagamento pela largura de banda do percentil 95 com 50% de desconto das 00:00 às 08:00: os 5% maiores valores entre a hora de início e a hora de fim são excluídos. O valor estimado é o maior valor entre os valores restantes.

Nota

Cada conta pode chamar esta operação apenas uma vez 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

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
StartTime	string	Não	A hora de início da estimativa. O valor padrão é 00:00 no primeiro dia do mês atual. 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 fim da estimativa. O 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 fim deve ser posterior à hora de início.	2018-10-25T10:00:00Z
Dimension	string	Não	O item faturável. O valor flow especifica largura de banda.	flow
Area	string	Não	A região faturável. Valores válidos: CN: parte continental da China OverSeas: fora da parte continental da China 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 Por padrão, o valor deste parâmetro é determinado pelo método de medição atualmente em uso. As regiões dentro e fora da parte continental da China são classificadas nas regiões faturáveis CN e OverSeas. As regiões faturáveis dentro da parte continental da China incluem CN. As regiões faturáveis fora da parte continental da China incluem AP1, AP2, AP3, NA, SA, EU e MEAA. Nota Para obter mais informações sobre as regiões faturáveis, consulte Regiões faturáveis.	CN,OverSeas

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
EndTime	string	A hora de fim da estimativa.	2018-10-25T10:00:00Z
StartTime	string	A hora de início da estimativa.	2018-09-30T16:00:00Z
RequestId	string	O ID da solicitação.	C370DAF1-C838-4288-A1A0-9A87633D248E
BillType	string	O método de medição. Nota Se o método de medição terminar com _overseas, a região faturável está fora da parte continental da China. Por exemplo, BillType": "month_avg_day_bandwidth_overseas especifica uma região faturável fora da parte continental da China e que o método de medição é o pagamento pela largura de banda de pico diária por mês. Valores válidos: hour_flow: pagamento por transferência de dados por hora day_bandwidth: pagamento por largura de banda diária month_95: pagamento pela largura de banda do percentil 95 mensal. month_avg_day_bandwidth: pagamento pela média diária de largura de banda de pico por mês month_4th_day_bandwidth: pagamento pela 4ª largura de banda de pico mensal month_avg_day_95: pagamento pela média diária de largura de banda do percentil 95 por mês month_95_night_half: pagamento pela largura de banda do percentil 95 com 50% de desconto das 00:00 às 08:00. hour_vas: pagamento por serviços de valor agregado por hora day_count: pagamento por solicitações diárias	month_95_overseas
BillPredictionData	object
BillPredictionDataItem	array<object>	Os dados de faturamento estimados.
	object
Value	number	The estimated value.	10000
TimeStp	string	The time when the value used as the estimated value is generated. This parameter is returned only if the metering method is pay by 95th percentile, pay by 95th percentile bandwidth with 50% off from 00:00 to 08:00, or pay by 4th peak bandwidth per month.	2018-10-15T16:00:00Z
Area	string	The billable region.	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.
400	BillTypeNotFound	The user billing type is not found or the billing type of this user is not the monthly billing type.	The bill type does not exist, or your account does not support monthly bills.
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.	StartTime must be earlier than EndTime.
400	InvalidTimeSpan	The time span exceeds the limit.	The time span exceeds the limit. Configure a valid time span as described in API documentation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.