러너 컨트롤러 토큰 API

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

히스토리 GitLab 18.9에서 FF_USE_JOB_ROUTER 플래그와 함께 도입 되었습니다. 기본적으로 비활성화. GitLab 18.10에서 last_used_at 필드가 추가 되었습니다. 이 기능은 개발 중이며 프로덕션 환경에서 사용할 준비가 되지 않았습니다. 러너 컨트롤러 토큰은 러너 컨트롤러 가 GitLab과 인증하는 데 사용됩니다. 전제 조건 # 관리자 액세스 권한이 있어야 합니다. 러너 컨트롤러 토큰 목록 조회 # 러너 컨트롤러의 인증 토큰 목록을 반환합니다. GET /runner_controllers/:id/tokens 속성 유형 필수 여부 설명 id integer 예 러너 컨트롤러의 ID 요청 예시: curl --header "PRIVATE-TOKEN: <your_access_token>" \ "https://gitlab.example.com/api/v4/runner_controllers/1/tokens" 응답 예시: [ { "id" : 1 , "created_at" : "2024-01-01T00:00:00.000Z" , "last_used_at" : "2024-01-01T00:00:00.000Z" } ] 단일 러너 컨트롤러 토큰 가져오기 # 러너 컨트롤러의 단일 인증 토큰을 반환합니다. GET /runner_controllers/:id/tokens/:token_id 속성 유형 필수 여부 설명 id integer 예 러너 컨트롤러의 ID token_id integer 예 토큰의 ID 요청 예시: curl --header "PRIVATE-TOKEN: <your_access_token>" \ "https://gitlab.example.com/api/v4/runner_controllers/1/tokens/1" 응답 예시: { "id" : 1 , "created_at" : "2024-01-01T00:00:00.000Z" , "last_used_at" : "2024-01-01T00:00:00.000Z" } 러너 컨트롤러 토큰 생성 # 러너 컨트롤러의 새 인증 토큰을 생성합니다. token 필드는 생성 직후에만 반환되며 이후에는 접근할 수 없습니다. 반드시 저장해 두어야 합니다. POST /runner_controllers/:id/tokens 속성 유형 필수 여부 설명 id integer 예 러너 컨트롤러의 ID 요청 예시: curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \ "https://gitlab.example.com/api/v4/runner_controllers/1/tokens" 응답 예시: { "id" : 1 , "token" : "glrct-<token>" , "created_at" : "2024-01-01T00:00:00.000Z" , "last_used_at" : null } 러너 컨트롤러 토큰 취소 # 러너 컨트롤러의 인증 토큰을 취소합니다. DELETE /runner_controllers/:id/tokens