--- sourceDocument: 호주 API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 애플리케이션 서비스 API # 애플리케이션 서비스 API {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 31분 애플리케이션 서비스 API는 애플리케이션 서비스를 생성, 수정 및 업데이트할 수 있는 엔드포인트를 제공합니다. 이 API를 사용하려면 사용자에게 애플리케이션 서비스 관리자 \[app_service_admin\] 역할이 있어야 합니다. 중요사항: 릴리스부터 Rome애플리케이션 서비스 API는 더 이상 향상되거나 지원되지 않습니다. 자세한 내용은 Now Support 지식베이스에서 [사용 중단 프로세스 \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) 문서를 참조하십시오. ## 애플리케이션 서비스 - GET /now/cmdb/app_service/{sys_id}/getContent {#ariaid-title2} 매핑된 애플리케이션 서비스의 CI(구성 항목) 목록과 해당 항목들 간의 관계를 검색합니다. 수동으로 생성된 서비스에 대한 컨텐츠만 검색합니다. ### URL 형식 {#appservice-GET-getContent__section_lwf_psn_wlb} 기본 URL: /api/now/cmdb/app_service/{sys_id}/getContent ### 지원되는 요청 매개변수 {#appservice-GET-getContent__entry__2} | 이름 | 설명 | |-|-| | sys_id | 매핑된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 테이블: 매핑된 애플리케이션 서비스 \[cmdb_ci_service_discovered\] | [표 1. 경로 매개변수] {#appservice-GET-getContent__entry__6} | 이름 | 설명 | |-|-| | 모드 | 반환할 관계 데이터의 양입니다. 유효한 값은 다음과 같습니다. * 전체: 얕은 모드로 반환된 데이터 외에 CI 속성 및 조회 정보를 반환합니다. * 얕은: 서비스 내 CI 간의 상위 및 하위 관계를 반환합니다. {#appservice-GET-getContent__ul_mcl_cl4_ndb} 이 값은 대소문자를 구분하지 않습니다. 데이터 유형: 문자열 | [표 2. 쿼리 매개변수] {#appservice-GET-getContent__entry__10} | 이름 | 설명 | |-|-| | 안 함 | | [표 3. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-GET-getContent__entry__14}{#appservice-GET-getContent__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 4. 요청 헤더] {#appservice-GET-getContent__entry__18} | 머리글 | 설명 | |-|-| | 안 함 | | [표 5. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-GET-getContent__entry__22}{#appservice-GET-getContent__entry-200-status-code}{#appservice-GET-getContent__entry-400-status-code}{#appservice-GET-getContent__entry-401-appservice}{#appservice-GET-getContent__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 app_service_admin 역할이 없습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 6. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#appservice-GET-getContent__table_nyj_nl4_wlb__entry__2} | 이름 | 설명 | |-|-| | CMDB | 지정된 애플리케이션 서비스와 연결된 CI를 설명하는 객체의 목록입니다. 데이터 유형: 객체 "cmdb": [ { "items": {Object}, "relations": [Array] } ] | | cmdb.항목 | 애플리케이션 서비스 내의 CI입니다. 요청에서 전체 쿼리 매개변수가 전달된 경우 이 섹션에는 각 CI에 대한 속성 및 조회 정보가 포함됩니다. 데이터 유형: 배열 "items": [ { "className": "String", "values": {Object} } ] | | cmdb.items.className | CI가 들어 있는 클래스의 이름입니다. 데이터 유형: 문자열 | | cmdb.항목.값 | 연결된 CI를 찾는 데 사용할 정보입니다. 데이터 유형: 객체 "values": { "name": "String", "sys_id": "String" } | | cmdb.items.values.name | CI의 이름입니다. 데이터 유형: 문자열 | | cmdb.items.values.sys_id | CI의 Sys_id입니다. 데이터 유형: 문자열 | | cmdb.relations | 호스트 및 해당 하위 호스트와 같은 연결된 CI에 대한 관계 데이터입니다. 데이터 유형: 배열 | | 서비스 | 식별된 서비스와 관련된 서비스 목록입니다. 데이터 유형: 객체 배열 "service": [ { "name": "String", "service_relations": [Array], "url": "String" } ] | | service.name | 애플리케이션 서비스의 이름입니다. 데이터 유형: 문자열 | | service.service_relations | 애플리케이션 서비스 내 CI에 대한 계층 구조 데이터입니다. 모든 CI는 상위 및 하위 CI와 쌍을 형성합니다. 애플리케이션 서비스의 엔트리포인트라고 하는 최상위 CI에는 상위 CI가 없습니다. 데이터 유형: 객체 배열 "service_relations": [ { "child": "String", "parent": "String" } ] | | service.service_relations.child | CI와 관련된 하위 CI의 이름입니다. 데이터 유형: 문자열 | | service.service_relations.parent | CI와 관련된 상위 CI의 이름입니다. 데이터 유형: 문자열 | | 서비스.url | 애플리케이션 서비스의 상대 경로입니다. 데이터 유형: 문자열 | [ ] {#appservice-GET-getContent__table_nyj_nl4_wlb} ### 샘플 cURL 요청 curl "https://instance.servicenow.com/api/now/cmdb/app_service/2fce42d80a0a0bb4004af34d7e3984c8/getContent?mode=shallow" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' { "service": { "name": "PeopleSoft Portals", "url": "/api/now/table/cmdb_ci_service_discovered/2fce42d80a0a0bb4004af34d7e3984c8", "service_relations": [ { "parent": "", "child": "3a2810c20a0a0bb400268337d6e942ca" }, { "parent": "3a27f1520a0a0bb400ecd6ff7afcf036", "child": "3a5dd3dbc0a8ce0100655f1ec66ed42c" }, { "parent": "3a290cc60a0a0bb400000bdb386af1cf", "child": "3a307c930a0a0bb400353965d0b8861f" }, { "parent": "3a172e820a0a0bb40034228e9f65f1be", "child": "3a27d4370a0a0bb4006316812bf45439" }, { "parent": "", "child": "3a172e820a0a0bb40034228e9f65f1be" }, { "parent": "", "child": "3a27f1520a0a0bb400ecd6ff7afcf036" }, { "parent": "3a2810c20a0a0bb400268337d6e942ca", "child": "3a290cc60a0a0bb400000bdb386af1cf" } ] }, "cmdb": { "relations": [], "items": [ { "values": { "sys_id": "3a172e820a0a0bb40034228e9f65f1be", "name": "PS LoadBal01" }, "className": "cmdb_ci_win_server" }, { "values": { "sys_id": "3a2810c20a0a0bb400268337d6e942ca", "name": "PS Apache03" }, "className": "cmdb_ci_web_server" }, { "values": { "sys_id": "55b35562c0a8010e01cff22378e0aea9", "name": "ny8500-nbxs08" }, "className": "cmdb_ci_netgear" }, { "values": { "sys_id": "3a27f1520a0a0bb400ecd6ff7afcf036", "name": "PS Apache02" }, "className": "cmdb_ci_web_server" }, { "values": { "sys_id": "3a307c930a0a0bb400353965d0b8861f", "name": "PS ORA01" }, "className": "cmdb_ci_database" } ] } } ## 애플리케이션 서비스 - GET /now/cmdb/csdm/app_service/find_service {#ariaid-title3} 지정된 애플리케이션 서비스 및 관련 비즈니스 컨텍스트에 대한 기본 정보를 반환합니다. 주: 이 엔드포인트는 더 이상 사용되지 않으므로 대신 사용하십시오 [SG 서비스 -- POST /sg_services/app_service/find](https://servicenow-prod.fluidtopics.net/wNuvdgu2cbIL7~RIXXMeoQ#sg_svcs-POST-find "지정된 애플리케이션 서비스 및 업스트림 관계의 상세 정보를 찾습니다.") . ### URL 형식 기본 URL: /api/now/cmdb/csdm/app_service/find_service ### 지원되는 요청 매개변수 {#appservice-GET-find_service__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 7. 경로 매개변수] {#appservice-GET-find_service__entry__6} | 이름 | 설명 | |-|-| | 이름 | 전달되지 않은 경우 number 필수입니다. 정보를 반환할 서비스의 이름입니다. 데이터 유형: 문자열 테이블: 서비스 인스턴스 \[cmdb_ci_service_auto\] | | 번호 | 전달되지 않은 경우 name 필수입니다. 정보를 반환할 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 테이블: 서비스 인스턴스 \[cmdb_ci_service_auto\] | [표 8. 쿼리 매개변수] {#appservice-GET-find_service__entry__12} | 이름 | 설명 | |-|-| | 안 함 | | [표 9. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-GET-find_service__entry__16}{#appservice-GET-find_service__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 10. 요청 헤더] {#appservice-GET-find_service__entry__20} | 머리글 | 설명 | |-|-| | 안 함 | | [표 11. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-GET-find_service__table_wwn_rhd_ct__entry__2}{#appservice-GET-find_service__entry-200-status-code}{#appservice-GET-find_service__entry-400-status-code}{#appservice-GET-find_service__entry-401-appservice}{#appservice-GET-find_service__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 app_service_admin 역할이 없습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 12. 상태 코드] {#appservice-GET-find_service__table_wwn_rhd_ct} ### 응답 본문 매개변수(JSON 또는 XML) {#appservice-GET-find_service__entry__34}{#appservice-GET-find_service__entry-error-appservice}{#appservice-GET-find_service__entry-error-details-appservice}{#appservice-GET-find_service__entry-error-message-appservice} | 이름 | 설명 | |-|-| | 오류 | 발생한 오류에 대해 설명합니다. 데이터 유형: 객체 "error": { "details": "String", "message": "String" } | | 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 | | 오류.메시지 | 오류를 설명하는 메시지입니다. 데이터 유형: 문자열 | | services | 지정된 애플리케이션 서비스와 연결된 서비스의 상세 정보를 포함하는 각 객체를 포함하는 객체의 배열입니다. 데이터 유형: 배열 "services": [ { "environment": "String", "name": "String", "number": "String", "relationships": {Object}, "sys_id": "String", "version": "String" } ] | | 서비스.환경 | 애플리케이션 서비스가 배포되는 환경(예: "프로덕션" 또는 "테스트 랩 2") 이 값은 구현자에게 의미가 있는 모든 값이 될 수 있습니다. 데이터 유형: 문자열 최대 길이: 40 기본값: null | | services.name | 필수 애플리케이션 서비스의 이름입니다. 다른 모든 애플리케이션 서비스의 고유한 이름이어야 합니다. 데이터 유형: 문자열 최대 길이: 255 | | 서비스.번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 이 값은 엔드포인트에서 처음 생성됩니다. 데이터 유형: 문자열 | | 서비스.관계 | 애플리케이션 서비스와 연결된 서비스 유형입니다. 데이터 유형: 객체 "relationships": { "business_app": [Array], "business_service_offering": [Array], "technical_service_offering": [Array] } | | services.relationships.business_app | 애플리케이션 서비스와 관련된 비즈니스 애플리케이션 sys_ids 목록입니다. 데이터 유형: 배열 | | services.relationships.technical_service_offering | 애플리케이션 서비스와 관련된 기술 관리 오퍼링(이전 명칭: 기술 서비스 오퍼링)의 sys_ids 목록입니다. 데이터 유형: 배열 | | services.relationships.business_service_offering | 애플리케이션 서비스와 관련된 비즈니스 서비스 오퍼링 sys_ids의 목록입니다. 데이터 유형: 배열 | | services.sys_id | 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 | | 서비스.버전 | 애플리케이션 서비스 버전 번호입니다. 데이터 유형: 문자열 최대 길이: 40 형식: 사용자 정의 가능 기본값: null | [ ] ### 샘플 cURL 요청 curl -X GET \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/find_service?name=Email_East&number=SNSVC0001018 \ -H 'Accept: application/json' \ -u 'username':'password' { "result": { "services": [ { "name": "Email_East", "number": "SNSVC0001018", "sys_id": "f809cb60db94101037740f95ca96190f", "environment": "Production", "version": "1.1.1", "relationships": { "business_app": [ "658c7620db54101037740f95ca9619f2" ], "technical_service_offering": [], "business_service_offering": [ "069c7e20db54101037740f95ca9619bf" ] } } ] } } ## 애플리케이션 서비스 - POST /now/cmdb/app_service/create {#ariaid-title4} 애플리케이션 서비스를 만들거나 기존 애플리케이션 서비스를 업데이트합니다. ### URL 형식 기본 URL: /api/now/cmdb/app_service/create ### 지원되는 요청 매개변수 {#createService-POST-api-now-cmdb-app__entry__2} | 매개변수 | 설명 | |-|-| | 안 함 | | [표 13. 매개변수] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#createService-POST-api-now-cmdb-app__entry__6}{#createService-POST-api-now-cmdb-app__accept-RESTAPI}{#createService-POST-api-now-cmdb-app__content_type-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 14. 요청 헤더] {#createService-POST-api-now-cmdb-app__entry__12} | 머리글 | 설명 | |-|-| | 안 함 | | [표 15. 응답 헤더] ### 상태 코드 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#createService-POST-api-now-cmdb-app__table_wwn_rhd_ct__entry__2}{#createService-POST-api-now-cmdb-app__entry-200-status-code}{#createService-POST-api-now-cmdb-app__entry-400-status-code}{#createService-POST-api-now-cmdb-app__entry-401-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | [표 16. 상태 코드] {#createService-POST-api-now-cmdb-app__table_wwn_rhd_ct} ### 요청 본문 API는 요청 본문에서 이러한 JSON 요소를 허용합니다. 또한 매핑된 애플리케이션 서비스 \[cmdb_ci_service_discovered\] 테이블의 필드를 추가하여 데이터를 애플리케이션 서비스 기록으로 전달할 수 있습니다. 예를 들어, 의견 필드에 콘텐츠를 추가하려면 JSON 요청에 `"의견": "의견 필드에 데이터 전달 중"` 을 추가합니다. {#createService-POST-api-now-cmdb-app__table_rm1_yjd_kv__entry__2} | 요소 | 설명 | |-|-| | 이름 | 만들거나 업데이트하려는 애플리케이션 서비스의 이름입니다. | | service_relations | CI와 CI가 형성하는 계층 구조에 대한 정보입니다. 모든 CI는 상위 CI 및 하위 CI와 쌍을 형성합니다. 애플리케이션 서비스의 엔트리포인트라고 하는 최상위 CI에는 상위 CI가 없습니다. | | 상위 | 맵 계층 구조의 하위 수준에 있는 CI와 나가는 연결이 이 CI를 조인하는 CI의 Sys_ ID입니다. | | 하위 | 맵 계층 구조에서 상위 수준에 위치한 CI와 이 CI를 조인하는 수신 연결이 있는 CI의 Sys_ ID입니다. | [표 17. 요청 본문에 수락된 요소] {#createService-POST-api-now-cmdb-app__table_rm1_yjd_kv} ### 응답 본문 API는 응답 본문에 이러한 JSON 요소를 반환합니다. {#createService-POST-api-now-cmdb-app__table_mc1_pr1_tx__entry__2} | 요소 | 설명 | |-|-| | URL | 애플리케이션 서비스 기록의 sys_id 표시하기 위한 표준 테이블 REST API의 URL입니다. 이 요소는 엔드포인트가 성공한 경우에만 나타납니다. 데이터 유형: 문자열 | | getContentUrl | 애플리케이션 서비스 컨텐츠를 가져오기 위한 REST API 경로입니다. 이 요소는 엔드포인트가 성공한 경우에만 나타납니다. 데이터 유형: 문자열 | | 정보 | 애플리케이션 서비스에 추가된 CI 수입니다. 이 요소는 엔드포인트가 성공한 경우에만 나타납니다. 데이터 유형: 문자열 | | 오류 | 오류 메시지 상세 정보입니다. 이 요소는 엔드포인트가 실패하는 경우에만 나타납니다. 데이터 유형: 객체 | | 메시지 | 오류의 특성을 설명하는 오류 메시지입니다. 이 요소는 엔드포인트가 실패하는 경우에만 나타납니다. 데이터 유형: 문자열 | | 상태 | REST API가 실패할 경우 "실패"라고 표시합니다. 이 요소는 엔드포인트가 실패하는 경우에만 나타납니다. 데이터 유형: 문자열 | [표 18. 응답 본문에 반환되는 요소] {#createService-POST-api-now-cmdb-app__table_mc1_pr1_tx} ### 샘플 cURL 요청 curl "http:///api/now/cmdb/app_service/create" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"name\": \"myTestAppService\", \"comments\": \"Passing data to the Comments field\", \"service_relations\": [ { \"parent\": \"\", \"child\": \"3a70f789c0a8ce010091b0ea635b982a\" },{ \"parent\": \"3a70f789c0a8ce010091b0ea635b982a\", \"child\": \"b4fd7c8437201000deeabfc8bcbe5dc1\" },{ \"parent\": \"b4fd7c8437201000deeabfc8bcbe5dc1\", \"child\": \"53fdbc8437201000deeabfc8bcbe5d10\" } ] }" \ --user 'admin':'admin' { "result": { "url": "/api/now/table/cmdb_ci_service_discovered/b1cff89fc9e19300964fcbb1ac3059a5", "getContentUrl": "/api/now/cmdb/app_service/b1cff89fc9e19300964fcbb1ac3059a5/getContent", "info": "3 CIs added to service" } } ## 애플리케이션 서비스 - POST /now/cmdb/csdm/app_service/register_service {#ariaid-title5} 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 애플리케이션 서비스 기록 스텁을 만들고 전달된 정보로 채웁니다. 레코드를 저장하기 전에 전달된 매개변수와 애플리케이션 서비스 이름의 고유성을 확인합니다. 또한 지정된 비즈니스 애플리케이션, 비즈니스 서비스 오퍼링 및 기술 관리 오퍼링(이전의 기술 서비스 오퍼링) 을 서비스 애플리케이션에 연결하여 서비스에 비즈니스 컨텍스트를 제공하는 업스트림 관계를 생성합니다. 인프라에 대한 다운스트림 관계를 생성하지 않습니다. 다운스트림 관계를 정의하려면 애플리케이션 서비스 - PUT /now/cmdb/csdm/app_service/{service_sys_id}/populate_service 엔드포인트를 호출해야 합니다. 주: 이 엔드포인트는 더 이상 사용되지 않으므로 대신 사용하십시오 [SG 서비스 -- POST /sg_services/app_service/register](https://servicenow-prod.fluidtopics.net/wNuvdgu2cbIL7~RIXXMeoQ#sg_svcs-POST-register "애플리케이션 서비스를 생성하고 태그를 지정하고 비즈니스 애플리케이션, 비즈니스 서비스 오퍼링 및 기타 애플리케이션 서비스와 같은 업스트림 관계를 구성합니다.") . ### URL 형식 기본 URL: /api/now/cmdb/csdm/app_service/register_service ### 지원되는 요청 매개변수 {#appservice-POST-register_service__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 19. 경로 매개변수] {#appservice-POST-register_service__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 20. 쿼리 매개변수] {#appservice-POST-register_service__entry__10}{#appservice-POST-register_service__entry-basic_details-environment-appservice}{#appservice-POST-register_service__entry-basic_details-name-appservice}{#appservice-POST-register_service__entry-basic_details-version-appservice}{#appservice-POST-register_service__entry-relationships-bus_app-appservice}{#appservice-POST-register_service__entry-relationships-bus_srv_off-appservice}{#appservice-POST-register_service__entry-relationships-tech_srv_off-appservice} | 이름 | 설명 | |-|-| | basic_details | 필수 지정된 애플리케이션 서비스와 연결된 서비스의 상세 정보입니다. 데이터 유형: 객체 "basic_details": { "environment": "String", "name": "String", "version": "String" } | | basic_details.environment | 애플리케이션 서비스가 배포되는 환경(예: "프로덕션" 또는 "테스트 랩 2") 이 값은 구현자에게 의미가 있는 모든 값이 될 수 있습니다. 데이터 유형: 문자열 최대 길이: 40 기본값: null | | basic_details.name | 필수 애플리케이션 서비스의 이름입니다. 다른 모든 애플리케이션 서비스의 고유한 이름이어야 합니다. 데이터 유형: 문자열 최대 길이: 255 | | basic_details.version | 애플리케이션 서비스 버전 번호입니다. 데이터 유형: 문자열 최대 길이: 40 형식: 사용자 정의 가능 기본값: null | | 관계 | 애플리케이션 서비스와 연결할 업스트림(상위) 서비스 유형입니다. 데이터 유형: 객체 "relationships": { "business_app": [Array], "business_service_offering": [Array], "technical_service_offering": [Array] } 테이블: CI 관계 \[cmdb_rel_ci\] | | relationships.business_app | 애플리케이션 서비스와 관련된 비즈니스 애플리케이션 sys_ids 목록입니다. 데이터 유형: 배열 | | relationships.business_service_offering | 애플리케이션 서비스와 관련된 비즈니스 서비스 오퍼링 sys_ids의 목록입니다. 데이터 유형: 배열 | | relationships.technical_service_offering | 애플리케이션 서비스와 관련된 기술 서비스 오퍼링 sys_ids의 목록입니다. 데이터 유형: 배열 | [표 21. 요청 본문 매개변수] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-POST-register_service__table_hxm_cks_mlb__entry__2}{#appservice-POST-register_service__accept-JSON-only-entry-RESTAPI}{#appservice-POST-register_service__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 22. 요청 헤더] {#appservice-POST-register_service__table_hxm_cks_mlb} {#appservice-POST-register_service__entry__34} | 머리글 | 설명 | |-|-| | 안 함 | | [표 23. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-POST-register_service__table_wwn_rhd_ct__entry__2}{#appservice-POST-register_service__entry-400-status-code}{#appservice-POST-register_service__entry-401-appservice}{#appservice-POST-register_service__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 201 | 성공입니다. 애플리케이션 서비스가 성공적으로 등록되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 app_service_admin 역할이 없습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 24. 상태 코드] {#appservice-POST-register_service__table_wwn_rhd_ct} ### 응답 본문 매개변수(JSON 또는 XML) {#appservice-POST-register_service__entry__48}{#appservice-POST-register_service__entry-error-appservice}{#appservice-POST-register_service__entry-error-details-appservice}{#appservice-POST-register_service__entry-error-message-appservice} | 이름 | 설명 | |-|-| | 오류 | 발생한 오류에 대해 설명합니다. 데이터 유형: 객체 "error": { "details": "String", "message": "String" } | | 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 | | 오류.메시지 | 오류를 설명하는 메시지입니다. 데이터 유형: 문자열 | | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 이 번호는 엔드포인트에서 생성됩니다. 데이터 유형: 문자열 | | service_sys_id | 등록된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 | [ ] ### 샘플 cURL 요청 curl -X POST \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/register_service \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' -d '{ "basic_details": { "environment": "Test Lab 2", "name": "Test Lab 2", "version": "1.1.1" }, "relationships": { "business_app":["f07c7620db54101037740f95ca96199a"], "business_service_offering":["069c7e20db54101037740f95ca9619bf"] } }' { "result": { "service_sys_id": "80f21bbadbd410103d3a93c3e296199a", "number": "SNSVC0001018" } } ## 애플리케이션 서비스 - PUT /now/cmdb/csdm/app_service/{service_sys_id}/populate_service {#ariaid-title6} 지정된 애플리케이션 서비스를 지정된 다운스트림 CI(구성 항목) 세트로 채웁니다. 이 엔드포인트를 호출하기 전에 [POST /now/cmdb/csdm/app_service/register_service](https://servicenow-prod.fluidtopics.net/yoa2hHk6qwzDmChCOpI94A#appservice-POST-register_service "서비스 인스턴스 [cmdb_ci_service_auto] 테이블에 애플리케이션 서비스 기록 스텁을 만들고 전달된 정보로 채웁니다.") 엔드포인트를 호출하여 애플리케이션 서비스를 만들어야 합니다. 주: 이 엔드포인트는 더 이상 사용되지 않으므로 대신 사용하십시오 [SG 서비스 -- POST /sg_services/app_service/populate](https://servicenow-prod.fluidtopics.net/wNuvdgu2cbIL7~RIXXMeoQ#sg_svcs-POST-populate "애플리케이션 서비스에 서비스 채우기 방법을 입력합니다.") . ### URL 형식 기본 URL: /api/now/cmdb/csdm/app_service/{service_sys_id}/populate_service ### 지원되는 요청 매개변수 {#appservice-PUT-populate_service__entry__2} | 이름 | 설명 | |-|-| | service_sys_id | 지정된 CI로 채울 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 테이블: 서비스 인스턴스 \[cmdb_ci_service_auto\] | [표 25. 경로 매개변수] {#appservice-PUT-populate_service__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 26. 쿼리 매개변수] {#appservice-PUT-populate_service__entry__10} | 이름 | 설명 | |-|-| | population_method | 지정된 애플리케이션 서비스와 연결할 CI입니다. 객체의 요소 population_method 는 매개변수로 type 정의되는 채워지는 정보의 유형에 따라 달라집니다. 데이터 유형: 객체 = type cmdb_group_based "population_method": { "group_id": "String", "type": "String" } For type = 디스커버리 주: 이 유형을 사용하려면 서비스 매핑(com.snc.service-mapping) 플러그인을 활성화해야 합니다. "population_method": { "attributes": [Array], "entry_point_id": "String", "type": "String" } = type tag_list 주: 이 유형을 사용하려면 서비스 매핑(com.snc.service-mapping) 플러그인을 활성화해야 합니다. "population_method": { "tags": [Array], "type": "String" } | | population_method.attributes | 호스트, 포트, 이름 및 URL과 같이 CI와 연결할 속성 목록입니다. 주: 필요한 모든 속성을 전달해야 합니다. 데이터 유형: 배열 "attributes": { "name":"String", "value":"String" } | | population_method.attributes.name | 호스트, 포트, 이름 및 URL과 같은 속성의 이름입니다. 데이터 유형: 문자열 | | population_method.attributes.value | 속성 값입니다. 데이터 유형: 문자열 | | population_method.entry_point | = discovery이면 population_method.type 필요합니다. 애플리케이션 서비스의 엔트리포인트입니다. 엔트리포인트에 대한 자세한 내용은 [엔트리포인트 속성](https://www.servicenow.com/docs/access?context=r_EntryPointsforBizSvcDef&version=australia&pubname=australia-it-operations-management&ft:locale=en-US) 및 [서비스 매핑에 대한 엔트리포인트 유형 생성](https://www.servicenow.com/docs/access?context=t_CreateEntryPoint&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)을 참조하십시오. 데이터 유형: 문자열 | | population_method.group_id | = cmdb_group_based이면 population_method.type 필수입니다. CI와 연결할 그룹의 Sys_id입니다. 데이터 유형: 문자열 제목: CMDB 그룹 \[cmdb_group\] | | population_method.tags | CI와 연결할 태그의 목록입니다. 데이터 유형: 객체 배열 [ "tags": { "tag": "String", "value": "String" } ] 제목: 키 값 \[cmdb_key_value\] | | population_method.tags.tag | 태그의 이름입니다. 데이터 유형: 문자열 | | population_method.tags.value | 태그 값입니다. 데이터 유형: 문자열 | | population_method.type | 필수 채울 CI의 유형입니다. 유효한 값은 다음과 같습니다. * cmdb_group_based * 디스커버리 * tag_list {#appservice-PUT-populate_service__ul_j42_5jm_tlb} 데이터 유형: 문자열 | [표 27. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-PUT-populate_service__table_h3m_gh2_mlb__entry__2}{#appservice-PUT-populate_service__accept-JSON-only-entry-RESTAPI}{#appservice-PUT-populate_service__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 28. 요청 헤더] {#appservice-PUT-populate_service__table_h3m_gh2_mlb} {#appservice-PUT-populate_service__entry__38} | 머리글 | 설명 | |-|-| | 안 함 | | [표 29. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-PUT-populate_service__entry__42}{#appservice-PUT-populate_service__entry-200-status-code}{#appservice-PUT-populate_service__entry-401-appservice}{#appservice-PUT-populate_service__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 app_service_admin 역할이 없습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. | [표 30. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#appservice-PUT-populate_service__entry__50}{#appservice-PUT-populate_service__entry-error-appservice}{#appservice-PUT-populate_service__entry-error-details-appservice}{#appservice-PUT-populate_service__entry-error-message-appservice} | 이름 | 설명 | |-|-| | 오류 | 발생한 오류에 대해 설명합니다. 데이터 유형: 객체 "error": { "details": "String", "message": "String" } | | 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 | | 오류.메시지 | 오류를 설명하는 메시지입니다. 데이터 유형: 문자열 | [ ] ### 샘플 cURL 요청 다음 코드 예제에서는 CI 유형이 cmdb_group_based일 때 애플리케이션 서비스를 채우는 방법을 보여줍니다. curl -X PUT \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/f809cb60db94101037740f95ca96190f/populate_service \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "population_method": { "type":"cmdb_group_based", "group_id": "e809cf60db94101037640f95ca961932" } }' { "result": {} } 다음 코드 예제에서는 검색 애플리케이션 서비스를 채우는 방법을 보여줍니다. curl -X PUT \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/f809cb60db94101037740f95ca96190f/populate_service \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "population_method": { "type":"discovery", "entry_point_id":"cmdb_ci_endpoint_ad_forest", "attributes": [ { "name":"host", "value":"test1.com" }, { "name":"port", "value":"500" }, { "name":"protocol", "value":"ssh" } ] } }' { "result": {} } ## 애플리케이션 서비스 - PUT /now/cmdb/csdm/app_service/{service_sys_id}/service_details {#ariaid-title7} 전달된 기본 정보로 지정된 애플리케이션 서비스를 업데이트합니다. 또한 전달된 정보를 애플리케이션 서비스 클래스에 정의된 IRE(식별 및 조정 엔진) 규칙과 비교하여 검사하여 애플리케이션 서비스의 고유성을 검증합니다. 주: 이 엔드포인트는 더 이상 사용되지 않으므로 대신 사용하십시오 [SG 서비스 -- POST /sg_services/app_service/update](https://servicenow-prod.fluidtopics.net/wNuvdgu2cbIL7~RIXXMeoQ#sg_svcs-POST-update "제공된 기존 애플리케이션 서비스를 업데이트하고 지정된 애플리케이션 서비스에 대한 태그를 생성합니다.") . ### URL 형식 기본 URL: /api/now/cmdb/csdm/app_service/{service_sys_id}/service_details ### 지원되는 요청 매개변수 {#appservice-PUT-service_details__entry__2} | 이름 | 설명 | |-|-| | service_sys_id | 업데이트할 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 테이블: 서비스 인스턴스 \[cmdb_ci_service_auto\] | [표 31. 경로 매개변수] {#appservice-PUT-service_details__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 32. 쿼리 매개변수] {#appservice-PUT-service_details__entry__10}{#appservice-PUT-service_details__entry-basic_details-appservice}{#appservice-PUT-service_details__entry-basic_details-environment-appservice}{#appservice-PUT-service_details__entry-basic_details-name-appservice}{#appservice-PUT-service_details__entry-relationships-appservice}{#appservice-PUT-service_details__entry-relationships-bus_app-appservice}{#appservice-PUT-service_details__entry-relationships-bus_srv_off-appservice}{#appservice-PUT-service_details__entry-relationships-tech_srv_off-appservice} | 이름 | 설명 | |-|-| | basic_details | 지정된 애플리케이션 서비스와 연결된 서비스의 상세 정보입니다. 데이터 유형: 객체 "basic_details": { "environment": "String", "name": "String" } | | basic_details.environment | 애플리케이션 서비스가 배포되는 환경(예: "프로덕션" 또는 "테스트 랩 2") 이 값은 구현자에게 의미가 있는 모든 값이 될 수 있습니다. 데이터 유형: 문자열 최대 길이: 40 기본값: null | | basic_details.name | 필수 애플리케이션 서비스의 이름입니다. 다른 모든 애플리케이션 서비스의 고유한 이름이어야 합니다. 데이터 유형: 문자열 최대 길이: 255 | | 관계 | 애플리케이션 서비스와 연결할 서비스 유형입니다. CI 관계 \[cmdb_rel_ci\] 테이블에 있습니다. 데이터 유형: 객체 "relationships": { "business_app": [Array], "business_service_offering": [Array], "technical_service_offering": [Array] } | | relationships.business_app | 애플리케이션 서비스와 관련된 비즈니스 애플리케이션 sys_ids 목록입니다. 데이터 유형: 배열 | | relationships.business_service_offering | 애플리케이션 서비스와 관련된 비즈니스 서비스 오퍼링 sys_ids의 목록입니다. 데이터 유형: 배열 | | relationships.technical_service_offering | 애플리케이션 서비스와 관련된 기술 서비스 오퍼링 sys_ids의 목록입니다. 데이터 유형: 배열 | [표 33. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-PUT-service_details__entry__26}{#appservice-PUT-service_details__accept-JSON-only-entry-RESTAPI}{#appservice-PUT-service_details__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 34. 요청 헤더] {#appservice-PUT-service_details__entry__32} | 머리글 | 설명 | |-|-| | 안 함 | | [표 35. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#appservice-PUT-service_details__entry__36}{#appservice-PUT-service_details__entry-200-status-code}{#appservice-PUT-service_details__entry-401-appservice} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 app_service_admin 역할이 없습니다. | [표 36. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#appservice-PUT-service_details__entry__42}{#appservice-PUT-service_details__entry-error-appservice}{#appservice-PUT-service_details__entry-error-details-appservice}{#appservice-PUT-service_details__entry-error-message-appservice} | 이름 | 설명 | |-|-| | 오류 | 발생한 오류에 대해 설명합니다. 데이터 유형: 객체 "error": { "details": "String", "message": "String" } | | 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 | | 오류.메시지 | 오류를 설명하는 메시지입니다. 데이터 유형: 문자열 | [ ] ### 샘플 cURL 요청 curl -X PUT \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/f809cb60db94101037740f95ca96190f/service_details \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "basic_details": { "environment": "Test Lab 2" }, "relationships": { "business_app" :["f07c7620db54101037740f95ca96199a"] } }' { "result": {} }