중요
레이블/태그에 대한 REST API 사용은 2022년 3월 31일에 수명 종료에 도달하며 이후에는 사용할 수 없습니다. 태그를 추가하는 방법은 태그 를 참조하십시오.
라벨 만들기
레이블/태그에 대한 REST API 사용은 더 이상 사용되지 않습니다. 태그를 추가하는 방법은 태그 를 참조하십시오.
REST API를 사용하여 레이블을 만들거나 적용하려면 다음이 필요합니다.
예에서
NEW_RELIC_USER_KEY
는 사용자 키 를 나타냅니다.
레이블은 기존 애플리케이션 ID 에 적용되어야 합니다.
라벨은 카테고리 라벨에 대한 지침을 준수해야 합니다.
다음 예와 유사한 명령을 사용하여 계정에 있는 애플리케이션에 레이블을 적용합니다. 예제에서 사용자 키와 애플리케이션 ID 를 대체하십시오.
이 명령을 사용하여 애플리케이션과 호스트에 동일한 레이블을 동시에 적용할 수 있습니다. 필요하지 않은 경우 "applications":
섹션을 생략할 수도 있습니다.
curl -X PUT 'https://api.newrelic.com/v2/labels.json' \
-H "Api-Key:NEW_RELIC_USER_KEY" -i \
-H 'Content-Type: application/json' \
-d \
'{
"label": {
"category": "Production",
"name": "Web01",
"links": {
"applications": [
123456,7898765 <---<< application ids
],
}
}
}'
레이블 생성: 출력 보기
레이블을 생성하거나 적용하기 위한 출력은 단일 애플리케이션에 대한 다음 예와 유사하게 나타납니다. 레이블 출력에는 다음이 포함됩니다.
- 레이블의 전체 키 이름(예:
Production:Main
), 키의 구성요소 및 이름 - 애플리케이션
health_status
(빨간색, 주황색, 녹색, 회색) 및 각 범주의 레이블에 대한 애플리케이션 ID 예를 들어 앱 ID 546917의 상태는 녹색(앱은 정상)입니다. - 이 레이블이 있는 앱 예를 들어
Production:Main
레이블이 한 애플리케이션에 적용되었습니다(546917).
{ "label": { "key": "Production:Main", "category": "Production", "name": "Main", "application_health_status": { "green": [ 546917 <---application id ], "orange": [], "red": [], "gray": [] }, "links": { "applications": [ 546917 <--- application id ], } },...}
라벨 반품 상태 만들기
라벨을 생성할 때 두 가지 가능한 반품 상태가 있습니다.
반품 상태 | 정의 |
---|---|
201 만들기 | 레이블이 생성되었습니다. |
304 수정되지 않음 | 기존 레이블을 다시 만들려는 시도가 있었지만 변경이 필요하거나 변경되지 않았습니다. |
기존 라벨 나열
레이블/태그에 대한 REST API 사용은 더 이상 사용되지 않습니다. 태그를 사용하는 방법은 태그 를 참조하십시오.
계정에 있는 라벨을 나열하려면 다음 명령어를 사용하세요.
curl 'https://api.newrelic.com/v2/labels.json' \
-H "Api-Key:NEW_RELIC_USER_KEY" -i
출력 보기
레이블 출력에는 다음이 포함됩니다.
- 레이블의 전체 키 이름(예:
Staging:Test1
), 키의 구성요소 및 이름 - 애플리케이션
health_status
(빨간색, 주황색, 녹색, 회색) 및 각 범주의 레이블에 대한 애플리케이션 ID - 이 레이블이 있는 앱 예를 들어
Staging:Test1
레이블은 하나의 애플리케이션(4937390)과 두 개의 호스트(3801143 및 5879721)에 적용되었습니다.
레이블 목록에 대한 출력은 다음과 유사하게 표시됩니다.
{ "labels": [ { "key": "Production:Main", "category": "Production", "name": "Main", "application_health_status": { "green": [], "orange": [], "red": [], "gray": [] }, "links": { "applications": [], } }, { "key": "Staging:Test1", "category": "Staging", "name": "Test1", "application_health_status": { "green": [], "orange": [], "red": [ 4937390 ], "gray": [] }, "links": { "applications": [ 4937390 ], } },...}
라벨 삭제
레이블/태그에 대한 REST API 사용은 더 이상 사용되지 않습니다. 태그를 사용하는 방법은 태그 를 참조하십시오.
주의
이 API 호출은 애플리케이션과 호스트 모두에서 레이블의 모든 인스턴스를 제거합니다. 특정 애플리케이션이나 호스트에서 레이블을 제거하려면 New Relic UI 를 사용해야 합니다.
다음 예와 유사한 명령을 사용하여 계정에서 레이블을 삭제합니다.
curl -X DELETE 'https://api.newrelic.com/v2/labels/Production:Main.json' \
-H "Api-Key:NEW_RELIC_USER_KEY" -i
New Relic REST API Explorer(v2)를 사용하여 레이블을 삭제할 수도 있습니다.
삭제: 출력 보기
레이블 삭제에 대한 출력은 단일 애플리케이션에 대한 다음 예와 유사하게 나타납니다. 이 예에서는 계정의 REST API 키 에 적용된 모든 위치에서 Production:Main
레이블을 삭제합니다.
레이블 삭제 출력에는 다음이 포함됩니다.
- 레이블의 전체 키 이름(예:
Production:Main
), 키의 구성요소 및 이름 - 애플리케이션
health_status
(빨간색, 주황색, 녹색, 회색) 및 각 범주의 레이블 ID 예를 들어 앱 ID 546917의 상태는 녹색(앱은 정상)입니다. - 이 레이블이 있는 앱 예를 들어
Production:Main
레이블이 한 애플리케이션에서 제거되었습니다(546917).
{ "label": { "key": "Production:Main", "category": "Production", "name": "Main", "application_health_status": { "green": [ 546917 ], "orange": [], "red": [], "gray": [] }, "links": { "applications": [ 546917 ], } }, ....}
반품 상태 삭제
레이블을 삭제할 때 두 가지 가능한 반품 상태가 있습니다.
반품 상태 | 정의 |
---|---|
200 OK | 레이블을 삭제하려는 시도가 성공했습니다. |
404 수정되지 않음 | 존재하지 않는 레이블을 삭제하려고 했습니다. |