--- 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 --- # 자원 인벤토리 Open API # 자원 인벤토리 Open API {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 92분 자원 인벤토리 Open API는 자원을 생성, 검색 및 삭제할 수 있는 엔드포인트를 제공합니다. 이 API를 사용하여 다음 테이블의 자원을 관리합니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inventory-api__ul_umw_gvn_bcc} {#resource-inventory-api__ul_utd_jmd_wxb} 이 API는 에서 사용할 수 ServiceNow Store있는 네트워크 인벤토리 코어 애플리케이션에 포함되어 있습니다. 이 API는 `sn_ni_core` 네임스페이스 내에서 제공됩니다. 호출 사용자에게 sn_ni_core.inventory_integrator 역할이 있어야 합니다. 이 API는 필수 매개변수, 요청 본문 확인 및 필드 매핑을 중심으로 사용자 지정되도록 확장할 수 있습니다. 자세한 내용은 [자원 인벤토리 Open API 개발자 가이드](https://servicenow-prod.fluidtopics.net/cG6TJcpa9GToJWQjJNewzg#resource-inventory-dev-guide "Resource Inventory Open API를 사용하여 인터페이스 카드, 논리적 및 물리적 연결, 네트워크 사이트 등과 같은 자원을 생성, 검색, 업데이트 및 삭제합니다.") 문서를 참조하십시오. 자원 인벤토리 오픈 API는 TM Forum 자원 인벤토리 API REST 사양의 구현입니다ServiceNow®. 이 구현은 [TMF639 Resource Inventory API 사용자 가이드 v4.0.1](https://www.tmforum.org/resources/standard/tmf639-resource-inventory-api-user-guide-v4-0/), 2020년 7월을 기반으로 합니다. ## 자원 인벤토리 Open API - DELETE /sn_ni_core/resource/{id} {#ariaid-title2} 지정된 자원 기록을 삭제합니다. ### URL 형식 기본 URL: /api/sn_ni_core/resource/{id} ### 지원되는 요청 매개변수 {#resource-inv-DELETE__table_tjw_q3s_g5b__entry__2} | 이름 | 설명 | |-|-| | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. {#resource-inv-DELETE__res-inv-tables} 주: IP 주소 \[cmdb_ci_ip_address\] 테이블의 자원은 이 API를 사용하여 삭제할 수 없습니다. 데이터 유형: 문자열 | [표 1. 경로 매개변수] {#resource-inv-DELETE__table_tjw_q3s_g5b} {#resource-inv-DELETE__table_cnn_cht_g5b__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 2. 쿼리 매개변수] {#resource-inv-DELETE__table_cnn_cht_g5b} {#resource-inv-DELETE__table_fdn_t3t_g5b__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 3. 요청 본문 매개변수(JSON)] {#resource-inv-DELETE__table_fdn_t3t_g5b} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-DELETE__table_e4k_vhs_g5b__entry__2}{#resource-inv-DELETE__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 4. 요청 헤더] {#resource-inv-DELETE__table_e4k_vhs_g5b} {#resource-inv-DELETE__table_gfy_npw_f5b__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | [표 5. 응답 헤더] {#resource-inv-DELETE__table_gfy_npw_f5b} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-DELETE__table_b4x_lrs_g5b__entry__2}{#resource-inv-DELETE__entry-400-status-code}{#resource-inv-DELETE__entry-401-status-code}{#resource-inv-DELETE__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 215 | 처리를 위한 요청이 성공적으로 수신되었습니다. 요청은 비동기식으로 완료됩니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 403 | 금지되었습니다. 자원을 삭제하지 못했습니다. 관련 자원에 자원이 필요할 수 있습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 6. 상태 코드] {#resource-inv-DELETE__table_b4x_lrs_g5b} ### 응답 본문 매개변수(JSON) {#resource-inv-DELETE__entry__34} | 이름 | 설명 | |-|-| | 없음 | | [ ] ### cURL 요청 이 예에서는 자원을 삭제합니다. curl "https://instance.service-now.com/api/sn_ni_core/resource/54ada05e875c15109a9c0f65dabb3586" \ --request DELETE \ --header "Accept:application/json" \ --user 'username':'password' 응답 본문. "" ## 자원 인벤토리 Open API - GET /sn_ni_core/resource {#ariaid-title3} 모든 자원 기록의 목록을 조회합니다. ### URL 형식 기본 URL: /api/sn_ni_core/resource ### 지원되는 요청 매개변수 {#resource-inv-GET-resource__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 7. 경로 매개변수] {#resource-inv-GET-resource__entry__6}{#resource-inv-GET-resource__tmf-offset} | 이름 | 설명 | |-|-| | @type | 필수 검색할 자원 유형의 테이블 이름입니다. API 호출당 한 가지 유형의 자원만 검색할 수 있습니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-GET-resource__ul_wmt_vfz_d5b} 데이터 유형: 문자열 | | 설명 | 자원을 필터링하는 데 사용할 설명입니다. 지정된 설명이 있는 자원만 응답에 반환됩니다. 데이터 유형: 문자열 | | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 값은 다음과 같습니다. * 설명 * href * ID * 이름 * 참고 * 장소 * 관련당사자 * 자원특성 * 자원 관계 * 자원 사양 * startOperatingDate {#resource-inv-GET-resource__ul_pzn_4gz_d5b} 데이터 유형: 문자열 기본값: 모든 필드를 반환합니다. | | 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 기본값: 20 데이터 유형: 숫자 | | 이름 | 자원을 필터링하는 데 사용할 이름입니다. 지정된 이름을 가진 자원만 응답에 반환됩니다. 데이터 유형: 문자열 | | 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 기본값: 0 데이터 유형: 숫자 | | resourceSpecification.id | 자원을 필터링하는 데 사용할 자원 사양 sys_id입니다. sys_id은 다음 테이블 중 하나의 모델에서 가져온 것이어야 합니다. * 장비 홀더 모델 \[sn_ni_core_equipment_holder_product_model\] * 장비 모델 \[sn_ni_core_equipment_product_model\] * 인터페이스 카드 모델 \[sn_ni_core_interface_card_product_model\] * 논리적 연결 모델 \[sn_ni_core_logical_connection_product_model\] * 네트워크 인터페이스 모델 \[sn_ni_core_network_interface_product_model\] * 물리적 연결 모델 \[sn_ni_core_physical_connection_product_model\] {#resource-inv-GET-resource__ul_a3t_1lz_d5b}지정된 sys_id과 일치하는 모델이 있는 자원만 응답에 반환됩니다. 데이터 유형: 문자열 | [표 8. 쿼리 매개변수] {#resource-inv-GET-resource__entry__22} | 이름 | 설명 | |-|-| | 안 함 | | [표 9. 요청 본문 매개변수(JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-GET-resource__entry__26}{#resource-inv-GET-resource__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 10. 요청 헤더] {#resource-inv-GET-resource__table_lpj_dh1_vxb__entry__2} | 머리글 | 설명 | |-|-| | 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠의 범위입니다. 예를 들어, `offset=2` 및 `limit=3`인 경우 헤더의 Content-Range 값은 `항목 3-5`입니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | | 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#resource-inv-GET-resource__ul_zzk_sdm_lsb} | | X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. 주: 총 기록 수가 100,000개를 초과하면 이 헤더는 항상 100,000개를 반환합니다. | [표 11. 응답 헤더] {#resource-inv-GET-resource__table_lpj_dh1_vxb} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-GET-resource__entry__40}{#resource-inv-GET-resource__entry-200-status-code}{#resource-inv-GET-resource__entry-400-status-code}{#resource-inv-GET-resource__entry-401-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 206 | 부분 컨텐츠입니다. 요청이 성공적으로 처리되어 페이지 매김된 호출에 의해 지정된 컨텐츠의 일부 범위가 반환되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | [표 12. 상태 코드] ### 응답 본문 매개변수(JSON) {#resource-inv-GET-resource__section_nkb_1rw_f5b} {#resource-inv-GET-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-GET-resource__type-descr-entry}{#resource-inv-GET-resource__related-party-parm} | 이름 | 설명 | |-|-| | @type | 자원의 유형입니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-GET-resource__d3457e145} 데이터 유형: 문자열 | | 설명 | 자원에 대한 설명입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-GET-resource__ul_umw_gvn_bcc} {#resource-inv-GET-resource__res-inv-tables} 데이터 유형: 문자열 | | 이름 | 자원의 이름입니다. 데이터 유형: 문자열 | | 참고 | 자원에 대한 메모 목록입니다. 데이터 유형: 객체 배열 "note": [ { "text": "String" } ] | | 메모.텍스트 | 메모 텍스트입니다. 데이터 유형: 문자열 | | 장소 | 자원의 네트워크 사이트입니다. 이 매개변수는 네트워크 사이트, 물리적 연결 또는 논리적 연결 자원에 대해 지원되지 않습니다. 데이터 유형: 객체 "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 장소 유형입니다. 이 값은 항상 `GeographicAddress`입니다. 데이터 유형: 문자열 | | 장소.href | 장소 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | place.id | 장소 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 네트워크 사이트 \[cmdb_ci_ni_site\] | | 관련당사자 | 자원의 접촉 창구에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 관련 당사자의 유형입니다. 유형 필드에 있습니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] 테이블의 유형 필드에 있습니다. | | relatedParty.href | 관련 당사자 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | relatedParty.id | 관련 당사자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] | | relatedParty.role | 관련 당사자의 역할입니다. 데이터 유형: 문자열 테이블: 팀 \[cmdb_rel_team\] 테이블의 그룹 유형 필드입니다. | | 자원특성 | 자원의 특성 목록입니다. 다음 자원 유형에는 특정 자원 특성이 필요합니다. * 물리적 연결 및 논리적 연결 자원의 경우 `포트 A` 또는 `포트 Z` 특성이 필요합니다. 자원의 수명주기 스테이지 상태가 사용 중이면 `포트 A` 와 `포트 Z` 가 모두 필요합니다. * 장비 홀더 자원의 경우 `컨테이너 유형` 특성이 필요합니다. {#resource-inv-GET-resource__ul_wsv_p2m_g5b} 데이터 유형: 객체 배열 "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | 매개변수로 지정된 자원 테이블의 필드 이름입니다 @type . 필드 model_id, 이름, network_site, operation_notes, operational_status, short_description, start_date 또는 sys_id와 같이 접두사가 붙은 sys_ 필드는 사용할 수 없습니다. 데이터 유형: 문자열 | | resourceCharacteristic.value | 특성의 값입니다. 데이터 유형: 문자열 | | resourceCharacteristic.valueType | 값의 유형입니다. 유효한 값은 다음과 같습니다. * 부울 * 날짜 시간 * 부동 * 정수 * ph_number * 참조 * 문자열 {#resource-inv-GET-resource__ul_bk1_rw2_g5b} 데이터 유형: 문자열 | | 자원 관계 | 관련 자원 목록입니다. 다음 자원 유형에는 특정 관련 자원이 필요합니다. * 인터페이스 카드 자원의 경우 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원에 대한 관계가 필요합니다. * 네트워크 인터페이스 자원의 경우 장비 또는 인터페이스 카드 자원에 대한 관계가 필요합니다. * 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원의 경우 장비 또는 인터페이스 카드 자원과의 관계가 필요합니다. {#resource-inv-GET-resource__ul_rlv_3dm_g5b} 데이터 유형: 배열 "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.RelationshipType | `[이 자원 설명자]::[관련 자원 설명자]` 형식의 두 자원 간의 관계 유형입니다. 예를 들어 `Contains::Contained by는` 관련 자원이 이 자원의 하위 자원임을 나타냅니다. 설명자에 유효한 값은 CI 관계 유형 \[cmdb_rel_type\] 테이블의 상위 설명자 및 하위 설명자 열에 있습니다. 데이터 유형: 문자열 | | resourceRelationship.resource | 관련 자원에 대한 상세 정보입니다. 관련 자원은 다음 자원 유형 중 하나여야 합니다. * 케이블 * 장비 * 장비 홀더 * 인터페이스 카드 * 논리적 연결 * 네트워크 인터페이스 * 네트워크 사이트 * 물리적 연결 * 스트랜드 * 토폴로지 {#resource-inv-GET-resource__ul_wmt_vtx_d5y} 데이터 유형: 객체 "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 관련 자원의 Sys_id입니다. 관련 자원의 유형에 따라 다음 테이블 중 하나에 위치합니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더를 확장하는 테이블 \[cmdb_ci_equipment_holder\] {#resource-inv-GET-resource__ul_vr1_4gf_g5b} 데이터 유형: 문자열 | | resourceRelationship.resource.href | 관련 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 자원 사양 | 자원 사양입니다. 데이터 유형: 객체 "resourceSpecification": { "id": "String" } | | resourceSpecification.id | 자원에 대한 연결된 모델의 Sys_id입니다. 모델 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 모델 \[sn_ent_cable_model\] * 장비 홀더 모델 \[sn_ent_nw_holder_model\] * 장비 모델 \[sn_ent_nw_equipment_model\] * 인터페이스 카드 모델 \[sn_ent_nw_interface_model\] * 논리적 연결 모델 \[sn_ent_logical_nw_connection_model\] * 네트워크 인터페이스 모델 \[sn_ent_nw_interface_model\] * 물리적 연결 모델 \[sn_ent_physical_nw_connection_model\] * 스트랜드 모델 \[sn_ent_strand_model\] * 토폴로지 모델 \[sn_ent_network_topology_model\] {#resource-inv-GET-resource__d3457e769} 데이터 유형: 문자열 | | startOperatingDate | 자원이 처음 운영을 시작한 날짜 및 시간입니다. 데이터 유형: 문자열 | [ ] {#resource-inv-GET-resource__table_okb_1rw_f5b} ### cURL 요청 이 예에서는 처음 5개의 네트워크 사이트 자원 기록에 대한 , id및 href 필드를 검색합니다name. curl "https://instance.service-now.com/api/sn_ni_core/resource?@type=cmdb_ci_ni_site&fields=name%2Cid%2Chref&limit=5" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 응답 본문. [ { "name": "DALLAS TX CO/HUB", "id": "c23683c54051c910f8772175cacd725c", "href": "/api/sn_ni_core/resource/c23683c54051c910f8772175cacd725c" }, { "name": "PFP LOC F-800", "id": "0ac19bc54051c910f8772175cacd724b", "href": "/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b" }, { "name": "FIBER SERVICE TERMINAL 003", "id": "d0541fcd4051c910f8772175cacd72c8", "href": "/api/sn_ni_core/resource/d0541fcd4051c910f8772175cacd72c8" }, { "name": "270 RUMWOOD MAIN", "id": "e6f6df8d4051c910f8772175cacd72b2", "href": "/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2" }, { "name": "3620 CHESTER ROMI48073", "id": "917dd8f6870e851079c40f2d0ebb353d", "href": "/api/sn_ni_core/resource/917dd8f6870e851079c40f2d0ebb353d" } ] ## 자원 인벤토리 Open API - GET /sn_ni_core/resource/{id} {#ariaid-title4} 지정된 자원 기록을 조회합니다. ### URL 형식 기본 URL: /api/sn_ni_core/resource/{id} ### 지원되는 요청 매개변수 {#resource-inv-GET-resource-id__table_tjw_q3s_g5b__entry__2} | 이름 | 설명 | |-|-| | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-GET-resource-id__ul_umw_gvn_bcc} {#resource-inv-GET-resource-id__res-inv-tables} 데이터 유형: 문자열 | [표 13. 경로 매개변수] {#resource-inv-GET-resource-id__table_tjw_q3s_g5b} {#resource-inv-GET-resource-id__entry__6} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 유효한 값은 다음과 같습니다. * 설명 * href * ID * 이름 * 참고 * 장소 * 관련당사자 * 자원특성 * 자원 관계 * 자원 사양 * startOperatingDate {#resource-inv-GET-resource-id__ul_pzn_4gz_d5b} 데이터 유형: 문자열 기본값: 모든 필드를 반환합니다. | [표 14. 쿼리 매개변수] {#resource-inv-GET-resource-id__table_yh2_zhs_g5b__entry__2} | 이름 | 설명 | |-|-| | 안 함 | | [표 15. 요청 본문 매개변수(JSON)] {#resource-inv-GET-resource-id__table_yh2_zhs_g5b} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-GET-resource-id__table_e4k_vhs_g5b__entry__2}{#resource-inv-GET-resource-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 16. 요청 헤더] {#resource-inv-GET-resource-id__table_e4k_vhs_g5b} {#resource-inv-GET-resource-id__table_gfy_npw_f5b__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | [표 17. 응답 헤더] {#resource-inv-GET-resource-id__table_gfy_npw_f5b} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-GET-resource-id__table_yn5_ths_g5b__entry__2}{#resource-inv-GET-resource-id__entry-200-status-code}{#resource-inv-GET-resource-id__entry-400-status-code}{#resource-inv-GET-resource-id__entry-401-status-code}{#resource-inv-GET-resource-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 18. 상태 코드] {#resource-inv-GET-resource-id__table_yn5_ths_g5b} ### 응답 본문 매개변수(JSON) {#resource-inv-GET-resource-id__section_nkb_1rw_f5b} {#resource-inv-GET-resource-id__table_okb_1rw_f5b__entry__2}{#resource-inv-GET-resource-id__type-descr-entry}{#resource-inv-GET-resource-id__related-party-parm} | 이름 | 설명 | |-|-| | @type | 자원의 유형입니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-GET-resource-id__ul_wmt_vfz_d5b} 데이터 유형: 문자열 | | 설명 | 자원에 대한 설명입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-GET-resource-id__d3457e280} {#resource-inv-GET-resource-id__d3457e235} 데이터 유형: 문자열 | | 이름 | 자원의 이름입니다. 데이터 유형: 문자열 | | 참고 | 자원에 대한 메모 목록입니다. 데이터 유형: 객체 배열 "note": [ { "text": "String" } ] | | 메모.텍스트 | 메모 텍스트입니다. 데이터 유형: 문자열 | | 장소 | 자원의 네트워크 사이트입니다. 이 매개변수는 네트워크 사이트, 물리적 연결 또는 논리적 연결 자원에 대해 지원되지 않습니다. 데이터 유형: 객체 "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 장소 유형입니다. 이 값은 항상 `GeographicAddress`입니다. 데이터 유형: 문자열 | | 장소.href | 장소 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | place.id | 장소 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 네트워크 사이트 \[cmdb_ci_ni_site\] | | 관련당사자 | 자원의 접촉 창구에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 관련 당사자의 유형입니다. 유형 필드에 있습니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] 테이블의 유형 필드에 있습니다. | | relatedParty.href | 관련 당사자 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | relatedParty.id | 관련 당사자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] | | 자원특성 | 자원의 특성 목록입니다. 다음 자원 유형에는 특정 자원 특성이 필요합니다. * 물리적 연결 및 논리적 연결 자원의 경우 `포트 A` 또는 `포트 Z` 특성이 필요합니다. 자원의 수명주기 스테이지 상태가 사용 중이면 `포트 A` 와 `포트 Z` 가 모두 필요합니다. * 장비 홀더 자원의 경우 `컨테이너 유형` 특성이 필요합니다. {#resource-inv-GET-resource-id__ul_wsv_p2m_g5b} 데이터 유형: 객체 배열 "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | 매개변수로 지정된 자원 테이블의 필드 이름입니다 @type . 필드 model_id, 이름, network_site, operation_notes, operational_status, short_description, start_date 또는 sys_id와 같이 접두사가 붙은 sys_ 필드는 사용할 수 없습니다. 데이터 유형: 문자열 | | resourceCharacteristic.value | 특성의 값입니다. 데이터 유형: 문자열 | | resourceCharacteristic.valueType | 값의 유형입니다. 유효한 값은 다음과 같습니다. * 부울 * 날짜 시간 * 부동 * 정수 * ph_number * 참조 * 문자열 {#resource-inv-GET-resource-id__ul_bk1_rw2_g5b} 데이터 유형: 문자열 | | 자원 관계 | 관련 자원 목록입니다. 다음 자원 유형에는 특정 관련 자원이 필요합니다. * 인터페이스 카드 자원의 경우 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원에 대한 관계가 필요합니다. * 네트워크 인터페이스 자원의 경우 장비 또는 인터페이스 카드 자원에 대한 관계가 필요합니다. * 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원의 경우 장비 또는 인터페이스 카드 자원과의 관계가 필요합니다. {#resource-inv-GET-resource-id__ul_rlv_3dm_g5b} 데이터 유형: 배열 "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.RelationshipType | `[이 자원 설명자]::[관련 자원 설명자]` 형식의 두 자원 간의 관계 유형입니다. 예를 들어 `Contains::Contained by는` 관련 자원이 이 자원의 하위 자원임을 나타냅니다. 설명자에 유효한 값은 CI 관계 유형 \[cmdb_rel_type\] 테이블의 상위 설명자 및 하위 설명자 열에 있습니다. 데이터 유형: 문자열 | | resourceRelationship.resource | 관련 자원에 대한 상세 정보입니다. 관련 자원은 다음 자원 유형 중 하나여야 합니다. * 케이블 * 장비 * 장비 홀더 * 인터페이스 카드 * 논리적 연결 * 네트워크 인터페이스 * 네트워크 사이트 * 물리적 연결 * 스트랜드 * 토폴로지 {#resource-inv-GET-resource-id__ul_wmt_vtx_d5y} 데이터 유형: 객체 "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 관련 자원의 Sys_id입니다. 관련 자원의 유형에 따라 다음 테이블 중 하나에 위치합니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더를 확장하는 테이블 \[cmdb_ci_equipment_holder\] {#resource-inv-GET-resource-id__ul_vr1_4gf_g5b} 데이터 유형: 문자열 | | resourceRelationship.resource.href | 관련 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 자원 사양 | 자원 사양입니다. 데이터 유형: 객체 "resourceSpecification": { "id": "String" } | | resourceSpecification.id | 자원에 대한 연결된 모델의 Sys_id입니다. 모델 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 모델 \[sn_ent_cable_model\] * 장비 홀더 모델 \[sn_ent_nw_holder_model\] * 장비 모델 \[sn_ent_nw_equipment_model\] * 인터페이스 카드 모델 \[sn_ent_nw_interface_model\] * 논리적 연결 모델 \[sn_ent_logical_nw_connection_model\] * 네트워크 인터페이스 모델 \[sn_ent_nw_interface_model\] * 물리적 연결 모델 \[sn_ent_physical_nw_connection_model\] * 스트랜드 모델 \[sn_ent_strand_model\] * 토폴로지 모델 \[sn_ent_network_topology_model\] {#resource-inv-GET-resource-id__ul_a3t_1lz_d5b} 데이터 유형: 문자열 | | startOperatingDate | 자원이 처음 운영을 시작한 날짜 및 시간입니다. 데이터 유형: 문자열 | [ ] {#resource-inv-GET-resource-id__table_okb_1rw_f5b} ### cURL 요청 이 예에서는 지정된 자원 기록을 조회합니다. curl "https://instance.service-now.com/api/sn_ni_core/resource/915da8e140ddc910f8772175cacd72de" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 응답 본문. { "href": "/api/sn_ni_core/resource/915da8e140ddc910f8772175cacd72de", "id": "915da8e140ddc910f8772175cacd72de", "name": "DLLSTXMR/ESS7450/IOM-01/MDA-01/NI-01", "place": { "id": "c23683c54051c910f8772175cacd725c", "href": "/api/now/table/cmdb_ci_ni_site/c23683c54051c910f8772175cacd725c", "@referredType": "GeographicAddress" }, "resourceCharacteristic": [ { "name": "attested", "valueType": "boolean", "value": "false" }, { "name": "availability", "valueType": "string", "value": "used" }, { "name": "cabled", "valueType": "boolean", "value": "false" }, { "name": "can_print", "valueType": "boolean", "value": "false" }, { "name": "connector_type", "valueType": "string", "value": "sc" }, { "name": "cost_cc", "valueType": "string", "value": "USD" }, { "name": "equipment_clli", "valueType": "string", "value": "DLLSTXESS01" }, { "name": "fault_count", "valueType": "integer", "value": "0" }, { "name": "install_status", "valueType": "integer", "value": "1" }, { "name": "life_cycle_stage", "valueType": "reference", "value": "Operational" }, { "name": "life_cycle_stage_status", "valueType": "reference", "value": "In Use" }, { "name": "manufacturer", "valueType": "reference", "value": "a2f6a4914055c910f8772175cacd723a" }, { "name": "monitor", "valueType": "boolean", "value": "false" }, { "name": "network_domain", "valueType": "string", "value": "core" }, { "name": "ni_type", "valueType": "reference", "value": "646cf25fe42e0510f877e70ec9bcaca8" }, { "name": "port_bandwidth", "valueType": "reference", "value": "ff39ae92eb900110700ca73bc152286d" }, { "name": "replaceable", "valueType": "boolean", "value": "false" }, { "name": "skip_sync", "valueType": "boolean", "value": "false" }, { "name": "telco_equipment", "valueType": "reference", "value": "583e7b95405dc910f8772175cacd7292" }, { "name": "unverified", "valueType": "boolean", "value": "false" }, { "name": "virtual", "valueType": "boolean", "value": "false" } ], "resourceRelationship": [ { "relationshipType": "Contained by::Contains", "resource": { "id": "81baac6140ddc910f8772175cacd728e", "href": "/api/sn_ni_core/resource/81baac6140ddc910f8772175cacd728e" } }, { "relationshipType": "Contained by::Contains", "resource": { "id": "bf624bc640194d10f8772175cacd7225", "href": "/api/sn_ni_core/resource/bf624bc640194d10f8772175cacd7225" } } ], "resourceSpecification": { "id": "980416b0874e8110d28eb259dabb356b", "href": "/api/now/table/sn_ni_core_network_inventory_product_model/980416b0874e8110d28eb259dabb356b", "@referredType": "NetworkInterfaceModel" }, "@type": "cmdb_ci_ni_interface" } ## 자원 인벤토리 Open API - PATCH /sn_ni_core/resource/{id} {#ariaid-title5} 지정된 자원 기록을 업데이트합니다. ### URL 형식 기본 URL: /api/sn_ni_core/resource/{id} ### 지원되는 요청 매개변수 {#resource-inv-PATCH-resource-id__entry__2} | 이름 | 설명 | |-|-| | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-PATCH-resource-id__ul_umw_gvn_bcc} {#resource-inv-PATCH-resource-id__res-inv-tables} 데이터 유형: 문자열 | [표 19. 경로 매개변수] {#resource-inv-PATCH-resource-id__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 20. 쿼리 매개변수] {#resource-inv-PATCH-resource-id__entry__10}{#resource-inv-PATCH-resource-id__type-descr-entry}{#resource-inv-PATCH-resource-id__note-text-entry}{#resource-inv-PATCH-resource-id__place-id-entry}{#resource-inv-PATCH-resource-id__rel-party-id-parm}{#resource-inv-PATCH-resource-id__res-char-name-parm}{#resource-inv-PATCH-resource-id__res-char-value-parm}{#resource-inv-PATCH-resource-id__rel-type-parm}{#resource-inv-PATCH-resource-id__rel-resource-parm}{#resource-inv-PATCH-resource-id__rel-resource-id-parm}{#resource-inv-PATCH-resource-id__res-spec-id-parm} | 이름 | 설명 | |-|-| | @type | 자원의 유형입니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-PATCH-resource-id__ul_wmt_vfz_d5b} 데이터 유형: 문자열 | | 설명 | 자원에 대한 설명입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 이름 | 자원의 이름입니다. 데이터 유형: 문자열 | | 참고 | 자원에 대한 메모 목록입니다. 데이터 유형: 객체 배열 "note": [ { "text": "String" } ] | | 메모.텍스트 | 매개변수가 note 사용되는 경우 필수입니다. 메모 텍스트입니다. 데이터 유형: 문자열 | | 장소 | 자원의 네트워크 사이트입니다. 이 매개변수는 네트워크 사이트, 물리적 연결 또는 논리적 연결 자원에 대해 지원되지 않습니다. 데이터 유형: 객체 "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 장소 유형입니다. 이 값은 항상 `GeographicAddress`입니다. 데이터 유형: 문자열 | | 장소.href | 장소 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | place.id | 매개변수가 place 사용되는 경우 필수입니다. 장소 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 네트워크 사이트 \[cmdb_ci_ni_site\] | | 관련당사자 | 자원의 접촉 창구에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] 주: 이 엔드포인트에서는 자원에서 relatedParty 기록 제거를 지원하지 않습니다. Teams \[cmdb_rel_team\] 테이블에서 기록을 수동으로 삭제할 수 있습니다. | | relatedParty.@referredType | 관련 당사자의 유형입니다. 유형 필드에 있습니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] 테이블의 유형 필드에 있습니다. | | relatedParty.href | 관련 당사자 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | relatedParty.id | 매개변수가 relatedParty 사용되는 경우 필수입니다. 관련 당사자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] | | relatedParty.role | 관련 당사자의 역할입니다. 데이터 유형: 문자열 테이블: 팀 \[cmdb_rel_team\] 테이블의 그룹 유형 필드입니다. | | 자원특성 | 자원의 특성 목록입니다. 다음 자원 유형에는 특정 자원 특성이 필요합니다. * 물리적 연결 및 논리적 연결 자원의 경우 `포트 A` 또는 `포트 Z` 특성이 필요합니다. 자원의 수명주기 스테이지 상태가 사용 중이면 `포트 A` 와 `포트 Z` 가 모두 필요합니다. * 장비 홀더 자원의 경우 `컨테이너 유형` 특성이 필요합니다. {#resource-inv-PATCH-resource-id__ul_wsv_p2m_g5b} 데이터 유형: 객체 배열 "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | 매개변수가 resourceCharacteristic 사용되는 경우 필수입니다. 매개변수로 지정된 자원 테이블의 필드 이름입니다 @type . 필드 model_id, 이름, network_site, operation_notes, operational_status, short_description, start_date 또는 sys_id와 같이 접두사가 붙은 sys_ 필드는 사용할 수 없습니다. 데이터 유형: 문자열 | | resourceCharacteristic.value | 매개변수가 resourceCharacteristic 사용되는 경우 필수입니다. 특성의 값입니다. 데이터 유형: 문자열 | | resourceCharacteristic.valueType | 값의 유형입니다. 유효한 값은 다음과 같습니다. * 부울 * 날짜 시간 * 부동 * 정수 * ph_number * 참조 * 문자열 {#resource-inv-PATCH-resource-id__ul_bk1_rw2_g5b} 데이터 유형: 문자열 | | 자원 관계 | 관련 자원 목록입니다. 다음 자원 유형에는 특정 관련 자원이 필요합니다. * 인터페이스 카드 자원의 경우 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원에 대한 관계가 필요합니다. * 네트워크 인터페이스 자원의 경우 장비 또는 인터페이스 카드 자원에 대한 관계가 필요합니다. * 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원의 경우 장비 또는 인터페이스 카드 자원과의 관계가 필요합니다. {#resource-inv-PATCH-resource-id__ul_rlv_3dm_g5b} 데이터 유형: 배열 "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.RelationshipType | 매개변수가 resourceRelationship 사용되는 경우 필수입니다. `[이 자원 설명자]::[관련 자원 설명자]` 형식의 두 자원 간의 관계 유형입니다. 예를 들어 `Contains::Contained by는` 관련 자원이 이 자원의 하위 자원임을 나타냅니다. 설명자에 유효한 값은 CI 관계 유형 \[cmdb_rel_type\] 테이블의 상위 설명자 및 하위 설명자 열에 있습니다. 데이터 유형: 문자열 | | resourceRelationship.resource | 매개변수가 resourceRelationship 사용되는 경우 필수입니다. 관련 자원에 대한 상세 정보입니다. 관련 자원은 다음 자원 유형 중 하나여야 합니다. * 케이블 * 장비 * 장비 홀더 * 인터페이스 카드 * 논리적 연결 * 네트워크 인터페이스 * 네트워크 사이트 * 물리적 연결 * 스트랜드 * 토폴로지 {#resource-inv-PATCH-resource-id__ul_wmt_vtx_d5y} 데이터 유형: 객체 "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 매개변수가 resourceRelationship 사용되는 경우 필수입니다. 관련 자원의 Sys_id입니다. 관련 자원의 유형에 따라 다음 테이블 중 하나에 위치합니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더를 확장하는 테이블 \[cmdb_ci_equipment_holder\] {#resource-inv-PATCH-resource-id__ul_vr1_4gf_g5b} 데이터 유형: 문자열 | | resourceRelationship.resource.href | 관련 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 자원 사양 | 자원 사양입니다. 데이터 유형: 객체 "resourceSpecification": { "id": "String" } | | resourceSpecification.id | 매개변수가 resourceSpecification 사용되는 경우 필수입니다. 자원에 대한 연결된 모델의 Sys_id입니다. 모델 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 모델 \[sn_ent_cable_model\] * 장비 홀더 모델 \[sn_ent_nw_holder_model\] * 장비 모델 \[sn_ent_nw_equipment_model\] * 인터페이스 카드 모델 \[sn_ent_nw_interface_model\] * 논리적 연결 모델 \[sn_ent_logical_nw_connection_model\] * 네트워크 인터페이스 모델 \[sn_ent_nw_interface_model\] * 물리적 연결 모델 \[sn_ent_physical_nw_connection_model\] * 스트랜드 모델 \[sn_ent_strand_model\] * 토폴로지 모델 \[sn_ent_network_topology_model\] {#resource-inv-PATCH-resource-id__ul_a3t_1lz_d5b} 데이터 유형: 문자열 | | startOperatingDate | 자원이 처음 운영을 시작한 날짜 및 시간입니다. 데이터 유형: 문자열 | [표 21. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-PATCH-resource-id__entry__66}{#resource-inv-PATCH-resource-id__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. .만 지원합니다 application/merge-patch+json. | [표 22. 요청 헤더] {#resource-inv-PATCH-resource-id__entry__72} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | [표 23. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-PATCH-resource-id__entry__76}{#resource-inv-PATCH-resource-id__entry-200-status-code}{#resource-inv-PATCH-resource-id__entry-400-status-code}{#resource-inv-PATCH-resource-id__entry-401-status-code}{#resource-inv-PATCH-resource-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | | 415 | 요청 본문이 지원되지 않는 형식이거나 Content-Type 요청 헤더가 잘못 설정되었습니다. | [표 24. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#resource-inv-PATCH-resource-id__entry__88}{#resource-inv-PATCH-resource-id__d3457e141}{#resource-inv-PATCH-resource-id__related-party-parm} | 이름 | 설명 | |-|-| | @type | 자원의 유형입니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-PATCH-resource-id__d3457e145} 데이터 유형: 문자열 | | 설명 | 자원에 대한 설명입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-PATCH-resource-id__d3457e280} {#resource-inv-PATCH-resource-id__d3457e235} 데이터 유형: 문자열 | | 이름 | 자원의 이름입니다. 데이터 유형: 문자열 | | 참고 | 자원에 대한 메모 목록입니다. 데이터 유형: 객체 배열 "note": [ { "text": "String" } ] | | 메모.텍스트 | 메모 텍스트입니다. 데이터 유형: 문자열 | | 장소 | 자원의 네트워크 사이트입니다. 이 매개변수는 네트워크 사이트, 물리적 연결 또는 논리적 연결 자원에 대해 지원되지 않습니다. 데이터 유형: 객체 "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 장소 유형입니다. 이 값은 항상 `GeographicAddress`입니다. 데이터 유형: 문자열 | | 장소.href | 장소 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | place.id | 장소 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 네트워크 사이트 \[cmdb_ci_ni_site\] | | 관련당사자 | 자원의 접촉 창구에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 관련 당사자의 유형입니다. 유형 필드에 있습니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] 테이블의 유형 필드에 있습니다. | | relatedParty.href | 관련 당사자 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | relatedParty.id | 관련 당사자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] | | relatedParty.role | 관련 당사자의 역할입니다. 데이터 유형: 문자열 테이블: 팀 \[cmdb_rel_team\] 테이블의 그룹 유형 필드입니다. | | 자원특성 | 자원의 특성 목록입니다. 다음 자원 유형에는 특정 자원 특성이 필요합니다. * 물리적 연결 및 논리적 연결 자원의 경우 `포트 A` 또는 `포트 Z` 특성이 필요합니다. 자원의 수명주기 스테이지 상태가 사용 중이면 `포트 A` 와 `포트 Z` 가 모두 필요합니다. * 장비 홀더 자원의 경우 `컨테이너 유형` 특성이 필요합니다. {#resource-inv-PATCH-resource-id__d3457e482} 데이터 유형: 객체 배열 "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | 매개변수로 지정된 자원 테이블의 필드 이름입니다 @type . 필드 model_id, 이름, network_site, operation_notes, operational_status, short_description, start_date 또는 sys_id와 같이 접두사가 붙은 sys_ 필드는 사용할 수 없습니다. 데이터 유형: 문자열 | | resourceCharacteristic.value | 특성의 값입니다. 데이터 유형: 문자열 | | resourceCharacteristic.valueType | 값의 유형입니다. 유효한 값은 다음과 같습니다. * 부울 * 날짜 시간 * 부동 * 정수 * ph_number * 참조 * 문자열 {#resource-inv-PATCH-resource-id__d3457e556} 데이터 유형: 문자열 | | 자원 관계 | 관련 자원 목록입니다. 다음 자원 유형에는 특정 관련 자원이 필요합니다. * 인터페이스 카드 자원의 경우 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원에 대한 관계가 필요합니다. * 네트워크 인터페이스 자원의 경우 장비 또는 인터페이스 카드 자원에 대한 관계가 필요합니다. * 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원의 경우 장비 또는 인터페이스 카드 자원과의 관계가 필요합니다. {#resource-inv-PATCH-resource-id__d3457e591} 데이터 유형: 배열 "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.RelationshipType | `[이 자원 설명자]::[관련 자원 설명자]` 형식의 두 자원 간의 관계 유형입니다. 예를 들어 `Contains::Contained by는` 관련 자원이 이 자원의 하위 자원임을 나타냅니다. 설명자에 유효한 값은 CI 관계 유형 \[cmdb_rel_type\] 테이블의 상위 설명자 및 하위 설명자 열에 있습니다. 데이터 유형: 문자열 | | resourceRelationship.resource | 관련 자원에 대한 상세 정보입니다. 관련 자원은 다음 자원 유형 중 하나여야 합니다. * 케이블 * 장비 * 장비 홀더 * 인터페이스 카드 * 논리적 연결 * 네트워크 인터페이스 * 네트워크 사이트 * 물리적 연결 * 스트랜드 * 토폴로지 {#resource-inv-PATCH-resource-id__d3457e649} 데이터 유형: 객체 "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 관련 자원의 Sys_id입니다. 관련 자원의 유형에 따라 다음 테이블 중 하나에 위치합니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더를 확장하는 테이블 \[cmdb_ci_equipment_holder\] {#resource-inv-PATCH-resource-id__d3457e702} 데이터 유형: 문자열 | | resourceRelationship.resource.href | 관련 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 자원 사양 | 자원 사양입니다. 데이터 유형: 객체 "resourceSpecification": { "id": "String" } | | resourceSpecification.id | 자원에 대한 연결된 모델의 Sys_id입니다. 모델 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 모델 \[sn_ent_cable_model\] * 장비 홀더 모델 \[sn_ent_nw_holder_model\] * 장비 모델 \[sn_ent_nw_equipment_model\] * 인터페이스 카드 모델 \[sn_ent_nw_interface_model\] * 논리적 연결 모델 \[sn_ent_logical_nw_connection_model\] * 네트워크 인터페이스 모델 \[sn_ent_nw_interface_model\] * 물리적 연결 모델 \[sn_ent_physical_nw_connection_model\] * 스트랜드 모델 \[sn_ent_strand_model\] * 토폴로지 모델 \[sn_ent_network_topology_model\] {#resource-inv-PATCH-resource-id__d3457e769} 데이터 유형: 문자열 | | startOperatingDate | 자원이 처음 운영을 시작한 날짜 및 시간입니다. 데이터 유형: 문자열 | [ ] ### cURL 요청 이 예시에서는 자원의 이름을 업데이트합니다. curl "http://instance.servicenow.com/api/sn_ni_core/resource/583e7b95405dc910f8772175cacd7292" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type: application/merge-patch+json" \ --user 'username':'password' \ --data '{"name": "new name"}' 응답 본문. { "href": "/api/sn_ni_core/resource/583e7b95405dc910f8772175cacd7292", "id": "583e7b95405dc910f8772175cacd7292", "name": "new name", "note": [ { "text": "TECHNICIAN SCHECULED TO BE ONSITE THE WEEK OF APRIL 4, 2022." } ], "place": { "id": "c23683c54051c910f8772175cacd725c", "href": "/api/now/table/cmdb_ci_ni_site/c23683c54051c910f8772175cacd725c", "@referredType": "GeographicAddress" }, "resourceCharacteristic": [ { "name": "alarmable", "valueType": "boolean", "value": "true" }, { "name": "attested", "valueType": "boolean", "value": "false" }, { "name": "can_hub", "valueType": "boolean", "value": "false" }, { "name": "can_partitionvlans", "valueType": "boolean", "value": "false" }, { "name": "can_print", "valueType": "boolean", "value": "false" }, { "name": "can_route", "valueType": "boolean", "value": "false" }, { "name": "can_switch", "valueType": "boolean", "value": "false" }, { "name": "comments", "valueType": "string", "value": "ETHERNET SWITCH" }, { "name": "cost_cc", "valueType": "string", "value": "USD" }, { "name": "cpu_count", "valueType": "integer", "value": "1" }, { "name": "equipment_clli", "valueType": "string", "value": "DLLSTXESS01" }, { "name": "fault_count", "valueType": "integer", "value": "0" }, { "name": "firmware_manufacturer", "valueType": "reference", "value": "0c441abbc6112275000025157c651c89" }, { "name": "firmware_version", "valueType": "string", "value": "A09DX887" }, { "name": "hardware_status", "valueType": "string", "value": "installed" }, { "name": "install_status", "valueType": "integer", "value": "1" }, { "name": "internet_facing", "valueType": "boolean", "value": "true" }, { "name": "inventory_category", "valueType": "string", "value": "equipment" }, { "name": "last_service_date", "valueType": "datetime", "value": "2022-02-18T16:36:54.000Z" }, { "name": "life_cycle_stage", "valueType": "reference", "value": "Deploy" }, { "name": "life_cycle_stage_status", "valueType": "reference", "value": "Reserved" }, { "name": "managed_by", "valueType": "reference", "value": "46c9e158a9fe198101d44d0d22cb640d" }, { "name": "manufacturer", "valueType": "reference", "value": "b7e831bdc0a80169015ae101f3c4d6cd" }, { "name": "model_number", "valueType": "string", "value": "7450ESS-1" }, { "name": "monitor", "valueType": "boolean", "value": "false" }, { "name": "network_domain", "valueType": "string", "value": "core" }, { "name": "ni_function", "valueType": "reference", "value": "2d22153940990d10f8772175cacd728b" }, { "name": "ni_role", "valueType": "reference", "value": "c68e3f15405dc910f8772175cacd72f1" }, { "name": "ni_type", "valueType": "reference", "value": "3772e8d54015c910f8772175cacd721c" }, { "name": "ram", "valueType": "integer", "value": "3000" }, { "name": "replaceable", "valueType": "boolean", "value": "true" }, { "name": "serial_number", "valueType": "string", "value": "7894564568225" }, { "name": "skip_sync", "valueType": "boolean", "value": "false" }, { "name": "spare", "valueType": "boolean", "value": "true" }, { "name": "template_id", "valueType": "reference", "value": "49433535e5d28110f877657a33339131" }, { "name": "unit_position", "valueType": "integer", "value": "2" }, { "name": "unverified", "valueType": "boolean", "value": "false" } ], "resourceRelationship": [ { "relationshipType": "Contains::Contained by", "resource": { "id": "f5d1c429405dc910f8772175cacd723f", "href": "/api/sn_ni_core/resource/f5d1c429405dc910f8772175cacd723f" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "d6e100e5405dc910f8772175cacd72e9", "href": "/api/sn_ni_core/resource/d6e100e5405dc910f8772175cacd72e9" } }, { "relationshipType": "Contained by::Contains", "resource": { "id": "5b10e8154015c910f8772175cacd724d", "href": "/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d" } } ], "resourceSpecification": { "id": "0ae34df1e5528110f877657a33339119", "href": "/api/now/table/cmdb_model/0ae34df1e5528110f877657a33339119", "@referredType": "EquipmentModel" }, "@type": "cmdb_ci_ni_telco_equipment" } ## 자원 인벤토리 Open API - POST /sn_ni_core/resource {#ariaid-title6} 자원 기록을 생성합니다. ### URL 형식 기본 URL: /api/sn_ni_core/resource ### 지원되는 요청 매개변수 {#resource-inv-POST-resource__table_vzn_xns_g5b__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 25. 경로 매개변수] {#resource-inv-POST-resource__table_vzn_xns_g5b} {#resource-inv-POST-resource__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 26. 쿼리 매개변수] {#resource-inv-POST-resource__entry__10}{#resource-inv-POST-resource__type-descr-entry}{#resource-inv-POST-resource__name-entry}{#resource-inv-POST-resource__note-text-entry}{#resource-inv-POST-resource__place-entry}{#resource-inv-POST-resource__place-id-entry}{#resource-inv-POST-resource__related-party-parm}{#resource-inv-POST-resource__rel-party-id-parm}{#resource-inv-POST-resource__res-char-name-parm}{#resource-inv-POST-resource__res-char-value-parm}{#resource-inv-POST-resource__rel-type-parm}{#resource-inv-POST-resource__rel-resource-parm}{#resource-inv-POST-resource__rel-resource-id-parm}{#resource-inv-POST-resource__res-spec-id-parm} | 이름 | 설명 | |-|-| | @type | 자원의 유형입니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-POST-resource__ul_wmt_vfz_d5b} 데이터 유형: 문자열 | | 설명 | 자원에 대한 설명입니다. 데이터 유형: 문자열 | | 이름 | 필수 자원의 이름입니다. 데이터 유형: 문자열 | | 참고 | 자원에 대한 메모 목록입니다. 데이터 유형: 객체 배열 "note": [ { "text": "String" } ] | | 메모.텍스트 | 매개변수가 note 사용되는 경우 필수입니다. 메모 텍스트입니다. 데이터 유형: 문자열 | | 장소 | 컨테이너 유형이 케이지, 베이, 캐비닛, 랙, 라인업 또는 인벤토리 모델 번들인 장비 홀더 자원에 필요합니다. 모든 장비 자원에 필요합니다. 자원의 네트워크 사이트입니다. 이 매개변수는 네트워크 사이트, 물리적 연결 또는 논리적 연결 자원에 대해 지원되지 않습니다. 데이터 유형: 객체 "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 장소 유형입니다. 이 값은 항상 `GeographicAddress`입니다. 데이터 유형: 문자열 | | 장소.href | 장소 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | place.id | 매개변수가 place 사용되는 경우 필수입니다. 장소 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 네트워크 사이트 \[cmdb_ci_ni_site\] | | 관련당사자 | 자원의 접촉 창구에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 관련 당사자의 유형입니다. 유형 필드에 있습니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] 테이블의 유형 필드에 있습니다. | | relatedParty.href | 관련 당사자 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | relatedParty.id | 매개변수가 relatedParty 사용되는 경우 필수입니다. 관련 당사자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] | | 자원특성 | 자원의 특성 목록입니다. 다음 자원 유형에는 특정 자원 특성이 필요합니다. * 물리적 연결 및 논리적 연결 자원의 경우 `포트 A` 또는 `포트 Z` 특성이 필요합니다. 자원의 수명주기 스테이지 상태가 사용 중이면 `포트 A` 와 `포트 Z` 가 모두 필요합니다. * 장비 홀더 자원의 경우 `컨테이너 유형` 특성이 필요합니다. {#resource-inv-POST-resource__ul_wsv_p2m_g5b} 데이터 유형: 객체 배열 "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | 매개변수가 resourceCharacteristic 사용되는 경우 필수입니다. 매개변수로 지정된 자원 테이블의 필드 이름입니다 @type . 필드 model_id, 이름, network_site, operation_notes, operational_status, short_description, start_date 또는 sys_id와 같이 접두사가 붙은 sys_ 필드는 사용할 수 없습니다. 데이터 유형: 문자열 | | resourceCharacteristic.value | 매개변수가 resourceCharacteristic 사용되는 경우 필수입니다. 특성의 값입니다. 데이터 유형: 문자열 | | resourceCharacteristic.valueType | 값의 유형입니다. 유효한 값은 다음과 같습니다. * 부울 * 날짜 시간 * 부동 * 정수 * ph_number * 참조 * 문자열 {#resource-inv-POST-resource__ul_bk1_rw2_g5b} 데이터 유형: 문자열 | | 자원 관계 | 관련 자원 목록입니다. 다음 자원 유형에는 특정 관련 자원이 필요합니다. * 인터페이스 카드 자원의 경우 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원에 대한 관계가 필요합니다. * 네트워크 인터페이스 자원의 경우 장비 또는 인터페이스 카드 자원에 대한 관계가 필요합니다. * 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원의 경우 장비 또는 인터페이스 카드 자원과의 관계가 필요합니다. {#resource-inv-POST-resource__ul_rlv_3dm_g5b} 데이터 유형: 배열 "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.RelationshipType | 매개변수가 resourceRelationship 사용되는 경우 필수입니다. `[이 자원 설명자]::[관련 자원 설명자]` 형식의 두 자원 간의 관계 유형입니다. 예를 들어 `Contains::Contained by는` 관련 자원이 이 자원의 하위 자원임을 나타냅니다. 설명자에 유효한 값은 CI 관계 유형 \[cmdb_rel_type\] 테이블의 상위 설명자 및 하위 설명자 열에 있습니다. 데이터 유형: 문자열 | | resourceRelationship.resource | 매개변수가 resourceRelationship 사용되는 경우 필수입니다. 관련 자원에 대한 상세 정보입니다. 관련 자원은 다음 자원 유형 중 하나여야 합니다. * 케이블 * 장비 * 장비 홀더 * 인터페이스 카드 * 논리적 연결 * 네트워크 인터페이스 * 네트워크 사이트 * 물리적 연결 * 스트랜드 * 토폴로지 {#resource-inv-POST-resource__ul_wmt_vtx_d5y} 데이터 유형: 객체 "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 매개변수가 resourceRelationship 사용되는 경우 필수입니다. 관련 자원의 Sys_id입니다. 관련 자원의 유형에 따라 다음 테이블 중 하나에 위치합니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더를 확장하는 테이블 \[cmdb_ci_equipment_holder\] {#resource-inv-POST-resource__ul_vr1_4gf_g5b} 데이터 유형: 문자열 | | resourceRelationship.resource.href | 관련 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 자원 사양 | 자원 사양입니다. 데이터 유형: 객체 "resourceSpecification": { "id": "String" } | | resourceSpecification.id | 매개변수가 resourceSpecification 사용되는 경우 필수입니다. 자원에 대한 연결된 모델의 Sys_id입니다. 모델 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 모델 \[sn_ent_cable_model\] * 장비 홀더 모델 \[sn_ent_nw_holder_model\] * 장비 모델 \[sn_ent_nw_equipment_model\] * 인터페이스 카드 모델 \[sn_ent_nw_interface_model\] * 논리적 연결 모델 \[sn_ent_logical_nw_connection_model\] * 네트워크 인터페이스 모델 \[sn_ent_nw_interface_model\] * 물리적 연결 모델 \[sn_ent_physical_nw_connection_model\] * 스트랜드 모델 \[sn_ent_strand_model\] * 토폴로지 모델 \[sn_ent_network_topology_model\] {#resource-inv-POST-resource__ul_a3t_1lz_d5b} 데이터 유형: 문자열 | | startOperatingDate | 자원이 처음 운영을 시작한 날짜 및 시간입니다. 데이터 유형: 문자열 | [표 27. 요청 본문 매개변수(JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-POST-resource__entry__62}{#resource-inv-POST-resource__accept-JSON-only-entry-RESTAPI}{#resource-inv-POST-resource__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 28. 요청 헤더] {#resource-inv-POST-resource__entry__68} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | | 위치 | 생성된 자원의 URL입니다. | [표 29. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-POST-resource__table_b4x_lrs_g5b__entry__2}{#resource-inv-POST-resource__entry-400-status-code}{#resource-inv-POST-resource__entry-401-status-code} | 상태 코드 | 설명 | |-|-| | 215 | 처리를 위한 요청이 성공적으로 수신되었습니다. 요청은 비동기식으로 완료됩니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | [표 30. 상태 코드] {#resource-inv-POST-resource__table_b4x_lrs_g5b} ### 응답 본문 매개변수(JSON) {#resource-inv-POST-resource__section_nkb_1rw_f5b} {#resource-inv-POST-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-POST-resource__d3457e141}{#resource-inv-POST-resource__d3457e405} | 이름 | 설명 | |-|-| | @type | 자원의 유형입니다. 유효한 값은 다음과 같습니다. * `cmdb_ci_cable` (케이블) * `cmdb_ci_interface_card` (인터페이스 카드) * `cmdb_ci_ip_address` (IP 주소) * `cmdb_ci_ni_logical_path` (논리적 연결) * `cmdb_ci_ni_interface` (네트워크 인터페이스) * `cmdb_ci_ni_site` (네트워크 사이트) * `cmdb_ci_ni_physical_link` (물리적 연결) * `cmdb_ci_strand` (스트랜드) * `cmdb_ci_topology` (토폴로지) * sys_property로 sn_ni_core.equipment_tables 지정된 테이블의 이름 또는 지정된 테이블을 확장하는 테이블의 이름입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블의 이름입니다. {#resource-inv-POST-resource__d3457e145} 데이터 유형: 문자열 | | 설명 | 자원에 대한 설명입니다. 데이터 유형: 문자열 | | href | 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | ID | 자원의 Sys_id입니다. 자원 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-POST-resource__ul_umw_gvn_bcc} {#resource-inv-POST-resource__res-inv-tables} 데이터 유형: 문자열 | | 이름 | 자원의 이름입니다. 데이터 유형: 문자열 | | 참고 | 자원에 대한 메모 목록입니다. 데이터 유형: 객체 배열 "note": [ { "text": "String" } ] | | 메모.텍스트 | 메모 텍스트입니다. 데이터 유형: 문자열 | | 장소 | 자원의 네트워크 사이트입니다. 이 매개변수는 네트워크 사이트, 물리적 연결 또는 논리적 연결 자원에 대해 지원되지 않습니다. 데이터 유형: 객체 "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 장소 유형입니다. 이 값은 항상 `GeographicAddress`입니다. 데이터 유형: 문자열 | | 장소.href | 장소 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | place.id | 장소 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 네트워크 사이트 \[cmdb_ci_ni_site\] | | 관련당사자 | 자원의 접촉 창구에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 관련 당사자의 유형입니다. 유형 필드에 있습니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] 테이블의 유형 필드에 있습니다. | | relatedParty.href | 관련 당사자 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | relatedParty.id | 관련 당사자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 그룹 \[sys_user_group\] | | 자원특성 | 자원의 특성 목록입니다. 다음 자원 유형에는 특정 자원 특성이 필요합니다. * 물리적 연결 및 논리적 연결 자원의 경우 `포트 A` 또는 `포트 Z` 특성이 필요합니다. 자원의 수명주기 스테이지 상태가 사용 중이면 `포트 A` 와 `포트 Z` 가 모두 필요합니다. * 장비 홀더 자원의 경우 `컨테이너 유형` 특성이 필요합니다. {#resource-inv-POST-resource__d3457e482} 데이터 유형: 객체 배열 "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | 매개변수로 지정된 자원 테이블의 필드 이름입니다 @type . 필드 model_id, 이름, network_site, operation_notes, operational_status, short_description, start_date 또는 sys_id와 같이 접두사가 붙은 sys_ 필드는 사용할 수 없습니다. 데이터 유형: 문자열 | | resourceCharacteristic.value | 특성의 값입니다. 데이터 유형: 문자열 | | resourceCharacteristic.valueType | 값의 유형입니다. 유효한 값은 다음과 같습니다. * 부울 * 날짜 시간 * 부동 * 정수 * ph_number * 참조 * 문자열 {#resource-inv-POST-resource__d3457e556} 데이터 유형: 문자열 | | 자원 관계 | 관련 자원 목록입니다. 다음 자원 유형에는 특정 관련 자원이 필요합니다. * 인터페이스 카드 자원의 경우 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원에 대한 관계가 필요합니다. * 네트워크 인터페이스 자원의 경우 장비 또는 인터페이스 카드 자원에 대한 관계가 필요합니다. * 컨테이너 유형이 슬롯 또는 하위 슬롯인 장비 홀더 자원의 경우 장비 또는 인터페이스 카드 자원과의 관계가 필요합니다. {#resource-inv-POST-resource__d3457e591} 데이터 유형: 배열 "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.RelationshipType | `[이 자원 설명자]::[관련 자원 설명자]` 형식의 두 자원 간의 관계 유형입니다. 예를 들어 `Contains::Contained by는` 관련 자원이 이 자원의 하위 자원임을 나타냅니다. 설명자에 유효한 값은 CI 관계 유형 \[cmdb_rel_type\] 테이블의 상위 설명자 및 하위 설명자 열에 있습니다. 데이터 유형: 문자열 | | resourceRelationship.resource | 관련 자원에 대한 상세 정보입니다. 관련 자원은 다음 자원 유형 중 하나여야 합니다. * 케이블 * 장비 * 장비 홀더 * 인터페이스 카드 * 논리적 연결 * 네트워크 인터페이스 * 네트워크 사이트 * 물리적 연결 * 스트랜드 * 토폴로지 {#resource-inv-POST-resource__d3457e649} 데이터 유형: 객체 "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 관련 자원의 Sys_id입니다. 관련 자원의 유형에 따라 다음 테이블 중 하나에 위치합니다. * 인터페이스 카드 \[cmdb_ci_interface_card\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더를 확장하는 테이블 \[cmdb_ci_equipment_holder\] {#resource-inv-POST-resource__d3457e702} 데이터 유형: 문자열 | | resourceRelationship.resource.href | 관련 자원 기록에 대한 상대 링크입니다. 데이터 유형: 문자열 | | 자원 사양 | 자원 사양입니다. 데이터 유형: 객체 "resourceSpecification": { "id": "String" } | | resourceSpecification.id | 자원에 대한 연결된 모델의 Sys_id입니다. 모델 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 모델 \[sn_ent_cable_model\] * 장비 홀더 모델 \[sn_ent_nw_holder_model\] * 장비 모델 \[sn_ent_nw_equipment_model\] * 인터페이스 카드 모델 \[sn_ent_nw_interface_model\] * 논리적 연결 모델 \[sn_ent_logical_nw_connection_model\] * 네트워크 인터페이스 모델 \[sn_ent_nw_interface_model\] * 물리적 연결 모델 \[sn_ent_physical_nw_connection_model\] * 스트랜드 모델 \[sn_ent_strand_model\] * 토폴로지 모델 \[sn_ent_network_topology_model\] {#resource-inv-POST-resource__d3457e769} 데이터 유형: 문자열 | | startOperatingDate | 자원이 처음 운영을 시작한 날짜 및 시간입니다. 데이터 유형: 문자열 | [ ] {#resource-inv-POST-resource__table_okb_1rw_f5b} ### cURL 요청 이 예에서는 콜로라도주 덴버에 네트워크 사이트를 만듭니다. curl "https://instance.service-now.com/api/sn_ni_core/resource" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"name\": \"DENVER CO CO/HUB\", \"note\": [ { \"text\": \"Cisco maintenance team onsite June 22, 2022.\" } ], \"resourceCharacteristic\": [ { \"name\": \"attested\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"can_print\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"clli_code\", \"valueType\": \"string\", \"value\": \"DNVRCOMR02T\" }, { \"name\": \"comments\", \"valueType\": \"string\", \"value\": \"Site is scheduled for diesel generator test July 13, 2022 at 9am CST.\" }, { \"name\": \"cost_cc\", \"valueType\": \"string\", \"value\": \"USD\" }, { \"name\": \"county\", \"valueType\": \"string\", \"value\": \"DENVER\" }, { \"name\": \"data_center_code\", \"valueType\": \"string\", \"value\": \"DNVR00564\" }, { \"name\": \"fault_count\", \"valueType\": \"integer\", \"value\": \"0\" }, { \"name\": \"install_status\", \"valueType\": \"integer\", \"value\": \"1\" }, { \"name\": \"life_cycle_stage\", \"valueType\": \"reference\", \"value\": \"Operational\" }, { \"name\": \"life_cycle_stage_status\", \"valueType\": \"reference\", \"value\": \"In Use\" }, { \"name\": \"location\", \"valueType\": \"reference\", \"value\": \"25ab8f300a0a0bb300d99f69c3ac24cd\" }, { \"name\": \"managed_by\", \"valueType\": \"reference\", \"value\": \"b0f31e5673500010c2e7660c4cf6a711\" }, { \"name\": \"monitor\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"network_domain\", \"valueType\": \"string\", \"value\": \"core\" }, { \"name\": \"ni_type\", \"valueType\": \"reference\", \"value\": \"8e8f3770404d0110f8772175cacd7204\" }, { \"name\": \"pots_number\", \"valueType\": \"ph_number\", \"value\": \"(214) 555-1234\" }, { \"name\": \"skip_sync\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"third_party_ownership\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"unverified\", \"valueType\": \"boolean\", \"value\": \"false\" } ], \"resourceRelationship\": [ { \"relationshipType\": \"Connects to::Connected by\", \"resource\": { \"id\": \"e6f6df8d4051c910f8772175cacd72b2\", \"href\": \"/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2\" } }, { \"relationshipType\": \"Connects to::Connected by\", \"resource\": { \"id\": \"0ac19bc54051c910f8772175cacd724b\", \"href\": \"/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b\" } }, { \"relationshipType\": \"Connects to::Connected by\", \"resource\": { \"id\": \"997e5c11875851109a9c0f65dabb35ac\", \"href\": \"/api/sn_ni_core/resource/997e5c11875851109a9c0f65dabb35ac\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"5b10e8154015c910f8772175cacd724d\", \"href\": \"/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"57e73b51405dc910f8772175cacd726e\", \"href\": \"/api/sn_ni_core/resource/57e73b51405dc910f8772175cacd726e\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"bf58f751405dc910f8772175cacd72e8\", \"href\": \"/api/sn_ni_core/resource/bf58f751405dc910f8772175cacd72e8\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"b5711e31405d0d10f8772175cacd7232\", \"href\": \"/api/sn_ni_core/resource/b5711e31405d0d10f8772175cacd7232\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"ed811e31405d0d10f8772175cacd72d3\", \"href\": \"/api/sn_ni_core/resource/ed811e31405d0d10f8772175cacd72d3\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"d74937d1405dc910f8772175cacd7288\", \"href\": \"/api/sn_ni_core/resource/d74937d1405dc910f8772175cacd7288\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"da0df2e3e4e64510f877e70ec9bcacc6\", \"href\": \"/api/sn_ni_core/resource/da0df2e3e4e64510f877e70ec9bcacc6\" } } ], \"@type\": \"cmdb_ci_ni_site\" }" \ --user 'username':'password' 응답 본문. { "href": "/api/sn_ni_core/resource/00399f0aed349150f877305f29f832b2", "id": "00399f0aed349150f877305f29f832b2", "name": "DENVER CO CO/HUB", "note": [ { "text": "Cisco maintenance team onsite June 22, 2022." } ], "resourceCharacteristic": [ { "name": "altitude_units", "valueType": "string", "value": "feet" }, { "name": "attestation_status", "valueType": "string", "value": "Not Yet Reviewed" }, { "name": "attested", "valueType": "boolean", "value": "false" }, { "name": "can_print", "valueType": "boolean", "value": "false" }, { "name": "clli_code", "valueType": "string", "value": "DNVRCOMR02T" }, { "name": "comments", "valueType": "string", "value": "Site is scheduled for diesel generator test July 13, 2022 at 9am CST." }, { "name": "cost_cc", "valueType": "string", "value": "USD" }, { "name": "county", "valueType": "string", "value": "DENVER" }, { "name": "data_center_code", "valueType": "string", "value": "DNVR00564" }, { "name": "discovery_source", "valueType": "string", "value": "Resource Inventory Open API" }, { "name": "fault_count", "valueType": "integer", "value": "0" }, { "name": "first_discovered", "valueType": "datetime", "value": "2022-07-21T19:38:04.000Z" }, { "name": "install_status", "valueType": "integer", "value": "1" }, { "name": "last_discovered", "valueType": "datetime", "value": "2022-07-21T19:38:04.000Z" }, { "name": "life_cycle_stage", "valueType": "reference", "value": "Operational" }, { "name": "life_cycle_stage_status", "valueType": "reference", "value": "In Use" }, { "name": "location", "valueType": "reference", "value": "25ab8f300a0a0bb300d99f69c3ac24cd" }, { "name": "managed_by", "valueType": "reference", "value": "b0f31e5673500010c2e7660c4cf6a711" }, { "name": "monitor", "valueType": "boolean", "value": "false" }, { "name": "network_domain", "valueType": "string", "value": "core" }, { "name": "ni_type", "valueType": "reference", "value": "8e8f3770404d0110f8772175cacd7204" }, { "name": "pots_number", "valueType": "ph_number", "value": "(214) 555-1234" }, { "name": "skip_sync", "valueType": "boolean", "value": "false" }, { "name": "third_party_ownership", "valueType": "boolean", "value": "false" }, { "name": "unverified", "valueType": "boolean", "value": "false" } ], "resourceRelationship": [ { "relationshipType": "Connects to::Connected by", "resource": { "id": "e6f6df8d4051c910f8772175cacd72b2", "href": "/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2" } }, { "relationshipType": "Connects to::Connected by", "resource": { "id": "0ac19bc54051c910f8772175cacd724b", "href": "/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b" } }, { "relationshipType": "Connects to::Connected by", "resource": { "id": "997e5c11875851109a9c0f65dabb35ac", "href": "/api/sn_ni_core/resource/997e5c11875851109a9c0f65dabb35ac" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "5b10e8154015c910f8772175cacd724d", "href": "/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "57e73b51405dc910f8772175cacd726e", "href": "/api/sn_ni_core/resource/57e73b51405dc910f8772175cacd726e" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "bf58f751405dc910f8772175cacd72e8", "href": "/api/sn_ni_core/resource/bf58f751405dc910f8772175cacd72e8" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "b5711e31405d0d10f8772175cacd7232", "href": "/api/sn_ni_core/resource/b5711e31405d0d10f8772175cacd7232" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "ed811e31405d0d10f8772175cacd72d3", "href": "/api/sn_ni_core/resource/ed811e31405d0d10f8772175cacd72d3" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "d74937d1405dc910f8772175cacd7288", "href": "/api/sn_ni_core/resource/d74937d1405dc910f8772175cacd7288" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "da0df2e3e4e64510f877e70ec9bcacc6", "href": "/api/sn_ni_core/resource/da0df2e3e4e64510f877e70ec9bcacc6" } } ], "@type": "cmdb_ci_ni_site" } ## 자원 인벤토리 Open API - POST /sn_ni_core/resourceinventoryviatemplate {#ariaid-title7} 템플릿을 기반으로 자원 CI(구성 항목) 및 관련 CI 계층 구조를 만듭니다. 이 엔드포인트를 호출하기 전에 인벤토리 템플릿 \[sn_ni_core_inventory_template\] 테이블에 인벤토리 템플릿을 생성해야 합니다. 인벤토리 템플릿에서 관련 CI의 전체 계층 구조를 정의할 수 있습니다. 그런 다음 단일 API 요청을 통해 모든 CI와 관계를 만들 수 있습니다. ### URL 형식 기본 URL: /api/sn_ni_core/resourceinventoryviatemplate ### 지원되는 요청 매개변수 {#resource-inv-POST-template__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 31. 경로 매개변수] {#resource-inv-POST-template__entry__6} | 이름 | 설명 | |-|-| | 없음 | | [표 32. 쿼리 매개변수] {#resource-inv-POST-template__entry__10} | 이름 | 설명 | |-|-| | 재정의 | 재정의할 열과 사용할 값의 목록입니다. 데이터 유형: 객체 "overrides": { "column_name": "String" } | | overrides.column_name | 매개변수가 overrides 사용되는 경우 필수입니다. 열 이름 및 값입니다. 데이터 유형: 문자열 | | parentId | 필수 상위 CI의 Sys_id입니다. 상위 CI 유형에 따라 다음 테이블 중 하나에 있습니다. * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 인터페이스 카드 \[cmdb_ci_interface_card\] * IP 주소 \[cmdb_ci_ip_address\] * 논리적 연결 \[cmdb_ci_ni_logical_path\] * 네트워크 인터페이스 \[cmdb_ci_ni_interface\] * 네트워크 사이트 \[cmdb_ci_ni_site\] * 물리적 연결 \[cmdb_ci_ni_physical_link\] * 스트랜드 \[cmdb_ci_strand\] * 토폴로지 \[cmdb_ci_topology\] * sys_property에서 지정한 sn_ni_core.equipment_tables 테이블 및 지정된 테이블을 확장하는 모든 테이블입니다. * 장비 홀더 \[cmdb_ci_equipment_holder\]를 확장하는 테이블입니다. * 다음 테이블을 확장하는 하위 테이블: * 케이블 \[cmdb_ci_cable\] * 장비 홀더 \[cmdb_ci_equipment_holder\] * 스트랜드 \[cmdb_ci_strand\] {#resource-inv-POST-template__ul_umw_gvn_bcc} {#resource-inv-POST-template__ul_ihw_mmd_wxb} 데이터 유형: 문자열 | | templateId | 필수 템플릿의 Sys_id입니다. 데이터 유형: 문자열 테이블: 인벤토리 템플릿 \[sn_ni_core_inventory_template\] | | templateOverrides | 템플릿 재정의 목록입니다. 데이터 유형: 객체 배열 "templateOverrides": [ { "overrideTemplateId": "String", "templateId": "String" } ] | | templateOverrides.overrideTemplateId | 매개변수가 templateOverrides 사용되는 경우 필수입니다. 사용 가능한 템플릿 sys_id입니다. 데이터 유형: 문자열 | | templateOverrides.templateId | 매개변수가 templateOverrides 사용되는 경우 필수입니다. 관련 템플릿 sys_id. 데이터 유형: 문자열 | [표 33. 요청 본문 매개변수(JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-POST-template__table_ss4_qtt_g5b__entry__2}{#resource-inv-POST-template__accept-JSON-only-entry-RESTAPI}{#resource-inv-POST-template__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 34. 요청 헤더] {#resource-inv-POST-template__table_ss4_qtt_g5b} {#resource-inv-POST-template__table_b21_rtt_g5b__entry__2} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json. | | 위치 | 계층 구조의 맨 위에 있는 생성된 CI의 URL입니다. | [표 35. 응답 헤더] {#resource-inv-POST-template__table_b21_rtt_g5b} ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#resource-inv-POST-template__table_b4x_lrs_g5b__entry__2}{#resource-inv-POST-template__entry-400-status-code}{#resource-inv-POST-template__entry-401-status-code} | 상태 코드 | 설명 | |-|-| | 201 | 자원이 작성되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 500 | 오류. 요청에 오류가 발생했습니다. 예를 들어, 요청이 유효성 확인 검사에 실패했습니다. | [표 36. 상태 코드] {#resource-inv-POST-template__table_b4x_lrs_g5b} ### 응답 본문 매개변수(JSON) {#resource-inv-POST-template__entry__48} | 이름 | 설명 | |-|-| | 결과 | 생성된 CI에 대한 정보가 포함된 결과 객체입니다. 데이터 유형: 객체 "result": { "sys_id": "String" } | | result.sys_id | 계층 구조의 맨 위에 있는 생성된 CI의 Sys_id입니다. 데이터 유형: 문자열 | [ ] ### cURL 요청 이 예에서는 템플릿을 사용하여 CI 계층 구조를 만듭니다. curl "https://instance.service-now.com/api/sn_ni_core/resourceinventoryviatemplate" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "templateId": "90475711ed6ec110f877d2f57b8accda", "parentId": "917dd8f6870e851079c40f2d0ebb353d", "overrides": { "equipment_clli": "test" }, "templateOverrides": [ { "templateId": "ac3b679ded6ec110f877d2f57b8acc29", "overrideTemplateId": "f9604efb54e18110f87749bbc4ad38d8" }, { "templateId": "171c23dded6ec110f877d2f57b8acc33", "overrideTemplateId": "0f38e59187424110e14f64e73cbb35b4" } ] }" \ --user 'username':'password' 응답 본문. "result": { "sys_id": "00598f0aed346259f388105f29f892c4" }