Obtém os principais dados da análise de eventos do WAF para um site.
Descrição da operação
-
Se você não especificar StartTime ou EndTime, esta operação retorna dados das últimas 24 horas. Se você especificar StartTime e EndTime, esta operação retorna dados para o intervalo de tempo especificado.
-
Devido ao alto volume de solicitações de acesso durante o período de consulta, a análise de dados pode envolver amostragem.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| SiteId |
string |
Não |
O ID do site. Você pode chamar a operação ListSites para obter o ID do site. Se este parâmetro for deixado vazio, os dados no nível do usuário serão consultados. |
1150376036***** |
| StartTime |
string |
Não |
O início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC+0. |
2023-04-08T16:00:00Z |
| EndTime |
string |
Não |
O fim do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC+0. Nota
A hora de término deve ser posterior à hora de início. |
2023-04-09T16:00:00Z |
| Interval |
string |
Não |
A granularidade de tempo para consulta de dados. Unidade: segundos. |
300 |
| Fields |
array<object> |
Sim |
As métricas de consulta. |
|
|
object |
Não |
As métricas de consulta. |
||
| FieldName |
string |
Não |
O valor da métrica de consulta. Nota
Para dimensões específicas, consulte Descrição dos campos de análise de dados. |
Requests |
| Dimension |
array |
Não |
A dimensão de consulta. |
|
|
string |
Não |
A dimensão de consulta. Nota
Para dimensões específicas, consulte Descrição dos campos de análise de dados. |
ALL |
|
| Limit |
string |
Não |
O número de principais entradas de dados a serem consultadas. Valores válidos:
|
5 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| Data |
array<object> |
Os dados retornados. |
|
|
array<object> |
Os dados retornados. |
||
| FieldName |
string |
O valor da métrica de consulta. |
Requests |
| DimensionName |
string |
A dimensão de consulta. |
ALL |
| DetailData |
array<object> |
Os dados retornados. |
|
|
object |
Os dados retornados. |
||
| DimensionValue |
string |
ALL |
|
| Value |
any |
123 |
|
| RequestId |
string |
O ID da solicitação. |
64041D4F-B615-5DEB-AC94-F01EE433**** |
| StartTime |
string |
O início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC+0. |
2023-04-08T16:00:00Z |
| EndTime |
string |
O fim do intervalo de tempo dos dados retornados. A hora está no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora está em UTC+0. |
2023-04-09T16:00:00Z |
| SamplingRate |
number |
A taxa de amostragem. Unidade: %. |
100 |
Exemplos
Resposta de sucesso
JSON formato
{
"Data": [
{
"FieldName": "Requests",
"DimensionName": "ALL",
"DetailData": [
{
"DimensionValue": "ALL",
"Value": "123"
}
]
}
],
"RequestId": "64041D4F-B615-5DEB-AC94-F01EE433****",
"StartTime": "2023-04-08T16:00:00Z",
"EndTime": "2023-04-09T16:00:00Z",
"SamplingRate": 100
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidParameter.TimeRange | The specified time range exceeds the limit. Adjust it and try again. | O intervalo de tempo para a consulta de dados é muito longo. Modifique o intervalo de tempo e tente novamente. |
| 400 | TooManyRequests | Too many requests.Please try again later. | A carga do sistema está flutuando. Tente novamente mais tarde. |
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | A hora de término é anterior à hora de início. Verifique os valores e tente novamente. |
| 400 | InvalidParameter | Parameter verification failed. Check your configurations and try again. | Falha na validação do formato do parâmetro de entrada. |
| 400 | QuotaCheckFailed.Function | The feature is unavailable in your plan. Upgrade the plan or contact your account manager to request the feature. | Seu plano não inclui este recurso. Atualize seu plano ou entre em contato com seu representante de vendas para adicioná-lo. |
| 400 | InvalidParameter.Field | The specified Field is invalid. | A métrica de consulta é inválida. Verifique se os parâmetros da solicitação existem e são válidos. Para mais informações, consulte a documentação da OpenAPI. |
| 400 | InvalidParameter.Dimension | The specified Dimension is invalid. | A dimensão de consulta é inválida. Verifique se os parâmetros da solicitação existem e são válidos. Para mais informações, consulte a documentação da OpenAPI. |
| 400 | InvalidTime.Malformed | Specified start time or end time is malformed. | O formato de hora que você especificou está incorreto. A hora deve estar no formato yyyy-MM-ddTHH:mm:ssZ. Corrija o formato e tente novamente. |
| 400 | TooManyDimensions | Too many query dimensions specified. Delete some and try again. | Você configurou muitas dimensões de consulta de dados. Remova algumas dimensões de consulta e tente novamente. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.