---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DevOps 구성 API

# DevOps 구성 API {#ariaid-title1}

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

DevOps 구성 API는 애플리케이션을 관리하기 위한 엔드포인트를 제공합니다.
이 API는 DevOps 구성 애플리케이션이 필요하며 `sn_devops_config` 네임스페이스 내에서 제공됩니다.

DELETE, PATCH 및 POST 작업의 경우 호출하는 사용자에게 sn_devops_config.admin 역할이 있어야 합니다. GET 작업의 경우 호출하는 사용자에게 sn_devops_config.viewer 또는 sn_devops_config.admin 역할이 있어야 합니다.

애플리케이션 수명주기 관리를 위해 DevOps 구성 API를 사용합니다. 를 사용하여 DevOps 구성애플리케이션을 관리하는 방법에 대한 자세한 내용은 [DevOps 구성 단원을](https://www.servicenow.com/docs/access?context=setting-up-devops-config-validation&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US) 참조하십시오.

## DevOps 구성 - DELETE /devops_config/application/{appid} {#ariaid-title2}

애플리케이션을 삭제합니다.

### URL 형식

버전이 지정된 URL: /api/sn_devops_config/v1/devops_config/application/{appid}

기본 URL: /api/sn_devops_config/devops_config/application/{appid}

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

{#devops-config-DELETE-app__entry__2}{#devops-config-DELETE-app__version-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| appid | 삭제할 애플리케이션의 Sys_id입니다. CDM 애플리케이션 \[sn_cdm_application\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#devops-config-DELETE-app__entry__8}

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

{#devops-config-DELETE-app__entry__12}

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

### 헤더

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

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

{#devops-config-DELETE-app__table_kwn_v1r_fvb} {#devops-config-DELETE-app__entry__20}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 5. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#devops-config-DELETE-app__table_egh_yyl_gvb__entry__2}{#devops-config-DELETE-app__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 애플리케이션 ID입니다. |
| 403 | 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다. |
[표 6. 상태 코드]

{#devops-config-DELETE-app__table_egh_yyl_gvb}

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

{#devops-config-DELETE-app__table_z3v_z5d_gvb__entry__2}

| 이름 | 설명 |
|-|-|
| 오류 | 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 데이터 유형: 객체 "error": { "message": "String", "detail": "String" } |
| 오류.상세 정보 | 요청이 실패한 이유에 대한 추가 세부 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지입니다. 데이터 유형: 문자열 |
| 결과 | 요청에 대한 정보를 포함하는 결과 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "success": [Array] } |
| 결과.오류 | 요청의 오류 배열입니다. 성공적인 요청에 대한 배열은 비어 있습니다. 데이터 유형: 배열 |
| 결과.성공 | 요청에 대한 성공 메시지입니다. 실패한 요청에 대한 배열이 비어 있습니다. 데이터 유형: 배열 |
| 상태 | 요청의 상태입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 가능한 값: 실패 데이터 유형: 문자열 |
[ ]

{#devops-config-DELETE-app__table_z3v_z5d_gvb}  

### cURL 요청

이 예제에서는 응용 프로그램을 삭제합니다.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

응답 본문입니다.

    { 
      "result": { 
        "errors": [], 
        "success": [ 
          "CDM Application Demo Application 1234 has been deleted successfully." 
        ] 
      } 
    }

### cURL 요청 {#devops-config-DELETE-app__example_ssd_qph_hvb}

이 예제에서는 사용자에게 API에 액세스할 수 있는 권한이 없는 경우 오류 응답을 보여 줍니다.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

오류 응답.

    { 
      "error": { 
        "message": "User Not Authorized", 
        "detail": "Failed API level ACL Validation" 
      }, 
      "status": "failure" 
    }

## DevOps 구성 - GET /devops_config/application/{appid} {#ariaid-title3}

애플리케이션을 검색합니다.

### URL 형식

버전이 지정된 URL: /api/sn_devops_config/v1/devops_config/application/{appid}

기본 URL: /api/sn_devops_config/devops_config/application/{appid}

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

{#devops-config-GET-app__entry__2}{#devops-config-GET-app__version-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| appid | 검색할 애플리케이션의 Sys_id입니다. CDM 애플리케이션 \[sn_cdm_application\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#devops-config-GET-app__entry__8}

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

{#devops-config-GET-app__entry__12}

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

### 헤더

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

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

{#devops-config-GET-app__table_kwn_v1r_fvb} {#devops-config-GET-app__entry__20}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 11. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#devops-config-GET-app__entry__24}{#devops-config-GET-app__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 애플리케이션 ID입니다. |
| 403 | 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다. |
[표 12. 상태 코드]

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

{#devops-config-GET-app__table_z3v_z5d_gvb__entry__2}

| 이름 | 설명 |
|-|-|
| 오류 | 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 데이터 유형: 객체 "error": { "message": "String", "detail": "String" } |
| 오류.상세 정보 | 요청이 실패한 이유에 대한 추가 세부 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지입니다. 데이터 유형: 문자열 |
| 결과 | 요청에 대한 정보를 포함하는 결과 객체입니다. 데이터 유형: 객체 "result": { "data": {Object}, "message": "String", "status": Number } |
| 결과.데이터 | 애플리케이션에 대한 데이터입니다. 데이터 유형: 객체 "data": { "appDescription": "String", "appId": "String", "appManagedByGroups": [Array], "appManufacturerId": "String", "appManufacturerName": "String", "appModelId": "String", "appModelName": "String", "appModelOwnerId": "String", "appModelOwnerName": "String", "appName": "String", "sdlcType": "String" } |
| result.data.appDescription | 애플리케이션에 대한 설명입니다. 데이터 유형: 문자열 |
| result.data.appId | 애플리케이션의 Sys_id입니다. CDM 애플리케이션 \[sn_cdm_application\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.data.appManagedByGroups | 애플리케이션을 관리하는 그룹의 쉼표로 구분된 sys_ids 목록입니다. 그룹 \[sys_user_group\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.data.appManufacturerId | 제조업체의 Sys_id입니다. 회사 \[core_company\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.data.app제조업체 이름 | 제조업체의 이름입니다. 데이터 유형: 문자열 |
| result.data.appModelId | 애플리케이션 모델의 Sys_id입니다. 애플리케이션 모델 \[cmdb_application_product_model\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.data.appModelName | 애플리케이션 모델의 이름입니다. 애플리케이션 모델 \[cmdb_application_product_model\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.data.appModelOwnerId | 애플리케이션 모델 소유자의 Sys_id입니다. 사용자 \[sys_user\] 테이블에 있습니다. 데이터 유형: 문자열 |
| result.data.appModelOwnerName | 애플리케이션 모델 소유자의 이름입니다. 데이터 유형: 문자열 |
| result.data.appName | 애플리케이션의 이름입니다. 데이터 유형: 문자열 |
| 결과.데이터.오류 | 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 데이터 유형: 문자열 |
| result.data.sdlcType | 애플리케이션의 유형입니다. 가능한 값: * 애플리케이션 * 인프라 {#devops-config-GET-app__ul_rt4_x3q_dvb} 데이터 유형: 문자열 |
| 결과.메시지 | 요청의 성공 또는 실패 결과에 대한 정보입니다. 데이터 유형: 문자열 |
| 결과.상태 | 요청의 상태 코드입니다. 가능한 값: * 200 * 400 * 403 {#devops-config-GET-app__ul_cvg_nkh_hvb} 데이터 유형: 숫자 |
| 상태 | 요청의 상태입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 가능한 값: 실패 데이터 유형: 문자열 |
[ ]

{#devops-config-GET-app__table_z3v_z5d_gvb}  

### cURL 요청

이 예제에서는 응용 프로그램을 검색합니다.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

응답 본문입니다.

    { 
      "result": { 
        "status": 200, 
        "message": "Success", 
        "data": { 
          "appName": "Demo Application 1234", 
          "appId": "38e17dc3473d111072566862736d43c7", 
          "appDescription": "Updated description of Demo Application created from REST API", 
          "sdlcType": "application", 
          "appModelId": "a4e13dc3473d111072566862736d4307", 
          "appModelName": "Demo Application 1234", 
          "appManufacturerId": "262702654725d950a34a3085d36d435e", 
          "appManufacturerName": "", 
          "appModelOwnerId": "6816f79cc0a8016401c5a33be04be441", 
          "appModelOwnerName": "System Administrator", 
          "appManagedByGroups": [] 
        } 
      } 
    }

### cURL 요청 {#devops-config-GET-app__example_wfs_2qh_hvb}

이 예제에서는 사용자가 잘못된 애플리케이션 ID를 제공할 때의 오류 응답을 보여 줍니다.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/18a17de3283d15107256686277777777" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

오류 응답.

    { 
      "result": { 
        "status": 400, 
        "message": "No valid Application", 
        "data": { 
          "error": "No valid Application" 
        } 
      } 
    }

## DevOps 구성 - PATCH /devops_config/application/{appid} {#ariaid-title4}

애플리케이션을 업데이트합니다.

### URL 형식

버전이 지정된 URL: /api/sn_devops_config/v1/devops_config/application/{appid}

기본 URL: /api/sn_devops_config/devops_config/application/{appid}

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

{#devops-config-PATCH-app__entry__2}{#devops-config-PATCH-app__version-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열 |
| appid | 업데이트할 애플리케이션의 Sys_id입니다. CDM 애플리케이션 \[sn_cdm_application\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 13. 경로 매개변수]

{#devops-config-PATCH-app__entry__8}

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

{#devops-config-PATCH-app__entry__12}{#devops-config-PATCH-app__app-descr}{#devops-config-PATCH-app__app-mfct}{#devops-config-PATCH-app__app-owner-id}

| 이름 | 설명 |
|-|-|
| app설명 | 애플리케이션에 대한 설명입니다. 데이터 유형: 문자열 |
| appManagedByGroups (영문) | 애플리케이션을 관리하는 그룹의 쉼표로 구분된 sys_ids 목록입니다. 호출하는 사용자는 이러한 그룹에 속해야 합니다. 그룹 \[sys_user_group\] 테이블에 있습니다. 데이터 유형: 문자열 "appManagedByGroups": "sys_id, sys_id" |
| app제조업체ID | 제조업체의 Sys_id입니다. 회사 \[core_company\] 테이블에 있습니다. 데이터 유형: 문자열 |
| appModelOwnerId (영문) | 애플리케이션 모델 소유자의 Sys_id입니다. 사용자 \[sys_user\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 15. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#devops-config-PATCH-app__table_kwn_v1r_fvb} {#devops-config-PATCH-app__entry__28}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 17. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#devops-config-PATCH-app__table_jk3_y1r_fvb__entry__2}

| 상태 코드 | 설명 |
|-|-|
| 200 | 애플리케이션이 성공적으로 업데이트되었습니다. |
| 403 | 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다. |
| 404 | 애플리케이션이 업데이트되지 않았습니다. 개체의 속성 result 에는 message 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

{#devops-config-PATCH-app__table_jk3_y1r_fvb}

### 응답 본문 매개변수(JSON) {#devops-config-PATCH-app__section_y3v_z5d_gvb}

{#devops-config-PATCH-app__table_z3v_z5d_gvb__entry__2}

| 이름 | 설명 |
|-|-|
| 오류 | 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 데이터 유형: 객체 "error": { "message": "String", "detail": "String" } |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지입니다. 데이터 유형: 문자열 |
| 오류.상세 정보 | 요청이 실패한 이유에 대한 추가 세부 정보입니다. 데이터 유형: 문자열 |
| 결과 | 애플리케이션에 대한 정보가 포함된 결과 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "data": "String" } |
| 결과.메시지 | 요청의 성공 또는 실패 결과에 대한 정보입니다. 데이터 유형: 문자열 |
| 결과.데이터 | 애플리케이션의 Sys_id입니다. CDM 애플리케이션 \[sn_cdm_application\] 테이블에 있습니다. 데이터 유형: 문자열 |
| 상태 | 요청의 상태입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 가능한 값: 실패 데이터 유형: 문자열 |
[ ]

{#devops-config-PATCH-app__table_z3v_z5d_gvb}  

### cURL 요청

이 예제에서는 기존 응용 프로그램을 업데이트합니다.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request PATCH \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"appDescription\": \"Updated description of Demo Application created from REST API\", 
      \"appManufacturerId\": \"262702654725d950a34a3085d36d435e\", 
      \"appModelOwnerId\": \"6816f79cc0a8016401c5a33be04be441\" 
    }" \ 
    --user 'username':'password' 

응답 본문입니다.

    { 
      "result": { 
        "message": "Application with name Demo Application 1234 updated successfully.", 
        "data": "38e17dc3473d111072566862736d43c7" 
      } 
    }

## DevOps 구성 - POST /devops_config/application {#ariaid-title5}

애플리케이션을 작성합니다.

### URL 형식

버전이 지정된 URL: /api/sn_devops_config/v1/devops_config/application

기본 URL: /api/sn_devops_config/devops_config/application

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

{#devops-config-POST-app__entry__2}{#devops-config-POST-app__version-RESTAPI}

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

{#devops-config-POST-app__entry__6}

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

{#devops-config-POST-app__entry__10}{#devops-config-POST-app__app-descr}{#devops-config-POST-app__app-mfct}{#devops-config-POST-app__app-owner-id}

| 이름 | 설명 |
|-|-|
| app설명 | 애플리케이션에 대한 설명입니다. 데이터 유형: 문자열 |
| appManagedByGroups (영문) | 애플리케이션을 관리하는 그룹의 쉼표로 구분된 sys_ids 목록입니다. 호출하는 사용자는 이러한 그룹에 속해야 합니다. 그룹 \[sys_user_group\] 테이블에 있습니다. 데이터 유형: 문자열 "appManagedByGroups": "sys_id, sys_id" |
| app제조업체ID | 제조업체의 Sys_id입니다. 회사 \[core_company\] 테이블에 있습니다. 데이터 유형: 문자열 |
| appModelId (영문) | 애플리케이션을 생성하는 데 사용할 기존 애플리케이션 모델의 Sys_id입니다. 애플리케이션 모델 \[cmdb_application_product_model\] 테이블에 있습니다. 이 매개변수가 제공된 경우 , appModelName, appServiceIdappServiceName, 또는 technicalServiceId 매개변수를 appName제공하지 마십시오. 데이터 유형: 문자열 |
| appModelName(앱 모델 이름) | 애플리케이션을 생성하는 데 사용할 기존 애플리케이션 모델의 이름입니다. 애플리케이션 모델 \[cmdb_application_product_model\] 테이블에 있습니다. 이 매개변수가 제공된 경우 , appModelId, appServiceIdappServiceName, 또는 technicalServiceId 매개변수를 appName제공하지 마십시오. 데이터 유형: 문자열 |
| appModelOwnerId (영문) | 애플리케이션 모델 소유자의 Sys_id입니다. 사용자 \[sys_user\] 테이블에 있습니다. 데이터 유형: 문자열 |
| appName | 애플리케이션의 이름입니다. 기존 애플리케이션과 동일한 이름을 사용하지 마세요. 이 매개변수가 제공된 경우 , appModelId, appServiceIdappServiceName, 또는 technicalServiceId 매개변수를 appModelName제공하지 마십시오. 데이터 유형: 문자열 |
| appServiceId | 애플리케이션을 생성하는 데 사용할 기존 애플리케이션 서비스의 Sys_id입니다. 애플리케이션 서비스 \[cmdb_ci_service_auto\] 테이블에 있습니다. <kbd class="ph userinput">애플리케이션이</kbd> 있는 경우에만 이 매개변수를 type 사용하십시오. 이 매개변수가 제공된 경우 , appModelName, appServiceNameappModelId, 또는 technicalServiceId 매개변수를 appName제공하지 마십시오. 데이터 유형: 문자열 |
| appServiceName | 애플리케이션을 생성하는 데 사용할 기존 애플리케이션 서비스의 이름입니다. 애플리케이션 서비스 \[cmdb_ci_service_auto\] 테이블에 있습니다. <kbd class="ph userinput">애플리케이션이</kbd> 있는 경우에만 이 매개변수를 type 사용하십시오. 이 매개변수가 제공된 경우 , appModelName, appServiceIdappModelId, 또는 technicalServiceId 매개변수를 appName제공하지 마십시오. 데이터 유형: 문자열 |
| technicalServiceId (영문) | 애플리케이션을 생성하는 데 사용할 기존 동적 CI 그룹의 Sys_id입니다. 동적 CI 그룹 \[cmdb_ci_query_based_service\] 테이블에 있습니다. <kbd class="ph userinput">is 인프라</kbd>인 경우에만 이 매개변수를 type 사용하십시오. 이 매개변수가 제공된 경우 , appModelName, appServiceNameappModelId, 또는 appServiceId 매개변수를 appName제공하지 마십시오. 데이터 유형: 문자열 |
| 유형 | 필수 작성할 애플리케이션의 유형입니다. 유효한 값은 다음과 같습니다. * 애플리케이션 * 인프라 {#devops-config-POST-app__ul_rt4_x3q_dvb} 데이터 유형: 문자열 |
[표 21. 요청 본문 매개변수(JSON)]

### 헤더

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

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

{#devops-config-POST-app__entry__40}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 23. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#devops-config-POST-app__entry__44}

| 상태 코드 | 설명 |
|-|-|
| 201 | 신청서가 성공적으로 작성되었습니다. |
| 403 | 금지되었습니다. 사용자에게 API에 액세스할 수 있는 권한이 없습니다. |
| 404 | 애플리케이션이 생성되지 않았습니다. 개체의 속성 result 에는 message 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수(JSON) {#devops-config-POST-app__section_y3v_z5d_gvb}

{#devops-config-POST-app__table_z3v_z5d_gvb__entry__2}

| 이름 | 설명 |
|-|-|
| 오류 | 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 데이터 유형: 객체 "error": { "message": "String", "detail": "String" } |
| 오류.메시지 | 요청이 실패한 이유를 포함하는 오류 메시지입니다. 데이터 유형: 문자열 |
| 오류.상세 정보 | 요청이 실패한 이유에 대한 추가 세부 정보입니다. 데이터 유형: 문자열 |
| 결과 | 애플리케이션에 대한 정보가 포함된 결과 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "data": "String" } |
| 결과.메시지 | 요청의 성공 또는 실패 결과에 대한 정보입니다. 데이터 유형: 문자열 |
| 결과.데이터 | 애플리케이션의 Sys_id입니다. CDM 애플리케이션 \[sn_cdm_application\] 테이블에 있습니다. 데이터 유형: 문자열 |
| 상태 | 요청의 상태입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 가능한 값: 실패 데이터 유형: 문자열 |
[ ]

{#devops-config-POST-app__table_z3v_z5d_gvb}  

### cURL 요청

이 예제에서는 새 응용 프로그램을 만듭니다.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"type\": \"application\", 
      \"appName\": \"Demo Application 1234\", 
      \"appDescription\": \"Description of Demo Application created from REST API\", 
      \"appManufacturerId\": \"262702654725d950a34a3085d36d435e\", 
      \"appModelOwnerId\": \"6816f79cc0a8016401c5a33be04be441\" 
    }" \ 
    --user 'username':'password' 

응답 본문입니다.

    { 
      "result": { 
        "message": "Application with name Demo Application 1234 created successfully.", 
        "data": "38e17dc3473d111072566862736d43c7" 
      } 
    }