CI 수명주기 관리 API

CI 수명주기 관리 - DELETE /now/cilifecyclemgmt/actions

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/actions

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 1. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열

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

표 3. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 5. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	CI 작업이 성공적으로 제거되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: CI 작업이 제거되었습니다. false: CI 작업이 제거되지 않았습니다. 데이터 유형: 문자열

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}

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/operators/{req_id}

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 7. 경로 매개변수
매개변수	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
req_id	워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 반환된 운영자 사용자 ID입니다 CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators . 운영자 사용자 ID는 CI 상태 등록 사용자 [statemgmt_register_users] 테이블에 있습니다. 데이터 유형: 문자열

표 8. 쿼리 매개변수
이름	설명
없음

표 9. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 11. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	운영자가 성공적으로 등록 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 연산자가 성공적으로 등록 취소되었습니다. false: 연산자가 성공적으로 등록 취소되지 않았습니다. 데이터 유형: 문자열

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}

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/actions/{sys_id}

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 13. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
sys_id	연결된 CI 작업을 반환할 CI의 Sys_id입니다. 데이터 유형: 문자열

표 14. 쿼리 매개변수
이름	설명
없음

표 15. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 17. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"result": { "errors": [Array], "result": "String" }`
result.ciActions	CI에 대한 활성 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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	지정된 모든 CI에 대해 활성 CI 작업 목록이 반환되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 활성 CI 작업 목록이 반환되었습니다. 아니오: 활성 CI 작업 목록이 반환되지 않았습니다. 데이터 유형: 문자열

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/compatActions

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

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

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

표 21. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 23. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


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

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/leases/{sys_id}/expired

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 25. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
sys_id	적용된 CI 작업의 대상인 CI의 Sys_id입니다. 데이터 유형: 문자열

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

표 27. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 29. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	적용된 CI 작업의 요청자에 대한 임대가 만료되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 요청자의 임대가 만료되었습니다. false: 요청자의 임대가 만료되지 않았습니다. 데이터 유형: 문자열

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/notAllowedAction

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 31. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열

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

표 33. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 35. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	지정된 운영 상태에 있을 때 지정된 유형의 CI에 대해 CI 작업이 제한되는지(허용되지 않음)되는지 여부를 나타내는 플래그입니다. 가능한 값: true: CI 작업이 제한됩니다(허용되지 않음). false: CI 작업이 무제한(허용)됩니다. 데이터 유형: 문자열

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/notAllowedOpsTransition

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 37. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열

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

표 39. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 41. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


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

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/requestors/{req_id}/valid

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 43. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
req_id	워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 반환된 운영자 사용자 ID입니다 CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators . 운영자 사용자 ID는 CI 상태 등록 사용자 [statemgmt_register_users] 테이블에 있습니다. 데이터 유형: 문자열

표 44. 쿼리 매개변수
이름	설명
없음

표 45. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 47. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	지정된 활성 워크플로우 사용자 또는 등록된 사용자가 올바른 요청자인지 여부를 나타내는 플래그입니다. 가능한 값: true: 올바른 요청자입니다. false: 잘못된 요청자입니다. 데이터 유형: 문자열

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}

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/statuses/{sys_id}

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 49. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
sys_id	CI의 Sys_id입니다. 데이터 유형: 문자열

표 50. 쿼리 매개변수
이름	설명
없음

표 51. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 53. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 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}

지정된 사용자에 대한 지정된 CI(구성 항목) 작업의 임대 만료 시간을 연장합니다.

이전 임대가 만료된 경우 새 임대 시간이 즉시 시작됩니다.

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/leases/{sys_id}

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 55. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열
sys_id	임대를 연장할 CI의 Sys_id입니다. 데이터 유형: 문자열

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

표 57. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 59. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	임대 시간이 연장되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 임대 시간이 연장되었습니다. false: 임대 시간이 연장되지 않았습니다. 데이터 유형: 문자열

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/actions

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 61. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열

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

표 63. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 65. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	목록에 있는 모든 CI에 대해 CI 작업이 설정되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: CI 작업이 설정되었습니다. false: CI 작업이 설정되지 않았습니다. 데이터 유형: 문자열

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/operators

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 67. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열

표 68. 쿼리 매개변수
이름	설명
없음

표 69. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 71. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
result.requestorId	등록된 운영자의 GUID입니다. 이 값을 사용하여 CI 작업 및 운영 상태를 설정합니다. 데이터 유형: 문자열
결과.결과	운영자가 성공적으로 등록되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 연산자가 성공적으로 등록되었습니다. false: 연산자가 성공적으로 등록되지 않았습니다. 데이터 유형: 문자열

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

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

URL 형식

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

기본 URL: /api/now/cilifecyclemgmt/statuses

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 73. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다. 데이터 유형: 문자열

표 74. 쿼리 매개변수
이름	설명
oldOps레이블	모든 CI를 포함해야 하는 이전 CI 운영 상태의 목록이며 콤마로 구분됩니다. 데이터 유형: 문자열
옵스레이블	필수 지정된 CI에 대해 설정할 운영 상태의 레이블입니다. 데이터 유형: 문자열
requestorId	필수 워크플로우 컨텍스트의 Sys_id 또는 엔드포인트에서 반환된 운영자 사용자 ID입니다 CI 수명주기 관리 - POST /now/cilifecyclemgmt/operators . 운영자 사용자 ID는 CI 상태 등록 사용자 [statemgmt_register_users] 테이블에 있습니다. 데이터 유형: 문자열
sysID	필수 운영 상태를 설정할 CI sys_ids 목록이며 콤마로 구분됩니다. 데이터 유형: 문자열

표 75. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
없음

헤더

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

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

표 77. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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


이름	설명
결과	요청 결과를 캡슐화하는 객체입니다. 데이터 유형: 객체 `"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 데이터 유형: 문자열
결과.오류.메시지	연결된 error에 대한 상세 정보를 제공하는 메시지입니다. 데이터 유형: 문자열
결과.결과	요청에 포함된 모든 CI에 대해 원하는 상태가 설정되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 운영 상태가 설정되었습니다. false: 운영 상태가 설정되지 않았습니다. 데이터 유형: 문자열

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