Freeze Periods API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

냠냠

권한 및 보안

기록자(Reporter)보다 높은 권한을 가진 사용자는 Freeze Period API 엔드포인트를 읽을 수 있습니다. 유지자(Maintainer) 역할을 가진 사용자만 Freeze Periods를 수정할 수 있습니다.

Freeze 기간 목록

created_at을 오름차순으로 정렬한 Freeze 기간의 페이지화된 목록입니다. 

GET /projects/:id/freeze_periods
속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.

예제 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/19/freeze_periods"

예제 응답: 

[
   {
      "id":1,
      "freeze_start":"0 23 * * 5",
      "freeze_end":"0 8 * * 1",
      "cron_timezone":"UTC",
      "created_at":"2020-05-15T17:03:35.702Z",
      "updated_at":"2020-05-15T17:06:41.566Z"
   }
]

freeze_period_id로 Freeze 기간 가져오기

주어진 freeze_period_id에 대한 Freeze 기간 가져오기 

GET /projects/:id/freeze_periods/:freeze_period_id
속성 유형 필수 설명
id 정수 또는 문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
freeze_period_id 정수 예 Freeze 기간의 ID.

예제 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/19/freeze_periods/1"

예제 응답: 

{
   "id":1,
   "freeze_start":"0 23 * * 5",
   "freeze_end":"0 8 * * 1",
   "cron_timezone":"UTC",
   "created_at":"2020-05-15T17:03:35.702Z",
   "updated_at":"2020-05-15T17:06:41.566Z"
}

Freeze 기간 생성

Freeze 기간 생성. 

POST /projects/:id/freeze_periods
속성 유형 필수 설명
id 정수 또는 문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
freeze_start 문자열 예 cron 형식의 Freeze 기간 시작.
freeze_end 문자열 예 cron 형식의 Freeze 기간 종료.
cron_timezone 문자열 아니오 cron 필드의 시간대, 제공되지 않으면 기본값은 UTC입니다.

예제 요청: 

curl --header 'Content-Type: application/json' --header "PRIVATE-TOKEN: <your_access_token>" \
     --data '{ "freeze_start": "0 23 * * 5", "freeze_end": "0 7 * * 1", "cron_timezone": "UTC" }' \
     --request POST "https://gitlab.example.com/api/v4/projects/19/freeze_periods"

예제 응답: 

{
   "id":1,
   "freeze_start":"0 23 * * 5",
   "freeze_end":"0 7 * * 1",
   "cron_timezone":"UTC",
   "created_at":"2020-05-15T17:03:35.702Z",
   "updated_at":"2020-05-15T17:03:35.702Z"
}

Freeze 기간 업데이트

주어진 freeze_period_id에 대한 Freeze 기간 업데이트. 

PUT /projects/:id/freeze_periods/:freeze_period_id
속성 유형 필수 설명
id 정수 또는 문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
freeze_period_id 정수 예 Freeze 기간의 ID.
freeze_start 문자열 아니요 cron 형식의 Freeze 기간 시작.
freeze_end 문자열 아니요 cron 형식의 Freeze 기간 종료.
cron_timezone 문자열 아니요 cron 필드의 시간대.

예제 요청: 

curl --header 'Content-Type: application/json' --header "PRIVATE-TOKEN: <your_access_token>" \
     --data '{ "freeze_end": "0 8 * * 1" }' \
     --request PUT "https://gitlab.example.com/api/v4/projects/19/freeze_periods/1"

예제 응답: 

{
   "id":1,
   "freeze_start":"0 23 * * 5",
   "freeze_end":"0 8 * * 1",
   "cron_timezone":"UTC",
   "created_at":"2020-05-15T17:03:35.702Z",
   "updated_at":"2020-05-15T17:06:41.566Z"
}

Freeze 기간 삭제

지정된 freeze_period_id에 대한 동결 기간을 삭제합니다. 

DELETE /projects/:id/freeze_periods/:freeze_period_id
속성 유형 필요 여부 설명
id 정수 또는 문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
freeze_period_id 정수 예 동결 기간의 ID.

예시 요청: 

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/19/freeze_periods/1"