Job Scheduler Locks API
출처: 문서
본문
Job Scheduler Locks API
3.2에 도입됨 {: .label .label-purple }
Job Scheduler는 분산 락킹 메커니즘을 사용해서 클러스터 전체에서 잡 인스턴스가 한 번에 하나만 실행되도록 보장해요. Locks API는 Job Scheduler가 관리하는 모든 활성 잡 락에 대한 정보를 반환해요.
엔드포인트
GET /_plugins/_job_scheduler/api/locks
GET /_plugins/_job_scheduler/api/locks/{lock_id}
경로 파라미터
다음 표는 사용할 수 있는 경로 파라미터를 보여 줘요. 모든 경로 파라미터는 선택 사항이에요.
| 파라미터 | 데이터 타입 | 설명 |
|---|---|---|
<lock_id> |
String | 락의 고유 식별자예요. "index"-"job_id" 형식이며(예: .scheduler_sample_extension-jobid1), 인덱스 이름과 잡 ID는 반드시 하이픈(-)으로 구분해야 해요. |
예제 요청
GET /_plugins/_job_scheduler/api/locks
{% include copy-curl.html %}
예제 응답
{
"total_locks": 1,
"locks": {
".scheduler_sample_extension-jobid1": {
"job_index_name": ".scheduler_sample_extension",
"job_id": "jobid1",
"lock_time": 1754410412,
"lock_duration_seconds": 10,
"released": false
}
}
}
응답 본문 필드
다음 표는 모든 응답 본문 필드를 정리한 거예요.
| 필드 | 데이터 타입 | 설명 |
|---|---|---|
total_locks |
Integer | 활성 상태와 해제된 락의 총 개수예요. |
locks |
Map | 락 ID와 각 락에 해당하는 정보를 담고 있는 맵이에요. |
job_index_name |
String | 잡이 저장된 인덱스의 이름이에요. |
job_id |
String | 잡 ID예요. |
lock_time |
Seconds since the epoch | 락이 획득된 시간이에요. |
lock_duration_seconds |
Integer | 락이 유효한 최대 시간이에요. |
released |
Boolean | 락이 해제되었는지(true) 아니면 현재 활성 상태인지(false)를 나타내요. |