러너 컨트롤러 API

러너 컨트롤러 API에 대해 설명합니다.

Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조하세요. 이 기능은 테스트 목적으로 사용 가능하지만 프로덕션 환경에서 사용할 준비가 되지 않았습니다. 히스토리 GitLab 18.9에서 FF_USE_JOB_ROUTER 플래그와 함께 도입 되었습니다. 이 기능은 실험 단계이며 GitLab 테스팅 계약 이 적용됩니다. GitLab 18.10에서 connected 필드가 추가 되었습니다. 러너 컨트롤러 API를 사용하면 CI/CD 작업 승인 제어를 위한 러너 컨트롤러를 관리할 수 있습니다. 러너 컨트롤러는 작업 라우터에 연결하여 커스텀 정책에 따라 작업을 평가하고, 승인 또는 거부 여부를 결정합니다. 이 API는 러너 컨트롤러를 생성, 조회, 업데이트, 삭제하는 엔드포인트를 제공합니다. 전제 조건: GitLab 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다. 모든 러너 컨트롤러 목록 조회 # 모든 러너 컨트롤러를 나열합니다. GET /runner_controllers 응답: 성공하면 다음 응답 속성과 함께 200 OK 를 반환합니다: 속성 유형 설명 id integer 러너 컨트롤러의 고유 식별자입니다. description string 러너 컨트롤러에 대한 설명입니다. state string 러너 컨트롤러의 상태입니다. 유효한 값은 disabled (기본값), enabled , 또는 dry_run 입니다. created_at datetime 러너 컨트롤러가 생성된 날짜 및 시간입니다. updated_at datetime 러너 컨트롤러가 마지막으로 업데이트된 날짜 및 시간입니다. 요청 예시: curl --request GET \ --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/runner_controllers" 응답 예시: [ { "id" : 1 , "description" : "Runner controller" , "state" : "enabled" , "created_at" : "2026-01-01T00:00:00Z" , "updated_at" : "2026-01-02T00:00:00Z" } , { "id" : 2 , "description" : "Another runner controller" , "state" : "disabled" , "created_at" : "2026-01-03T00:00:00Z" , "updated_at" : "2026-01-04T00:00:00Z" } ] 단일 러너 컨트롤러 조회 # ID로 특정 러너 컨트롤러의 세부 정보를 조회합니다. GET /runner_controllers/:id 응답: 성공하면 다음 응답 속성과 함께 200 OK 를 반환합니다: 속성 유형 설명 id integer 러너 컨트롤러의 고유 식별자입니다. description string 러너 컨트롤러에 대한 설명입니다. state string 러너 컨트롤러의 상태