디지털 제품 릴리스 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 62분

    • 디지털 제품 릴리스 API는 릴리스 및 정책 준수를 관리하는 엔드포인트를 제공합니다.

    이 API에는 다음에서 ServiceNow Store사용할 수 있는 (sn_dpr) 애플리케이션이 필요합니다 디지털 제품 릴리스 . 자세한 내용은 Digital Product Release 문서를 참조하십시오.

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

    릴리스 번들 상세 정보를 검색합니다.

    이 엔드포인트를 확장하여 응답 본문에 반환되는 필드와 집계 데이터를 사용자 지정할 수 있습니다. 이 엔드포인트의 기본 기능은 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

    URL 형식

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

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    sysId 릴리스 번들의 Sys_id입니다.

    테이블: 릴리스 번들 [sn_dpr_model_release_bundle]

    데이터 유형: 문자열
    표 2. 쿼리 매개변수
    이름 설명
    sendAggregation 응답 본문에 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계 데이터를 포함할지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울

    유효한 값은 다음과 같습니다.
    • true: 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계를 반환합니다.
    • 아니오: 집계를 반환하지 않습니다.

    기본값: false
    표 3. 요청 본문 매개변수(JSON)
    이름 설명
    안 함

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    집계 개선 사항, 정책, 릴리스 상태 및 작업 수에 대한 집계된 데이터입니다.

    이 매개변수는 요청에서 쿼리 매개변수가 sendAggregationtrue 로 설정된 경우에만 응답 본문에 포함됩니다.

    "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

    릴리스의 현재 단계에 대한 제품별 정책 실행 상세 정보를 가져옵니다.

    이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin
    • sn_dpr_model.release_coordinator
    • sn_dpr_model.release_user

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

    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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    releaseId 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열
    표 8. 쿼리 매개변수
    이름 설명
    없음
    표 9. 요청 본문 매개변수(JSON)
    이름 설명
    안 함

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 준수 요약 및 제품 정책 상세 정보가 포함된 객체입니다.

    데이터 유형: 객체

    "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: 평가된 모든 정책이 규정을 준수하는 것은 아닙니다.

    데이터 유형: 부울
    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

    데이터 유형: 문자열
    result.products.productId 제품의 Sys_id입니다.

    테이블: 제품 모델 [cmdb_model]

    데이터 유형: 문자열
    결과.제품.제품 이름 제품의 표시 이름입니다.

    데이터 유형: 문자열
    result.products.productVersion 최신 릴리스의 제품과 연결된 버전입니다.

    데이터 유형: 문자열
    결과.제품.요약 제품에 대한 준수 결과입니다.

    데이터 유형: 객체

    "summary": {
   "compliant": Boolean,
   "compliantCount": Number,
   "nonCompliantCount": Number,
   "totalCount": Number
}
    결과.제품.요약.준수 제품에 대한 모든 정책이 규정을 준수하는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 모든 정책이 준수합니다.
    • false: 모든 정책이 규정을 준수하는 것은 아닙니다.

    데이터 유형: 부울
    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

    제품 또는 서비스에 대한 개선 사항을 생성합니다.

    이 엔드포인트에 액세스하려면 호출자에게 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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 14. 쿼리 매개변수
    이름 설명
    없음
    표 15. 요청 본문 매개변수(JSON)
    이름 설명
    설명 개선 사항에 대한 설명입니다.

    데이터 유형: 문자열
    이름 필수 개선 사항의 이름입니다.

    데이터 유형: 문자열
    우선순위 개선 사항의 우선순위입니다.
    유효한 값은 다음과 같습니다.
    • 높음
    • 보통
    • 낮음

    기본값: 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]

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "sysId": "String"
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    result.sysId 생성된 개선 사항의 Sys_id입니다.

    표: 제품 개선 사항 [sn_dpr_model_product_enhancement]

    데이터 유형: 문자열

    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

    릴리스를 작성합니다.

    릴리스는 독립 릴리스로 생성하거나 하위 릴리스를 포함하는 기본 릴리스로 생성할 수 있습니다. 이 엔드포인트는 기존 릴리스를 초안 상태에서 진행 중으로 이동하는 데에도 사용할 수 있습니다.

    이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin

    URL 형식

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

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 20. 쿼리 매개변수
    이름 설명
    없음
    표 21. 요청 본문 매개변수(JSON)
    이름 설명
    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: 릴리스가 진행 중 상태로 생성됩니다.

    기본값: 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: 릴리스에서 버전을 확인하지 않습니다.

    기본값: false

    데이터 유형: 부울

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "message": "String",
   "progressId": "String",
   "releaseId": "String"
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    결과.메시지 API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다.

    데이터 유형: 문자열
    result.progressId 요청 매개변수에 나열된 하위 릴리스 버전의 생성 진행률에 대한 추적기의 시스템 ID입니다 autoCreateIncludedVersions .

    테이블: Progress Worker [sys_progress_worker]

    데이터 유형: 문자열
    result.releaseId 생성된 기본 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열

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

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

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

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

    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

    릴리스에 대한 키 날짜를 생성합니다.

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

    이 엔드포인트를 호출하기 전에 타임라인 지향 릴리스 를 만들어야 합니다. 타임라인 지향 릴리스는 기한이 고정되어 있고 엄격한 일정을 따르는 반면, 단계 지향 릴리스는 기한을 지키기보다는 목표와 기능을 완료하는 데 주로 중점을 둡니다.

    이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin
    • sn_dpr_model.release_coordinator

    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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    releaseId 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열
    표 26. 쿼리 매개변수
    이름 설명
    없음
    표 27. 요청 본문 매개변수(JSON)
    이름 설명
    assignedTo 키 날짜에 할당된 사용자의 Sys_id입니다.
    사용자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin
    • sn_dpr_model.release_coordinator
    • sn_dpr_model.release_user

    테이블: 사용자 [sys_user]

    데이터 유형: 문자열
    설명 키 날짜에 대한 설명입니다.

    데이터 유형: 문자열
    기한 필수 이벤트 또는 목표를 완료해야 하는 기한입니다.

    기한은 릴리스 계획된 시작 날짜와 종료 날짜 사이여야 합니다.

    형식: yyyy-MM-dd

    데이터 유형: 문자열
    이름 필수 키 날짜의 이름입니다.

    데이터 유형: 문자열
    상태 필수 키 날짜의 상태입니다.
    유효한 값은 다음과 같습니다.
    • 보관됨
    • 누락됨
    • 예정

    데이터 유형: 문자열
    유형 필수 키 날짜의 유형입니다.
    유효한 값은 다음과 같습니다.
    • 마감 기한
    • important_date
    • key_event
    • 마일스톤

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "keyDateSysId": "String",
   "message": "String"
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    result.keyDateSysId 생성된 키 날짜의 Sys_id입니다.

    테이블: 릴리스 키 날짜 [sn_dpr_model_release_key_date]

    데이터 유형: 문자열
    결과.메시지 API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다.

    데이터 유형: 문자열

    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

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

    이 엔드포인트에 액세스하려면 호출자에게 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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    releaseId 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열
    표 32. 쿼리 매개변수
    이름 설명
    없음
    표 33. 요청 본문 매개변수(JSON)
    이름 설명
    안 함

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "errorCode": "String",
   "message": "String",
   "policyExecutionScheduled": Boolean
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    result.errorCode 요청에 대한 HTTP 상태 코드입니다.

    데이터 유형: 문자열
    결과.메시지 API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다.

    데이터 유형: 문자열
    result.policyExecutionScheduled 릴리스 단계 정책이 실행되도록 예약되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 릴리스 단계 정책이 실행되도록 예약되었습니다.
    • false: 릴리스 단계 정책이 실행되도록 예약되지 않았습니다.

    데이터 유형: 부울

    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

    릴리스에 관련 작업을 추가합니다.

    디지털 제품 릴리스 작업 공간의 릴리스 탭에서 릴리스 정보를 볼 수 있습니다. 릴리스에 대한 관련 작업은 릴리스 기록의 릴리스 범위 섹션에 표시됩니다.

    중요사항:
    이 엔드포인트를 호출하기 전에 릴리스에 대한 관련 작업으로 추가할 수 있는 기존 작업 기록이 있어야 합니다. 기록은 작업 [task] 테이블을 확장하는 테이블에 있어야 하지만 작업 테이블 자체에는 없어야 합니다. 시스템 속성에서 sn_dpr_model.release_related_task_types 작업 기록이 포함된 테이블을 나열합니다.
    이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin

    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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    releaseId 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열
    표 38. 쿼리 매개변수
    이름 설명
    없음
    표 39. 요청 본문 매개변수(JSON)
    이름 설명
    taskIds 필수 릴리스에 대한 관련 작업으로 추가할 작업 sys_ids 목록입니다.

    작업 기록은 시스템 속성에 sn_dpr_model.release_related_task_types 나열된 테이블에서 가져와야 합니다. 자세한 내용은 Digital Product Release properties 문서를 참조하십시오.

    데이터 유형: 배열

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "message": "String"
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    결과.메시지 API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다.

    데이터 유형: 문자열

    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

    릴리스 달력을 생성합니다.

    이 엔드포인트에 액세스하려면 호출자에게 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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 44. 쿼리 매개변수
    이름 설명
    없음
    표 45. 요청 본문 매개변수(JSON)
    이름 설명
    설명 릴리스 달력에 대한 설명입니다.

    데이터 유형: 문자열
    이름 필수 릴리스 달력의 이름입니다.

    데이터 유형: 문자열
    릴리스관리자 필수 릴리스 달력 소유자의 Sys_id입니다.

    테이블: 사용자 [sys_user]

    데이터 유형: 문자열
    일정 릴리스 달력에 사용할 일정 sys_ids의 쉼표로 구분된 목록입니다. 예: "sysId1,sysId2,sysId3".

    테이블: 일정 [cmn_schedule]

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "message": "String",
   "releaseCalendarId": "String"
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    결과.메시지 API 요청의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다.

    데이터 유형: 문자열
    result.releaseCalendarId 생성된 릴리스 달력의 Sys_id입니다.

    테이블: 릴리스 달력 [sn_dpr_model_release_calendar]

    데이터 유형: 문자열

    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

    릴리스의 현재 단계를 완료합니다.

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

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

    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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    releaseId 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열
    표 50. 쿼리 매개변수
    이름 설명
    없음
    표 51. 요청 본문 매개변수(JSON)
    이름 설명
    안 함

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 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 요청

    이 예에서는 잘못된 릴리스 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

    릴리스 준비 대상 또는 반복 릴리스 준비 대상 집합을 생성합니다.

    이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin

    URL 형식

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

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 56. 쿼리 매개변수
    이름 설명
    없음
    표 57. 요청 본문 매개변수(JSON)
    이름 설명
    설명 준비 대상에 대한 설명입니다.

    데이터 유형: 문자열
    endDate 반복 준비 대상의 종료 날짜입니다. 예일 경우isRecurring 필요합니다.

    데이터 유형: 문자열
    isRecurring 필수 준비 대상이 반복되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 대상이 반복되고 있습니다.
    • false: 대상은 단일 날짜입니다.

    데이터 유형: 부울
    이름 필수 릴리스 준비 대상의 이름입니다.

    데이터 유형: 문자열
    릴리스관리자 필수 준비 대상 소유자의 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
    유효한 값은 다음과 같습니다.
    • 주별
    • 월별

    데이터 유형: 문자열
    scheduleSysId 릴리스 대상에 사용할 일정의 Sys_id입니다.

    테이블: 일정 [cmn_schedule]

    데이터 유형: 문자열
    startDate 필수 준비 대상의 날짜 또는 반복되는 준비 대상의 첫 번째 날짜입니다.

    데이터 유형: 문자열
    targetsWithOverlappingScheduleDetails 반복 준비 대상의 날짜 목록입니다.

    데이터 유형: 배열

    "targetsWithOverlappingScheduleDetails": [ 
   { 
      "active": Boolean, 
      "date": "String" 
   }
]
    targetsWithOverlappingScheduleDetails.active 준비 대상 반복이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 활성
    • false: 비활성입니다.

    데이터 유형: 부울
    targetsWithOverlappingScheduleDetails.date 준비 대상 반복 날짜입니다.

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "count": Number,
   "error": Boolean,
   "message": "String"
}
    결과.카운트 API 요청에 의해 생성된 릴리스 대상 수입니다.

    데이터 유형: 숫자
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    결과.메시지 오류 메시지. 성공적인 요청의 경우 이 매개변수는 비어 있습니다.

    데이터 유형: 문자열

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

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

    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

    릴리스에 대한 준비 대상을 변경합니다.

    새 준비 대상은 이미 정의된 기존 준비 대상 또는 대역 외 날짜(표준 릴리스 달력에 연결되지 않은 일회성 준비 대상)일 수 있습니다. 대역 외 날짜 sn_dpr.out_of_band_release_allowed 를 설정하려면 시스템 속성을 true로 설정해야 합니다.

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

    이 엔드포인트를 호출하기 전에 릴리스 상태가 진행 중 또는 보류 중이어야 합니다.

    이 엔드포인트에 액세스하려면 호출자에게 다음 역할 중 하나가 있어야 합니다.
    • sn_dpr_model.product_manager
    • sn_dpr_model.release_admin

    URL 형식

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

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    sysId 릴리스의 Sys_id입니다.

    테이블: 릴리스 [sn_dpr_model_release]

    데이터 유형: 문자열
    표 62. 쿼리 매개변수
    이름 설명
    없음
    표 63. 요청 본문 매개변수(JSON)
    이름 설명
    outOfBand 준비 대상이 대역 외 날짜(표준 릴리스 달력에 연결되지 않은 일회성 준비 대상)인지 여부를 나타내는 플래그입니다.

    이 매개변수는 사용되지 않으면 필수 releaseTarget  입니다.

    유효한 값은 다음과 같습니다.
    • true: 준비 대상이 대역 외입니다.
    • false: 준비 대상이 이미 정의되어 표준 릴리스 달력에 연결되어 있습니다.

    기본값: false

    데이터 유형: 부울
    releaseCalendar 준비 대상에 사용할 릴리스 달력의 릴리스 달력 Sys_id입니다. 사용하는 경우 outOfBand필수입니다.

    테이블: 릴리스 달력 [sn_dpr_model_release_calendar]

    데이터 유형: 문자열
    릴리스 날짜 준비 대상의 날짜입니다. 사용하는 경우 outOfBand필수입니다.

    데이터 유형: 문자열
    릴리스 대상 릴리스 준비 대상의 Sys_id입니다.

    이 매개변수를 사용하여 기존 준비 대상을 선택합니다. 이 매개변수 또는 outOfBand 새 대상을 설정하는 데 필요합니다.

    테이블: 릴리스 준비 대상 [sn_dpr_model_release_target]

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    응답 본문 매개변수(JSON)

    이름 설명
    결과 API 요청에 대한 상세 정보입니다.

    데이터 유형: 객체

    "result": {
   "error": Boolean,
   "message": "String"
}
    결과.오류 API 요청에 오류가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 오류.
    • false: 오류 없음.

    데이터 유형: 부울
    결과.메시지 오류 메시지. 성공적인 요청의 경우 이 매개변수는 비어 있습니다.

    데이터 유형: 문자열

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

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

    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": ""
  }
}