← Аналитика / analytics / graphql-api / features / discovery

Узел настроек

Cloudflare GraphQL API предоставляет своим клиентам более 70 наборов данных. Эти наборы данных представляют разные продукты Cloudflare с очень разными структурами данных, поэтому у каждого есть своя конфигурация ограничения.

Хотя доступ к основным наборам данных открыт для ВСЕХ тарифных планов (например, httpRequestsAdaptiveGroups, firewallEventsAdaptive, и так далее), пользователям с более крупными тарифными планами доступен более широкий список наборов данных и более высокие лимиты запросов.

Помимо интроспекция, пользователи могут использовать узел Settings, который доступен как для зон, так и для аккаунтов.

Settings узел включает все датасеты из zones и accounts в качестве полей.

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

Каждый подузел settings узел может включать следующие поля:

• enabled - показывает, доступен ли узел для запрашивающей стороны;
• availableFields - показывает список полей, доступных для запрашивающей стороны. Если это вложенное поле, будет возвращён его путь, например sum_requests;
• maxPageSize - определяет максимальное количество записей, которое может быть возвращено
• maxNumberOfFields - показывает, сколько полей можно использовать в одном запросе для этого узла;
• notOlderThan - возвращает количество секунд, на которое запрос может заглянуть в прошлое;
• maxDuration - показывает, насколько широким может быть запрошенный временной диапазон.

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
}

Подробнее о том, как выполнять запросы, см. в нашем руководстве по началу работы руководства.