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


---

# DevOps 구성 API

# DevOps 구성 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](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=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하십시오.

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

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

### URL 형식

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

기본 URL: /api/sn_devops_config/devops_config/application/{appid}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#devops-config-DELETE-app__entry__2}{#devops-config-DELETE-app__version-not_optional-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/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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": { "detail": "String", "message": "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/{api_version}/devops_config/application/{appid}

기본 URL: /api/sn_devops_config/devops_config/application/{appid}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#devops-config-GET-app__entry__2}{#devops-config-GET-app__version-not_optional-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/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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": { "detail": "String", "message": "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.appManufacturerName | 제조업체의 이름입니다. 데이터 유형: 문자열 |
| 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/{api_version}/devops_config/application/{appid}

기본 URL: /api/sn_devops_config/devops_config/application/{appid}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#devops-config-PATCH-app__entry__2}{#devops-config-PATCH-app__version-not_optional-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}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 요청 실패 원인에 대한 추가 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청에 실패한 이유를 포함하는 오류 메시지입니다. 데이터 유형: 문자열 |
| 결과 | 애플리케이션에 대한 정보를 포함하는 결과 객체입니다. 데이터 유형: 객체 "result": { "data": "String", "message": "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/{api_version}/devops_config/application

기본 URL: /api/sn_devops_config/devops_config/application  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#devops-config-POST-app__entry__2}{#devops-config-POST-app__version-not_optional-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}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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": { "detail": "String", "message": "String" } |
| 오류.상세 정보 | 요청 실패 원인에 대한 추가 정보입니다. 데이터 유형: 문자열 |
| 오류.메시지 | 요청에 실패한 이유를 포함하는 오류 메시지입니다. 데이터 유형: 문자열 |
| 결과 | 애플리케이션에 대한 정보를 포함하는 결과 객체입니다. 데이터 유형: 객체 "result": { "data": "String", "message": "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" 
      } 
    }