경보 관리 경보 API

요약

이 API를 사용하여 경보의 메트릭 이미지와 상호작용합니다. 추가 엔드포인트는 GraphQL API를 통해 사용할 수 있습니다. 지정된 경보의 메트릭 이미지를 업로드합니다. 지정된 경보의 모든 메트릭 이미지를 나열합니다.

이 API를 사용하여 경보의 메트릭 이미지와 상호작용합니다.

추가 엔드포인트는 GraphQL API를 통해 사용할 수 있습니다.

메트릭 이미지 업로드#

지정된 경보의 메트릭 이미지를 업로드합니다.

POST /projects/:id/alert_management_alerts/:alert_iid/metric_images

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

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
  --form 'file=@/path/to/file.png' \
  --form 'url=http://example.com' \
  --form 'url_text=Example website' \
  --url "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images"

응답 예시:

{
  "id":17,
  "created_at":"2020-11-12T20:07:58.156Z",
  "filename":"sample_2054",
  "file_path":"/uploads/-/system/alert_metric_image/file/17/sample_2054.png",
  "url":"https://example.com/metric",
  "url_text":"An example metric"
}

모든 메트릭 이미지 목록#

지정된 경보의 모든 메트릭 이미지를 나열합니다.

GET /projects/:id/alert_management_alerts/:alert_iid/metric_images

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

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images"

응답 예시:

[
  {
    "id":17,
    "created_at":"2020-11-12T20:07:58.156Z",
    "filename":"sample_2054",
    "file_path":"/uploads/-/system/alert_metric_image/file/17/sample_2054.png",
    "url":"https://example.com/metric",
    "url_text":"An example metric"
  },
  {
    "id":18,
    "created_at":"2020-11-12T20:14:26.441Z",
    "filename":"sample_2054",
    "file_path":"/uploads/-/system/alert_metric_image/file/18/sample_2054.png",
    "url":"https://example.com/metric",
    "url_text":"An example metric"
  }
]

메트릭 이미지 업데이트#

경보의 지정된 메트릭 이미지를 업데이트합니다.

PUT /projects/:id/alert_management_alerts/:alert_iid/metric_images/:image_id

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`alert_iid`	정수	예	프로젝트 경보의 내부 ID.
`image_id`	정수	예	이미지의 ID.
`url`	문자열	아니요	더 많은 메트릭 정보를 볼 수 있는 URL.
`url_text`	문자열	아니요	이미지 또는 URL에 대한 설명.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --request PUT  --form 'url=http://example.com' \
  --form 'url_text=Example website' \
  --url "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images/1"

응답 예시:

{
  "id":23,
  "created_at":"2020-11-13T00:06:18.084Z",
  "filename":"file.png",
  "file_path":"/uploads/-/system/alert_metric_image/file/23/file.png",
  "url":"https://example.com/metric",
  "url_text":"An example metric"
}

메트릭 이미지 삭제#

경보의 지정된 메트릭 이미지를 삭제합니다.

DELETE /projects/:id/alert_management_alerts/:alert_iid/metric_images/:image_id

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`alert_iid`	정수	예	프로젝트 경보의 내부 ID.
`image_id`	정수	예	이미지의 ID.

요청 예시:

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url  "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images/1"

다음 상태 코드를 반환할 수 있습니다:

204 No Content: 이미지가 성공적으로 삭제된 경우.
422 Unprocessable: 이미지를 삭제할 수 없는 경우.

경보 관리 경보 API

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

원문 보기

번역일: 2026-05-22

요약

이 API를 사용하여 경보의 메트릭 이미지와 상호작용합니다.

추가 엔드포인트는 GraphQL API를 통해 사용할 수 있습니다.

메트릭 이미지 업로드#

지정된 경보의 메트릭 이미지를 업로드합니다.

POST /projects/:id/alert_management_alerts/:alert_iid/metric_images

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

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
  --form 'file=@/path/to/file.png' \
  --form 'url=http://example.com' \
  --form 'url_text=Example website' \
  --url "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images"

응답 예시:

{
  "id":17,
  "created_at":"2020-11-12T20:07:58.156Z",
  "filename":"sample_2054",
  "file_path":"/uploads/-/system/alert_metric_image/file/17/sample_2054.png",
  "url":"https://example.com/metric",
  "url_text":"An example metric"
}

모든 메트릭 이미지 목록#

지정된 경보의 모든 메트릭 이미지를 나열합니다.

GET /projects/:id/alert_management_alerts/:alert_iid/metric_images

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

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images"

응답 예시:

[
  {
    "id":17,
    "created_at":"2020-11-12T20:07:58.156Z",
    "filename":"sample_2054",
    "file_path":"/uploads/-/system/alert_metric_image/file/17/sample_2054.png",
    "url":"https://example.com/metric",
    "url_text":"An example metric"
  },
  {
    "id":18,
    "created_at":"2020-11-12T20:14:26.441Z",
    "filename":"sample_2054",
    "file_path":"/uploads/-/system/alert_metric_image/file/18/sample_2054.png",
    "url":"https://example.com/metric",
    "url_text":"An example metric"
  }
]

메트릭 이미지 업데이트#

경보의 지정된 메트릭 이미지를 업데이트합니다.

PUT /projects/:id/alert_management_alerts/:alert_iid/metric_images/:image_id

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`alert_iid`	정수	예	프로젝트 경보의 내부 ID.
`image_id`	정수	예	이미지의 ID.
`url`	문자열	아니요	더 많은 메트릭 정보를 볼 수 있는 URL.
`url_text`	문자열	아니요	이미지 또는 URL에 대한 설명.

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --request PUT  --form 'url=http://example.com' \
  --form 'url_text=Example website' \
  --url "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images/1"

응답 예시:

{
  "id":23,
  "created_at":"2020-11-13T00:06:18.084Z",
  "filename":"file.png",
  "file_path":"/uploads/-/system/alert_metric_image/file/23/file.png",
  "url":"https://example.com/metric",
  "url_text":"An example metric"
}

메트릭 이미지 삭제#

경보의 지정된 메트릭 이미지를 삭제합니다.

DELETE /projects/:id/alert_management_alerts/:alert_iid/metric_images/:image_id

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`alert_iid`	정수	예	프로젝트 경보의 내부 ID.
`image_id`	정수	예	이미지의 ID.

요청 예시:

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url  "https://gitlab.example.com/api/v4/projects/5/alert_management_alerts/93/metric_images/1"

다음 상태 코드를 반환할 수 있습니다:

204 No Content: 이미지가 성공적으로 삭제된 경우.
422 Unprocessable: 이미지를 삭제할 수 없는 경우.