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


---

# CdmPoliciesApi

# CdmPoliciesApi {#ariaid-title1}

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

CdmPoliciesAPI는 CDM(배포 구성 데이터 관리 가능 항목)의 정책 매핑을 관리할 수 있는 엔드포인트를 제공합니다. 배포 가능 항목에 올바르게 매핑된 정책은 배포 가능 항목의 스냅샷이 확인될 때 실행됩니다.  
이 API의 엔드포인트에 액세스하려면 다음 역할 중 하나가 있어야 합니다.

* 스크립팅된 REST CDM 뷰 ACL
* 스크립팅된 REST CDM 관리자 ACL

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

정책 매핑에 대한 자세한 내용은 [배포 가능 항목에 정책 매핑](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US)을 참조하세요.

## CdmPoliciesApi - DELETE /sn_cdm/policies/mappings {#ariaid-title2}

배포 가능 항목에 대한 지정된 정책의 매핑을 삭제합니다.
이 엔드포인트의 호출자에게 CDM 관리자 역할이 있어야 합니다.

### URL 형식

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

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

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

{#policies-DELETE-mappings__entry__2}{#policies-DELETE-mappings__version-not_optional-RESTAPI}

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

{#policies-DELETE-mappings__entry__6}{#policies-DELETE-mappings__appName-policy-entry}{#policies-DELETE-mappings__deployableName-policy-entry}{#policies-DELETE-mappings__policyName-policy-entry}

| 이름 | 설명 |
|-|-|
| appName | 필수 정책에 대한 매핑을 제거할 CDM(CDM) 애플리케이션의 구성 데이터 관리 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| deployableName | 필수 정책에 대한 매핑을 제거할 CDM 배포 가능 항목의 이름입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| policyName | 필수 연결된 정책의 이름입니다. 데이터 유형: 문자열 테이블: 정책 \[sn_pace_policy\] |
[표 2. 쿼리 매개변수]

{#policies-DELETE-mappings__entry__14}

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

### 헤더

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

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

{#policies-DELETE-mappings__entry__22}

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

### 상태 코드

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

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

### 응답 본문 매개변수

{#policies-DELETE-mappings__entry__34}

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

### cURL 요청

다음 코드 예제에서는 정책 매핑을 제거하는 방법을 보여 줍니다.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings?deployableName=Development_1&policyName=testALPolicy1&appName=testApp" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

매핑이 성공적으로 삭제되면 HTTP 상태 코드 외에는 응답이 반환되지 않습니다.

    None - results defined by the HTTP status code

## CdmPoliciesApi - GET /sn_cdm/policies/mappings/inputs/resolved {#ariaid-title3}

배포 가능 항목의 지정된 정책 매핑에 대해 확인된 입력을 반환합니다.
정책 매핑에 대한 자세한 내용은 [배포 가능 항목에 정책 매핑](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 및 [구성 데이터 유효성 검사 및 수정](https://www.servicenow.com/docs/access?context=cdm-validating-cfg-data&version=australia&pubname=australia-it-service-management&ft:locale=en-US)을 참조하세요.

이 엔드포인트의 호출자에게 CDM 뷰어 역할이 있어야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/policies/mappings/inputs/resolved

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

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

{#policies-GET-map-input-resolved__entry__2}{#policies-GET-map-input-resolved__version-not_optional-RESTAPI}

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

{#policies-GET-map-input-resolved__entry__6}{#policies-GET-map-input-resolved__appName-policy-row}{#policies-GET-map-input-resolved__deployableName-policy-row}{#policies-GET-map-input-resolved__policyName-policy-entry}

| 이름 | 설명 |
|-|-|
| appName | 필수 해결된 정책 입력을 반환할 배포 가능 항목과 연결된 CDM(애플리케이션)의 이름 구성 데이터 관리 입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| deployableName | 필수 해결된 정책을 반환할 CDM 배포 가능 항목의 이름입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| policyName | 필수 연결된 정책의 이름입니다. 데이터 유형: 문자열 테이블: 정책 \[sn_pace_policy\] |
[표 8. 쿼리 매개변수]

{#policies-GET-map-input-resolved__entry__14}

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

### 헤더

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

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

{#policies-GET-map-input-resolved__entry__22}

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

### 상태 코드

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

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

### 응답 본문 매개변수

{#policies-GET-map-input-resolved__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 정책 매핑에 대해 해결된 모든 입력의 이름-값 쌍 목록입니다. 예: `{"input_name": "user_1", "input_password": "" }` 데이터 유형: 객체 |
[ ]

### cURL 요청

다음 예제에서는 이 엔드포인트를 사용하여 해결된 정책 입력을 얻는 방법을 보여줍니다.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs/resolved?policyName=testALPolicy1&deployableName=Development_1&appName=testApp" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

반환 결과:

    { 
      "result": { 
        "key1": "someVal", 
        "additionalDeployablesInput": "[{\"id\":\"e7e34a531b501110636e0fe0604bcba9\",\"label\":\"testApp-Development_2\"}]" 
      } 
    }

## CdmPoliciesApi - POST /sn_cdm/policies/mappings {#ariaid-title4}

지정된 정책을 배포 가능 항목에 매핑합니다.
이 엔드포인트의 호출자에게 CDM 관리자 역할이 있어야 합니다.

### URL 형식

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

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

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

{#policies-POST-mappings__entry__2}{#policies-POST-mappings__version-not_optional-RESTAPI}

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

{#policies-POST-mappings__id_ds3_yyg_15b__entry__2}{#policies-POST-mappings__appName-policy-entry}{#policies-POST-mappings__deployableName-policy-entry}{#policies-POST-mappings__policyName-policy-entry}{#policies-POST-mappings__cdm_apps-returnFields-entry}

| 이름 | 설명 |
|-|-|
| appName | 필수 정책을 매핑할 CDM(CDM) 애플리케이션의 구성 데이터 관리 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| deployableName | 필수 정책을 매핑할 CDM 배포 가능 항목의 이름입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| policyName | 필수 연결된 정책의 이름입니다. 데이터 유형: 문자열 테이블: 정책 \[sn_pace_policy\] |
| returnFields | 응답의 일부로 반환할 필드 목록입니다. sys_id, sys_updated_by 또는 상태와 같은 기록 열 이름을 전달합니다. 데이터 유형: 배열 기본값: 엔드포인트에서 결정한 모든 필드 |
[표 14. 쿼리 매개변수]

{#policies-POST-mappings__id_ds3_yyg_15b} {#policies-POST-mappings__entry__16}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 16. 요청 헤더]

{#policies-POST-mappings__entry__26}

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

### 상태 코드

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

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

### 응답 본문 매개변수

{#policies-POST-mappings__id_b5l_rbh_15b__entry__2}{#policies-POST-mappings__sys_created_by-policies-entry}{#policies-POST-mappings__sys_created_onpolicies-entry}{#policies-POST-mappings__sys_id-policies-entry}{#policies-POST-mappings__sys_updated_by-policies-entry}{#policies-POST-mappings__sys_updated_on-policies-entry}

| 이름 | 설명 |
|-|-|
| 설명 | 매핑에 대한 설명입니다. 데이터 유형: 문자열 |
| 문서 | 문서의 Sys_id입니다. 데이터 유형: 문자열 |
| document_ref | 노드와 연결된 document_ref 기록의 상세 정보입니다. 데이터 유형: 객체 "document_ref": { "link": "String", "value": "String" } |
| document_ref.link | 테이블 REST API를 사용하여 정책에 매핑된 배포 가능 항목 기록을 쿼리하기 위한 호출 구문입니다. PaCE 는 이 필드를 사용하여 정책에 매핑되는 배포 가능 항목에 대한 참조를 저장합니다. 데이터 유형: 문자열 |
| document_ref.sys_id | 정책에 매핑된 배포 가능 항목 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 오류 | 처리 중에 오류가 발생한 경우 오류에 대한 상세 정보입니다. 데이터 유형: 객체 "error": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 오류에 대한 추가 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청을 처리하는 동안 생성된 오류 메시지입니다. 데이터 유형: 문자열 |
| 예외 | 매핑을 수행하는 동안 예외가 발생하면 예외 기록에 대한 링크입니다. 데이터 유형: 문자열 |
| exception_allowed | 정책에 예외가 허용되는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 예외가 허용됩니다. * false: 예외가 허용되지 않습니다. 데이터 유형: 부울 |
| input_status | 입력의 상태입니다. 가능한 값: * 잘못됨 * 유효함 데이터 유형: 문자열 |
| last_updated_by | 정책 매핑을 마지막으로 업데이트한 사용자의 세부 정보입니다. 데이터 유형: 객체 "last_updated_by": { "link": "String", "value": "String" } |
| last_updated_by.link | 테이블 REST API를 사용하여 사용자 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| last_updated_by.sys_id | 사용자 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| 번호 | 매핑을 식별하는 고유 번호입니다. 이 값은 매핑에 대해 사용자가 읽을 수 있는 식별자를 제공합니다. 데이터 유형: 문자열 |
| 정책 | 매핑과 관련된 정책 기록의 상세 정보입니다. 데이터 유형: 객체 "policy": { "link": "String", "value": "String" } |
| policy.link | 테이블 REST API를 사용하여 정책에 매핑된 정책 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| policy.sys_id | 정책 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 정책 \[sn_pace_policy\] |
| 이유 | 현재 상태의 원인에 대한 설명입니다. 데이터 유형: 문자열 |
| 상태 | 매핑의 현재 상태입니다. 가능한 값: * 활성 * 비활성 데이터 유형: 문자열 |
| sys_class_name | 정책 매핑의 테이블 이름입니다. 데이터 유형: 문자열 |
| sys_created_by | 매핑을 생성한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_created_on | 매핑이 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| sys_id | 매핑의 Sys_id입니다. 데이터 유형: 문자열 테이블: 정책 매핑 \[sn_pace_policy_mapping\] |
| sys_updated_by | 매핑을 업데이트한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_updated_on | 매핑이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
[ ]

{#policies-POST-mappings__id_b5l_rbh_15b}  

### cURL 요청

이 코드 예제에서는 특정 정책을 배포 가능 항목에 매핑하는 방법을 보여 줍니다.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings?appName=testApp&deployableName=Development_1&policyName=testALPolicy1" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

반환 결과:

    { 
      "result": { 
        "exception": null, 
        "reason": null, 
        "exception_allowed": "--", 
        "document": "0be34a531b501110636e0fe0604bcb21", 
        "input_status": "valid", 
        "description": null, 
        "sys_updated_on": "2022-06-30 14:07:37", 
        "sys_class_name": "sn_cdm_pace_policy_mapping", 
        "sys_id": "ea24469f1b101110636e0fe0604bcbed", 
        "number": "MAP0001001", 
        "last_updated_by": { 
          "value": "48630e131b501110636e0fe0604bcb53", 
          "link": "https://instance.servicenow.com/api/now/table/sys_user/48630e131b501110636e0fe0604bcb53" 
        }, 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-30 14:07:37", 
        "document_ref": { 
          "value": "0be34a531b501110636e0fe0604bcb21", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_deployable/0be34a531b501110636e0fe0604bcb21" 
        }, 
        "state": "active", 
        "sys_created_by": "admin", 
        "policy": { 
          "value": "12a3c2531b501110636e0fe0604bcb9b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_pace_policy/12a3c2531b501110636e0fe0604bcb9b" 
        } 
      } 
    }

## CdmPoliciesApi - PUT /sn_cdm/policies/mappings/inputs/additional-deployables {#ariaid-title5}

(CDM) 정책 매핑의 additionalDeployablesInput 입력 변수를 구성 데이터 관리 업데이트합니다.
additionalDeployablesInput 입력 변수에는 기존 정책 매핑에 할당할 수 있는 추가 배포 가능 항목이 포함되어 있습니다. 입력 매핑과 유사하지만 특정 배열 구조를 가지고 있습니다.

정책 매핑에 대한 자세한 내용은 [배포 가능 항목에 정책 매핑](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US)을 참조하세요.

이 엔드포인트의 호출자에게 CDM 관리자 역할이 있어야 합니다.

### URL 형식

버전 관리된 URL: /api/sn_cdm/{api_version}/policies/mappings/inputs/additional-deployables

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

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

{#policies-PUT-map-input-add-deploy__entry__2}{#policies-PUT-map-input-add-deploy__version-not_optional-RESTAPI}

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

{#policies-PUT-map-input-add-deploy__entry__6}{#policies-PUT-map-input-add-deploy__appName-policy-row}{#policies-PUT-map-input-add-deploy__deployableName-policy-row}{#policies-PUT-map-input-add-deploy__policyName-policy-entry}{#policies-PUT-map-input-add-deploy__cdm_apps-returnFields-entry}

| 이름 | 설명 |
|-|-|
| additionalDeployables | 필수 additionalDeployablesInput 입력 변수에 추가할 배포 가능 항목 목록입니다. 데이터 유형: 객체 배열 "additionalDeployables": [ { "appName": "String", "deployableName": "String" } ] |
| additionalDeployables.appName | 필수 배포 가능 항목이 연결된 CDM 애플리케이션의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| additionalDeployables.deployableName | 필수 additionalDeployablesInput 입력 변수에 추가할 CDM 배포 가능 항목의 이름입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| appName | 필수 additionalDeployablesInput 입력 변수를 업데이트할 CDM 애플리케이션의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| deployableName | 필수 additionalDeployablesInput 입력 변수를 업데이트할 CDM 배포 가능 항목의 이름입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| policyName | 필수 연결된 정책의 이름입니다. 데이터 유형: 문자열 테이블: 정책 \[sn_pace_policy\] |
| returnFields | 응답의 일부로 반환할 필드 목록입니다. sys_id, sys_updated_by 또는 상태와 같은 기록 열 이름을 전달합니다. 데이터 유형: 배열 기본값: 엔드포인트에서 결정한 모든 필드 |
[표 20. 쿼리 매개변수]

{#policies-PUT-map-input-add-deploy__entry__22}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 22. 요청 헤더]

{#policies-PUT-map-input-add-deploy__entry__32}

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

### 상태 코드

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

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

### 응답 본문 매개변수

{#policies-PUT-map-input-add-deploy__id_jx1_px2_c5b__entry__2}

| 이름 | 설명 |
|-|-|
| io_definition | 연결된 PaCE IO 정의 기록에 대한 상세 정보입니다. 에 대한 PaCE자세한 내용은 다음 문서를 참조하십시오 [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). 데이터 유형: 객체 "io_definition": { "link": "String", "value": "String" } |
| io_definition.link | 테이블 REST API를 사용하여 이 PaCE IO 정의 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| io_definition.value | IO 정의 기록의 PaCE Sys_id입니다. 데이터 유형: 문자열 테이블: IO 매핑 \[sn_pace_io_mapping\] |
| is_unused | 매핑 입력 변수가 사용되지 않았는지 여부를 나타내는 플래그입니다. 가능한 값: * 예: 연결된 매핑 입력 변수가 현재 사용되지 않습니다. * 아니오: 연결된 매핑 입력 변수가 현재 사용 중입니다. {#policies-PUT-map-input-add-deploy__ul_gcm_t1l_25b} 데이터 유형: 부울 |
| mapped_value | 매핑 입력 변수의 현재 값입니다. 데이터 유형: 객체 또는 문자열 배열 |
| policy_mapping | 정책 매핑 기록에 대한 상세 정보입니다 PaCE . 에 대한 PaCE자세한 내용은 다음 문서를 참조하십시오 [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). 데이터 유형: 객체 "policy_mapping": { "link": "String", "value": "String" } |
| policy_mapping.link | 테이블 REST API를 사용하여 정책 매핑 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| policy_mapping.value | 정책 매핑 기록의 PaCE Sys_id입니다. 데이터 유형: 문자열 테이블: 정책 매핑 \[sn_pace_policy_mapping\] |
| sys_created_by | 매핑 입력 변수를 생성한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_created_on | 매핑 입력 변수가 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| sys_id | 연결된 매핑 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: IO 매핑 \[sn_pace_io_mapping\] |
| sys_updated_by | 매핑 입력 변수를 업데이트한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_updated_on | 매핑 입력 변수가 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
[ ]

{#policies-PUT-map-input-add-deploy__id_jx1_px2_c5b}  

### cURL 요청

다음 예제는 additionalDeployablesInput 입력 변수에 배포 가능 항목을 추가하는 방법을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs/additional-deployables?additionalDeployables=%5B%7B%22appName%22%3A%20%22testApp%22%2C%20%22deployableName%22%3A%22Development_2%22%7D%5D&policyName=testALPolicy1&deployableName=Development_1&appName=testApp" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'admin':'admin

반환 결과:

    { 
      "result": { 
        "sys_id": "6bb746171b501110636e0fe0604bcb1c", 
        "policy_mapping": { 
          "value": "6bb746171b501110636e0fe0604bcb1b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_pace_policy_mapping/6bb746171b501110636e0fe0604bcb1b" 
        }, 
        "sys_updated_by": "ameya", 
        "sys_created_on": "2022-06-30 14:23:15", 
        "io_definition": { 
          "value": "4d0b061b1b501110636e0fe0604bcb2f", 
          "link": "https://instance.servicenow.com/api/now/table/sn_pace_io_definition/4d0b061b1b501110636e0fe0604bcb2f" 
        }, 
        "mapped_value": "[{\"id\":\"e7e34a531b501110636e0fe0604bcba9\",\"label\":\"testApp-Development_2\"}]", 
        "sys_updated_on": "2022-06-30 14:53:21", 
        "sys_created_by": "ameya", 
        "is_unused": false 
      } 
    } 

## CdmPoliciesApi - PUT /sn_cdm/policies/mappings/inputs {#ariaid-title6}

(CDM) 정책 매핑에 지정된 구성 데이터 관리 입력 변수를 업데이트합니다.
정책 매핑에 대한 자세한 내용은 [배포 가능 항목에 정책 매핑](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US)을 참조하세요.

이 엔드포인트의 호출자에게 CDM 관리자 역할이 있어야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_cdm/{api_version}/policies/mappings/inputs

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

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

{#policies-PUT-mappings-inputs__entry__2}{#policies-PUT-mappings-inputs__version-not_optional-RESTAPI}

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

{#policies-PUT-mappings-inputs__entry__6}{#policies-PUT-mappings-inputs__appName-policy-row}{#policies-PUT-mappings-inputs__deployableName-policy-row}{#policies-PUT-mappings-inputs__policyName-policy-entry}{#policies-PUT-mappings-inputs__cdm_apps-returnFields-entry}

| 이름 | 설명 |
|-|-|
| appName | 필수 정책 매핑 입력을 업데이트할 CDM 애플리케이션의 이름입니다. 데이터 유형: 문자열 테이블: CDM 애플리케이션 \[sn_cdm_application\] |
| deployableName | 필수 정책 매핑 입력을 업데이트할 CDM 배포 가능 항목의 이름입니다. 데이터 유형: 문자열 테이블: CDM 배포 가능 항목 \[sn_cdm_deployable\] |
| inputName | 필수 업데이트할 입력 변수의 이름입니다. 데이터 유형: 문자열 테이블: IO 매핑 \[sn_pace_io_mapping\] |
| inputValue | 필수 입력 변수에 할당할 값입니다. 데이터 유형: 입력 변수에 따라 다릅니다. IO 매핑 \[sn_pace_io_mapping\] 테이블에서 데이터 유형을 찾을 수 있습니다. |
| policyName | 필수 연결된 정책의 이름입니다. 데이터 유형: 문자열 테이블: 정책 \[sn_pace_policy\] |
| returnFields | 응답의 일부로 반환할 필드 목록입니다. sys_id, sys_updated_by 또는 상태와 같은 기록 열 이름을 전달합니다. 데이터 유형: 배열 기본값: 엔드포인트에서 결정한 모든 필드 |
[표 26. 쿼리 매개변수]

{#policies-PUT-mappings-inputs__entry__20}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 28. 요청 헤더]

{#policies-PUT-mappings-inputs__entry__30}

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

### 상태 코드

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

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

### 응답 본문 매개변수

{#policies-PUT-mappings-inputs__id_tny_nx2_c5b__entry__2}

| 이름 | 설명 |
|-|-|
| io_definition | 연결된 PaCE IO 정의 기록에 대한 상세 정보입니다. 에 대한 PaCE자세한 내용은 다음 문서를 참조하십시오 [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). 데이터 유형: 객체 "io_definition": { "link": "String", "value": "String" } |
| io_definition.link | 테이블 REST API를 사용하여 이 PaCE IO 정의 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| io_definition.value | IO 정의 기록의 PaCE Sys_id입니다. 데이터 유형: 문자열 테이블: IO 매핑 \[sn_pace_io_mapping\] |
| is_unused | 매핑 입력 변수가 사용되지 않았는지 여부를 나타내는 플래그입니다. 가능한 값: * 예: 연결된 매핑 입력 변수가 현재 사용되지 않습니다. * 아니오: 연결된 매핑 입력 변수가 현재 사용 중입니다. {#policies-PUT-mappings-inputs__ul_gcm_t1l_25b} 데이터 유형: 부울 |
| mapped_value | 매핑 입력 변수의 현재 값입니다. 데이터 유형: 객체 또는 문자열 배열 |
| policy_mapping | 정책 매핑 기록에 대한 상세 정보입니다 PaCE . 에 대한 PaCE자세한 내용은 다음 문서를 참조하십시오 [Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). 데이터 유형: 객체 "policy_mapping": { "link": "String", "value": "String" } |
| policy_mapping.link | 테이블 REST API를 사용하여 정책 매핑 기록을 쿼리하기 위한 호출 구문입니다. 데이터 유형: 문자열 |
| policy_mapping.value | 정책 매핑 기록의 PaCE Sys_id입니다. 데이터 유형: 문자열 테이블: 정책 매핑 \[sn_pace_policy_mapping\] |
| sys_created_by | 매핑 입력 변수를 생성한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_created_on | 매핑 입력 변수가 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| sys_id | 연결된 매핑 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: IO 매핑 \[sn_pace_io_mapping\] |
| sys_updated_by | 매핑 입력 변수를 업데이트한 사용자의 이름입니다. 데이터 유형: 문자열 |
| sys_updated_on | 매핑 입력 변수가 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
[ ]

{#policies-PUT-mappings-inputs__id_tny_nx2_c5b}  

### cURL 요청

다음 예제에서는 testALPolicy와 연결된 key1 입력 변수를 업데이트하는 방법을 보여줍니다.

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs?policyName=testALPolicy1&appName=testApp&inputValue=value1&inputName=key1&deployableName=Development_1" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

반환 결과:

    { 
      "result": { 
        "sys_id": "631b861b1b501110636e0fe0604bcb6f", 
        "policy_mapping": { 
          "value": "6bb746171b501110636e0fe0604bcb1b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_pace_policy_mapping/6bb746171b501110636e0fe0604bcb1b" 
        }, 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-30 14:38:00", 
        "io_definition": { 
          "value": "fe1b061b1b501110636e0fe0604bcb90", 
          "link": "https://instance.servicenow.comm/api/now/table/sn_pace_io_definition/fe1b061b1b501110636e0fe0604bcb90" 
        }, 
        "mapped_value": "someVal", 
        "sys_updated_on": "2022-06-30 14:39:21", 
        "sys_created_by": "admin", 
        "is_unused": false 
      } 
    }