CdmSharedLibraryApi

CdmSharedLibraryApi - 삭제 /sn_cdm/shared_libraries

지정된 이름의 공유 라이브러리를 삭제합니다.

이 엔드포인트에 액세스하려면 CDM 관리자 역할이 필요합니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries

기본 URL: /api/sn_cdm/shared_libraries

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 1. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 2. 쿼리 매개변수
이름	설명
안 함

표 3. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
이름	필수 삭제할 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 [sn_cdm_application]

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 4. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 5. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 6. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수(JSON 또는 XML)


이름	설명
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 코드 예제는 공유 라이브러리 "javalib"를 삭제하는 방법을 보여줍니다.

curl "http://instance.servicenow.com/sn_cdm/shared_libraries?name='javalib'\ 
--request DELETE\ 
--header "Accept:application/json" \ 
--user 'username':'password'

응답:

""

CdmSharedLibraryApi - 삭제 /sn_cdm/shared_libraries/components

지정된 라이브러리에서 지정된 공유 구성요소를 삭제합니다.

이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.

주:

현재 사용 중이 아닌 구성요소만 삭제할 수 있습니다. 또한 연결된 공유 라이브러리가 활성화되어 있지 않으면 구성요소를 삭제할 수 없습니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries/components

기본 URL: /api/sn_cdm/shared_libraries/components

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 7. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 8. 쿼리 매개변수
이름	설명
changesetNumber	필수 구성요소와 연결된 변경 세트의 수입니다. 데이터 유형: 문자열 테이블: CDM 변경 세트 [sn_cdm_changeset]
이름	필수 삭제할 공유 구성요소의 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 [sn_cdm_shared_component]
sharedLibraryName	필수 삭제할 구성요소가 있는 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 [sn_cdm_application]

표 9. 요청 본문 매개변수
이름	설명
안 함

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 10. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 11. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 12. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 가능한 문제: 공유 라이브러리가 없습니다. 공유 라이브러리가 활성 상태가 아닙니다. 공유 구성요소가 사용 중입니다. 삭제할 수 없습니다. 사용자는 공유 구성요소를 삭제할 수 없습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 코드 예제는 "javalib" 공유 라이브러리에서 "TestComponent" 구성요소를 삭제하는 방법을 보여줍니다.

curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components?sharedLibraryName='javalib&changesetNumber='chset-8'&name='TestComponent'\ 
--request DELETE\ 
--header "Accept:application/json" \ 
--user 'username':'password'

응답:

""

CdmSharedLibraryApi - GET /sn_cdm/shared_libraries/upload-status/{upload-id}

지정된 공유 라이브러리 업로드 요청의 현재 상태를 반환합니다.

URL 형식

버전 관리 URL: /api/sn_cdm/{api_version}/shared_libraries/upload-status/{upload-id}

기본 URL: /api/sn_cdm/shared_libraries/upload-status/{upload-id}

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 13. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열
업로드 ID	상태가 반환될 업로드 요청의 Sys_id입니다. 이 값은 다양한 CdmSharedLibrary 업로드 요청 엔드포인트에서 반환됩니다. 데이터 유형: 문자열

표 14. 쿼리 매개변수
이름	설명
없음

표 15. 요청 본문 매개변수
이름	설명
안 함

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 16. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 17. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 18. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수(JSON 또는 XML)


이름	설명
오류	업로드 중 발생한 오류에 대한 설명입니다. 데이터 유형: 문자열
출력	업로드된 데이터에 대한 설명 또는 업로드 중에 오류가 발생한 경우 발생한 오류를 설명하는 오류 메시지입니다. 데이터 유형: 문자열 배열 `"output": { "auto_validate": "String", "cdm_application": "String", "committed_at": "String", "committed_by": "String", "description": "String", "last_conflict_detection_time": "String", "number": "String", "publish_option": "String", "sharedLibraryName": "String", "snapshot_description": "String", "snapshot_name": "String", "state": "String", "sys_created_by": "String", "sys_id": "String", "title": "String" }`
output.auto_validate	커밋 후 확인을 호출할지 여부를 나타냅니다. 데이터 유형: 문자열
output.cdm_application	업로드가 수행된 애플리케이션의 이름입니다. 데이터 유형: 문자열
output.committed_at	업로드된 콘텐츠가 커밋된 날짜 및 시간입니다. 데이터 유형: 문자열
output.committed_by	커밋을 수행한 엔터티의 레코드 Sys_id입니다. 데이터 유형: 문자열
출력.설명	현재 사용되지 않습니다. 데이터 유형: 문자열
output.last_conflict_detection_time	날짜 및 시간 상충 탐지 발동입니다. 데이터 유형: 문자열
출력.번호	Chset-124와 같은 고유한 변경 세트 식별 값입니다. 데이터 유형: 문자열
output.publish_option	연결된 업로드 호출에 전달된 게시 옵션의 값입니다. 스냅샷 게시에 대한 자세한 내용은 스냅샷 게시 또는 게시 취소를 참조하세요. 데이터 유형: 문자열
output.sharedLibraryName	원래 업로드 호출 시 전달된 공유 라이브러리의 이름입니다. 데이터 유형: 문자열
output.snapshot_description	연결된 스냅샷에 대한 설명입니다. 데이터 유형: 문자열
output.snapshot_name	연결된 스냅샷의 이름입니다. 데이터 유형: 문자열
출력.상태	업로드의 상태입니다. 가능한 값: COMPLETED: 업로드가 완료되었습니다. EXPIREDERROR: 업로드 요청을 처리하는 동안 오류가 발생했습니다. 작업이 15분 이상 실행되어 시스템에 의해 종료되었습니다. IN_PROGRESS: 업로드가 진행 중입니다. 신규: 처리가 아직 시작되지 않았습니다. 준비: 요청이 큐에 대기 중입니다. 데이터 유형: 문자열
output.sys_created_by	기록을 생성한 엔터티의 Sys_id입니다. 데이터 유형: 문자열
output.sys_id	변경 세트를 포함하는 기록의 Sys_id입니다. 데이터 유형: 문자열
출력.제목	업로드의 일부로 생성된 변경 세트의 제목입니다. 데이터 유형: 문자열
processing_state	업로드 요청의 현재 처리 상태입니다. 가능한 값: PROCESSED 데이터 유형: 문자열
상태	업로드 요청의 현재 상태입니다. 가능한 값: 완료됨 오류
유형	업로드 요청의 유형입니다. 가능한 값: upload_and_commit 데이터 유형: 문자열
upload_id	업로드된 구성 페이로드가 포함된 기록의 Sys_id입니다. 데이터 유형: 문자열

cURL 요청

이 코드 예제에서는 upload-id 0d91d9891b2b19109524cae0604bcbe6에 대한 상태를 요청하는 방법을 보여줍니다.

curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/upload-status/0d91d9891b2b19109524cae0604bcbe6" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

응답:

// Successful response
{
  "result": {
    "type": "upload_and_commit",
    "state": "completed",
    "output": {
      "sys_id": "0002ea107768a1109ac0cf0bbb5a9963",
      "number": "Chset-457",
      "title": "admin8802ea107768a1109ac0cf0bbb5a9962",
      "description": null,
      "committed_at": "",
      "committed_by": null,
      "sys_created_by": "admin",
      "state": "open",
      "publish_option": "publish_none",
      "auto_validate": false,
      "snapshot_name": null,
      "snapshot_description": null,
      "cdm_application": "OracleG-Library-15",
      "last_conflict_detection_time": null
    },
    "processing_state": "PROCESSED",
    "upload_id": "00b226547768a1109ac0cf0bbb5a99f2"
  }
}

// Error response
{
  "result": {
    "type": "upload_and_commit",
    "state": "error",
    "output": "Error: Application with sys_id 87fb1ecb1be3111050fc21b0604bcb95 is in State Deleted. No data can be modified on deleted applications",
    "processing_state": "PROCESSED",
    "upload_id": "fcdfaf7f1b88211050fc21b0604bcb79"
  }
}

CdmSharedLibraryApi - 게시 /sn_cdm/shared_libraries

지정된 이름으로 새 공유 라이브러리를 작성합니다.

이 엔드포인트에 액세스하려면 CDM 관리자 역할이 필요합니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries

기본 URL: /api/sn_cdm/shared_libraries

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 19. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 20. 쿼리 매개변수
이름	설명
설명	공유 라이브러리에 대한 설명입니다. 데이터 유형: 문자열 기본값: 비어 있음
이름	필수 작성할 공유 라이브러리의 이름입니다. 이 이름은 모든 CDM 애플리케이션 및 라이브러리에서 고유해야 합니다. 데이터 유형: 문자열
returnFields	응답의 일부로 반환할 쉼표로 구분된 필드 목록입니다. 데이터 유형: 문자열 기본값: 모든 비시스템 필드가 반환됩니다. 테이블: CDM 애플리케이션 [sn_cdm_application]
userGroupId	연결된 공유 라이브러리를 편집할 수 있는 사용자 그룹 sys_ids의 쉼표로 구분된 목록입니다. 적절한 역할이 있는 모든 사용자가 공유 라이브러리를 볼 수 있습니다. 데이터 유형: 문자열 기본적으로 CDM 편집자 역할이 있는 모든 사용자는 공유 라이브러리 내에서 데이터를 편집할 수 있습니다. 테이블: 그룹 [sys_user_group]

표 21. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
안 함

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 22. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 23. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 24. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
<필드>	요청된 필드. 데이터 유형: 변수 테이블: CDM 애플리케이션 [sn_cdm_application]
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 코드 예제에서는 이 엔드포인트를 호출하여 모든 사용자 그룹이 라이브러리에 액세스할 수 있는 공유 라이브러리 Java11Lib를 만드는 방법을 보여 줍니다.

curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries?name=Java11Lib&description=The%20new%20java%20library" \ 
--request POST \ 
--header "Accept:application/json" \ 
--user 'userName':'password

응답:

{
  "result": {
    "sdlc_component": null,
    "cdi_count": "0",
    "available": false,
    "description": "Description of LibraryA",
    "managed_by_group": null,
    "sys_updated_on": "2023-01-18 11:34:43",
    "type": "shared_library",
    "node": {
      "value": "d852b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node/d852b15877a4a1109ac0cf0bbb5a99aa"
    },
    "sys_id": "185235dc77a4a1109ac0cf0bbb5a994e",
    "sys_updated_by": "admin",
    "node_main": {
      "value": "1852b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node_main/1852b15877a4a1109ac0cf0bbb5a99aa"
    },
    "sys_created_on": "2023-01-18 11:34:43",
    "cdi_usage": "0",
    "name": "LibraryA",
    "last_committed_changeset": {
      "value": "9052b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/9052b15877a4a1109ac0cf0bbb5a99aa"
    },
    "state": "active",
    "sys_created_by": "admin"
  }
}

CdmSharedLibraryApi - 게시 /sn_cdm/shared_libraries/components

지정된 라이브러리 아래에 지정된 공유 구성요소를 작성합니다.

이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries/components

기본 URL: /api/sn_cdm/shared_libraries/components

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 25. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 26. 쿼리 매개변수
이름	설명
changesetNumber	필수 연결된 변경 세트의 고유 식별자입니다(예: "Chset-10"). 데이터 유형: 문자열 테이블: CDM 변경 세트 [sn_cdm_changeset]
설명	공유 구성요소에 대한 설명입니다. 데이터 유형: 문자열
이름	필수 공유 라이브러리에서 생성할 공유 구성요소의 이름입니다. 이 이름은 고유해야 합니다. 데이터 유형: 문자열
returnFields	응답의 일부로 반환할 CDM 노드 [sn_cdm_node] 테이블의 쉼표로 구분된 필드 목록입니다. 데이터 유형: 문자열 기본값: 내부가 아닌 모든 필드가 반환됩니다.
sharedLibraryName	필수 구성요소를 작성할 공유 라이브러리의 이름입니다. 이 라이브러리는 이미 존재하며 활성 상태여야 합니다. 데이터 유형: 문자열

표 27. 요청 본문 매개변수
이름	설명
안 함

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 28. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 29. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 30. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
<요청된 필드>	요청된 필드. 데이터 유형: 다양한 테이블: CDM 노드 [sn_cdm_node]
오류	처리 중 오류가 발생한 경우에만 반환됩니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	발생한 오류에 대한 상세 정보입니다. 데이터 유형: 문자열
오류.메시지	오류에 대한 개요를 제공하는 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 코드 예제는 공유 라이브러리 "javalib"에 "SharedComponent"라는 구성 요소를 저장합니다.

curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components/?sharedLibraryName=javalib&changeSetNumber='Chset-9'&name='SharedComponent'\  
--request POST\  
--header "Accept:application/json" \  
--user 'username':'password'

응답:

{
  "result": {
    "changeset_id": {
      "value": "ca7e6a501b202110636e0fe0604bcb71",
      "link": "https://instance.servicenow.com/api/now/table/sn_cdm_changeset/ca7e6a501b202110636e0fe0604bcb71"
    },
    "node_path": "!2!3!:",
    "description": null,
    "sys_updated_on": "2023-01-18 16:04:52",
    "type": "sn_cdm_node_shared_component",
    "sys_class_name": "sn_cdm_node",
    "sys_id": "6d2072901b602110636e0fe0604bcbec",
    "sys_updated_by": "admin",
    "previous_version": null,
    "sys_created_on": "2023-01-18 16:04:52",
    "value": null,
    "effective_from": null,
    "linked_to": null,
    "sys_created_by": "admin",
    "restricted_to": null,
    "linked_to_version": null,
    "level": "2",
    "conflict_type": null,
    "main_id": "19",
    "effective_to": null,
    "secure_value": null,
    "node_classifier": "/shared_library/shared_components",
    "main_id_encoded": ":",
    "name": "testSharedComponent",
    "position": null,
    "reason_for_conflict": null,
    "system_folder": false,
    "status": "new",
    "conflict": false
  }
}

CdmSharedLibraryApi - POST /sn_cdm/shared_libraries/uploads/components

공유 라이브러리 및 공유 구성요소를 만들고 관리할 수 있습니다. 이 엔드포인트는 CDM 노드 [sn_cdm_node] 테이블에 공유 구성요소 노드를 생성하고 CDM 공유 구성요소 [sn_cdm_shared_component] 테이블에 공유 구성요소 기록을 생성합니다.

이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.

주:

기본적으로 최대 컨텐츠 업로드 크기는 2MB입니다. 이 기본값은 sn_cdm.max_allowed_upload_file_size 속성을 업데이트하여 수정할 수 있습니다.

주:

이 업로드 메서드는 노드를 수정하는 데 사용할 수 없습니다. 다른 CdmSharedLibraryApi - POST /sn_cdm/shared_libraries/uploads/components/file 방법을 사용하여 노드를 수정합니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries/uploads/components

기본 URL: /api/sn_cdm/shared_libraries/uploads/components

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 31. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 32. 쿼리 매개변수
이름	설명
자동 커밋	매개변수에서 changesetNumber 식별된 변경 세트가 업로드 후 데이터 모델에 커밋되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 업로드 후 변경 세트가 커밋됩니다. false: 업로드 후 변경 세트가 커밋되지 않습니다. 데이터 유형: 부울 기본값: false
autoDelete	업로드 컨텐츠의 일부가 아닌 기존 노드가 처리가 완료된 후 삭제되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 기존 노드를 자동으로 삭제합니다. false: 기존 노드를 자동으로 삭제하지 않습니다. 데이터 유형: 부울 기본값: false
changesetNumber	필수 Chset-102와 연결된 애플리케이션과 연결된 변경 세트를 고유하게 식별하는 문자열입니다. 이 변경 세트는 "오픈" 상태여야 합니다. 데이터 유형: 문자열 테이블: CDM 변경 세트 [sn_cdm_changeset]
데이터 형식	필수 구성 데이터의 형식입니다. 유효한 값은 다음과 같습니다. csv INI JSON 속성 원시 XML YAML 데이터 유형: 문자열
deleteRedundantOverrides	중복 값이 있는 경우 재정의를 생성할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 중복 값이 있으면 재정의가 생성되지 않습니다. false: 중복 값이 있는 경우 재정의를 진행합니다. 기본값: true
identifierKeys	동일한 노드를 식별하는 데 사용할 배열 하위 항목을 나타내는 이름 목록입니다. 예를 들어 업로드하는 경우: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` 다음 기존 모델에서: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` 이름을 `설정하면`identifierKeys 다음과 같은 출력이 생성됩니다. `[ {"name" : "Karen, "city" : "Sydney"}, {"name" : "Allan, "city" : "Paris"} ]` 그렇지 않으면 다음과 같은 출력이 생성됩니다. `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"}, {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` 데이터 유형: 문자열 배열
ignoreAttributes	지정된 데이터 형식이 속성을 지원하는지 여부를 나타내는 플래그입니다(현재는 XML만 해당). 유효한 값은 다음과 같습니다. true: 지정된 데이터 형식이 속성을 지원하는 경우 업로드 중에 입력 데이터의 모든 속성을 건너뜁니다. 아니오: 지정된 데이터 형식이 속성을 지원하는 경우 입력 데이터의 모든 속성이 업로드에 포함됩니다. 데이터 유형: 부울 기본값: false
namePath	구성 데이터를 업로드해야 하는 대상 노드의 경로입니다. 이 경로는 구성 요소, 컬렉션 또는 배포 가능 폴더(호출 중인 엔드포인트에 따라 다름)를 기준으로 합니다. 다음 형식으로 이름 경로를 전달할 수 있습니다. 예를 들어 `testApp/deployables/Development1/cdi1` 노드의 이름 경로를 정의하려면 다음을 수행합니다. 백슬래시 형식: testApp/deployables/Development1/cdi1 주: 노드 이름에 백슬래시("/")가 포함된 경우 이 형식을 사용할 수 없습니다. 대체 문자가 있는 백엔드 이름 경로: testApp 배포 가능 항목 개발1 cdi1 배열: ['testApp','배포 가능 항목','Development1','cdi1'] 주: 지정된 구성요소가 지정된 경로에 없으면 시스템은 자동으로 지정된 경로에 구성요소를 생성한 다음 데이터를 업로드합니다. 데이터 유형: 문자열
게시 옵션	연결된 구성된 스냅샷에 대한 게시 옵션입니다. 유효한 값은 다음과 같습니다. publish_new_and_unpublish_old: 커밋 후 생성된 새 스냅샷을 게시하고 기존 스냅샷의 게시를 취소합니다. publish_none: 스냅샷을 게시하지 않습니다. 스냅샷 게시에 대한 자세한 내용은 스냅샷 게시 또는 게시 취소를 참조하세요. 데이터 유형: 문자열 기본값: publish_none
sharedLibraryName	필수 작성하거나 관리할 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 [sn_cdm_application]

표 33. 요청 본문 매개변수
이름	설명
변수 업로드 데이터	업로드할 구성 데이터입니다. 쿼리 매개변수의 매개변수에 의해 dataFormat 정의된 형식의 모든 데이터가 될 수 있습니다.

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 34. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. application/json만 지원합니다.
콘텐츠-형식	요청 본문의 데이터 형식입니다. 지원되는 유형: text/plain 및 application/x-www-form-urlencoded. 기본값: text/plain

표 35. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 36. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 업로드 요청이 거부되었습니다. 가능한 문제: 구성 페이로드의 크기는 허용되는 최대값인 기본적으로 2MB보다 큽니다. 호출에서 필수 매개변수가 누락되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
upload_id	업로드 요청의 Sys_id입니다. 이 ID를 사용하여 엔드포인트를 호출하여 업로드 상태를 가져옵니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 예시에서는 구성 데이터가 일반 텍스트인 Demo_App1631126164773라는 공유 라이브러리를 업로드하는 방법을 보여줍니다.

curl "http://instance.servicenow.com/api/sn_cdm/sharedlibrary/component/upload?namePath=%2FSettings%2FdbSettings&dataFormat=json&appName=Demo_App1631126164773&changesetNumber=Chset-8&autoCommit=false&publishOption=publish_none&autoDelete=true" \ 
--request POST \  
--header "Accept:application/json" \  
--header "Content-Type:text/plain" \  
--data "{  
  \"dbIPAddress\": \"10.10.10.110\",  
\"dbPort\": \"8080\",  
\"dbConnectionString\": \"admin:admin server1.xyz.com:8080 dbName_payments\",  
\"dbConnectionStringBackup\": \"admin:admin server2.xyz.com dbName_payments_backup\ "}" \  
--user 'username':'password'

다음 반환 결과에는 이 요청에 대한 성공 및 오류 응답이 모두 표시됩니다.

// Successful response 
{  
"result": {  
    "upload_id": "ec1f71f45322301096edddeeff7b12b3"  
  }  
}
 
// Error response 

{  
"error": {  
   "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)",  
   "detail": ""  
},  
"status": "failure" 
}

CdmSharedLibraryApi - POST /sn_cdm/shared_libraries/uploads/components/file

공유 라이브러리의 구성요소 폴더 아래에 있는 CDM(구성 데이터 모델)의 일부로 파일을 업로드합니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}shared_libraries/uploads/components/file

기본 URL: /api/sn_cdm/shared_libraries/uploads/components/file

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 37. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 38. 쿼리 매개변수

자동 커밋	매개변수에서 changesetNumber 식별된 변경 세트가 업로드 후 데이터 모델에 커밋되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 업로드 후 변경 세트가 커밋됩니다. false: 업로드 후 변경 세트가 커밋되지 않습니다. 데이터 유형: 부울 기본값: false
자동 확인	커밋 시 생성된 스냅샷이 확인되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 스냅샷의 유효성을 확인합니다. false: 스냅샷을 확인하지 않습니다. 주: 이 옵션은 매개변수가 autoCommit true인 경우에만 사용할 수 있습니다`.` 데이터 유형: 부울 기본값: false
changesetNumber	Chset-102와 연결된 애플리케이션과 연결된 변경 세트 를 고유하게 식별하는 문자열입니다. 이 변경 세트는 "오픈" 상태여야 합니다. 데이터 유형: 문자열 기본값: 사용할 변경 세트를 생성합니다. 변경 세트 상세 정보는 결과의 일부로 반환됩니다.CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} 테이블: CDM 변경 세트 [sn_cdm_changeset]
fileName	업로드할 파일의 이름입니다. 이 이름은 실제 파일 이름과 다를 수 있으며 파일 확장자를 포함합니다. 예: .txt/.scv/.jar. fileName 값은 파일을 다운로드할 때 적용됩니다. 데이터 유형: 문자열
file노드 이름	파일 노드의 이름입니다. 이 파일 이름은 데이터를 익스포트할 때 구성 데이터에 사용됩니다. 이 이름에는 파일 확장자가 필요하지 않으며 다운로드에도 영향을 주지 않습니다. 데이터 유형: 문자열
namePath	구성 데이터를 업로드해야 하는 대상 노드의 경로입니다. 이 경로는 구성 요소, 컬렉션 또는 배포 가능 폴더(호출 중인 엔드포인트에 따라 다름)를 기준으로 합니다. 다음 형식으로 이름 경로를 전달할 수 있습니다. 예를 들어 `testApp/deployables/Development1/cdi1` 노드의 이름 경로를 정의하려면 다음을 수행합니다. 백슬래시 형식: testApp/deployables/Development1/cdi1 주: 노드 이름에 백슬래시("/")가 포함된 경우 이 형식을 사용할 수 없습니다. 대체 문자가 있는 백엔드 이름 경로: testApp 배포 가능 항목 개발1 cdi1 배열: ['testApp','배포 가능 항목','Development1','cdi1'] 주: 지정된 구성요소가 지정된 경로에 없으면 시스템은 자동으로 지정된 경로에 구성요소를 생성한 다음 데이터를 업로드합니다. 데이터 유형: 문자열
sharedLibraryName	필수 삭제할 구성요소가 있는 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 [sn_cdm_application]

표 39. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
변수 업로드 데이터	업로드할 구성 데이터입니다. 기본적으로 업로드할 파일 크기는 5MB로 제한됩니다. 업로드 파일 크기와 유형을 조정하는 방법에 대한 자세한 내용은 다음을 참조하십시오 Now Support 문서. 데이터 유형: 문자열/스트림

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 40. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json
콘텐츠-형식	업로드할 파일의 콘텐츠 유형입니다. 예: application/zip, text/plain, application/json.

표 41. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 42. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청. 업로드 요청이 거부되었습니다. 가능한 문제: 구성 페이로드의 크기는 허용되는 최대값인 기본적으로 2MB보다 큽니다. 호출에서 필수 매개변수가 누락되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수(JSON 또는 XML)


이름	설명
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열
upload_id	업로드 요청의 Sys_id입니다. 이 ID를 사용하여 엔드포인트를 CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} 호출하여 업로드 상태를 가져옵니다. 데이터 유형: 문자열

cURL 요청

다음 호출은 일반 텍스트 파일을 공유 라이브러리의 구성 요소 폴더에 업로드하는 방법을 보여 줍니다.

curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/uploads/components/file?autoValidate=true&sharedLibraryName=sharedLibA &namePath=testComponent%2FfilesFolder&fileName=testFileNodeName.txt&publishOption=publish_valid&changesetNumber=Chset-108&autoCommit=true&fileNodeName=testFile.txt" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "This is sample content that will be uploaded to a plain text file."\ 
--user 'username':'password'

다음 반환 결과에는 이 요청에 대한 성공 및 오류 응답이 모두 표시됩니다.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Could not find active application with name: ‘testApp’ of type application", 
    "detail": "" 
  },
  "status": "failure"
}

CdmSharedLibraryApi - PUT /sn_cdm/shared_libraries

공유 라이브러리 정보를 업데이트합니다. 이 엔드포인트를 사용하여 공유 라이브러리의 이름, 설명, 상태 및 라이브러리에 액세스할 수 있는 사용자 그룹을 업데이트할 수 있습니다.

이 엔드포인트에 액세스하려면 CDM 관리자 역할이 필요합니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries

기본 URL: /api/sn_cdm/shared_libraries

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 43. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 44. 쿼리 매개변수
이름	설명
이름	필수 업데이트할 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 [sn_cdm_application]
newAvailableState	공유 라이브러리의 상태를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 공유 라이브러리가 활성 상태입니다. false: 공유 라이브러리가 비활성 상태입니다. 어떤 사용자도 이 라이브러리에 접근할 수 없습니다. 기본값: true
newDescription	공유 라이브러리에 대한 업데이트된 설명입니다. 데이터 유형: 문자열
새 이름	공유 라이브러리의 새 이름입니다. 데이터 유형: 문자열
newUserGroupIds	연결된 공유 라이브러리에 접근할 수 있는 사용자 그룹 sys_ids의 쉼표로 구분된 목록입니다. 데이터 유형: 문자열 테이블: 그룹 [sys_user_group]
returnFields	응답의 일부로 반환할 CDM 애플리케이션 [sn_cdm_application] 테이블의 쉼표로 구분된 필드 목록입니다. 데이터 유형: 문자열 기본값: 모든 비시스템 필드가 반환됩니다.

표 45. 요청 본문 매개변수
이름	설명
안 함

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 46. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 47. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 48. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
<필드>	요청된 필드. 데이터 유형: 변수 테이블: CDM 애플리케이션 [sn_cdm_application]
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 코드 예제에서는 공유 라이브러리 Java11Lib에 대해 이 엔드포인트를 호출하고 라이브러리 이름 및 설명을 업데이트하는 방법을 보여 줍니다.

curl "http://instance.servicenow.com/sn_cdm/shared_libraries?name=' javalib'&newName=’NewLibraryName’&newDescription=’new%20description%20of%20library’\ 
--request PUT\ 
--header "Accept:application/json" \ 
--user 'username':'password'

응답:

{
  "result": {
    "sdlc_component": null,
    "cdi_count": "0",
    "available": true,
    "description": "Set new description",
    "managed_by_group": null,
    "sys_updated_on": "2023-01-18 11:51:14",
    "type": "shared_library",
    "node": {
      "value": "021635dc77a4a1109ac0cf0bbb5a9952",
      "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node/021635dc77a4a1109ac0cf0bbb5a9952"
    },
    "sys_id": "185235dc77a4a1109ac0cf0bbb5a994e",
    "sys_updated_by": "admin",
    "node_main": {
      "value": "1852b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node_main/1852b15877a4a1109ac0cf0bbb5a99aa"
    },
    "sys_created_on": "2023-01-18 11:34:43",
    "cdi_usage": "0",
    "name": "LibraryA",
    "last_committed_changeset": {
      "value": "4a1635dc77a4a1109ac0cf0bbb5a9951",
      "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_changeset/4a1635dc77a4a1109ac0cf0bbb5a9951"
    },
    "state": "active",
    "sys_created_by": "admin"
  }
}

CdmSharedLibraryApi - PUT /sn_cdm/shared_libraries/components

지정된 공유 구성요소의 이름과 설명을 업데이트합니다.

이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.

주:

이름 변경은 구성요소의 스냅샷을 임포트하지 않은 경우와 같이 구성요소가 사용된 적이 없는 경우에만 허용됩니다. 이름 바꾸기 시나리오는 주로 새 구성요소를 만들 때 오타를 수정하기 위한 것입니다.

URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/shared_libraries/components

기본 URL: /api/sn_cdm/shared_libraries/components

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 49. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 50. 쿼리 매개변수
이름	설명
changesetNumber	필수 연결된 변경 세트의 이름입니다. 데이터 유형: 문자열 테이블:CDM 변경 세트 [sn_cdm_changeset]
이름	필수 업데이트할 공유 구성요소의 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 [sn_cdm_shared_component]
새 이름	필수 공유 구성요소의 업데이트된 이름입니다. 데이터 유형: 문자열
newDescription	공유 구성요소에 대한 설명을 업데이트했습니다. 데이터 유형: 문자열 기본값: 비어 있음
returnFields	응답의 일부로 반환할 CDM 공유 구성요소 [sn_cdm_shared_component] 테이블의 쉼표로 구분된 필드 목록입니다. 데이터 유형: 문자열 기본값: 모든 비시스템 필드가 반환됩니다.

표 51. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
안 함

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 52. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. 지원되는 유형: application/json application/xml text/xml 기본값: application/json

표 53. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 54. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
400	잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수


이름	설명
<필드>	CDM 공유 구성요소 [sn_cdm_shared_component] 테이블에서 요청한 필드입니다. 데이터 유형: 변수
오류	처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 `"error": { "detail": "String", "message": "String" }`
오류.상세 정보	오류에 대한 추가 정보입니다. 데이터 유형: 문자열
오류.메시지	요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열
상태	요청의 오류 상태입니다. 가능한 값: 실패 데이터 유형: 문자열

cURL 요청

다음 코드 샘플은 구성요소 SharedComponentTest의 설명을 업데이트하는 방법을 보여줍니다.

curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components/?sharedLibraryName=javalib&changeSetNumber='chset-9'&name='SharedComponentTest'&newDescription='The shared component description'\  
--request POST\  
--header "Accept:application/json" \  
--user 'username':'password

응답:

{
  "result": {
    "changeset_id": {
      "value": "5c33311077e4a1109ac0cf0bbb5a9902",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/5c33311077e4a1109ac0cf0bbb5a9902"
    },
    "node_path": "!(1!(2!(3",
    "description": "Changing the description only",
    "sys_updated_on": "2023-01-18 12:09:05",
    "type": "sn_cdm_node_shared_component",
    "sys_class_name": "sn_cdm_node",
    "sys_id": "9953f99077a4a1109ac0cf0bbb5a99ec",
    "sys_updated_by": "admin",
    "previous_version": null,
    "sys_created_on": "2023-01-18 11:39:09",
    "value": null,
    "effective_from": null,
    "linked_to": null,
    "sys_created_by": "admin",
    "restricted_to": null,
    "linked_to_version": null,
    "level": "2",
    "conflict_type": null,
    "main_id": "183",
    "effective_to": null,
    "secure_value": null,
    "node_classifier": "/shared_library/shared_components",
    "main_id_encoded": "(3",
    "name": "sharedComponentName",
    "position": null,
    "reason_for_conflict": null,
    "system_folder": false,
    "status": "new",
    "conflict": false
  }
}