REST API deprecations and removals

v4 API가 제거되면 다음과 같은 API 변경사항이 발생합니다.

이 변경사항의 날짜는 알려지지 않았습니다. 세부 정보는 이슈 216456 및 이슈 387485를 참조하십시오.

geo_nodes API endpoints

파괴적인 변경사항. 관련 이슈.

geo_nodes API endpoints는 폐지되었으며 geo_sites로 대체되었습니다. 이것은 Geo 배포물을 참조하는 방법에 대한 전역적인 변경의 일부입니다. 노드는 애플리케이션 전반에서 사이트로 이름이 변경되었습니다. 두 엔드포인트의 기능은 여전히 동일합니다.

merged_by API field

파괴적인 변경사항. 관련 이슈.

병합 요청 API의 merged_by 필드가 폐지되었으며 auto-merge로 설정하는 등의 작업을 수행할 때 더 정확하게 누가 병합을 수행했는지 식별하는 merge_user 필드로 대체되었습니다.

API 사용자는 새로운 merge_user 필드를 대신 사용할 것을 장려받습니다. merged_by 필드는 GitLab REST API의 v5에서 제거될 예정입니다.

merge_status API field

파괴적인 변경사항. 관련 이슈.

병합 요청 API의 merge_status 필드가 폐지되었으며 병합 요청이 가질 수 있는 잠재적인 상태를 보다 정확하게 식별하는 detailed_merge_status 필드로 대체되었습니다. API 사용자는 새로운 detailed_merge_status 필드를 대신 사용할 것을 장려받습니다. merge_status 필드는 GitLab REST API의 v5에서 제거될 예정입니다.

User API에서 private_profile 속성에 대한 Null 값

파괴적인 변경사항. 관련 이슈.

API를 통해 사용자를 생성하고 업데이트할 때 null은 private_profile 속성에 대한 유효한 값이었으며, 내부적으로 기본값으로 변환되었습니다. GitLab REST API의 v5에서는 더 이상이 매개변수에 대한 유효한 값이 아니며 사용할 경우 응답은 400이 될 것입니다. 이 변경 이후에는 유효한 값은 true와 false뿐입니다.

단일 병합 요청 변경 API 엔드포인트

파괴적인 변경사항. 관련 이슈.

단일 병합 요청에서 변경 사항을 가져오는 엔드포인트가 폐지되었으며 대신 병합 요청 차이 목록 엔드포인트를 사용하는 것이 좋습니다. API 사용자는 새로운 차이 엔드포인트로 전환하는 것이 좋습니다.

단일 병합 요청 변경 엔드포인트는 GitLab REST API의 v5에서 제거될 예정입니다.

관리되는 라이선스 API 엔드포인트

파괴적인 변경사항. 관련 이슈.

특정 프로젝트의 모든 관리되는 라이선스를 가져오는 엔드포인트가 폐지되었으며 대신 라이선스 승인 정책 기능을 사용하는 것이 좋습니다.

라이선스 감지를 기반으로 승인을 계속 원하는 사용자는 새로운 라이선스 승인 정책을 생성하는 것이 좋습니다.

관리되는 라이선스 엔드포인트는 GitLab REST API의 v5에서 제거될 예정입니다.

병합 요청 승인 API의 승인자 및 승인 그룹 필드

파괴적인 변경사항. 관련 이슈.

프로젝트의 승인 구성을 가져오는 엔드포인트는 approvers 및 approval_groups에 대해 빈 배열을 반환합니다. 이들 필드는 병합 요청에 대한 프로젝트 수준 규칙 엔드포인트를 대신하기 위해 폐지되었습니다. API 사용자는 이 엔드포인트로 전환하는 것이 좋습니다.

이들 필드는 GitLab REST API의 v5에서 구성 가져오기 엔드포인트에서 제거될 예정입니다.

active의 사용이 paused로 대체된 Runner 사용 API 엔드포인트

파괴적인 변경사항. 관련 이슈.

GitLab Runner GraphQL API 엔드포인트에서 active 식별자의 발생이 GitLab 16.0에서 paused로 이름이 바뀔 것입니다.

  • GitLab 14.8부터 시작하여 REST API의 v4에서 active 속성 대신 paused 속성을 사용할 수 있습니다.
  • GitLab REST API의 v5에서 이 변경은 active 속성을 사용하거나 반환하는 엔드포인트에 영향을 줄 것입니다.
    • GET /runners
    • GET /runners/all
    • GET /runners/:id / PUT /runners/:id
    • PUT --form "active=false" /runners/:runner_id
    • GET /projects/:id/runners / POST /projects/:id/runners
    • GET /groups/:id/runners

GitLab Runner 16.0 릴리스에서는 러너를 등록할 때 paused 속성을 사용할 것입니다.

Runner 상태는 중지됨을 반환하지 않습니다

파괴적인 변경. 관련 이슈.

미래의 REST API v5에서 GitLab Runner에 대한 엔드포인트는 더 이상 paused 또는 active를 반환하지 않을 것입니다.

Runner의 상태는 러너 연락처 상태와만 관련이 있을 것이며 다음과 같습니다: online, offline, 또는 not_connected. paused 또는 active 상태는 더 이상 표시되지 않을 것입니다.

API 사용자가 러너가 paused된 상태인지 확인할 때는 불리언 속성 paused가 true인지 확인하는 것이 권장됩니다. 또한, 러너가 active 상태인지 확인할 때는 paused가 false인지 확인하세요.

Runner가 ip_address를 반환하지 않을 것입니다

파괴적인 변경. 관련 이슈.

GitLab 17.0에서 Runners API는 러너에 대해 ip_address 대신 ""를 반환할 것입니다. REST API v5에서 해당 필드는 제거될 것입니다.