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


---

# CI 수명주기 관리 API

# CI 수명주기 관리 API {#ariaid-title1}

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

CI 수명주기 관리 API는 CI(구성 항목) 운영 상태를 조작하고 CI 작업을 적용할 수 있는 엔드포인트를 제공합니다.
API 인터페이스는 허용되지 않는 CI 작업, 호환 가능한 CI 작업 및 허용되지 않는 운영 전환에 지정된 제한 및 허용량을 준수합니다. 인터페이스가 제한된 작업을 시도하면 작업이 차단되고 오류가 기록되며 적절한 경우 작업이 생성됩니다.

## CI 수명주기 관리 - DELETE /now/cilifecyclemgmt/actions {#ariaid-title2}

CI 목록에 대한 CI(구성 항목) 작업을 제거합니다.

### URL 형식 {#cilifecyclemgmt-DELETE-actions__section_fcm_jph_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/actions

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

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

{#cilifecyclemgmt-DELETE-actions__entry__2}{#cilifecyclemgmt-DELETE-actions__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-DELETE-actions__entry__6}{#cilifecyclemgmt-DELETE-actions__requestor-id-query-param-desc-entry}

| 이름 | 설명 |
|-|-|
| actionName | 필수 구성 항목 작업 이름입니다. 데이터 유형: 문자열 |
| requestorId | 필수 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다. 데이터 유형: 문자열 |
| sysID | 필수 쉼표로 구분된 CI sys_ids 목록입니다. 데이터 유형: 문자열 |
[표 2. 쿼리 매개변수]

{#cilifecyclemgmt-DELETE-actions__entry__14}

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

### 헤더

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

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

{#cilifecyclemgmt-DELETE-actions__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

{#cilifecyclemgmt-DELETE-actions__table_od5_2wf_mmb}

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

{#cilifecyclemgmt-DELETE-actions__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-DELETE-actions__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | CI 작업이 성공적으로 제거되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: CI 작업이 제거되었습니다. * false: CI 작업이 제거되지 않았습니다. {#cilifecyclemgmt-DELETE-actions__ul_psg_lsh_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

두 CI에서 CI 작업을 제거합니다.

    curl --request DELETE \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/actions?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a&sysIds=00a9a80d3790200044e0bfc8bcbe5d1c,d0fdbc8437201000deeabfc8bcbe5d33' \
    --header 'Accept: application/json' \
    --user "username":"password"

응답 본문은 CI 작업이 CI에서 제거되었음을 확인합니다.

    {
      "result": {
        "result": true
      }
    }

## CI 수명주기 관리 - DELETE /now/cilifecyclemgmt/operators/{req_id} {#ariaid-title3}

비워크플로우 사용자에 대한 연산자 등록을 취소합니다.

### URL 형식 {#cilifecyclemgmt-DELETE-operators__section_xyw_syh_dmb}

버전 관리된 URL: /api/now/{api_version}/cilifecyclemgmt/operators/{req_id}

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

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

{#cilifecyclemgmt-DELETE-operators__entry__2}{#cilifecyclemgmt-DELETE-operators__version-not_optional-RESTAPI}{#cilifecyclemgmt-DELETE-operators__req-id-data-type-p}

| 매개변수 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| req_id | 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다.{#cilifecyclemgmt-DELETE-operators__req-id-table-p} 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#cilifecyclemgmt-DELETE-operators__entry__8}

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

{#cilifecyclemgmt-DELETE-operators__entry__12}

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

### 헤더

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

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

{#cilifecyclemgmt-DELETE-operators__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

{#cilifecyclemgmt-DELETE-operators__table_hsj_2wf_mmb}

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

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-DELETE-operators__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 운영자가 성공적으로 등록 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 운영자가 성공적으로 등록 취소되었습니다. * false: 운영자가 성공적으로 등록 취소되지 않았습니다. {#cilifecyclemgmt-DELETE-operators__ul_mkt_tlk_lmb} 데이터 유형: 문자열 |
[ ]

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb}  

### cURL 요청

사용자 ID로 운영자 등록을 취소합니다.

    curl --request DELETE \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/operators/3cf1b3cc30121010f877773aa7167c6e" \
    --header "Accept: application/json" \
    --user "username":"password"

응답 본문은 운영자가 등록 취소되었는지 확인합니다.

    {
      "result": {
        "result": true
      }
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/actions/{sys_id} {#ariaid-title4}

지정된 CI에 대한 활성 CI(구성 항목) 작업 목록을 반환합니다.

### URL 형식 {#cilifecyclemgmt-GET-actions__section_m1y_5xm_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/actions/{sys_id}

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

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

{#cilifecyclemgmt-GET-actions__entry__2}{#cilifecyclemgmt-GET-actions__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-actions__entry__8}

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

{#cilifecyclemgmt-GET-actions__entry__12}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-actions__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.ciActions 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

{#cilifecyclemgmt-GET-actions__table_lrs_cwf_mmb}

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

{#cilifecyclemgmt-GET-actions__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| result.ciActions | CI에 대한 활성 CI 작업의 쉼표로 구분된 목록이거나 아무 것도 찾을 수 없는 경우 `no_active_action` 목록입니다. 데이터 유형: 문자열 |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-actions__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 지정된 모든 CI에 대해 활성 CI 작업 목록이 반환되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 활성 CI 작업 목록이 반환되었습니다. * false: 활성 CI 작업 목록이 반환되지 않았습니다. {#cilifecyclemgmt-GET-actions__ul_psg_lsh_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/actions/00a9a80d3790200044e0bfc8bcbe5d1c' \
    --header 'Accept: application/json' \
    --user "username":"password"

응답 본문은 지정된 CI에 대해 활성 상태인 CI 작업이 없음을 보여줍니다.

    {
      "result": {
        "ciActions": [
          "no_active_action"
        ],
        "result": true
      }
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/compatActions {#ariaid-title5}

두 개의 지정된 CI(구성 항목) 작업이 호환되는지 여부를 결정합니다.

### URL 형식 {#cilifecyclemgmt-GET-compatAction__section_rgg_g2n_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/compatActions

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

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

{#cilifecyclemgmt-GET-compatAction__entry__2}{#cilifecyclemgmt-GET-compatAction__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-compatAction__entry__6}

| 이름 | 설명 |
|-|-|
| actionName | 필수 비교할 CI 작업의 이름입니다. 데이터 유형: 문자열 |
| otherActionName | 필수 비교할 CI 작업의 이름입니다. 데이터 유형: 문자열 |
[표 20. 쿼리 매개변수]

{#cilifecyclemgmt-GET-compatAction__entry__12}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-compatAction__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

{#cilifecyclemgmt-GET-compatAction__table_vz1_cwf_mmb}

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

{#cilifecyclemgmt-GET-compatAction__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 두 CI 작업이 호환되는지 여부를 나타내는 플래그입니다. 가능한 값: * true: CI 작업이 호환됩니다. * false: CI 작업이 호환되지 않습니다. {#cilifecyclemgmt-GET-compatAction__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

패치 적용 및 프로비저닝 CI 작업의 호환성을 확인합니다.

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/compatActions?actionName=Patching&otherActionName=Provisioning' \
    --header 'Accept: application/json' \
    --user "username":"password"

응답 본문은 두 CI 작업이 호환 가능함을 확인합니다.

    {
      "result": true
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/leases/{sys_id}/expired {#ariaid-title6}

지정된 CI에 적용된 CI(구성 항목) 작업의 요청자에 대한 임대가 만료되었는지 여부를 결정합니다.

### URL 형식 {#cilifecyclemgmt-GET-leases-expired__section_kgl_mjn_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}/expired

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

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

{#cilifecyclemgmt-GET-leases-expired__entry__2}{#cilifecyclemgmt-GET-leases-expired__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-leases-expired__entry__8}{#cilifecyclemgmt-GET-leases-expired__requestor-id-query-param-desc-entry}

| 이름 | 설명 |
|-|-|
| actionName | 필수 지정된 CI에 적용되는 CI 작업의 이름입니다. 데이터 유형: 문자열 |
| requestorId | 필수 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 26. 쿼리 매개변수]

{#cilifecyclemgmt-GET-leases-expired__entry__14}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-leases-expired__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 30. 상태 코드]

{#cilifecyclemgmt-GET-leases-expired__table_hwr_bwf_mmb}

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

{#cilifecyclemgmt-GET-leases-expired__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-leases-expired__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 적용된 CI 작업의 요청자에 대한 임대가 만료되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 요청자의 임대가 만료되었습니다. * false: 요청자의 임대가 만료되지 않았습니다. {#cilifecyclemgmt-GET-leases-expired__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/leases/00a9a80d3790200044e0bfc8bcbe5d1c/expired?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a' \
    --header 'Accept: application/json' \
    --user "username":"password"

응답 본문은 적용된 CI 작업의 요청자에 대한 임대가 만료되지 않았음을 보여줍니다.

    {
      "result": {
        "result": false
      }
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/notAllowedAction {#ariaid-title7}

지정된 운영 상태에 있을 때 지정된 클래스의 CI에 대해 지정된 CI(구성 항목) 작업이 허용되지 않는지 여부를 결정합니다.

### URL 형식 {#cilifecyclemgmt-GET-notAllowedAct__section_wbv_pln_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/notAllowedAction

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

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__2}{#cilifecyclemgmt-GET-notAllowedAct__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__6}

| 이름 | 설명 |
|-|-|
| actionName | 필수 확인할 CI 작업의 이름입니다. 데이터 유형: 문자열 |
| ciClass | 필수 CI 클래스입니다. 데이터 유형: 문자열 |
| opsLabel | 필수 검사할 운영 상태입니다. 데이터 유형: 문자열 |
[표 32. 쿼리 매개변수]

{#cilifecyclemgmt-GET-notAllowedAct__entry__14}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 36. 상태 코드]

{#cilifecyclemgmt-GET-notAllowedAct__table_qqg_bwf_mmb}

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 운영 상태일 때 지정된 유형의 CI에 대해 CI 작업이 제한되는지(허용되지 않음) 여부를 나타내는 플래그입니다. 가능한 값: * true: CI 작업이 제한됨(허용되지 않음) * false: CI 작업이 제한되지 않습니다(허용됨). {#cilifecyclemgmt-GET-notAllowedAct__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

DR 비상 대기 모드 작동 상태의 컴퓨터에 대해 CI 패치 적용 작업이 제한되는지(허용되지 않음) 확인합니다.

    curl --request GET \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/notAllowedAction?actionName=Patching&ciClass=cmdb_ci_computer&opsLabel=DR+Standby" \
    --header "Accept: application/json" \
    --user "username":"password"

응답 본문은 지정된 운영 상태일 때 지정된 CI 클래스에 대해 이 작업이 제한적인(허용되지 않음) 확인합니다.

    {
      "result": true
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/notAllowedOpsTransition {#ariaid-title8}

지정된 클래스의 CI(구성 항목)가 지정된 운영 상태에서 두 번째 지정된 운영 상태로 전환될 수 있는지 여부를 결정합니다.

### URL 형식 {#cilifecyclemgmt-GET-notAllowedOps__section_dmp_44n_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/notAllowedOpsTransition

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

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

{#cilifecyclemgmt-GET-notAllowedOps__entry__2}{#cilifecyclemgmt-GET-notAllowedOps__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-notAllowedOps__entry__6}

| 이름 | 설명 |
|-|-|
| ciClass | 필수 전환 제한을 확인할 CI 클래스입니다. 데이터 유형: 문자열 |
| opsLabel | 필수 현재 CI 운영 상태의 레이블입니다. 데이터 유형: 문자열 |
| transitionOpsLabel | 필수 전환 대상인 운영 상태의 레이블입니다. 데이터 유형: 문자열 |
[표 38. 쿼리 매개변수]

{#cilifecyclemgmt-GET-notAllowedOps__entry__14}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-notAllowedOps__entry__22}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 42. 상태 코드]

{#cilifecyclemgmt-GET-notAllowedOps__table_clt_1wf_mmb}

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

{#cilifecyclemgmt-GET-notAllowedOps__entry__34}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 CI 클래스에 대해 지정된 운영 상태 전환이 제한되는지(허용되지 않음) 여부를 나타내는 플래그입니다. 가능한 값: * true: 운영 상태 전환이 제한됩니다(허용되지 않음). * false: 운영 상태 전환이 제한되지 않음(허용됨)입니다. {#cilifecyclemgmt-GET-notAllowedOps__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

Linux 서버 CI에 대해 폐기됨 운영 상태에서 DR 비상 대기 모드 운영 상태로 전환이 제한된(허용되지 않음) 있는지 확인합니다.

    curl --request GET \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/notAllowedOpsTransition?ciClass=cmdb_ci_computer&opsLabel=Retired&transitionOpsLabel=DR+Standby" \
    --header "Accept: application/json" \
    --user "username":"password"

응답 본문은 지정된 운영 상태 전환이 이 CI 클래스에 대해 제한되지 않음(허용됨)임을 보여줍니다.

    {
      "result": false
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/requestors/{req_id}/valid {#ariaid-title9}

지정된 활성 워크플로우 사용자 또는 등록된 사용자가 유효한 요청자인지 여부를 결정합니다.

### URL 형식 {#cilifecyclemgmt-GET-req-valid__section_gdl_3d4_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/requestors/{req_id}/valid

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

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

{#cilifecyclemgmt-GET-req-valid__entry__2}{#cilifecyclemgmt-GET-req-valid__version-not_optional-RESTAPI}{#cilifecyclemgmt-GET-req-valid__req-id-data-type-p}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| req_id | 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다.{#cilifecyclemgmt-GET-req-valid__req-id-table-p} 데이터 유형: 문자열 |
[표 43. 경로 매개변수]

{#cilifecyclemgmt-GET-req-valid__entry__8}

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

{#cilifecyclemgmt-GET-req-valid__entry__12}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-req-valid__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 48. 상태 코드]

{#cilifecyclemgmt-GET-req-valid__table_mbj_1wf_mmb}

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

{#cilifecyclemgmt-GET-req-valid__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-req-valid__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 지정된 활성 워크플로우 사용자 또는 등록된 사용자가 유효한 요청자인지 여부를 나타내는 플래그입니다. 가능한 값: * true: 올바른 요청자입니다. * 아니오: 잘못된 요청자입니다. {#cilifecyclemgmt-GET-req-valid__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/requestors/4cab9b95301a9010f877773aa7167ca9/valid' \
    --header 'Accept: application/json' \
    --user "username":"password"

    {
      "result": {
        "result": true
      }
    }

## CI 수명주기 관리 - GET /now/cilifecyclemgmt/statuses/{sys_id} {#ariaid-title10}

지정된 CI(구성 항목)에 대한 현재 운영 상태를 반환합니다.

### URL 형식 {#cilifecyclemgmt-GET-statuses__section_bgd_bf4_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/statuses/{sys_id}

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

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

{#cilifecyclemgmt-GET-statuses__entry__2}{#cilifecyclemgmt-GET-statuses__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-statuses__entry__8}

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

{#cilifecyclemgmt-GET-statuses__entry__12}

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

### 헤더

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

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

{#cilifecyclemgmt-GET-statuses__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 54. 상태 코드]

{#cilifecyclemgmt-GET-statuses__table_pdp_yvf_mmb}

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

{#cilifecyclemgmt-GET-statuses__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-statuses__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| result.operationalStates | 지정된 CI의 운영 상태 또는 상태가 지정되지 않은 경우 `알 수 없음` . 데이터 유형: 문자열 |
[ ]

### cURL 요청

    curl --request GET 'https://instance.service-now.com/api/now/cilifecyclemgmt/statuses/aac0b1213784200044e0bfc8bcbe5de3' \
    --header 'Accept: application/json' \
    --user "username":"password"

    {
      "result": {
        "operationalState": "Repair in Progress",
        "result": true
      }
    }

## CI 수명주기 관리 - PATCH /now/cilifecyclemgmt/leases/{sys_id} {#ariaid-title11}

지정된 사용자에 대한 지정된 CI(구성 항목) 작업의 임대 만료 시간을 연장합니다.
이전 임대가 만료된 경우 새 임대 시간이 즉시 시작됩니다.

### URL 형식 {#cilifecyclemgmt-PATCH-leases__section_c22_hp4_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}

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

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

{#cilifecyclemgmt-PATCH-leases__entry__2}{#cilifecyclemgmt-PATCH-leases__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-PATCH-leases__entry__8}{#cilifecyclemgmt-PATCH-leases__requestor-id-query-param-desc-entry}

| 이름 | 설명 |
|-|-|
| actionName | 필수 연결된 CI 작업의 이름입니다. 데이터 유형: 문자열 |
| 임대 시간 | 필수 에 지정된 actionNameCI 작업에 대해 임대가 유효한 기간입니다. 데이터 유형: 문자열 형식: HH:MM:SS |
| requestorId | 필수 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다. 데이터 유형: 문자열 |
[표 56. 쿼리 매개변수]

{#cilifecyclemgmt-PATCH-leases__entry__16}

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

### 헤더

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

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

{#cilifecyclemgmt-PATCH-leases__entry__26}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 60. 상태 코드]

{#cilifecyclemgmt-PATCH-leases__table_rwq_xvf_mmb}

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

{#cilifecyclemgmt-PATCH-leases__entry__38}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-PATCH-leases__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 임대 시간이 연장되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 임대 시간이 연장되었습니다. * 아니오: 임대 시간이 연장되지 않았습니다. {#cilifecyclemgmt-PATCH-leases__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

CI 패치 적용 작업 요청자 임대 기간을 24시간 연장합니다.

    curl --request PATCH 'https://instance.service-now.com/api/now/cilifecyclemgmt/leases/affd3c8437201000deeabfc8bcbe5dc3?actionName=Patching&leaseTime=24:00:00&requestorId=e7c3402d305a9010f877773aa7167c2a' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --user "username":"password"

    {
      "result": {
        "result": true
      }
    }

## CI 수명주기 관리 - POST /now/cilifecyclemgmt/actions {#ariaid-title12}

지정된 CI(구성 항목) 작업을 지정된 CI 목록에 추가합니다.

### URL 형식 {#cilifecyclemgmt-POST-actions__section_lmz_dv4_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/actions

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

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

{#cilifecyclemgmt-POST-actions__entry__2}{#cilifecyclemgmt-POST-actions__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-POST-actions__entry__6}{#cilifecyclemgmt-POST-actions__requestor-id-query-param-desc-entry}

| 이름 | 설명 |
|-|-|
| actionName | 필수 목록에 추가할 CI 작업의 이름입니다. 데이터 유형: 문자열 |
| 임대 시간 | 지정된 CI 작업에 대한 임대 유효 기간입니다. 데이터 유형: 문자열 형식: HH:MM:SS |
| oldActionNames | 모든 CI가 있어야 하는 이전 CI 작업의 쉼표로 구분된 목록입니다. 데이터 유형: 문자열 |
| requestorId | 필수 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다. 데이터 유형: 문자열 |
| sysID | 필수 CI 작업을 추가할 CI sys_ids의 쉼표로 구분된 목록입니다. 데이터 유형: 문자열 |
[표 62. 쿼리 매개변수]

{#cilifecyclemgmt-POST-actions__entry__18}

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

### 헤더

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

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

{#cilifecyclemgmt-POST-actions__entry__28}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 66. 상태 코드]

{#cilifecyclemgmt-POST-actions__table_wj1_xvf_mmb}

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

{#cilifecyclemgmt-POST-actions__entry__40}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-POST-actions__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 목록의 모든 CI에 대해 CI 작업이 설정되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: CI 작업이 설정되었습니다. * false: CI 작업이 설정되지 않았습니다. {#cilifecyclemgmt-POST-actions__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

두 CI에 CI 패치 적용 작업을 추가합니다.

    curl --request POST \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/actions?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a&sysIds=00a9a80d3790200044e0bfc8bcbe5d1c,d0fdbc8437201000deeabfc8bcbe5d33" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username":"password"

    {
      "result": {
        "result": true
      }
    }

## CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators {#ariaid-title13}

비워크플로우 사용자에 대한 연산자를 등록합니다.

### URL 형식 {#cilifecyclemgmt-POST-operators__section_b3l_kv4_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/operators

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

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

{#cilifecyclemgmt-POST-operators__entry__2}{#cilifecyclemgmt-POST-operators__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-POST-operators__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 68. 쿼리 매개변수]

{#cilifecyclemgmt-POST-operators__entry__10}

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

### 헤더

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

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

{#cilifecyclemgmt-POST-operators__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 72. 상태 코드]

{#cilifecyclemgmt-POST-operators__table_oj2_wvf_mmb}

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

{#cilifecyclemgmt-POST-operators__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-POST-operators__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| result.requestorId | 등록된 연산자의 GUID입니다. 이 값을 사용하여 CI 작업 및 운영 상태를 설정합니다. 데이터 유형: 문자열 |
| 결과.결과 | 운영자가 성공적으로 등록되었는지 여부를 나타내는 플래그입니다. 가능한 값: * 예: 운영자가 성공적으로 등록되었습니다. * 아니오: 운영자가 등록되지 않았습니다. {#cilifecyclemgmt-POST-operators__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

    curl --request POST \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/operators" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username":"password"

    {
      "result": {
        "result": true,
        "requestorId": "6f992b8430121010f877773aa7167c42"
      }
    }

## CI 수명주기 관리 - POST /now/cilifecyclemgmt/statuses {#ariaid-title14}

지정된 CI(구성 항목) 목록에 대한 운영 상태를 설정합니다.

### URL 형식 {#cilifecyclemgmt-POST-statuses__section_shp_tw4_dmb}

버전이 지정된 URL: /api/now/{api_version}/cilifecyclemgmt/statuses

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

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

{#cilifecyclemgmt-POST-statuses__entry__2}{#cilifecyclemgmt-POST-statuses__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-POST-statuses__entry__6}{#cilifecyclemgmt-POST-statuses__requestor-id-query-param-desc-entry}

| 이름 | 설명 |
|-|-|
| oldOpsLabels | 모든 CI가 포함되어야 하는 이전 CI 운영 상태의 쉼표로 구분된 목록입니다. 데이터 유형: 문자열 |
| opsLabel | 필수 지정된 CI에 대해 설정할 운영 상태의 레이블입니다. 데이터 유형: 문자열 |
| requestorId | 필수 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 [CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/MJMf_AhQ3j7FsAwb9ubUKQ#cilifecyclemgmt-POST-operators "비워크플로우 사용자에 대한 연산자를 등록합니다.") 반환된 운영자 사용자 ID입니다. 운영자 사용자 ID는 CI 상태 등록 사용자\[statemgmt_register_users\] 테이블에 있습니다. 데이터 유형: 문자열 |
| sysID | 필수 작동 상태를 설정할 CI sys_ids의 쉼표로 구분된 목록입니다. 데이터 유형: 문자열 |
[표 74. 쿼리 매개변수]

{#cilifecyclemgmt-POST-statuses__entry__16}

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

### 헤더

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

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

{#cilifecyclemgmt-POST-statuses__entry__26}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 엔드포인트에서 요청을 성공적으로 처리했습니다. 응답 본문 result.result 매개변수를 검토하여 작업 결과를 확인합니다. 요청을 처리하는 동안 엔드포인트에 오류가 발생하면 응답 본문 result.errors 매개변수에 오류 코드와 메시지가 나타납니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 78. 상태 코드]

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

{#cilifecyclemgmt-POST-statuses__entry__38}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 "result": { "errors": [Array], "result": "String" } |
| 결과.오류 | 각 객체가 요청을 처리하는 동안 발생한 오류를 나타내는 객체의 목록입니다. 데이터 유형: 배열 "errors": [ { "error": "String", "message": "String" } ] |
| 결과.오류.오류 | 요청을 처리하는 동안 발생한 상태 관리 오류의 식별자입니다. 가능한 값: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-POST-statuses__ul_ghk_2fk_lmb} 데이터 유형: 문자열 |
| 결과.오류.메시지 | 관련된 error. 데이터 유형: 문자열 |
| 결과.결과 | 요청에 포함된 모든 CI에 대해 원하는 상태가 설정되었는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 운영 상태가 설정되었습니다. * false: 운영 상태가 설정되지 않았습니다. {#cilifecyclemgmt-POST-statuses__ul_hsp_chn_dmb} 데이터 유형: 문자열 |
[ ]

### cURL 요청

두 CI에 대해 `수리 진행 중` 운영 상태를 설정합니다.

    curl --request POST \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/statuses?opsLabel=Repair%20in%20Progress&requestorId=23d58bc030121010f877773aa7167c83&sysIds=affd3c8437201000deeabfc8bcbe5dc3,aac0b1213784200044e0bfc8bcbe5de3" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username":"password"

응답 본문은 요청에 지정된 두 CI에 대해 원하는 운영 상태가 설정되었음을 보여줍니다.

    {
      "result": {
        "result": true
      }
    }