InfoGrab Docs

REST API 더 이상 사용되지 않는 기능

요약

다음 더 이상 사용되지 않는 기능을 정기적으로 검토하고 권장 변경 사항을 적용해야 합니다. 일부 더 이상 사용되지 않는 기능에서 v5 REST API를 언급하지만 현재 v5 REST API 개발은 진행되지 않습니다. geo_nodes API 엔드포인트는 더 이상 사용되지 않으며 geo_sites로 대체되었습니다.

다음 더 이상 사용되지 않는 기능을 정기적으로 검토하고 권장 변경 사항을 적용해야 합니다. 이러한 더 이상 사용되지 않는 기능은 종종 개선된 API 기능을 나타내며 기능을 위해 새 필드나 엔드포인트를 사용하도록 권장합니다.

일부 더 이상 사용되지 않는 기능에서 v5 REST API를 언급하지만 현재 v5 REST API 개발은 진행되지 않습니다. GitLab은 REST API v4 내에서 이러한 변경 사항을 적용하지 않으며 REST API에 대한 시맨틱 버저닝을 따릅니다.

geo_nodes API 엔드포인트#

주요 변경 사항. 관련 이슈.

geo_nodes API 엔드포인트는 더 이상 사용되지 않으며 geo_sites로 대체되었습니다. 이는 Geo 배포를 지칭하는 방법에 대한 전역 변경의 일부입니다. 노드는 애플리케이션 전반에 걸쳐 사이트로 이름이 변경되었습니다. 두 엔드포인트의 기능은 동일하게 유지됩니다.

merged_by API 필드#

주요 변경 사항. 관련 이슈.

머지 리퀘스트 API의 merged_by 필드는 단순 병합 외의 작업(자동 병합 설정, 머지 트레인 추가)을 수행할 때 머지 리퀘스트를 병합한 사람을 더 정확하게 식별하는 merge_user 필드로 대체되어 더 이상 사용되지 않습니다.

API 사용자는 새 merge_user 필드를 사용하도록 권장됩니다. merged_by 필드는 GitLab REST API v5에서 제거됩니다.

merge_status API 필드#

주요 변경 사항. 관련 이슈.

머지 리퀘스트 API의 merge_status 필드는 머지 리퀘스트가 가질 수 있는 모든 잠재적 상태를 더 정확하게 식별하는 detailed_merge_status 필드로 대체되어 더 이상 사용되지 않습니다. API 사용자는 새 detailed_merge_status 필드를 사용하도록 권장됩니다. merge_status 필드는 GitLab REST API v5에서 제거됩니다.

사용자 API의 private_profile 속성 Null 값#

주요 변경 사항. 관련 이슈.

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

단일 머지 리퀘스트 변경 사항 API 엔드포인트#

주요 변경 사항. 관련 이슈.

단일 머지 리퀘스트에서 변경 사항을 가져오는 엔드포인트는 머지 리퀘스트 diff 목록 엔드포인트로 대체되어 더 이상 사용되지 않습니다. API 사용자는 새 diff 엔드포인트로 전환하도록 권장됩니다.

단일 머지 리퀘스트의 변경 사항 엔드포인트는 GitLab REST API v5에서 제거됩니다.

관리형 라이선스 API 엔드포인트#

주요 변경 사항. 관련 이슈.

주어진 프로젝트의 모든 관리형 라이선스를 가져오는 엔드포인트는 라이선스 승인 정책 기능으로 대체되어 더 이상 사용되지 않습니다.

탐지된 라이선스를 기반으로 승인을 계속 적용하려는 사용자는 새 라이선스 승인 정책을 생성하도록 권장됩니다.

관리형 라이선스 엔드포인트는 GitLab REST API v5에서 제거됩니다.

머지 리퀘스트 승인 API의 승인자 및 승인자 그룹 필드#

주요 변경 사항. 관련 이슈.

프로젝트에 대한 승인 구성을 가져오는 엔드포인트는 approvers 및 approval_groups에 빈 배열을 반환합니다. 이러한 필드는 머지 리퀘스트에 대한 모든 승인 규칙을 나열하는 엔드포인트를 위해 더 이상 사용되지 않습니다. API 사용자는 이 엔드포인트로 전환하도록 권장됩니다.

이러한 필드는 GitLab REST API v5의 구성 가져오기 엔드포인트에서 제거됩니다.

active를 paused로 교체한 러너 사용#

주요 변경 사항. 관련 이슈.

GitLab Runner GraphQL API 엔드포인트에서 active 식별자는 GitLab 16.0에서 paused로 이름이 변경됩니다.

  • REST API v4에서는 active 속성 대신 paused 속성을 사용할 수 있습니다
  • 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 속성을 사용하기 시작합니다.

러너 상태는 paused를 반환하지 않음#

주요 변경 사항. 관련 이슈.

향후 REST API v5에서는 GitLab Runner 엔드포인트가 paused 또는 active를 반환하지 않습니다.

러너의 상태는 online, offline 또는 not_connected와 같은 러너 연결 상태에만 관련됩니다. paused 또는 active 상태는 더 이상 표시되지 않습니다.

러너가 paused 상태인지 확인할 때는 불리언 속성 paused가 true인지 확인하도록 권장됩니다. 러너가 active 상태인지 확인할 때는 paused가 false인지 확인하세요.

러너는 ip_address를 반환하지 않음#

주요 변경 사항. 관련 이슈.

GitLab 17.0에서 러너 API는 러너에 대해 ip_address 대신 ""를 반환합니다. REST API v5에서는 이 필드가 제거됩니다.

default_branch_protection API 필드#

주요 변경 사항. 관련 이슈.

default_branch_protection 필드는 GitLab 17.0에서 다음 API에 대해 더 이상 사용되지 않습니다:

기본 브랜치 보호에 대한 더 세밀한 제어를 제공하는 default_branch_protection_defaults 필드를 대신 사용해야 합니다.

default_branch_protection 필드는 GitLab REST API v5에서 제거됩니다.

require_password_to_approve API 필드#

require_password_to_approve는 GitLab 16.9에서 더 이상 사용되지 않습니다. 대신 require_reauthentication_to_approve 필드를 사용하세요. 두 필드에 모두 값을 제공하면 require_reauthentication_to_approve 필드가 우선합니다.

require_password_to_approve 필드는 GitLab REST API v5에서 제거됩니다.

프로젝트 API 엔드포인트를 통한 풀 미러링 구성#

주요 변경 사항. 관련 이슈.

GitLab 17.6에서 프로젝트 API를 통한 풀 미러링 구성이 더 이상 사용되지 않습니다. 새 구성 및 엔드포인트인 projects/:id/mirror/pull로 대체되었습니다.

프로젝트 API를 사용한 이전 구성은 GitLab REST API v5에서 제거됩니다.

프로젝트 API 엔드포인트의 restrict_user_defined_variables 매개변수#

GitLab 17.7에서 프로젝트 API의 restrict_user_defined_variables 매개변수는 ci_pipeline_variables_minimum_override_role만 사용하도록 더 이상 사용되지 않습니다.

restrict_user_defined_variables: false와 동일한 동작을 사용하려면 ci_pipeline_variables_minimum_override_role을 developer로 설정하세요.

프로젝트 가져오기 API 엔드포인트의 namespace 매개변수#

주요 변경 사항. 관련 이슈.

GitLab 18.7에서 프로젝트 가져오기 및 내보내기 API의 namespace 매개변수는 namespace_id 및 namespace_path 매개변수로 대체되어 더 이상 사용되지 않습니다. namespace 매개변수는 ID 또는 경로를 모두 허용하여 네임스페이스 경로에 숫자만 포함된 경우 모호성이 발생했습니다.

대신 다음을 사용해야 합니다:

  • 숫자 ID로 네임스페이스를 지정할 때는 namespace_id.
  • 경로로 네임스페이스를 지정할 때는 namespace_path.

namespace 매개변수는 GitLab REST API v5에서 제거됩니다.

REST API 더 이상 사용되지 않는 기능

원문 보기
요약

다음 더 이상 사용되지 않는 기능을 정기적으로 검토하고 권장 변경 사항을 적용해야 합니다. 일부 더 이상 사용되지 않는 기능에서 v5 REST API를 언급하지만 현재 v5 REST API 개발은 진행되지 않습니다. geo_nodes API 엔드포인트는 더 이상 사용되지 않으며 geo_sites로 대체되었습니다.

다음 더 이상 사용되지 않는 기능을 정기적으로 검토하고 권장 변경 사항을 적용해야 합니다. 이러한 더 이상 사용되지 않는 기능은 종종 개선된 API 기능을 나타내며 기능을 위해 새 필드나 엔드포인트를 사용하도록 권장합니다.

일부 더 이상 사용되지 않는 기능에서 v5 REST API를 언급하지만 현재 v5 REST API 개발은 진행되지 않습니다. GitLab은 REST API v4 내에서 이러한 변경 사항을 적용하지 않으며 REST API에 대한 시맨틱 버저닝을 따릅니다.

geo_nodes API 엔드포인트#

주요 변경 사항. 관련 이슈.

geo_nodes API 엔드포인트는 더 이상 사용되지 않으며 geo_sites로 대체되었습니다. 이는 Geo 배포를 지칭하는 방법에 대한 전역 변경의 일부입니다. 노드는 애플리케이션 전반에 걸쳐 사이트로 이름이 변경되었습니다. 두 엔드포인트의 기능은 동일하게 유지됩니다.

merged_by API 필드#

주요 변경 사항. 관련 이슈.

머지 리퀘스트 API의 merged_by 필드는 단순 병합 외의 작업(자동 병합 설정, 머지 트레인 추가)을 수행할 때 머지 리퀘스트를 병합한 사람을 더 정확하게 식별하는 merge_user 필드로 대체되어 더 이상 사용되지 않습니다.

API 사용자는 새 merge_user 필드를 사용하도록 권장됩니다. merged_by 필드는 GitLab REST API v5에서 제거됩니다.

merge_status API 필드#

주요 변경 사항. 관련 이슈.

머지 리퀘스트 API의 merge_status 필드는 머지 리퀘스트가 가질 수 있는 모든 잠재적 상태를 더 정확하게 식별하는 detailed_merge_status 필드로 대체되어 더 이상 사용되지 않습니다. API 사용자는 새 detailed_merge_status 필드를 사용하도록 권장됩니다. merge_status 필드는 GitLab REST API v5에서 제거됩니다.

사용자 API의 private_profile 속성 Null 값#

주요 변경 사항. 관련 이슈.

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

단일 머지 리퀘스트 변경 사항 API 엔드포인트#

주요 변경 사항. 관련 이슈.

단일 머지 리퀘스트에서 변경 사항을 가져오는 엔드포인트는 머지 리퀘스트 diff 목록 엔드포인트로 대체되어 더 이상 사용되지 않습니다. API 사용자는 새 diff 엔드포인트로 전환하도록 권장됩니다.

단일 머지 리퀘스트의 변경 사항 엔드포인트는 GitLab REST API v5에서 제거됩니다.

관리형 라이선스 API 엔드포인트#

주요 변경 사항. 관련 이슈.

주어진 프로젝트의 모든 관리형 라이선스를 가져오는 엔드포인트는 라이선스 승인 정책 기능으로 대체되어 더 이상 사용되지 않습니다.

탐지된 라이선스를 기반으로 승인을 계속 적용하려는 사용자는 새 라이선스 승인 정책을 생성하도록 권장됩니다.

관리형 라이선스 엔드포인트는 GitLab REST API v5에서 제거됩니다.

머지 리퀘스트 승인 API의 승인자 및 승인자 그룹 필드#

주요 변경 사항. 관련 이슈.

프로젝트에 대한 승인 구성을 가져오는 엔드포인트는 approvers 및 approval_groups에 빈 배열을 반환합니다. 이러한 필드는 머지 리퀘스트에 대한 모든 승인 규칙을 나열하는 엔드포인트를 위해 더 이상 사용되지 않습니다. API 사용자는 이 엔드포인트로 전환하도록 권장됩니다.

이러한 필드는 GitLab REST API v5의 구성 가져오기 엔드포인트에서 제거됩니다.

active를 paused로 교체한 러너 사용#

주요 변경 사항. 관련 이슈.

GitLab Runner GraphQL API 엔드포인트에서 active 식별자는 GitLab 16.0에서 paused로 이름이 변경됩니다.

  • REST API v4에서는 active 속성 대신 paused 속성을 사용할 수 있습니다
  • 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 속성을 사용하기 시작합니다.

러너 상태는 paused를 반환하지 않음#

주요 변경 사항. 관련 이슈.

향후 REST API v5에서는 GitLab Runner 엔드포인트가 paused 또는 active를 반환하지 않습니다.

러너의 상태는 online, offline 또는 not_connected와 같은 러너 연결 상태에만 관련됩니다. paused 또는 active 상태는 더 이상 표시되지 않습니다.

러너가 paused 상태인지 확인할 때는 불리언 속성 paused가 true인지 확인하도록 권장됩니다. 러너가 active 상태인지 확인할 때는 paused가 false인지 확인하세요.

러너는 ip_address를 반환하지 않음#

주요 변경 사항. 관련 이슈.

GitLab 17.0에서 러너 API는 러너에 대해 ip_address 대신 ""를 반환합니다. REST API v5에서는 이 필드가 제거됩니다.

default_branch_protection API 필드#

주요 변경 사항. 관련 이슈.

default_branch_protection 필드는 GitLab 17.0에서 다음 API에 대해 더 이상 사용되지 않습니다:

기본 브랜치 보호에 대한 더 세밀한 제어를 제공하는 default_branch_protection_defaults 필드를 대신 사용해야 합니다.

default_branch_protection 필드는 GitLab REST API v5에서 제거됩니다.

require_password_to_approve API 필드#

require_password_to_approve는 GitLab 16.9에서 더 이상 사용되지 않습니다. 대신 require_reauthentication_to_approve 필드를 사용하세요. 두 필드에 모두 값을 제공하면 require_reauthentication_to_approve 필드가 우선합니다.

require_password_to_approve 필드는 GitLab REST API v5에서 제거됩니다.

프로젝트 API 엔드포인트를 통한 풀 미러링 구성#

주요 변경 사항. 관련 이슈.

GitLab 17.6에서 프로젝트 API를 통한 풀 미러링 구성이 더 이상 사용되지 않습니다. 새 구성 및 엔드포인트인 projects/:id/mirror/pull로 대체되었습니다.

프로젝트 API를 사용한 이전 구성은 GitLab REST API v5에서 제거됩니다.

프로젝트 API 엔드포인트의 restrict_user_defined_variables 매개변수#

GitLab 17.7에서 프로젝트 API의 restrict_user_defined_variables 매개변수는 ci_pipeline_variables_minimum_override_role만 사용하도록 더 이상 사용되지 않습니다.

restrict_user_defined_variables: false와 동일한 동작을 사용하려면 ci_pipeline_variables_minimum_override_role을 developer로 설정하세요.

프로젝트 가져오기 API 엔드포인트의 namespace 매개변수#

주요 변경 사항. 관련 이슈.

GitLab 18.7에서 프로젝트 가져오기 및 내보내기 API의 namespace 매개변수는 namespace_id 및 namespace_path 매개변수로 대체되어 더 이상 사용되지 않습니다. namespace 매개변수는 ID 또는 경로를 모두 허용하여 네임스페이스 경로에 숫자만 포함된 경우 모호성이 발생했습니다.

대신 다음을 사용해야 합니다:

  • 숫자 ID로 네임스페이스를 지정할 때는 namespace_id.
  • 경로로 네임스페이스를 지정할 때는 namespace_path.

namespace 매개변수는 GitLab REST API v5에서 제거됩니다.