← Analytics / analytics / graphql-api / features / discovery

Uzel nastavení

Cloudflare GraphQL API zpřístupňuje svým zákazníkům více než 70 datasetů. Tyto datasety reprezentují různé produkty Cloudflare s velmi odlišnými strukturami dat, a proto má každý vlastní konfiguraci limity.

Ačkoli umožňujeme přístup ke všem plánům pro základní datové sady (například httpRequestsAdaptiveGroups, firewallEventsAdaptive, atd.), mají uživatelé s většími plány k dispozici rozšířenou sadu datových sad a vyšší limity dotazů.

Kromě introspekce, mohou uživatelé použít uzel Settings, který je dostupný pro obory zón i účtů.

Settings uzel obsahuje všechny datasety z zones a accounts jako pole.

{
  viewer {
    accounts(filter: { accountTag : $accountTag }) {
      settings {
        # any dataset(s) from accounts
      }
    }
    zones(filter: { zoneTag : $zoneTag }) {
      settings {
        # any dataset(s) from zones
      }
    }
  }
}

Každý poduzel settings uzel by mohl obsahovat tato pole:

• enabled - udává, zda je uzel pro daného žadatele dostupný, nebo ne;
• availableFields - zobrazuje seznam polí dostupných pro daného žadatele. Pokud jde o vnořené pole, vrátí se jeho cesta, například sum_requests;
• maxPageSize - načte maximální počet záznamů, které lze vrátit
• maxNumberOfFields - udává, kolik polí lze v jediném dotazu pro daný uzel použít;
• notOlderThan - vrací počet sekund, jak daleko do minulosti může dotaz číst data;
• maxDuration - udává, jak široké může být požadované časové rozmezí.

query SampleQuery($zoneTag: string) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			settings {
				firewallEventsAdaptive {
					enabled
					maxDuration
					maxNumberOfFields
					maxPageSize
					notOlderThan
				}
			}
		}
	}
}

{
	"data": {
		"viewer": {
			"zones": [
				{
					"settings": {
						"firewallEventsAdaptive": {
							"enabled": true,
							"maxDuration": 259200,
							"maxNumberOfFields": 30,
							"maxPageSize": 10000,
							"notOlderThan": 2678400
						}
					}
				}
			]
		}
	},
	"errors": null
}

Další podrobnosti o provádění dotazů najdete v našem úvodním průvodci.