Epic API를 Work Items로 마이그레이션

Epic GraphQL API에서 Work Item API로 마이그레이션하는 방법을 설명합니다. 쿼리, 생성, 업데이트, 삭제 예시를 포함합니다.

히스토리 GitLab 17.2에서 work_item_epics 라는 플래그 와 함께 도입 되었습니다. 기본적으로 비활성화되어 있습니다. 에픽의 새로운 모양 이 활성화되어야 합니다. 베타 로 도입되었습니다. GitLab 17.4에서 GraphQL API 를 사용하여 에픽 나열 기능이 도입 되었습니다. GitLab 17.6에서 GitLab.com에 활성화 되었습니다. GitLab 17.7에서 GitLab Self-Managed 및 GitLab Dedicated에서 기본적으로 활성화 되었습니다. GitLab 18.1에서 일반 공급 되었습니다. 기능 플래그 work_item_epics 가 제거되었습니다. GitLab 17.2에서 에픽을 work item으로 도입했습니다. 통합이 계속 작동하도록 하려면: Epic GraphQL API 를 사용하는 경우 Epic GraphQL API가 제거되기 전에 Work Item API로 마이그레이션하세요. REST API 를 사용하는 경우 계속 사용할 수 있지만 통합을 미래에 대비하기 위해 마이그레이션해야 합니다. 새 기능(담당자, 건강 상태, 다른 유형과의 연결된 항목 등)을 사용하려면 WorkItem GraphQL API를 사용해야 합니다. API 상태 # REST API ( /api/v4/ ) # 에픽용 REST API: 여전히 지원되지만 사용 중단(deprecated)되었습니다. 기존 엔드포인트에서 계속 작동합니다. 새 기능을 받지 않습니다. 제거 날짜가 정해져 있지 않지만 주요 릴리스에서 제거될 예정입니다. GraphQL API # WorkItem GraphQL API: 실험적(experimental)으로 표시되어 있습니다. 프로덕션 환경에서 사용됩니다. GitLab 19.0 이전에 일반 공급 될 예정입니다. GitLab 19.0 이전에 실험적 상태 를 졸업할 예정입니다. Epic GraphQL API 는 GitLab 19.0에서 제거될 계획입니다. Work Item API로 마이그레이션 # Work Item API는 위젯을 사용하여 건강 상태, 담당자, 계층 구조와 같은 에픽 속성을 표현합니다. GraphiQL 탐색기 설정 # 다음 예시를 실행하려면 GraphiQL(기존 쿼리를 탐색할 수 있는 대화형 GraphQL API 탐색기)을 사용할 수 있습니다: GraphiQL 탐색기 도구를 열고: GitLab.com의 경우 https://gitlab.com/-/graphql-explorer 로 이동합니다. GitLab Self-Managed의 경우 https://gitlab.example.com/-/graphql-explorer 로 이동합니다. gitlab.example.com 을 인스턴스 URL로 변경합니다. 예시에 나열된 쿼리를 GraphiQL 탐색기 도구의 왼쪽 창에 붙여넣습니다. Play 를 선택합니다. 에픽 쿼리 # Note 에픽 ID는 work item ID와 다르지만 IID(각 그룹에 대해 증가하는 ID)는 동일합니다. 예를 들어 /gitlab-org/-/epics/123 의 에픽은 work