Consul HTTP API
Consul HTTP API (Consul HTTP API)
이 문서는 Consul의 HTTP API 인터페이스에 대해 설명해 드릴게요. API를 통해 어떤 작업을 할 수 있고, 어떻게 호출하고, 어떤 일반 규칙이 적용되는지 이해할 수 있어요.
출처: 문서
본문
이 페이지는 Consul의 기본 상호 작용 인터페이스인 HTTP API에 대해 설명합니다.
소개 (Introduction)
Consul은 모든 주요 기능에 대한 RESTful HTTP API를 제공합니다. API는 명령줄 도구, 다른 애플리케이션, orkel أدوات 자동화에서 호출할 수 있으며, JSON 형식의 응답을 반환합니다.
에이전트와 서버는 기본적으로 HTTP API를 위한 포트 8500에서 수신합니다. TLS를 활성화하면 8501 포트가 사용됩니다.
API 접근 (Accessing the API)
/v1/ 경로의 엔드포인트를 통해 API에 접근합니다. 대부분의 API는 HTTP 메서드(GET, PUT, POST, DELETE)와 리소스 경로를 사용합니다. 예를 들어 키/값 저장소를 조회하려면 GET /v1/kv/<key>를 사용합니다.
인증 (Authentication)
ACL이 활성화된 경우 요청 헤더 X-Consul-Token 또는 Authorization: Bearer 헤더로 토큰을 전달합니다.
일반 규칙 (General conventions)
- 쿼리 파라미터로
dc=를 전달하여 조회할 데이터센터를 지정할 수 있습니다. ?pretty파라미터로 JSON 응답을 보기 좋게 출력할 수 있습니다.- 많은 엔드포인트가 블로킹 쿼리(blocking queries)를 지원하여 특정 인덱스 이후의 변경을 감지할 수 있습니다.