이슈 링크 API

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

간단한 “관련된 사항” 관계는 GitLab Free에서 13.4로 이동되었습니다.

이슈 관계 목록

주어진 이슈의 연결된 이슈 목록을 가져와, 관계 생성 일시(오름차순)에 따라 정렬합니다. 사용자 권한에 따라 이슈가 필터링됩니다.

GET /projects/:id/issues/:issue_iid/links

매개변수:

속성	유형	필수 여부	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로
`issue_iid`	정수	예	프로젝트의 이슈의 내부 ID

[
  {
    "id" : 84,
    "iid" : 14,
    "issue_link_id": 1,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/14",
    "confidential": false,
    "weight": null,
    "link_type": "relates_to",
    "link_created_at": "2016-01-07T12:44:33.959Z",
    "link_updated_at": "2016-01-07T12:44:33.959Z"
  }
]

이슈 링크 가져오기

GitLab 15.1에서 도입되었습니다.

이슈 링크에 대한 세부 정보를 가져옵니다.

GET /projects/:id/issues/:issue_iid/links/:issue_link_id

지원되는 속성:

속성	유형	필수 여부	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로
`issue_iid`	정수	예	프로젝트의 이슈의 내부 ID
`issue_link_id`	정수/문자열	예	이슈 관계의 ID

응답 본문 속성:

속성	유형	설명
`source_issue`	객체	관계의 소스 이슈 세부 정보
`target_issue`	객체	관계의 대상 이슈 세부 정보
`link_type`	문자열	관계의 유형. 가능한 값은 `relates_to`, `blocks`, `is_blocked_by`입니다.

예시 요청:

curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/84/issues/14/links/1"

예시 응답:

{
  "source_issue" : {
    "id" : 83,
    "iid" : 11,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "subscribed" : true,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/11",
    "confidential": false,
    "weight": null
  },
  "target_issue" : {
    "id" : 84,
    "iid" : 14,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "subscribed" : true,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/14",
    "confidential": false,
    "weight": null
  },
  "link_type": "relates_to"
}

이슈 링크 만들기

두 이슈 간의 양방향 관계를 생성합니다. 사용자는 두 이슈를 업데이트할 수 있어야 합니다.

POST /projects/:id/issues/:issue_iid/links

속성	타입	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로
`issue_iid`	정수	예	프로젝트의 이슈의 내부 ID
`target_project_id`	정수/문자열	예	대상 프로젝트의 ID 또는 URL 인코딩된 경로
`target_issue_iid`	정수/문자열	예	대상 프로젝트의 이슈의 내부 ID
`link_type`	문자열	아니오	관계의 유형 (`relates_to`, `blocks`, `is_blocked_by`), 기본값은 `relates_to`

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/issues/1/links?target_project_id=5&target_issue_iid=1"

예시 응답:

{
  "source_issue" : {
    "id" : 83,
    "iid" : 11,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "subscribed" : true,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/11",
    "confidential": false,
    "weight": null
  },
  "target_issue" : {
    "id" : 84,
    "iid" : 14,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "subscribed" : true,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/14",
    "confidential": false,
    "weight": null
  },
  "link_type": "relates_to"
}

이슈 링크 삭제하기

이슈 링크를 삭제하여 양방향 관계를 제거합니다.

DELETE /projects/:id/issues/:issue_iid/links/:issue_link_id

속성	타입	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로
`issue_iid`	정수	예	프로젝트의 이슈의 내부 ID
`issue_link_id`	정수/문자열	예	이슈 관계의 ID
`link_type`	문자열	아니오	관계의 유형 (`relates_to`, `blocks`, `is_blocked_by`), 기본값은 `relates_to`

{
  "source_issue" : {
    "id" : 83,
    "iid" : 11,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "subscribed" : true,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/11",
    "confidential": false,
    "weight": null
  },
  "target_issue" : {
    "id" : 84,
    "iid" : 14,
    "project_id" : 4,
    "created_at" : "2016-01-07T12:44:33.959Z",
    "title" : "Issues with auth",
    "state" : "opened",
    "assignees" : [],
    "assignee" : null,
    "labels" : [
      "bug"
    ],
    "author" : {
      "name" : "Alexandra Bashirian",
      "avatar_url" : null,
      "state" : "active",
      "web_url" : "https://gitlab.example.com/eileen.lowe",
      "id" : 18,
      "username" : "eileen.lowe"
    },
    "description" : null,
    "updated_at" : "2016-01-07T12:44:33.959Z",
    "milestone" : null,
    "subscribed" : true,
    "user_notes_count": 0,
    "due_date": null,
    "web_url": "http://example.com/example/example/issues/14",
    "confidential": false,
    "weight": null
  },
  "link_type": "relates_to"
}

이슈 링크 API

이슈 관계 목록

이슈 링크 가져오기

이슈 링크 만들기

이슈 링크 삭제하기

도움말

기능 사용 가능성과 제품 평가판

도움받기