이 문서는 GraphQL Playground를 사용하여 일부 샘플 쿼리를 실행하고 Cato Networks API 엔드포인트에 대한 연결을 테스트하는 방법을 설명합니다.
GraphQL Playground를 통해 Cato API 서버로 직접 전송되는 API 쿼리를 실행할 수 있습니다. Altair 또는 Postman과 같은 써드파티 API 쿼리 소프트웨어는 API 호출 실행을 위한 강력한 기능을 제공합니다. 그러나 API 쿼리와의 연결에 문제가 있는 경우, Playground를 사용하여 문제의 원인을 식별하는 데 도움을 받을 수 있습니다.
GraphQL Playground에서 Cato API 쿼리를 실행하려면 계정의 API 키(Resources > API Keys)가 필요합니다. API 키에 대한 자세한 내용은 Cato API에 대한 API 키 생성를 참조하십시오.
샘플 쿼리에 계정에 대한 Cato Management Application (CMA) ID를 입력해야 합니다. CMA ID는 계정 정보 페이지에서 찾을 수 있습니다.
API 엔드포인트의 URL은 Cato Management Application (CMA) 인스턴스가 호스팅되는 위치에 따라 다릅니다. URL에 귀하의 CMA 계정 및 API 엔드포인트에 첨부되는 <prefix> 값이 있을 수 있습니다.
-
prefix가 없는 경우 (
cc.catonetworks.com), 다음 URL을 사용합니다:https://api.catonetworks.com/api/v1/graphql2 -
prefix가 있는 경우 (예:
cc.us1.catonetworks.com), 다음 URL을 사용합니다:https://api.us1.catonetworks.com/api/v1/graphql2
Cato API 서버에 대한 연결을 테스트하기 위해 샘플 API 쿼리를 실행할 수 있습니다. accountID 인수와 API 키가 올바르게 구성된 경우, 샘플 API 쿼리가 계정 데이터를 반환하고 결과를 GraphQL Playground에 표시합니다. 쿼리가 귀하의 계정에 대한 결과를 반환하지 않으면, API 서버와의 연결에 문제가 있거나 서버가 다운되었을 수 있습니다. 다음 샘플 API 쿼리를 사용하여 Cato API 서버와의 연결성을 테스트할 수 있습니다:
인터넷 브라우저를 사용하여 Cato API에 대한 GraphQL Playground를 엽니다. Playground의 HTTP 헤더를 귀하의 API 키로 구성합니다. 왼쪽 창에 샘플 쿼리를 붙여넣고 계정 ID를 입력합니다. 그런 다음 쿼리를 실행하고 Playground에서 결과를 확인할 수 있습니다.
-
이 문서에서 샘플 API 쿼리 중 하나를 다운로드하고 메모장과 같은 텍스트 편집기에서 파일을 엽니다.
-
인터넷 브라우저에서 Cato API에 대한 GraphQL Playground로 이동합니다.
-
왼쪽 창 하단에서 HTTP HEADERS를 클릭합니다.
-
다음 형식으로 API 키를 입력합니다:
{ "x-api-key" :"<api key>" }.다음 스크린샷은 API 키AaBbCcDdEeFf0123456789ABCDEF1234로 구성된 HTTP 헤더를 보여줍니다:
-
Playground의 왼쪽 창에 샘플 쿼리 중 하나를 복사하여 붙여넣습니다.
-
쿼리 상단에서
accountID인수에 귀하의 계정 ID를 입력합니다.다음 스크린샷은 값 2626으로 구성된
accountID인수를 보여줍니다: -
플레이 버튼을 클릭합니다.
-
오른쪽 창에 API 쿼리의 결과가 표시됩니다. 다음 스크린샷은 계정 ID 2626에 대한 샘플 accountMetrics 쿼리 결과를 보여줍니다:
- accountMetrics_sample.txt3 킬로바이트
- accountSnapshot_sample.txt4 킬로바이트
댓글 0개
댓글을 남기려면 로그인하세요.