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


---

# CdmVersionApi

# CdmVersionApi {#ariaid-title1}

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

CdmVersionAPI는 공유 라이브러리 아래의 공유 구성요소에 대한 버전(스냅샷)을 구성 데이터 관리 CDM(게시 취소 및 익스포트할 수 있는 엔드포인트)을 제공합니다.
스냅샷을 익스포트할 수 있도록 게시하면 파이프라인이 CICD(지속적 통합 및 지속적 제공) 연결된 공유 구성요소 및 라이브러리에 액세스하고 사용할 수 있습니다. 익스포터는 게시된 스냅샷에서만 실행할 수 있습니다. 스냅샷이 더 이상 필요하지 않은 경우 스냅샷의 게시를 취소하여 스냅샷이 더 이상 실행 가능한지에 대한 혼동을 줄일 수 있습니다.  
이 API에 액세스하려면 다음 역할 중 하나가 있어야 합니다.

* 스크립팅된 REST CDM 뷰 ACL(sn_cdm.cdm.viewer)
* 스크립팅된 REST CDM 편집기 ACL(sn_cdm.cdm_editor)

또한 구성 데이터 관리 인스턴스에서 이 API를 사용할 수 있으려면 (CDM) 플러그인을 활성화해야 합니다.

스냅샷에 대한 자세한 내용은 [스냅샷 보기 섹션을 참조하세요.](https://www.servicenow.com/docs/access?context=cdm-snapshots-view-list&version=australia&pubname=australia-it-service-management&ft:locale=en-US)

## CdmVersionApi - GET /sn_cdm/versions/export {#ariaid-title2}

지정된 게시 버전에 대해 지정된 공유 라이브러리 내에서 지정된 공유 구성요소에 대한 구성 데이터를 반환합니다.
이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.

### URL 형식

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

기본 URL: /api/sn_cdm/versions/export  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#versions-GET-export__entry__2}{#versions-GET-export__version-not_optional-RESTAPI}

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

{#versions-GET-export__entry__6}

| 이름 | 설명 |
|-|-|
| 데이터 형식 | 필수 구성 데이터의 형식입니다. 유효한 값은 다음과 같습니다. * csv * INI * JSON * 속성 * 원시 * XML * YAML 데이터 유형: 문자열 |
| 암호 해독 | 암호화된 암호 값 또는 암호 해독된 값을 표시할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 암호를 해독하고 암호 해독된 값을 표시합니다. * 아니오: 암호화된 암호 값을 표시합니다. 기본값: false |
| sharedComponentName | 필수 익스포트할 구성 데이터의 공유 구성요소의 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 \[sn_cdm_shared_component\] |
| sharedLibraryName | 필수 반환하려는 구성 데이터의 구성요소가 들어 있는 공유 라이브러리의 이름입니다. 지정된 애플리케이션의 유형 필드가 "shared_library"로 설정되어 있어야 합니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| substitute변수 | 변수를 따를지 여부를 나타내는 플래그입니다. 변수 추적에 대한 자세한 내용은 [구성 데이터 유효성 검사 및 수정을](https://www.servicenow.com/docs/access?context=cdm-validating-cfg-data&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하십시오. 유효한 값은 다음과 같습니다. * true: 변수를 따릅니다. * false: 변수를 따르지 않습니다. 기본값: true |
[표 2. 쿼리 매개변수]

{#versions-GET-export__entry__18}

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

### 헤더

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

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

{#versions-GET-export__entry__26}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 다음 문제 중 하나가 발생했을 수 있습니다. * 공유 라이브러리가 활성 상태가 아닙니다. * 공유 구성요소가 활성화되어 있지 않습니다. * 버전이 게시되지 않았습니다. * 호출에 매개변수가 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수

{#versions-GET-export__entry__38}

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

### cURL 요청

다음 코드 예제는 "JavaLib" 공유 라이브러리에서 "jdk8" 구성 요소의 구성 데이터를 내보내는 방법을 보여줍니다.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/components/exports?sharedLibraryName=JavaLib&componentName=jdk8 
    --request POST \  
    --header "Accept:application/json" \   
    --user 'username':'password'

응답:

    {  
    "result": {  
        "sharedComponentA": { "cdi": "val" } 
     }  
    } 

## CdmVersionApi - PUT /sn_cdm/versions/publish {#ariaid-title3}

지정된 공유 라이브러리 아래에 공유 구성요소의 버전을 게시합니다.
이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.  
주:  
스냅샷과 버전은 이 구현의 의미에서 동의어입니다.

### URL 형식

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

기본 URL: /api/sn_cdm/versions/publish  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#versions-PUT-publish__entry__2}{#versions-PUT-publish__version-not_optional-RESTAPI}

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

{#versions-PUT-publish__entry__6}

| 이름 | 설명 |
|-|-|
| 이름 | 필수 게시할 공유 구성요소의 버전 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 \[sn_cdm_shared_component\] |
| returnFields | 응답의 일부로 반환할 CDM 스냅샷 \[sn_cdm_snapshot\] 테이블의 쉼표로 구분된 필드 목록입니다. 데이터 유형: 문자열 기본값: 비시스템 필드를 모두 반환합니다. |
| sharedComponentName | 필수 게시할 공유 구성요소의 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 \[sn_cdm_shared_component\] |
| sharedLibraryName | 필수 지정된 구성요소가 있는 공유 라이브러리의 이름입니다. 연결된 기록의 유형 필드를 "shared_library"로 설정해야 합니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
[표 8. 쿼리 매개변수]

{#versions-PUT-publish__entry__16}

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

### 헤더

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

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

{#versions-PUT-publish__entry__24}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 게시 중 오류가 발생했습니다. 가능한 문제: * 버전 이름을 찾을 수 없습니다. * 구성요소 버전이 이미 게시되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수

{#versions-PUT-publish__id_rtv_wbb_fwb__entry__2}

| 이름 | 설명 |
|-|-|
| cdm_application_id | 스냅샷과 연결된 CDM 애플리케이션에 대한 상세 정보입니다. 데이터 유형: 객체 "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | REST 테이블 API를 사용하여 CDM 애플리케이션 기록에 액세스하는 데 사용할 호출입니다. 데이터 유형: 문자열 |
| cdm_application_id.value | 연결된 CDM 애플리케이션 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| cdm_deployable_id | 스냅샷과 연결된 CDM 배포 가능 항목에 대한 상세 정보입니다. 데이터 유형: 객체 "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | 테이블 REST API를 사용하여 이 배포 가능 항목 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| cdm_deployable_id.value | 배포 가능 항목 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| changeset_id | 스냅샷과 연결된 변경 세트에 대한 상세 정보입니다. 데이터 유형: 객체 "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | 테이블 REST API를 사용하여 이 변경 세트 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| changeset_id.value | 변경 세트 기록의 고유 식별자입니다. 데이터 유형: 문자열 테이블: CDM 변경 세트 \[sn_cdm_changeset\] |
| 설명 | 스냅샷에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| 오류 | 처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 "error": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열 |
| last_published | 스냅샷이 마지막으로 게시된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| last_validated | 스냅샷이 마지막으로 확인된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| 이름 | 스냅샷의 이름입니다. 데이터 유형: 문자열 |
| 번호 | 스냅샷을 식별하는 고유 번호입니다. 이 값은 매핑에 대해 사용자가 읽을 수 있는 식별자를 제공합니다. 데이터 유형: 문자열 |
| 게시 날짜: | 스냅샷이 게시되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 스냅샷이 게시되었습니다. * false: 스냅샷이 게시되지 않았습니다. 데이터 유형: 부울 |
| sys_created_by | 스냅샷을 생성한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_created_on | 스냅샷이 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| sys_id | 스냅샷의 Sys_id입니다. 데이터 유형: 문자열 테이블: CDM 스냅샷 \[sn_cdm_snapshot\] |
| sys_updated_by | 스냅샷을 업데이트한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_updated_on | 스냅샷이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| 확인 | 스냅샷의 현재 확인 상태입니다. 가능한 값: * execution_error * 실패 * in_progress * not_validated * 통과함 * passed_with_exception * 요청됨 데이터 유형: 문자열 |
[ ]

{#versions-PUT-publish__id_rtv_wbb_fwb}  

### cURL 요청

이 코드 예제는 공유 구성 요소 "Development"를 버전 이름이 "Development-v1.shc"인 게시하는 방법을 보여줍니다.

    curl "http://instance.servicenow.com/api/sn_cdm/versions/publish?sharedLibraryName=LibraryJdk&componentName=Development&name=Development-v1.shc" \  
    --request PUT\  
    --header "Accept:application/json" \  
    --user 'username':'password

응답:

    {
      "result": {
        "changeset_id": {
          "value": "1a2bd15c7764a1109ac0cf0bbb5a99fc",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/1a2bd15c7764a1109ac0cf0bbb5a99fc"
        },
        "cdm_deployable_id": null,
        "cdm_shared_component_node_id": {
          "value": "fe2b155c7764a1109ac0cf0bbb5a995d",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node/fe2b155c7764a1109ac0cf0bbb5a995d"
        },
        "cdm_shared_component_id": {
          "value": "362b155c7764a1109ac0cf0bbb5a9970",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_shared_component/362b155c7764a1109ac0cf0bbb5a9970"
        },
        "description": null,
        "cdm_application_id": {
          "value": "122bd15c7764a1109ac0cf0bbb5a99fa",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/122bd15c7764a1109ac0cf0bbb5a99fa"
        },
        "published": true,
        "sys_updated_on": "2023-01-18 14:15:44",
        "last_published": "2023-01-18 09:53:37",
        "sequence_number": "1",
        "number": "SNAP0001110",
        "sys_id": "df2b155c7764a1109ac0cf0bbb5a9949",
        "sys_updated_by": "admin",
        "sys_created_on": "2023-01-18 09:53:36",
        "name": "logonService-V2.1-v1.shc",
        "last_validated": "",
        "validation": "passed",
        "sys_created_by": "admin"
      }
    }

## CdmVersionApi - PUT /sn_cdm/versions/unpublish {#ariaid-title4}

지정된 공유 라이브러리에서 공유 구성요소 버전의 게시를 취소합니다.
이 엔드포인트에 액세스하려면 CDM 편집자 역할이 필요합니다.  
주:  
스냅샷과 버전은 이 구현의 의미에서 동의어입니다.

### URL 형식 {#versions-PUT-unpublish__section_pcx_3cb_fwb}

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

기본 URL: /api/sn_cdm/versions/publish  
주:  
사용 가능한 버전은 [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를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#versions-PUT-unpublish__entry__2}{#versions-PUT-unpublish__version-not_optional-RESTAPI}

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

{#versions-PUT-unpublish__entry__6}

| 이름 | 설명 |
|-|-|
| 이름 | 필수 게시를 취소할 공유 구성요소의 버전 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 \[sn_cdm_shared_component\] |
| returnFields | 응답의 일부로 반환할 CDM 스냅샷 \[sn_cdm_snapshot\] 테이블의 쉼표로 구분된 필드 목록입니다. 데이터 유형: 문자열 기본값: 비시스템 필드를 모두 반환합니다. |
| sharedComponentName | 필수 게시를 취소할 공유 구성요소의 이름입니다. 데이터 유형: 문자열 테이블: CDM 공유 구성요소 \[sn_cdm_shared_component\] |
| sharedLibraryName | 필수 지정된 구성요소가 있는 공유 라이브러리의 이름입니다. 연결된 기록의 유형 필드를 "shared_library"로 설정해야 합니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
[표 14. 쿼리 매개변수]

{#versions-PUT-unpublish__entry__16}

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

### 헤더

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

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

{#versions-PUT-unpublish__entry__24}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 게시를 취소하는 동안 오류가 발생했습니다. 가능한 문제: * 버전 이름을 찾을 수 없습니다. * 구성요소 버전이 이미 게시되었습니다. {#versions-PUT-unpublish__ul_h5h_pcb_fwb} |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수

{#versions-PUT-unpublish__id_mbl_2cb_fwb__entry__2}

| 이름 | 설명 |
|-|-|
| cdm_application_id | 스냅샷과 연결된 CDM 애플리케이션에 대한 상세 정보입니다. 데이터 유형: 객체 "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | REST 테이블 API를 사용하여 CDM 애플리케이션 기록에 액세스하는 데 사용할 호출입니다. 데이터 유형: 문자열 |
| cdm_application_id.value | 연결된 CDM 애플리케이션 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| cdm_deployable_id | 스냅샷과 연결된 CDM 배포 가능 항목에 대한 상세 정보입니다. 데이터 유형: 객체 "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | 테이블 REST API를 사용하여 이 배포 가능 항목 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| cdm_deployable_id.value | 배포 가능 항목 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| changeset_id | 스냅샷과 연결된 변경 세트에 대한 상세 정보입니다. 데이터 유형: 객체 "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | 테이블 REST API를 사용하여 이 변경 세트 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| changeset_id.value | 변경 세트 기록의 고유 식별자입니다. 데이터 유형: 문자열 테이블: CDM 변경 세트 \[sn_cdm_changeset\] |
| 설명 | 스냅샷에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| 오류 | 처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 "error": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열 |
| last_published | 스냅샷이 마지막으로 게시된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| last_validated | 스냅샷이 마지막으로 확인된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| 이름 | 스냅샷의 이름입니다. 데이터 유형: 문자열 |
| 번호 | 스냅샷을 식별하는 고유 번호입니다. 이 값은 매핑에 대해 사용자가 읽을 수 있는 식별자를 제공합니다. 데이터 유형: 문자열 |
| 게시 날짜: | 스냅샷이 게시되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 스냅샷이 게시되었습니다. * false: 스냅샷이 게시되지 않았습니다. 데이터 유형: 부울 |
| sys_created_by | 스냅샷을 생성한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_created_on | 스냅샷이 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| sys_id | 스냅샷의 Sys_id입니다. 데이터 유형: 문자열 테이블: CDM 스냅샷 \[sn_cdm_snapshot\] |
| sys_updated_by | 스냅샷을 업데이트한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_updated_on | 스냅샷이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| 확인 | 스냅샷의 현재 확인 상태입니다. 가능한 값: * execution_error * 실패 * in_progress * not_validated * 통과함 * passed_with_exception * 요청됨 데이터 유형: 문자열 |
[ ]

{#versions-PUT-unpublish__id_mbl_2cb_fwb}  

### cURL 요청

다음 코드 예제는 "OracleG-Library-10" 공유 라이브러리에서 "paymentService-V1" 공유 구성요소의 게시를 취소하는 방법을 보여줍니다.

    curl "https://instance-name.service-now.com/api/sn_cdm/versions/unpublish?sharedLibraryName=OracleG-Library-10&sharedComponentName=paymentService-V1.1&name=paymentService-V1.1-v1.shc" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

응답:

    {
      "result": {
        "changeset_id": {
          "value": "1a2bd15c7764a1109ac0cf0bbb5a99fc",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_changeset/1a2bd15c7764a1109ac0cf0bbb5a99fc"
        },
        "cdm_deployable_id": null,
        "cdm_shared_component_node_id": {
          "value": "fe2b155c7764a1109ac0cf0bbb5a995d",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node/fe2b155c7764a1109ac0cf0bbb5a995d"
        },
        "cdm_shared_component_id": {
          "value": "362b155c7764a1109ac0cf0bbb5a9970",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_shared_component/362b155c7764a1109ac0cf0bbb5a9970"
        },
        "description": null,
        "cdm_application_id": {
          "value": "122bd15c7764a1109ac0cf0bbb5a99fa",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_application/122bd15c7764a1109ac0cf0bbb5a99fa"
        },
        "published": false,
        "sys_updated_on": "2023-01-18 14:15:44",
        "last_published": "2023-01-18 09:53:37",
        "sequence_number": "1",
        "number": "SNAP0001110",
        "sys_id": "df2b155c7764a1109ac0cf0bbb5a9949",
        "sys_updated_by": "admin",
        "sys_created_on": "2023-01-18 09:53:36",
        "name": "logonService-V2.1-v1.shc",
        "last_validated": "",
        "validation": "passed",
        "sys_created_by": "admin"
      }
    }