Consulta de detalhes da largura de banda da rede
Você pode consultar dados nos últimos 90 dias.
O intervalo de tempo varia de 1 hora a 31 dias.
Você pode especificar até 100 nomes de domínio em uma consulta.
A hora de início e a hora de término devem ser especificadas ao mesmo tempo. Seus valores devem ser precisos até o milissegundo. Se o intervalo de amostragem for menor ou igual a 1 hora, a granularidade do tempo deve ser de uma hora, por exemplo, 01/07/2020 08:00:00 e 01/07/2020 09:00:00. Se o intervalo de amostragem for superior a 1 hora, a granularidade de tempo deve ser um dia inteiro, por exemplo, 01/07/2020 00:00:00 e 02/07/2020 00:00:00.
Se a hora de início e a hora de término não atenderem aos requisitos, os dados retornados podem ser diferentes do esperado.
Função
Essa API é usada para consultar detalhes da largura de banda da rede.
O tempo mínimo suportado é de uma hora.
URI
GET /v1.0/cdn/statistics/bandwidth-detail
Solicitação
Parâmetros de solicitação
Tabela 1 descreve os parâmetros de solicitação.
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| start_time | Não | Interger | Especifica a hora de início de uma consulta (timestamp, em milissegundos). |
| end_time | Não | Interger | Especifica a hora de término de uma consulta (timestamp, em milissegundos). |
| domain_name | Sim | String | Especifica uma lista de nomes de domínio. Use vírgulas (,) para separar nomes de domínio, por exemplo, www.test1.com,www.test2.com. O valor ALL indica que todos os nomes de domínio sob um locatário são consultados. |
| interval | Não | Interger | Especifica o intervalo de amostragem. interval é medido em segundos, e seus valores são descritos da seguinte forma: Para um período de tempo de 1 dia, o valor pode ser 5 minutos, 1 hora, 4 horas ou 8 horas. Para um intervalo de tempo de 2 a 7 dias, o valor pode ser 5 minutos, 1 hora, 4 horas, 8 horas ou 1 dia. Para um período de 8 a 31 dias, o valor pode ser 4 horas, 8 horas ou 1 dia. Se você não especificar um valor para interval, o sistema usará o menor valor correspondente ao período de tempo consultado por padrão. Se precisar especificá-lo na solicitação, converta o intervalo em segundos. |
| enterprise_project_id | Não | String | Projeto corporativo ao qual o recurso pertence. Este parâmetro é válido somente quando a função do projeto empresarial está ativada. O valor all indica todos os projetos. Esse parâmetro é obrigatório quando você usa um usuário do IAM para chamar essa API. |
Exemplos de solicitações
Caminho solicitado
GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/bandwidth-detail?start_time=1498838400000&end_time=1502380500000&domain_name=www.example.com&interval=300&enterprise_project_id=0
Resposta
Parâmetros de resposta
Tabela 2 descreve os parâmetros de resposta.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| bandwidth_detail | Object | Especifica os dados detalhados. Para mais detalhes, consulte Tabela 3. |
descrição do parâmetro de largura de banda
Tabela 3 descreve os parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| start_time | Interger | Especifica a hora de início de uma consulta (timestamp, em milissegundos). |
| end_time | Interger | Especifica a hora de término de uma consulta (timestamp, em milissegundos). |
| stat_type | String | Especifica o tipo de estatística. |
| interval | Interger | Especifica o intervalo de amostragem, medido por segundos. |
| values | Array of integers | Especifica os valores dos dados de largura de banda. Os valores são exibidos em ordem cronológica a partir do ponto de start_time (unidade: bit/s). |
{
"bandwidth_detail": {
"interval": 300,
"values": [835038583,835038544],
"start_time": 1498838400000,
"end_time": 1502380500000,
"stat_type" : "bw"
}
} Código de estado
Consulte Códigos de estado.
Código de erro
Consulte Códigos de erro.
