---
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


---

# CdmSharedLibraryApi

# CdmSharedLibraryApi {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 49분

CdmSharedLibraryApi는 공유 라이브러리 및 공유 구성 요소를 만들고 관리할 수 있는 엔드포인트를 제공합니다. 또한 공유 구성요소의 구성 데이터를 업로드하고 익스포트할 수 있는 엔드포인트도 있습니다.
이 API 구성 데이터 관리 를 사용하려면 인스턴스에서 이러한 API를 사용할 수 있도록 (CDM) 플러그인을 활성화해야 합니다. 또한 이 API에 액세스하려면 다음 역할 중 하나가 있어야 합니다.

* CDM 편집자 역할
* CDM 관리자 역할

공유 라이브러리 및 공유 구성요소에 대한 자세한 내용은 [애플리케이션 간 구성요소 공유 - 구성요소 라이브러리를](https://www.servicenow.com/docs/access?context=cdm-component-libraries&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하십시오.

## CdmSharedLibraryApi - 삭제 /sn_cdm/shared_libraries {#ariaid-title2}

지정된 이름의 공유 라이브러리를 삭제합니다.
이 엔드포인트에 액세스하려면 CDM 관리자 역할이 필요합니다.

### URL 형식 {#sl-DELETE-shared_libs__section_evn_zmx_dwb}

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

기본 URL: /api/sn_cdm/shared_libraries  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-DELETE-shared_libs__entry__2}{#sl-DELETE-shared_libs__version-not_optional-RESTAPI}

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

{#sl-DELETE-shared_libs__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 2. 쿼리 매개변수]

{#sl-DELETE-shared_libs__entry__10}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-DELETE-shared_libs__entry__14}{#sl-DELETE-shared_libs__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-DELETE-shared_libs__entry__18}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-DELETE-shared_libs__entry__22}{#sl-DELETE-shared_libs__entry-200-status-code}{#sl-DELETE-shared_libs__entry-400-status-code}{#sl-DELETE-shared_libs__entry-500-status-code}

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

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

{#sl-DELETE-shared_libs__entry__30}

| 이름 | 설명 |
|-|-|
| 오류 | 처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 "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 {#ariaid-title3}

지정된 라이브러리에서 지정된 공유 구성요소를 삭제합니다.
이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.  
주:  
현재 사용 중이 아닌 구성요소만 삭제할 수 있습니다. 또한 연결된 공유 라이브러리가 활성화되어 있지 않으면 구성요소를 삭제할 수 없습니다.

### URL 형식

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

기본 URL: /api/sn_cdm/shared_libraries/components  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-DELETE-shared_libs-comps__entry__2}{#sl-DELETE-shared_libs-comps__version-not_optional-RESTAPI}

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

{#sl-DELETE-shared_libs-comps__entry__6}

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

{#sl-DELETE-shared_libs-comps__entry__14}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-DELETE-shared_libs-comps__entry__18}{#sl-DELETE-shared_libs-comps__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-DELETE-shared_libs-comps__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-DELETE-shared_libs-comps__entry__26}{#sl-DELETE-shared_libs-comps__entry-200-status-code}{#sl-DELETE-shared_libs-comps__entry-500-status-code}

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

### 응답 본문 매개변수

{#sl-DELETE-shared_libs-comps__entry__34}

| 이름 | 설명 |
|-|-|
| 오류 | 처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 "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} {#ariaid-title4}

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

### 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 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-GET-shared_libs-upload-status__entry__2}{#sl-GET-shared_libs-upload-status__version-not_optional-RESTAPI}

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

{#sl-GET-shared_libs-upload-status__entry__8}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 14. 쿼리 매개변수]

{#sl-GET-shared_libs-upload-status__entry__12}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-GET-shared_libs-upload-status__entry__16}{#sl-GET-shared_libs-upload-status__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-GET-shared_libs-upload-status__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-GET-shared_libs-upload-status__entry__24}{#sl-GET-shared_libs-upload-status__entry-200-status-code}{#sl-GET-shared_libs-upload-status__entry-400-status-code}{#sl-GET-shared_libs-upload-status__entry-500-status-code}

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

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

{#sl-GET-shared_libs-upload-status__entry__32}

| 이름 | 설명 |
|-|-|
| 오류 | 업로드 중 발생한 오류에 대한 설명입니다. 데이터 유형: 문자열 |
| 출력 | 업로드된 데이터에 대한 설명 또는 업로드 중에 오류가 발생한 경우 발생한 오류를 설명하는 오류 메시지입니다. 데이터 유형: 문자열 배열 "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 | 연결된 업로드 호출에 전달된 게시 옵션의 값입니다. 스냅샷 게시에 대한 자세한 내용은 [스냅샷 게시 또는 게시 취소를](https://www.servicenow.com/docs/access?context=cdm-snapshot-publish&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하세요. 데이터 유형: 문자열 |
| 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 {#ariaid-title5}

지정된 이름으로 새 공유 라이브러리를 작성합니다.
이 엔드포인트에 액세스하려면 CDM 관리자 역할이 필요합니다.

### URL 형식

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

기본 URL: /api/sn_cdm/shared_libraries  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-POST-shared_libs__entry__2}{#sl-POST-shared_libs__version-not_optional-RESTAPI}

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

{#sl-POST-shared_libs__entry__6}{#sl-POST-shared_libs__appName-userGroupIds-entry}

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

{#sl-POST-shared_libs__entry__16}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-POST-shared_libs__entry__20}{#sl-POST-shared_libs__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-POST-shared_libs__entry__24}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 23. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-POST-shared_libs__entry__28}{#sl-POST-shared_libs__entry-200-status-code}{#sl-POST-shared_libs__entry-400-status-code}{#sl-POST-shared_libs__entry-500-status-code}

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

### 응답 본문 매개변수

{#sl-POST-shared_libs__entry__36}

| 이름 | 설명 |
|-|-|
| \<필드\> | 요청된 필드. 데이터 유형: 변수 테이블: 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 {#ariaid-title6}

지정된 라이브러리 아래에 지정된 공유 구성요소를 작성합니다.
이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.

### URL 형식

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

기본 URL: /api/sn_cdm/shared_libraries/components  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-POST-shared_libs-comps__entry__2}{#sl-POST-shared_libs-comps__version-not_optional-RESTAPI}

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

{#sl-POST-shared_libs-comps__entry__6}{#sl-POST-shared_libs-comps__changesetNumber-changeset-entry}

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

{#sl-POST-shared_libs-comps__entry__18}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-POST-shared_libs-comps__entry__22}{#sl-POST-shared_libs-comps__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-POST-shared_libs-comps__entry__26}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 29. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-POST-shared_libs-comps__entry__30}{#sl-POST-shared_libs-comps__entry-200-status-code}{#sl-POST-shared_libs-comps__entry-400-status-code}{#sl-POST-shared_libs-comps__entry-500-status-code}

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

### 응답 본문 매개변수

{#sl-POST-shared_libs-comps__entry__38}{#sl-POST-shared_libs-comps__cdm_apps-error-entry}{#sl-POST-shared_libs-comps__cdm_apps-error_detail-entry}{#sl-POST-shared_libs-comps__cdm_apps-error_message-entry}

| 이름 | 설명 |
|-|-|
| \<요청된 필드\> | 요청된 필드. 데이터 유형: 다양한 테이블: 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 {#ariaid-title7}

공유 라이브러리 및 공유 구성요소를 만들고 관리할 수 있습니다. 이 엔드포인트는 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](https://servicenow-prod.fluidtopics.net/y4ZHm2_EkSo1tYef~Y0YvQ#csl-POST-shared_libs-upld-comp-file "공유 라이브러리의 구성요소 폴더 아래에 있는 CDM(구성 데이터 모델)의 일부로 파일을 업로드합니다.") 방법을 사용하여 노드를 수정합니다.

### URL 형식

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

기본 URL: /api/sn_cdm/shared_libraries/uploads/components  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-POST-shared_libs-uploads-comp__entry__2}{#sl-POST-shared_libs-uploads-comp__version-not_optional-RESTAPI}

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

{#sl-POST-shared_libs-uploads-comp__entry__6}

| 이름 | 설명 |
|-|-|
| 자동 커밋 | 매개변수에서 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"} ] 이름을 <kbd class="ph userinput">설정하면</kbd>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: 지정된 데이터 형식이 속성을 지원하는 경우 업로드 중에 입력 데이터의 모든 속성을 건너뜁니다. * 아니오: 지정된 데이터 형식이 속성을 지원하는 경우 입력 데이터의 모든 속성이 업로드에 포함됩니다. {#sl-POST-shared_libs-uploads-comp__ul_egn_4q4_1yb} 데이터 유형: 부울 기본값: false |
| namePath | 구성 데이터를 업로드해야 하는 대상 노드의 경로입니다. 이 경로는 구성 요소, 컬렉션 또는 배포 가능 폴더(호출 중인 엔드포인트에 따라 다름)를 기준으로 합니다. 다음 형식으로 이름 경로를 전달할 수 있습니다. 예를 들어 `testApp/deployables/Development1/cdi1` 노드의 이름 경로를 정의하려면 다음을 수행합니다. * 백슬래시 형식: testApp/deployables/Development1/cdi1 주: 노드 이름에 백슬래시("/")가 포함된 경우 이 형식을 사용할 수 없습니다. * 대체 문자가 있는 백엔드 이름 경로: testApp 배포 가능 항목 개발1 cdi1 * 배열: \['testApp','배포 가능 항목','Development1','cdi1'\] {#sl-POST-shared_libs-uploads-comp__cdm_apps-namePath-ul} 주: 지정된 구성요소가 지정된 경로에 없으면 시스템은 자동으로 지정된 경로에 구성요소를 생성한 다음 데이터를 업로드합니다. 데이터 유형: 문자열 |
| 게시 옵션 | 연결된 구성된 스냅샷에 대한 게시 옵션입니다. 유효한 값은 다음과 같습니다. * publish_new_and_unpublish_old: 커밋 후 생성된 새 스냅샷을 게시하고 기존 스냅샷의 게시를 취소합니다. * publish_none: 스냅샷을 게시하지 않습니다. 스냅샷 게시에 대한 자세한 내용은 [스냅샷 게시 또는 게시 취소를](https://www.servicenow.com/docs/access?context=cdm-snapshot-publish&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하세요. 데이터 유형: 문자열 기본값: publish_none |
| sharedLibraryName | 필수 작성하거나 관리할 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
[표 32. 쿼리 매개변수]

{#sl-POST-shared_libs-uploads-comp__entry__28}{#sl-POST-shared_libs-uploads-comp__cdm_apps-var_up_data-entry}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-POST-shared_libs-uploads-comp__id_fyp_pmb_fwb__entry__2}{#sl-POST-shared_libs-uploads-comp__accept-JSON-only-entry-RESTAPI}

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

{#sl-POST-shared_libs-uploads-comp__id_fyp_pmb_fwb} {#sl-POST-shared_libs-uploads-comp__entry__38}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 35. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-POST-shared_libs-uploads-comp__entry__42}{#sl-POST-shared_libs-uploads-comp__entry-200-status-code}{#sl-POST-shared_libs-uploads-comp__entry-500-status-code}

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

### 응답 본문 매개변수

{#sl-POST-shared_libs-uploads-comp__entry__50}

| 이름 | 설명 |
|-|-|
| 오류 | 처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 "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 {#ariaid-title8}

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

### URL 형식 {#csl-POST-shared_libs-upld-comp-file__section_abk_fyr_byb}

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

기본 URL: /api/sn_cdm/shared_libraries/uploads/components/file  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#csl-POST-shared_libs-upld-comp-file__entry__2}{#csl-POST-shared_libs-upld-comp-file__version-not_optional-RESTAPI}

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

{#csl-POST-shared_libs-upld-comp-file__table_hxt_rmm_2yb__entry__2}

|   |   |
|-|-|
| 자동 커밋 | 매개변수에서 changesetNumber 식별된 변경 세트가 업로드 후 데이터 모델에 커밋되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 업로드 후 변경 세트가 커밋됩니다. * false: 업로드 후 변경 세트가 커밋되지 않습니다. 데이터 유형: 부울 기본값: false |
| 자동 확인 | 커밋 시 생성된 스냅샷이 확인되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 스냅샷의 유효성을 확인합니다. * false: 스냅샷을 확인하지 않습니다. 주: 이 옵션은 매개변수가 autoCommit true인 경우에만 사용할 수 있습니다<kbd class="ph userinput">.</kbd> 데이터 유형: 부울 기본값: false |
| changesetNumber | Chset-102와 연결된 애플리케이션과 연결된 [변경 세트](https://www.servicenow.com/docs/access?context=cdm-changesets-version-control&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 를 고유하게 식별하는 문자열입니다. 이 변경 세트는 "오픈" 상태여야 합니다. 데이터 유형: 문자열 기본값: 사용할 변경 세트를 생성합니다. 변경 세트 상세 정보는 결과의 일부로 반환됩니다.[CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}](https://servicenow-prod.fluidtopics.net/mxhKTmPcbYyZwCp9noBFbA#apps-GET-upload-status "지정된 구성 데이터 업로드 요청의 현재 상태를 반환합니다.") 테이블: 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'\] {#csl-POST-shared_libs-upld-comp-file__cdm_apps-namePath-ul} 주: 지정된 구성요소가 지정된 경로에 없으면 시스템은 자동으로 지정된 경로에 구성요소를 생성한 다음 데이터를 업로드합니다. 데이터 유형: 문자열 |
| sharedLibraryName | 필수 삭제할 구성요소가 있는 공유 라이브러리의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
[표 38. 쿼리 매개변수]

{#csl-POST-shared_libs-upld-comp-file__table_hxt_rmm_2yb} {#csl-POST-shared_libs-upld-comp-file__table_j22_fgm_2yb__entry__2}

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

{#csl-POST-shared_libs-upld-comp-file__table_j22_fgm_2yb}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#csl-POST-shared_libs-upld-comp-file__entry__26}{#csl-POST-shared_libs-upld-comp-file__accept-RESTAPI}

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

{#csl-POST-shared_libs-upld-comp-file__entry__32}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 41. 응답 헤더]

### 상태 코드 {#csl-POST-shared_libs-upld-comp-file__section_mtw_2vr_byb}

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#csl-POST-shared_libs-upld-comp-file__id_cdq_fft_byb__entry__2}{#csl-POST-shared_libs-upld-comp-file__entry-200-status-code}{#csl-POST-shared_libs-upld-comp-file__entry-500-status-code}

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

{#csl-POST-shared_libs-upld-comp-file__id_cdq_fft_byb}

### 응답 본문 매개변수(JSON 또는 XML) {#csl-POST-shared_libs-upld-comp-file__section_sbq_2bx_1yb}

{#csl-POST-shared_libs-upld-comp-file__id_af3_kft_byb__entry__2}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error_detail-row}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error_messaage-row}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error_status-row}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-upload_id-row}

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

{#csl-POST-shared_libs-upld-comp-file__id_af3_kft_byb}  

### 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 {#ariaid-title9}

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

### URL 형식 {#sl-PUT-shared_libs__section_thy_4hj_dwb}

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

기본 URL: /api/sn_cdm/shared_libraries  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-PUT-shared_libs__entry__2}{#sl-PUT-shared_libs__version-not_optional-RESTAPI}

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

{#sl-PUT-shared_libs__entry__6}

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

{#sl-PUT-shared_libs__entry__20}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-PUT-shared_libs__entry__24}{#sl-PUT-shared_libs__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-PUT-shared_libs__entry__28}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 47. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-PUT-shared_libs__entry__32}{#sl-PUT-shared_libs__entry-200-status-code}{#sl-PUT-shared_libs__entry-400-status-code}{#sl-PUT-shared_libs__entry-500-status-code}

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

### 응답 본문 매개변수

{#sl-PUT-shared_libs__entry__40}

| 이름 | 설명 |
|-|-|
| \<필드\> | 요청된 필드. 데이터 유형: 변수 테이블: 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 {#ariaid-title10}

지정된 공유 구성요소의 이름과 설명을 업데이트합니다.
이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.  
주:  
이름 변경은 구성요소의 스냅샷을 임포트하지 않은 경우와 같이 구성요소가 사용된 적이 없는 경우에만 허용됩니다. 이름 바꾸기 시나리오는 주로 새 구성요소를 만들 때 오타를 수정하기 위한 것입니다.

### URL 형식 {#sl-PUT-shared_libs-comps__section_nff_yxj_dwb}

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

기본 URL: /api/sn_cdm/shared_libraries/components  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#sl-PUT-shared_libs-comps__entry__2}{#sl-PUT-shared_libs-comps__version-not_optional-RESTAPI}

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

{#sl-PUT-shared_libs-comps__entry__6}

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

{#sl-PUT-shared_libs-comps__entry__18}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-PUT-shared_libs-comps__entry__22}{#sl-PUT-shared_libs-comps__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-PUT-shared_libs-comps__entry__26}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 53. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sl-PUT-shared_libs-comps__entry__30}{#sl-PUT-shared_libs-comps__entry-200-status-code}{#sl-PUT-shared_libs-comps__entry-400-status-code}{#sl-PUT-shared_libs-comps__entry-500-status-code}

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

### 응답 본문 매개변수

{#sl-PUT-shared_libs-comps__entry__38}

| 이름 | 설명 |
|-|-|
| \<필드\> | 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
      }
    }