GraphiQL Playground

Abra o GraphiQL em uma URL de endpoint da GraphQL API, execute queries no navegador e adapte queries de exemplo para o schema, ataques e IPs de ataque.

Última atualização

Ver como Markdown Configurar agente

O GraphiQL Playground é um editor no navegador para a GraphQL API. Nele, você escreve, valida e executa queries na URL de endpoint que o serve, e o editor verifica erros na query enquanto você digita. Use-o para explorar os datasets e os campos de um endpoint e para testar uma query antes de enviá-la pelo código.

Acessar o GraphiQL Playground

Abrir o Playground

Cada URL de endpoint da GraphQL API serve o Playground quando você a abre em um navegador. O Playground de um endpoint executa apenas os datasets que esse endpoint serve:

URL do endpointDados
https://api.azion.com/v4/metrics/graphqlMétricas agregadas, como o dataset workloadMetrics
https://api.azion.com/v4/events/graphqlEventos brutos, como o dataset workloadEvents
https://api.azion.com/v4/billing/graphqlDados de faturamento
https://api.azion.com/v4/accounting/graphqlDados contábeis
https://api.azion.com/v4/consumption/graphqlDados de consumo

Para abrir o Playground, faça login no Azion Console e acesse a URL do endpoint no mesmo navegador. Sem uma sessão ativa, a URL retorna HTTP 401 com este corpo em vez do Playground:

{"detail": "Authentication credentials were not provided."}

Executar uma query

Para executar uma query, cole-a no editor do Playground e execute-a. O Playground valida a query contra o schema do endpoint enquanto você digita e marca cada erro que encontra. A resposta é um JSON: um objeto data com um array por dataset da query, ou uma mensagem detail quando a API recusa a query.

Uma query para um dataset que o endpoint não serve é recusada. Por exemplo, uma query workloadEvents enviada ao endpoint de métricas retorna HTTP 400:

JSON
01{
02 "detail": "Cannot query field \"workloadEvents\" on type \"Query\". Did you mean \"workloadMetrics\" or \"workloadBreakdownMetrics\"?"
03}

Para executar essa query, abra o Playground do endpoint de eventos.

dica — Depois que uma query é executada, o Playground adiciona a query à URL da página como um parâmetro codificado. Copie a URL e compartilhe: quem abrir a URL recebe a mesma query.

Queries de exemplo

As queries desta seção são executadas no Playground como estão escritas. Cada uma indica o endpoint cujo Playground a executa. Cole uma query e, em seguida, altere os campos, os filtros e as datas para ver como a resposta muda.

Introspecção do schema

Esta query de introspecção é executada no Playground de qualquer um dos cinco endpoints. Ela retorna o schema desse endpoint: cada tipo, com os campos, os argumentos e os valores de enum, incluindo os depreciados e o motivo pelo qual cada um foi depreciado:

GraphQL
01query IntrospectionQuery {
02 __schema {
03 queryType { name }
04 mutationType { name }
05 subscriptionType { name }
06 types {
07 ...FullType
08 }
09 directives {
10 name
11 description
12 locations
13 args {
14 ...InputValue
15 }
16 }
17 }
18}
19
20fragment FullType on __Type {
21 kind
22 name
23 description
24 fields(includeDeprecated: true) {
25 name
26 description
27 args {
28 ...InputValue
29 }
30 type {
31 ...TypeRef
32 }
33 isDeprecated
34 deprecationReason
35 }
36 inputFields {
37 ...InputValue
38 }
39 interfaces {
40 ...TypeRef
41 }
42 enumValues(includeDeprecated: true) {
43 name
44 description
45 isDeprecated
46 deprecationReason
47 }
48 possibleTypes {
49 ...TypeRef
50 }
51}
52
53fragment InputValue on __InputValue {
54 name
55 description
56 type {
57 ...TypeRef
58 }
59 defaultValue
60}
61
62fragment TypeRef on __Type {
63 name
64 ofType {
65 kind
66 name
67 ofType {
68 kind
69 name
70 ofType {
71 kind
72 name
73 ofType {
74 kind
75 name
76 ofType {
77 kind
78 name
79 ofType {
80 kind
81 name
82 ofType {
83 kind
84 name
85 }
86 }
87 }
88 }
89 }
90 }
91 }
92}

A resposta indica Query como o tipo de query e retorna null para os tipos de mutation e de subscription: a GraphQL API lê dados e não tem mutations.

Dados transferidos ao longo do tempo

A query HttpCalculatedDataTransferred lê o dataset workloadMetrics no Playground do endpoint de métricas. Ela seleciona ts, dataTransferredIn, dataTransferredOut e dataTransferredTotal para a janela em tsRange, agrupa as linhas por ts, ordena as linhas com ts_ASC e define limit como 2000. O dataset depreciado httpMetrics aceita a mesma query; use workloadMetrics.

IPs por trás dos ataques

A query TOP5IPsWAFRequests lê o dataset workloadEvents, então ela é executada no Playground do endpoint de eventos, https://api.azion.com/v4/events/graphql. Ela conta as requisições que o WAF sinalizou como ataques, agrupa as requisições por endereço IP do cliente e por família de ataque e retorna as cinco maiores contagens. No Playground do endpoint de métricas, a mesma query retorna HTTP 400.

O endpoint de eventos mantém os registros por cerca de 7 dias. Substitua os valores de begin e end por uma janela dentro dos últimos 7 dias:

GraphQL
01query TOP5IPsWAFRequests {
02 workloadEvents(
03 limit: 5
04 filter: {
05 tsRange: {
06 begin:"2026-09-26T14:00:00"
07 end:"2026-10-03T14:00:00"
08 },
09 wafMatchNe: "-"
10 wafAttackFamilyNe: "-"
11 }
12 aggregate: {
13 count: rows
14 }
15 groupBy:[remoteAddress, wafAttackFamily]
16 orderBy:[count_DESC]
17 )
18 {
19 remoteAddress
20 wafAttackFamily
21 count
22 }
23}

Quando o WAF não sinalizou nenhuma requisição na janela, o array workloadEvents retorna vazio. Para saber o que cada argumento e cada campo faz, consulte Encontre os IPs por trás do tráfego de ataque.

Principais famílias de ataque

A query Top5Attacks lê o dataset workloadMetrics no Playground do endpoint de métricas. Ela agrupa as requisições por família de ataque, classifica as famílias por wafRequestsThreat, o número de requisições que o WAF sinalizou como ameaças, e retorna as cinco maiores. Substitua os valores de begin e end pela sua janela:

GraphQL
01query Top5Attacks {
02 workloadMetrics(
03 limit: 5
04 filter: {
05 tsRange: {
06 begin:"2026-09-26T14:00:00"
07 end:"2026-10-03T14:00:00"
08 }
09 }
10 groupBy:[wafAttackFamily]
11 orderBy:[wafRequestsThreat_DESC]
12 )
13 {
14 wafAttackFamily
15 wafRequestsThreat
16 }
17}

Para uma janela em que o WAF não sinalizou nenhuma requisição, a resposta contém uma linha, com - como família de ataque e 0 requisições de ameaça:

JSON
01{
02 "data": {
03 "workloadMetrics": [
04 {
05 "wafAttackFamily": "-",
06 "wafRequestsThreat": 0
07 }
08 ]
09 }
10}

Para saber o que cada argumento e cada campo faz, consulte Encontre os principais ataques com GraphQL.

Recursos relacionados

GraphQL API

Todas as páginas da documentação da GraphQL API, dos primeiros passos aos campos de cada dataset.

Guias e tutoriais da GraphQL API

Mais queries para adaptar, cada uma em um guia que cobre uma tarefa.

Queries

Os formatos de query para dados brutos, agregados, financeiros e de uso, cada um com a resposta.

Datasets e argumentos de query

Os datasets de cada endpoint e os argumentos de filtro, ordenação e paginação que uma query aceita.