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


---

# 디지털 제품 릴리스 API

# 디지털 제품 릴리스 API {#ariaid-title1}

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

디지털 제품 릴리스 API는 릴리스 및 정책 준수를 관리하는 엔드포인트를 제공합니다.
이 API에는 다음에서 ServiceNow Store사용할 수 있는 (sn_dpr) 애플리케이션이 필요합니다 디지털 제품 릴리스 . 자세한 내용은 [Digital Product Release](https://www.servicenow.com/docs/access?context=dpr-landing-page&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 문서를 참조하십시오.

## 디지털 제품 릴리스 - GET /sn_dpr/digital_product_release/bundle/{sysId} {#ariaid-title2}

릴리스 번들 상세 정보를 검색합니다.
이 엔드포인트를 확장하여 응답 본문에 반환되는 필드와 집계 데이터를 사용자 지정할 수 있습니다. 이 엔드포인트의 기본 기능은 ReleaseBundleSNC 스크립트 포함의 getReleaseBundleDetails() 메서드에 의해 정의됩니다. 기능을 사용자 지정하려면 ReleaseBundleSNC를 확장하는 ReleaseBundle 스크립트 포함의 getReleaseBundleDetails() 메서드를 재정의합니다. 기본적으로 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계 데이터는 응답 본문에 포함될 수 있습니다.  
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
* sn_dpr_model.release_coordinator
* sn_dpr_model.release_user
{#dpr-GET-bundle__ul_nwh_2fr_2hc}

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/bundle/{sysId}

기본 URL: /api/sn_dpr/digital_product_release/bundle/{sysId}

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

{#dpr-GET-bundle__entry__2}{#dpr-GET-bundle__version-not_optional-RESTAPI}

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

{#dpr-GET-bundle__entry__8}

| 이름 | 설명 |
|-|-|
| sendAggregation | 응답 본문에 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계 데이터를 포함할지 여부를 나타내는 플래그입니다. 데이터 유형: 부울 유효한 값은 다음과 같습니다. * true: 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계를 반환합니다. * 아니오: 집계를 반환하지 않습니다. {#dpr-GET-bundle__ul_grf_jrg_whc} 기본값: false |
[표 2. 쿼리 매개변수]

{#dpr-GET-bundle__entry__12}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 권한 부여 | 인증을 위한 기본 또는 전달자 토큰입니다. |
[표 4. 요청 헤더]

{#dpr-GET-bundle__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
[표 6. 상태 코드]

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

{#dpr-GET-bundle__entry__32}

| 이름 | 설명 |
|-|-|
| 집계 | 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계된 데이터입니다. 이 매개변수는 요청에서 쿼리 매개변수가 sendAggregation`true` 로 설정된 경우에만 응답 본문에 포함됩니다. "aggregates": { "enhancementAggregate": {Object}, "policyAggregate": {Object}, "releaseAggregate": {Object}, "taskAggregate": {Object} } 데이터 유형: 객체 |
| aggregates.enhancementAggregate | 각 상태의 개선 사항 수를 나열합니다. 데이터 유형: 객체 "enhancementAggregate": { "Closed": Number, "Open": Number } |
| aggregates.policyAggregate | 각 실행 상태의 정책 수를 나열합니다. 데이터 유형: 객체 "policyAggregate": { "Executed": Number, "Pending": Number } |
| aggregates.releaseAggregate | 각 상태의 릴리스 수를 나열합니다. 하나 이상의 릴리스가 해당 상태에 있는 경우에만 상태가 이 객체에 포함됩니다. 데이터 유형: 객체 "releaseAggregate": { "Cancelled": Number, "Completed": Number, "Draft": Number, "In Progress": Number, "Pending": Number, "Restarting": Number, "Review": Number } |
| aggregates.taskAggregate | 승인된 작업 수와 승인되지 않은 작업 수를 나열합니다. 데이터 유형: 객체 "taskAggregate": { "approval": Number, "nonApproval": Number } |
| 이름 | 릴리스 번들의 이름입니다. 데이터 유형: 문자열 |
| 소유자 | 릴리스 번들의 소유자입니다. 데이터 유형: 문자열 |
| 릴리스 | 번들에 포함된 릴리스에 대한 데이터입니다. "releases": { "count": Number, "list": [Array] } 데이터 유형: 객체 |
| 릴리스.카운트 | 번들에 포함된 릴리스 수입니다. 데이터 유형: 숫자 |
| releases.list | 번들에 포함된 sys_ids 릴리스 목록입니다. 테이블: 릴리스 \[sn_dpr_model_release\] 데이터 유형: 배열 |
| sysId | 릴리스 번들의 Sys_id입니다. 테이블: 릴리스 번들 \[sn_dpr_model_release_bundle\] 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계 데이터를 포함하여 지정된 릴리스 번들에 대한 상세 정보를 검색합니다.

    curl -X GET \ "https://instance.service-now.com/api/sn_dpr/v1/digital_product_release/bundle/9d0d0b4c874b1110dba83d5ebf867de2?sendAggregation=true" \
    --header "Accept: application/json" \ 
    --header "Authorization: Basic <base64encoded-credentials>"

응답 본문.

    {
       "sysId": "9d0d0b4c874b1110dba83d5ebf867de2",
       "name": "Release Bundle Q4",
       "owner": "jane.doe",
       "releases": {
          "count": 2,
          "list": ["rel1", "rel2"]
       },
       "aggregates": {
          "releaseAggregate": {
             "In Progress": 1,
             "Completed": 1
          },
          "taskAggregate": {
             "approval": 3,
             "nonApproval": 5
          },
          "policyAggregate": {
             "Executed": 2,
             "Pending": 1
          },
          "enhancementAggregate": {
             "Open": 1,
             "Closed": 1
          }
       }
    }

## 디지털 제품 릴리스 - GET /sn_dpr/digital_product_release/releases/{releaseId}/policies/status {#ariaid-title3}

릴리스의 현재 단계에 대한 제품별 정책 실행 상세 정보를 가져옵니다.
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
* sn_dpr_model.release_coordinator
* sn_dpr_model.release_user
{#dpr-GET-releases-policies-status__ul_nwh_2fr_2hc}

이 엔드포인트를 호출하기 전에 릴리스 상태가 진행 중 상태여야 하며 현재 단계 상태도 진행 중이어야 합니다. 릴리스 탭에서 릴리스 정보를 디지털 제품 릴리스 작업 공간 볼 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/releases/{releaseId}/policies/status

기본 URL: /api/sn_dpr/digital_product_release/releases/{releaseId}/policies/status

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

{#dpr-GET-releases-policies-status__entry__2}{#dpr-GET-releases-policies-status__version-not_optional-RESTAPI}

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

{#dpr-GET-releases-policies-status__entry__8}

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

{#dpr-GET-releases-policies-status__entry__12}

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

### 헤더

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

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

{#dpr-GET-releases-policies-status__entry__20}

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

### 상태 코드

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

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

{#dpr-GET-releases-policies-status__table_csx_jkm_fhc}

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

{#dpr-GET-releases-policies-status__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 준수 요약 및 제품 정책 상세 정보가 포함된 객체입니다. 데이터 유형: 객체 "result": { "overallSummary": {Object}, "products": [Array] } |
| result.overallSummary | 현재 릴리스 단계에 대한 정책 준수 요약입니다. 데이터 유형: 객체 "overallSummary": { "compliant": Boolean, "compliantCount": Number, "currentPhase": "String", "nonCompliantCount": Number, "timestamp": "String", "totalCount": Number } |
| result.overallSummary.compliant | 현재 릴리스 단계에 대해 평가된 모든 정책이 규정을 준수하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 평가된 모든 정책이 준수합니다. * false: 평가된 모든 정책이 규정을 준수하는 것은 아닙니다. {#dpr-GET-releases-policies-status__ul_vmf_vvc_hhc} 데이터 유형: 부울 |
| result.overallSummary.compliantCount | 규정 준수 정책 수입니다. 데이터 유형: 숫자 |
| result.overallSummary.currentPhase | 현재 릴리스 단계의 이름입니다. 데이터 유형: 문자열 |
| result.overallSummary.nonCompliantCount | 규정 미준수 정책의 수입니다. 데이터 유형: 숫자 |
| result.overallSummary.timestamp | 정책 규정 준수가 마지막으로 평가된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.overallSummary.totalCount | 평가된 총 정책 수입니다. 데이터 유형: 숫자 |
| 결과.제품 | 제품 수준 준수 결과 목록입니다. 배열의 각 객체는 제품을 나타냅니다. 데이터 유형: 배열 "products": [ { "policyExecutionDetails": [Array], "productId": "String", "productName": "String", "productVersion": "String", "summary": {Object} } ] |
| result.products.policyExecutionDetails | 준수 결과와 함께 실행된 정책 목록입니다. 배열의 각 객체는 정책을 나타냅니다. 데이터 유형: 배열 "policyExecutionDetails": [ { "executionOutput": "Check sum OK; 0 violations. Execution log id: e23-9a.", "lastRunAt": "2025-09-26T08:30:00Z", "name": "Policy Name 1", "policyId": "policyVersionSysId1", "reason": "All checks passed", "status": "compliant" } ] |
| result.products.policyExecutionDetails.executionOutput | 정책 실행에 의해 생성된 출력 메시지입니다. 데이터 유형: 문자열 |
| result.products.policyExecutionDetails.lastRunAt | 정책 준수 여부를 마지막으로 평가한 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.products.policyExecutionDetails.name | 정책의 표시 이름입니다. 데이터 유형: 문자열 |
| result.products.policyExecutionDetails.policyId | 정책의 Sys_id입니다. 테이블: 정책 \[sn_pace_policy\] 데이터 유형: 문자열 |
| result.products.policyExecutionDetails.reason | 정책이 규정을 준수하는지 또는 규정을 준수하지 않는 이유를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| result.products.policyExecutionDetails.status | 정책의 준수 상태입니다. 유효한 값은 다음과 같습니다. * 규정 준수 * non_compliant * not_run {#dpr-GET-releases-policies-status__ul_yqv_x1d_hhc} 데이터 유형: 문자열 |
| result.products.productId | 제품의 Sys_id입니다. 테이블: 제품 모델 \[cmdb_model\] 데이터 유형: 문자열 |
| 결과.제품.제품 이름 | 제품의 표시 이름입니다. 데이터 유형: 문자열 |
| result.products.productVersion | 최신 릴리스의 제품과 연결된 버전입니다. 데이터 유형: 문자열 |
| 결과.제품.요약 | 제품에 대한 준수 결과입니다. 데이터 유형: 객체 "summary": { "compliant": Boolean, "compliantCount": Number, "nonCompliantCount": Number, "totalCount": Number } |
| 결과.제품.요약.준수 | 제품에 대한 모든 정책이 규정을 준수하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 모든 정책이 준수합니다. * false: 모든 정책이 규정을 준수하는 것은 아닙니다. {#dpr-GET-releases-policies-status__ul_kh3_myc_hhc} 데이터 유형: 부울 |
| result.products.summary.compliantCount | 규정 준수 정책 수입니다. 데이터 유형: 숫자 |
| result.products.summary.nonCompliantCount | 규정 미준수 정책의 수입니다. 데이터 유형: 숫자 |
| result.products.summary.totalCount | 제품에 대해 평가된 총 정책 수입니다. 데이터 유형: 숫자 |
[ ]

### cURL 요청

이 예에서는 지정된 릴리스의 현재 단계에 대한 정책 실행 상세 정보를 가져옵니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/releases/d4982eeb474b621027d48b41516d4385/policies/status" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "overallSummary": {
             "compliant": false,
             "compliantCount": 3,
             "nonCompliantCount": 2,
             "totalCount": 5,
             "currentPhase": "Phase Name",
             "timestamp": "2025-09-26T09:15:00Z"
          },
          "products": [
             {
                "productId": "f8fe5fd40a0a0b9100f91d64df145295",
                "productName": "Payments Service",
                "productVersion": "v2.4.1",
                "summary": {
                   "compliant": false,
                   "compliantCount": 1,
                   "nonCompliantCount": 1,
                   "totalCount": 2
                },
                "policyExecutionDetails": [
                   {
                      "name": "Policy Name 1",
                      "policyId": "f6783cc843590210ab16fc4bbcb8f223",
                      "status": "compliant",
                      "lastRunAt": "2025-09-26T08:30:00Z",
                      "executionOutput": "Check sum OK; 0 violations. Execution log id: e23-9a.",
                      "reason": "All checks passed"
                   },
                   {
                      "name": "Policy Name 2",
                      "policyId": "152bb04c43590210ab16fc4bbcb8f2a7",
                      "status": "non_compliant",
                      "lastRunAt": "2025-09-26T08:32:00Z",
                      "executionOutput": "Validation failed at step 3: required configuration missing.",
                      "reason": "Missing required configuration 'payments.retry_limit'"
                   }
                ]
             }
          ]
       }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/product_enhancement {#ariaid-title4}

제품 또는 서비스에 대한 개선 사항을 생성합니다.
이 엔드포인트에 액세스하려면 호출자에게 sn_dpr_model.product_manager 역할이 있어야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/product_enhancement

기본 URL: /api/sn_dpr/digital_product_release/product_enhancement

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

{#dpr-POST-product_enhancement__entry__2}{#dpr-POST-product_enhancement__version-not_optional-RESTAPI}

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

{#dpr-POST-product_enhancement__entry__6}

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

{#dpr-POST-product_enhancement__entry__10}

| 이름 | 설명 |
|-|-|
| 설명 | 개선 사항에 대한 설명입니다. 데이터 유형: 문자열 |
| 이름 | 필수 개선 사항의 이름입니다. 데이터 유형: 문자열 |
| 우선순위 | 개선 사항의 우선순위입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#dpr-POST-product_enhancement__ul_mkf_p5h_whc} 기본값: medium 데이터 유형: 문자열 |
| productFeatureSysId | 개선 사항과 연결할 제품 기능의 Sys_id입니다. 테이블: 제품 기능 \[sn_dpr_model_product_feature\] 데이터 유형: 문자열 |
| productSysId | 필수 개선 사항과 연결할 제품 또는 서비스의 Sys_id입니다. 테이블: 애플리케이션 모델 \[cmdb_application_product_model\] 또는 서비스 모델 \[cmdb_service_product_model\] 데이터 유형: 문자열 |
| releaseSysId | 개선 사항을 추가할 릴리스의 Sys_id입니다. 릴리스는 매개변수에 versionSysId 제공된 버전과 연결되어 있어야 합니다. 테이블: 릴리스 \[sn_dpr_model_release\] 데이터 유형: 문자열 |
| versionSysId | 개선 사항과 연결할 제품 버전 또는 서비스 버전의 Sys_id입니다. 버전은 매개변수에 productSysId 제공된 것과 동일한 제품 또는 서비스에 대한 버전이어야 합니다. 테이블: 소프트웨어 모델 \[cmdb_software_product_model\] 또는 서비스 오퍼링 모델 \[cmdb_service_offering_model\] 데이터 유형: 문자열 |
[표 15. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#dpr-POST-product_enhancement__table_zpj_tcp_whc} {#dpr-POST-product_enhancement__entry__32}

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

### 상태 코드

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

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

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

{#dpr-POST-product_enhancement__table_fv1_gmm_fhc__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "sysId": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-product_enhancement__ul_tz2_smm_fhc} 데이터 유형: 부울 |
| result.sysId | 생성된 개선 사항의 Sys_id입니다. 표: 제품 개선 사항 \[sn_dpr_model_product_enhancement\] 데이터 유형: 문자열 |
[ ]

{#dpr-POST-product_enhancement__table_fv1_gmm_fhc}  

### cURL 요청

이 예에서는 제품 개선 사항을 만듭니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/product_enhancement" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"name\":\"Offline streaming\", 
       \"productSysId\":\"de8e9c0dfff8f2108289ffffffffff61\", 
       \"priority\":\"high\", 
       \"description\":\"Enhancement description\", 
       \"versionSysId\":\"da4b608dff7cf2108289ffffffffffc2\", 
       \"releaseSysId\":\"9a4b608dff7cf2108289ffffffffffc3\", 
       \"productFeatureSysId\":\"192d2905ff7436108289ffffffffff3f\" 
    }" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "error": false,
          "sysId": "76417985ff7436108289ffffffffff5f"
       }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release {#ariaid-title5}

릴리스를 작성합니다.
릴리스는 독립 릴리스로 생성하거나 하위 릴리스를 포함하는 기본 릴리스로 생성할 수 있습니다. 이 엔드포인트는 기존 릴리스를 초안 상태에서 진행 중으로 이동하는 데에도 사용할 수 있습니다.  
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
{#dpr-POST-release__ul_nwh_2fr_2hc}

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release

기본 URL: /api/sn_dpr/digital_product_release/release

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

{#dpr-POST-release__entry__2}{#dpr-POST-release__version-not_optional-RESTAPI}

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

{#dpr-POST-release__entry__6}

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

{#dpr-POST-release__entry__10}

| 이름 | 설명 |
|-|-|
| autoCreateIncludedVersions | 자동으로 생성할 하위 릴리스 버전 목록입니다. 데이터 유형: 배열 "autoCreateIncludedVersions": [ { "product": "String", "version": "String" } ] |
| autoCreateIncludedVersions.product | 버전에 사용할 제품의 Sys_id입니다. 테이블: 제품 모델 \[cmdb_model\] 데이터 유형: 문자열 |
| autoCreateIncludedVersions.version | 버전 이름입니다. 데이터 유형: 문자열 |
| autoCreateVersionName | 자동으로 작성할 버전의 이름입니다. 데이터 유형: 문자열 |
| draftReleaseId | 초안 릴리스의 Sys_id입니다. 이 매개변수를 사용하여 릴리스를 초안 상태에서 진행 중으로 이동합니다. 테이블: 릴리스 \[sn_dpr_model_release\] 데이터 유형: 문자열 |
| 포함된 버전 | 릴리스에 포함할 기존 제품 버전의 sys_ids 목록입니다. 테이블: 시스템 구성요소 모델 \[cmdb_sw_component_model\] 데이터 유형: 배열 |
| isDraftRelease | 릴리스를 초안 상태로 생성할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 릴리스가 초안으로 설정된 상태로 생성됩니다. * false: 릴리스가 진행 중 상태로 생성됩니다. {#dpr-POST-release__ul_pzs_pfp_ghc} 기본값: false 데이터 유형: 부울 |
| 이름 | 필수 릴리스의 이름입니다. 데이터 유형: 문자열 |
| productId | 필수 제품의 Sys_id입니다. 테이블: 제품 모델 \[cmdb_model\] 데이터 유형: 문자열 |
| 제품 버전 | 제품 버전의 Sys_id입니다. 테이블: 시스템 구성요소 모델 \[cmdb_sw_component_model\] 데이터 유형: 문자열 |
| releaseCalendar | 릴리스 달력의 Sys_id입니다. 테이블: 릴리스 달력 \[sn_dpr_model_release_calendar\] 데이터 유형: 문자열 |
| 릴리스 날짜 | yyyy-MM-dd 형식의 릴리스 날짜입니다. 이 매개변수를 사용하면 릴리스 준비 대상 \[sn_dpr_model_release_target\] 테이블에 기록이 생성됩니다. 데이터 유형: 문자열 |
| 릴리스설명 | 릴리스에 대한 설명입니다. 데이터 유형: 문자열 |
| 릴리스 소유자 | 필수 릴리스 소유자의 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| 릴리스 대상 | 릴리스 준비 대상의 Sys_id입니다. 테이블: 릴리스 준비 대상 \[sn_dpr_model_release_target\] 데이터 유형: 문자열 |
| templateId | 릴리스에 사용할 템플릿의 Sys_id입니다. 테이블: 릴리스 템플릿 \[sn_dpr_model_release_template\] 데이터 유형: 문자열 |
| validatesVersion | 릴리스가 버전을 확인하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 릴리스에서 버전을 확인합니다. * false: 릴리스에서 버전을 확인하지 않습니다. {#dpr-POST-release__ul_vtk_kfp_ghc} 기본값: false 데이터 유형: 부울 |
[표 21. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#dpr-POST-release__entry__52}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 201 | 만든. 릴리스가 성공적으로 생성되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수(JSON) {#dpr-POST-release__section_hsf_11q_ghc}

{#dpr-POST-release__table_fv1_gmm_fhc__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "message": "String", "progressId": "String", "releaseId": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-release__ul_tz2_smm_fhc} 데이터 유형: 부울 |
| 결과.메시지 | API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 데이터 유형: 문자열 |
| result.progressId | 요청 매개변수에 나열된 하위 릴리스 버전의 생성 진행률에 대한 추적기의 시스템 ID입니다 autoCreateIncludedVersions . 테이블: Progress Worker \[sys_progress_worker\] 데이터 유형: 문자열 |
| result.releaseId | 생성된 기본 릴리스의 Sys_id입니다. 테이블: 릴리스 \[sn_dpr_model_release\] 데이터 유형: 문자열 |
[ ]

{#dpr-POST-release__table_fv1_gmm_fhc}  

### cURL 요청

이 예에서는 포함된 버전으로 릴리스를 만듭니다.

    curl "http://instance.service-now.com/api/sn_dpr/v1/digital_product_release/release" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"name\": \"Patch Q4\", 
      \"releaseTarget\": \"8071e5f8ff687a10509cffffffffffd9\", 
      \"releaseOwner\": \"6816f79cc0a8016401c5a33be04be441\", 
      \"releaseDescription\": \"Q4 release\", 
      \"productVersion\": \"\", 
      \"templateId\": \"c83134a4ff643a10509cffffffffffb5\", 
      \"releaseDate\": \"\", 
      \"releaseCalendar\": \"\", 
      \"includedVersions\": [ 
        \"39fd3f66ff503610509cffffffffff09\" 
      ], 
      \"productId\": \"c65c372bfb9d5610fdacfe7405efdcd7\", 
      \"autoCreateVersionName\": \"1.2\", 
      \"autoCreateIncludedVersions\": [ 
        { 
          \"product\": \"de66ea3833e966103e8361a9ed5c7b4e\", 
          \"version\": \"1.1\" 
        } 
      ] 
    }" \ 
    --user 'username':'password'

응답 본문.

    {
      "result": { 
        "error": false, 
        "message": "", 
        "releaseId": "af90e98dff3c3210509cffffffffffc9", 
        "progressId": "f7902d01ffbc3210509cffffffffff7b" 
      } 
    }

### cURL 요청 {#dpr-POST-release__example_bqc_mdq_ghc}

이 예에서는 기존 릴리스를 초안 상태에서 진행 중으로 옮깁니다.

    curl "http://instance.service-now.com/api/sn_dpr/v1/digital_product_release/release" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"name\": \"Q4 2025 Product Release\", 
      \"releaseTarget\": \"077e1ffb97bc4e107bc2341de053afe2\", 
      \"releaseOwner\": \"6816f79cc0a8016401c5a33be04be441\", 
      \"releaseDescription\": \"\", 
      \"productVersion\": \"0ff12581ffbc3210509cffffffffff15\", 
      \"templateId\": \"648c6ca8ffe03a10509cffffffffff11\", 
      \"releaseDate\": \"\", 
      \"releaseCalendar\": \"\", 
      \"includedVersions\": [], 
      \"productId\": \"\", 
      \"autoCreateVersionName\": \"\", 
      \"autoCreateIncludedVersions\": [], 
      \"draftReleaseId\": \"83f12581ffbc3210509cffffffffff16\" 
    }" \ 
    --user 'username':'password'

응답 본문.

    { 
      "result": { 
        "error": false, 
        "message": "", 
        "releaseId": "83f12581ffbc3210509cffffffffff16" 
      } 
    }

### cURL 요청 {#dpr-POST-release__example_mnp_j2q_ghc}

이 예에서는 독립 릴리스를 만듭니다.

    curl "http://instance.service-now.com/api/sn_dpr/v1/digital_product_release/release" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"name\": \"Q2 2026 patch\", 
      \"productVersion\": null, 
      \"releaseTarget\": \"008b84a1ffe4ba10509cffffffffff2c\", 
      \"releaseDescription\": \"\", 
      \"releaseOwner\": \"6816f79cc0a8016401c5a33be04be441\", 
      \"productId\": \"012c6d20ff203210229bffffffffff25\", 
      \"autoCreateVersionName\": \"2.4\", 
      \"templateId\": \"648c6ca8ffe03a10509cffffffffff11\", 
      \"releaseDate\": \"\", 
      \"releaseCalendar\": \"\", 
      \"isDraftRelease\": false, 
      \"validatesVersion\": true 
    }" \ 
    --user 'username':'password'

응답 본문.

    { 
      "result": { 
        "error": false, 
        "message": "", 
        "releaseId": "c6f52181ffbc3210509cffffffffffc0" 
      } 
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release/{releaseId}/key_date {#ariaid-title6}

릴리스에 대한 키 날짜를 생성합니다.
키 날짜는 릴리스 기간 동안 기한, 마일스톤 및 기타 중요 이벤트를 추적하는 데 사용됩니다.

이 엔드포인트를 호출하기 전에 [타임라인 지향 릴리스](https://www.servicenow.com/docs/access?context=dpr-working-timeline-release&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 를 만들어야 합니다. 타임라인 지향 릴리스는 기한이 고정되어 있고 엄격한 일정을 따르는 반면, 단계 지향 릴리스는 기한을 지키기보다는 목표와 기능을 완료하는 데 주로 중점을 둡니다.  
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
* sn_dpr_model.release_coordinator
{#dpr-POST-release-key_date__ul_nwh_2fr_2hc}

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release/{releaseId}/key_date

기본 URL: /api/sn_dpr/digital_product_release/release/{releaseId}/key_date

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

{#dpr-POST-release-key_date__entry__2}{#dpr-POST-release-key_date__version-not_optional-RESTAPI}

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

{#dpr-POST-release-key_date__entry__8}

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

{#dpr-POST-release-key_date__entry__12}

| 이름 | 설명 |
|-|-|
| assignedTo | 키 날짜에 할당된 사용자의 Sys_id입니다. 사용자에게 다음 역할 중 하나가 있어야 합니다. * sn_dpr_model.product_manager * sn_dpr_model.release_admin * sn_dpr_model.release_coordinator * sn_dpr_model.release_user {#dpr-POST-release-key_date__ul_kyv_ghc_xhc} 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| 설명 | 키 날짜에 대한 설명입니다. 데이터 유형: 문자열 |
| 기한 | 필수 이벤트 또는 목표를 완료해야 하는 기한입니다. 기한은 릴리스 계획된 시작 날짜와 종료 날짜 사이여야 합니다. 형식: yyyy-MM-dd 데이터 유형: 문자열 |
| 이름 | 필수 키 날짜의 이름입니다. 데이터 유형: 문자열 |
| 상태 | 필수 키 날짜의 상태입니다. 유효한 값은 다음과 같습니다. * 보관됨 * 누락됨 * 예정 {#dpr-POST-release-key_date__ul_ssr_1hc_xhc} 데이터 유형: 문자열 |
| 유형 | 필수 키 날짜의 유형입니다. 유효한 값은 다음과 같습니다. * 마감 기한 * important_date * key_event * 마일스톤 {#dpr-POST-release-key_date__ul_ikw_3fc_xhc} 데이터 유형: 문자열 |
[표 27. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#dpr-POST-release-key_date__table_zpj_tcp_whc} {#dpr-POST-release-key_date__entry__32}

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

### 상태 코드

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

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

{#dpr-POST-release-key_date__table_d11_5kv_whc}

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

{#dpr-POST-release-key_date__table_fv1_gmm_fhc__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "keyDateSysId": "String", "message": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-release-key_date__ul_tz2_smm_fhc} 데이터 유형: 부울 |
| result.keyDateSysId | 생성된 키 날짜의 Sys_id입니다. 테이블: 릴리스 키 날짜 \[sn_dpr_model_release_key_date\] 데이터 유형: 문자열 |
| 결과.메시지 | API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 데이터 유형: 문자열 |
[ ]

{#dpr-POST-release-key_date__table_fv1_gmm_fhc}  

### cURL 요청

이 예에서는 지정된 릴리스에 대한 프로젝트 시작 날짜를 만듭니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release/eb7dd11d97b402107bc2341de053af34/key_date" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{ 
        \"name\": \"Project Launch\", 
        \"type\": \"milestone\", 
        \"dueDate\": \"2025-11-01\", 
        \"state\": \"upcoming\", 
        \"description\": \"Launching the new project phase.\", 
        \"assignedTo\": \"62826bf03710200044e0bfc8bcbe5df1\" 
    }" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "error": false,
          "message": "Release key date created successfully",
          "keyDateSysId": "eb0b0905ff7036108289ffffffffff6d"
       }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release/{releaseId}/policies/run {#ariaid-title7}

릴리스의 현재 단계에 대해 매핑된 정책을 실행합니다.
이 엔드포인트에 액세스하려면 호출자에게 sn_dpr_model.product_manager 역할이 있어야 합니다.

이 엔드포인트를 호출하기 전에 릴리스 상태가 진행 중 상태여야 하며 현재 단계 상태도 진행 중이어야 합니다. 릴리스 탭에서 릴리스 정보를 디지털 제품 릴리스 작업 공간 볼 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release/{releaseId}/policies/run

기본 URL: /api/sn_dpr/digital_product_release/release/{releaseId}/policies/run

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

{#dpr-POST-release-policies-run__entry__2}{#dpr-POST-release-policies-run__version-not_optional-RESTAPI}

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

{#dpr-POST-release-policies-run__entry__8}

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

{#dpr-POST-release-policies-run__entry__12}

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

### 헤더

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

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

{#dpr-POST-release-policies-run__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 201 | 만든. 릴리스 단계 정책이 실행되도록 예약되어 있습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 36. 상태 코드]

{#dpr-POST-release-policies-run__table_csx_jkm_fhc}

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

{#dpr-POST-release-policies-run__table_fv1_gmm_fhc__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "errorCode": "String", "message": "String", "policyExecutionScheduled": Boolean } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-release-policies-run__ul_tz2_smm_fhc} 데이터 유형: 부울 |
| result.errorCode | 요청에 대한 HTTP 상태 코드입니다. 데이터 유형: 문자열 |
| 결과.메시지 | API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 데이터 유형: 문자열 |
| result.policyExecutionScheduled | 릴리스 단계 정책이 실행되도록 예약되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 릴리스 단계 정책이 실행되도록 예약되었습니다. * false: 릴리스 단계 정책이 실행되도록 예약되지 않았습니다. {#dpr-POST-release-policies-run__ul_hfm_2nm_fhc} 데이터 유형: 부울 |
[ ]

{#dpr-POST-release-policies-run__table_fv1_gmm_fhc}  

### cURL 요청

이 예에서는 지정된 릴리스의 현재 단계에 대해 매핑된 정책을 실행합니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release/d4982eeb474b621027d48b41516d4385/policies/run" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "error": false,
          "errorCode": "",
          "message": "Policy execution scheduled.",
          "policyExecutionScheduled": true
       }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release/{releaseId}/related_task {#ariaid-title8}

릴리스에 관련 작업을 추가합니다.
디지털 제품 릴리스 작업 공간의 릴리스 탭에서 릴리스 정보를 볼 수 있습니다. 릴리스에 대한 관련 작업은 릴리스 기록의 릴리스 범위 섹션에 표시됩니다.  
중요사항:  
이 엔드포인트를 호출하기 전에 릴리스에 대한 관련 작업으로 추가할 수 있는 기존 작업 기록이 있어야 합니다. 기록은 작업 \[task\] 테이블을 확장하는 테이블에 있어야 하지만 작업 테이블 자체에는 없어야 합니다. 시스템 속성에서 [sn_dpr_model.release_related_task_types](https://www.servicenow.com/docs/access?context=digital-product-release-properties&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 작업 기록이 포함된 테이블을 나열합니다.  
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
{#dpr-POST-release-related_task__ul_nwh_2fr_2hc}

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release/{releaseId}/related_task

기본 URL: /api/sn_dpr/digital_product_release/release/{releaseId}/related_task

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

{#dpr-POST-release-related_task__entry__2}{#dpr-POST-release-related_task__version-not_optional-RESTAPI}

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

{#dpr-POST-release-related_task__entry__8}

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

{#dpr-POST-release-related_task__entry__12}

| 이름 | 설명 |
|-|-|
| taskIds | 필수 릴리스에 대한 관련 작업으로 추가할 작업 sys_ids 목록입니다. 작업 기록은 시스템 속성에 sn_dpr_model.release_related_task_types 나열된 테이블에서 가져와야 합니다. 자세한 내용은 [Digital Product Release properties](https://www.servicenow.com/docs/access?context=digital-product-release-properties&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 배열 |
[표 39. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#dpr-POST-release-related_task__table_zpj_tcp_whc} {#dpr-POST-release-related_task__entry__22}

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

### 상태 코드

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

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

{#dpr-POST-release-related_task__table_d11_5kv_whc}

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

{#dpr-POST-release-related_task__table_fv1_gmm_fhc__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "message": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-release-related_task__ul_tz2_smm_fhc} 데이터 유형: 부울 |
| 결과.메시지 | API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 데이터 유형: 문자열 |
[ ]

{#dpr-POST-release-related_task__table_fv1_gmm_fhc}  

### cURL 요청

이 예에서는 릴리스에 두 개의 관련 작업을 추가합니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release/eb7dd11d97b402107bc2341de053af34/related_task" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"taskIds\": [\"36836028532023004247ddeeff7b12f1\", \"bc84b11dff5c32108289ffffffffff12\"]}" \
    --user 'username':'password'

응답 본문.

    {
       "result": {
          "error": false,
          "message": "Successfully created the mappings between the release and all the tasks."
       }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release_calendar {#ariaid-title9}

릴리스 달력을 생성합니다.
이 엔드포인트에 액세스하려면 호출자에게 sn_dpr_model.release_calendar_admin 역할이 있어야 합니다.

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release_calendar

기본 URL: /api/sn_dpr/digital_product_release/release_calendar

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

{#dpr-POST-release_calendar__entry__2}{#dpr-POST-release_calendar__version-not_optional-RESTAPI}

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

{#dpr-POST-release_calendar__entry__6}

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

{#dpr-POST-release_calendar__entry__10}

| 이름 | 설명 |
|-|-|
| 설명 | 릴리스 달력에 대한 설명입니다. 데이터 유형: 문자열 |
| 이름 | 필수 릴리스 달력의 이름입니다. 데이터 유형: 문자열 |
| 릴리스관리자 | 필수 릴리스 달력 소유자의 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| 일정 | 릴리스 달력에 사용할 일정 sys_ids의 쉼표로 구분된 목록입니다. 예: `"sysId1,sysId2,sysId3"`. 테이블: 일정 \[cmn_schedule\] 데이터 유형: 문자열 |
[표 45. 요청 본문 매개변수(JSON)]

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 권한 부여 | 인증을 위한 기본 또는 전달자 토큰입니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 46. 요청 헤더]

{#dpr-POST-release_calendar__table_zpj_tcp_whc} {#dpr-POST-release_calendar__entry__28}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 201 | 만든. 릴리스 달력이 생성되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
[표 48. 상태 코드]

{#dpr-POST-release_calendar__table_d11_5kv_whc}

### 응답 본문 매개변수(JSON) {#dpr-POST-release_calendar__section_tmc_1lv_whc}

{#dpr-POST-release_calendar__table_fv1_gmm_fhc__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "message": "String", "releaseCalendarId": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-release_calendar__ul_tz2_smm_fhc} 데이터 유형: 부울 |
| 결과.메시지 | API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 데이터 유형: 문자열 |
| result.releaseCalendarId | 생성된 릴리스 달력의 Sys_id입니다. 테이블: 릴리스 달력 \[sn_dpr_model_release_calendar\] 데이터 유형: 문자열 |
[ ]

{#dpr-POST-release_calendar__table_fv1_gmm_fhc}  

### cURL 요청

이 예에서는 릴리스 달력을 만듭니다.

    curl 'https://instance.service-now.com/api/sn_dpr/v1/digital_product_release/release_calendar' \ 
    --request POST \
    --header 'Accept:application/json' \
    --header 'Content-Type: application/json' \ 
    --header 'Authorization: Basic <base64encoded-credentials>' \ 
    --data '{ 
        "name": "Q1 2025 Release Calendar123", 
        "releaseAdmin": "dc6770ae3b97a210532fb50f23e45a33", 
        "description": "Calendar for Q1 releases" 
    }'

응답 본문.

    {
       "result": {
          "error": false,
          "message": "",
          "releaseCalendarId": "5f6702c13bbc3a50532fb50f23e45a2b"
       }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release_id/{releaseId}/complete_phase {#ariaid-title10}

릴리스의 현재 단계를 완료합니다.
주:  
현재 단계는 단계의 모든 정책이 준수되는 경우에만 완료됨으로 설정됩니다.  
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
* sn_dpr_model.release_coordinator
{#dpr-POST-releaseid-completephase__ul_nwh_2fr_2hc}

이 엔드포인트를 호출하기 전에 릴리스 상태가 진행 중 상태여야 하며 현재 단계 상태도 진행 중이어야 합니다. 릴리스 탭에서 릴리스 정보를 디지털 제품 릴리스 작업 공간 볼 수 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release_id/{releaseId}/complete_phase

기본 URL: /api/sn_dpr/digital_product_release/release_id/{releaseId}/complete_phase

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

{#dpr-POST-releaseid-completephase__entry__2}{#dpr-POST-releaseid-completephase__version-not_optional-RESTAPI}

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

{#dpr-POST-releaseid-completephase__entry__8}

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

{#dpr-POST-releaseid-completephase__entry__12}

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

### 헤더

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

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

{#dpr-POST-releaseid-completephase__entry__20}

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

### 상태 코드

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

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

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

{#dpr-POST-releaseid-completephase__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 이 객체에 포함된 요소는 요청의 성공 또는 실패 여부에 따라 달라집니다. 데이터 유형: 객체 성공 객체입니다. "result": { "message": "String", "phaseSysId": "String", "status": "String", } 오류 객체. "result": { "error": Boolean, "message": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 이 매개변수는 요청이 실패한 경우에만 반환되므로 가능한 유일한 값은 `예`입니다. 데이터 유형: 부울 |
| 결과.메시지 | API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 데이터 유형: 문자열 |
| result.phaseSysId | 릴리스 단계의 Sys_id입니다. 테이블: 릴리스 단계 \[sn_dpr_model_release_phase\] 데이터 유형: 문자열 |
| 결과.상태 | API 요청의 상태입니다. 이 매개변수는 요청이 성공한 경우에만 반환되므로 가능한 유일한 값은 `성공`입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예시에서는 지정된 릴리스의 현재 단계를 완료합니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release_id/d4982eeb474b621027d48b41516d4385/complete_phase" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
      "result": {
        "status": "success",
        "message": "Release phase is marked as complete",
        "phaseSysId": "2498222f474b621027d48b41516d4342"
      }
    }

### cURL 요청 {#dpr-POST-releaseid-completephase__example_dtv_vsf_fhc}

이 예에서는 잘못된 릴리스 sys_id가 제공된 경우의 오류 응답을 보여줍니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release_id/a/complete_phase" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

오류 응답입니다.

    {
      "result": {
        "error": true,
        "message": "Release ID is invalid"
      }
    }

## 디지털 제품 릴리스 - POST /sn_dpr/digital_product_release/release_target {#ariaid-title11}

릴리스 준비 대상 또는 반복 릴리스 준비 대상 집합을 생성합니다.
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
{#dpr-POST-release_target__ul_nwh_2fr_2hc}

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release_target

기본 URL: /api/sn_dpr/digital_product_release/release_target

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

{#dpr-POST-release_target__entry__2}{#dpr-POST-release_target__version-not_optional-RESTAPI}

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

{#dpr-POST-release_target__entry__6}

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

{#dpr-POST-release_target__entry__10}

| 이름 | 설명 |
|-|-|
| 설명 | 준비 대상에 대한 설명입니다. 데이터 유형: 문자열 |
| endDate | 반복 준비 대상의 종료 날짜입니다. 예`일 경우`isRecurring 필요합니다. 데이터 유형: 문자열 |
| isRecurring | 필수 준비 대상이 반복되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 대상이 반복되고 있습니다. * false: 대상은 단일 날짜입니다. {#dpr-POST-release_target__ul_nwm_nxf_k3c} 데이터 유형: 부울 |
| 이름 | 필수 릴리스 준비 대상의 이름입니다. 데이터 유형: 문자열 |
| 릴리스관리자 | 필수 준비 대상 소유자의 Sys_id입니다. 테이블: 사용자 \[sys_user\] 데이터 유형: 문자열 |
| releaseCalendar | 필수 준비 대상에 대한 릴리스 달력의 Sys_id입니다. 테이블: 릴리스 달력 \[sn_dpr_model_release_calendar\] 데이터 유형: 문자열 |
| 반복 | 반복 준비 대상에 대한 일정을 설정합니다. 예`일 경우`isRecurring 필요합니다. 데이터 유형: 객체 "repeats": { "daysOfWeek": Number, "every": Number, "type": "String" } |
| repeats.daysOfWeek | 한 주의 근무일 수입니다. 데이터 유형: 숫자 |
| 반복.매번 | 각 날짜 사이의 간격 수입니다. 대상이 반복되는 빈도를 정의하는 데 사용됩니다.repeats.type 이 예에서 대상은 2주마다 반복됩니다. "repeats": { "every": 2, "type": "weekly" } 데이터 유형: 숫자 |
| 반복.유형 | 각 날짜 사이의 간격 유형입니다. 대상이 반복되는 빈도를 정의하는 데 사용됩니다.repeats.every 유효한 값은 다음과 같습니다. * 주별 * 월별 {#dpr-POST-release_target__ul_kgt_1bg_k3c} 데이터 유형: 문자열 |
| scheduleSysId | 릴리스 대상에 사용할 일정의 Sys_id입니다. 테이블: 일정 \[cmn_schedule\] 데이터 유형: 문자열 |
| startDate | 필수 준비 대상의 날짜 또는 반복되는 준비 대상의 첫 번째 날짜입니다. 데이터 유형: 문자열 |
| targetsWithOverlappingScheduleDetails | 반복 준비 대상의 날짜 목록입니다. 데이터 유형: 배열 "targetsWithOverlappingScheduleDetails": [ { "active": Boolean, "date": "String" } ] |
| targetsWithOverlappingScheduleDetails.active | 준비 대상 반복이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 활성 * false: 비활성입니다. {#dpr-POST-release_target__ul_sjq_hgg_k3c} 데이터 유형: 부울 |
| targetsWithOverlappingScheduleDetails.date | 준비 대상 반복 날짜입니다. 데이터 유형: 문자열 |
[표 57. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#dpr-POST-release_target__table_tn3_hhg_k3c} {#dpr-POST-release_target__entry__48}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 201 | 만든. 릴리스 대상이 생성되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
[표 60. 상태 코드]

{#dpr-POST-release_target__table_osg_lhg_k3c}

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

{#dpr-POST-release_target__table_ndx_qsy_j3c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "count": Number, "error": Boolean, "message": "String" } |
| 결과.카운트 | API 요청에 의해 생성된 릴리스 대상 수입니다. 데이터 유형: 숫자 |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-POST-release_target__ul_odx_qsy_j3c} 데이터 유형: 부울 |
| 결과.메시지 | 오류 메시지. 성공적인 요청의 경우 이 매개변수는 비어 있습니다. 데이터 유형: 문자열 |
[ ]

{#dpr-POST-release_target__table_ndx_qsy_j3c}  

### cURL 요청

이 예에서는 매주 금요일에 반복되는 대상을 사용하여 4개의 릴리스 준비 대상 집합을 생성합니다.

    curl "http://instance.service-now.com/api/sn_dpr/digital_product_release/release_target" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"name\": \"Weekly Friday patch\", 
      \"releaseAdmin\": \"6816f79cc0a8016401c5a33be04be441\", 
      \"isRecurring\": true, 
      \"description\": \"\", 
      \"startDate\": \"2025-10-24\", 
      \"releaseCalendar\": \"d3d1f3b4ff60ba10509cffffffffffa8\", 
      \"endDate\": \"2025-11-19\", 
      \"repeats\": { 
        \"type\": \"weekly\", 
        \"every\": 1, 
        \"daysOfWeek\": 5 
      }, 
      \"scheduleSysId\": \"b862d589ff3c3210509cffffffffff97\", 
      \"targetsWithOverlappingScheduleDetails\": [ 
        { 
          \"active\": true, 
          \"date\": \"2025-10-24\" 
        }, 
        { 
          \"active\": true, 
          \"date\": \"2025-10-31\" 
        }, 
        { 
          \"active\": true, 
          \"date\": \"2025-11-07\" 
        }, 
        { 
          \"active\": true, 
          \"date\": \"2025-11-14\" 
        } 
      ] 
    }" \ 
    --user 'username':'password'

응답 본문.

    {
      "result": {
        "error": false,
        "message": "",
        "count": 4
      }
    }

### cURL 요청 {#dpr-POST-release_target__example_cdx_2lz_j3c}

이 예에서는 지정된 날짜에 대한 릴리스 준비 대상을 생성합니다.

    curl "http://instance.service-now.com/api/sn_dpr/digital_product_release/release_target" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"name\": \"Fourth Thursday patch\", 
      \"releaseAdmin\": \"6816f79cc0a8016401c5a33be04be441\", 
      \"isRecurring\": false, 
      \"description\": \"Last Thursday of October\", 
      \"startDate\": \"2025-10-30\", 
      \"releaseCalendar\": \"d3d1f3b4ff60ba10509cffffffffffa8\" 
    }" \ 
    --user 'username':'password' 

응답 본문.

    {
      "result": {
        "error": false,
        "message": "",
        "count": 1
      }
    }

## 디지털 제품 릴리스 - PUT /sn_dpr/digital_product_release/release/{sysId}/retarget {#ariaid-title12}

릴리스에 대한 준비 대상을 변경합니다.
새 준비 대상은 이미 정의된 기존 준비 대상 또는 대역 외 날짜(표준 릴리스 달력에 연결되지 않은 일회성 준비 대상)일 수 있습니다. 대역 외 날짜 [sn_dpr.out_of_band_release_allowed](https://www.servicenow.com/docs/access?context=digital-product-release-properties&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 를 설정하려면 시스템 속성을 <kbd class="ph userinput">true</kbd>로 설정해야 합니다.

릴리스 단계 기간은 새로운 준비 대상을 반영하도록 조정됩니다.

이 엔드포인트를 호출하기 전에 릴리스 상태가 진행 중 또는 보류 중이어야 합니다.  
이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.

* sn_dpr_model.product_manager
* sn_dpr_model.release_admin
{#dpr-PUT-release-retarget__ul_nwh_2fr_2hc}

### URL 형식

버전이 지정된 URL: /api/sn_dpr/{api_version}/digital_product_release/release/{sysId}/retarget

기본 URL: /api/sn_dpr/digital_product_release/release/{sysId}/retarget

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

{#dpr-PUT-release-retarget__entry__2}{#dpr-PUT-release-retarget__version-not_optional-RESTAPI}

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

{#dpr-PUT-release-retarget__entry__8}

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

{#dpr-PUT-release-retarget__entry__12}

| 이름 | 설명 |
|-|-|
| outOfBand | 준비 대상이 대역 외 날짜(표준 릴리스 달력에 연결되지 않은 일회성 준비 대상)인지 여부를 나타내는 플래그입니다. 이 매개변수는 사용되지 않으면 필수 releaseTarget  입니다. 유효한 값은 다음과 같습니다. * true: 준비 대상이 대역 외입니다. * false: 준비 대상이 이미 정의되어 표준 릴리스 달력에 연결되어 있습니다. {#dpr-PUT-release-retarget__ul_hdr_lmy_j3c} 기본값: false 데이터 유형: 부울 |
| releaseCalendar | 준비 대상에 사용할 릴리스 달력의 릴리스 달력 Sys_id입니다. 사용하는 경우 outOfBand필수입니다. 테이블: 릴리스 달력 \[sn_dpr_model_release_calendar\] 데이터 유형: 문자열 |
| 릴리스 날짜 | 준비 대상의 날짜입니다. 사용하는 경우 outOfBand필수입니다. 데이터 유형: 문자열 |
| 릴리스 대상 | 릴리스 준비 대상의 Sys_id입니다. 이 매개변수를 사용하여 기존 준비 대상을 선택합니다. 이 매개변수 또는 outOfBand 새 대상을 설정하는 데 필요합니다. 테이블: 릴리스 준비 대상 \[sn_dpr_model_release_target\] 데이터 유형: 문자열 |
[표 63. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#dpr-PUT-release-retarget__entry__28}

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

### 상태 코드

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

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

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

{#dpr-PUT-release-retarget__table_ndx_qsy_j3c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "error": Boolean, "message": "String" } |
| 결과.오류 | API 요청에 오류가 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 오류. * false: 오류 없음. {#dpr-PUT-release-retarget__ul_odx_qsy_j3c} 데이터 유형: 부울 |
| 결과.메시지 | 오류 메시지. 성공적인 요청의 경우 이 매개변수는 비어 있습니다. 데이터 유형: 문자열 |
[ ]

{#dpr-PUT-release-retarget__table_ndx_qsy_j3c}  

### cURL 요청

이 예에서는 기존 준비 대상을 사용하여 릴리스 준비 대상을 업데이트합니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release/9b2e7ec9476c8e105b8e0dcfe16d43d4/retarget" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"releaseTarget\": \"3f6668e95427fd10f877ac7ac399daa6\"
    }" \
    --user 'username':'password'

응답 본문.

    {
      "result": {
        "error": false,
        "message": ""
      }
    }

### cURL 요청 {#dpr-PUT-release-retarget__example_mkk_lpy_j3c}

이 예에서는 대역 외 준비 대상을 사용하여 릴리스 준비 대상을 업데이트합니다.

    curl "https://instance.service-now.com/api/sn_dpr/digital_product_release/release/9b2e7ec9476c8e105b8e0dcfe16d43d4/retarget" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"outOfBand\": true,
       \"releaseCalendar\": \"fcb2eaa09f4302105c534d837a0a1c2b\",
       \"releaseDate\": \"2026-10-23\"
    }" \
    --user 'username':'password'

응답 본문.

    {
      "result": {
        "error": false,
        "message": ""
      }
    }