변경 관리 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 322분
  • 변경 관리 API는 타사 애플리케이션과 프로세스의 통합을 가능하게 하는 엔드포인트를 제공합니다.ServiceNow 변경 관리

    애플리케이션을 프로세스와 ServiceNow 변경 관리 통합하면 모든 변경 요청이 시작 위치에 관계없이 단일 정보 소스를 갖게 되어 단일 감사 소스를 제공합니다.

    클라이언트 측 애플리케이션을 개발 ServiceNow 할 때 변경 관리 프로세스를 외부 애플리케이션과 통합할 때 이 REST API를 사용합니다.

    통합자는 이 REST API를 통해 다음을 수행할 수 있습니다.

    • 게시된 표준 변경 요청 템플릿에서 표준 변경 요청을 시작합니다.
    • 긴급 또는 일반 유형의 변경 요청을 생성합니다.
    • 변경 요청에 대해 변경 요청 테이블에 있는 모든 필드를 업데이트합니다.
    • 생성부터 종결/취소에 이르기까지 변경 작업 테이블 및 작업 작업에 있는 모든 필드를 업데이트합니다.
    • 특정 변경 요청, 표준 템플릿, 변경 요청 작업 또는 변경 모델을 검색합니다.
    • 페이지 매김을 사용하여 여러 변경 요청, 표준 템플릿, 변경 요청 작업을 검색합니다.
    • 위험 평가를 수행합니다.
    • 영향을 받는 서비스를 새로 고칩니다.
    • 변경 요청과 관련된 모든 승인 활동을 생성하고 처리합니다.
    • 잠재적인 일정 상충을 식별하고 상충이 없는 기간을 식별합니다.
    • 변경 요청, 변경 요청 작업 및 상충 확인 프로세스를 삭제합니다.
    • 변경 모델 기록을 기반으로 변경 요청 기록을 만듭니다.
    • 현재 상태를 포함하여 지정된 변경 요청에 사용할 수 있는 상태 목록을 조회합니다.
    변경 관리 API는 및 를 워크플로우사용하여 워크플로우 스튜디오 ITIL 유형 및 변경 모델을 지원합니다. 변경 모델은 목적에 맞는 변경을 제공합니다. 유형과 모델은 변경 요청이 다음 상태로 진행되기 전에 충족해야 하는 전환 기준을 정의합니다. 상태, 워크플로우, 도구 및 비즈니스 규칙을 사용하여 이 기준을 정의할 수 있습니다.
    • 기존 ITIL 유형: 표준, 긴급 및 일반.
    • 변경 모델 상태: 신규, 예약됨, 구현, 검토 및 종결됨

    인스턴스 내에 ServiceNow 추가 변경 모델을 구성한 다음 이 API의 엔드포인트를 사용하여 해당 변경 모델을 기반으로 변경 요청을 생성할 수 있습니다. 및 변경 관리 - GET /sn_chg_rest/change/model 엔드포인트를 변경 관리 - GET /sn_chg_rest/change/model/{sys_id} 사용하여 인스턴스에서 사용 가능한 변경 모델을 가져옵니다. 그런 다음 을 변경 관리 - POST /sn_chg_rest/change 사용하여 지정된 변경 모델을 기반으로 변경 요청을 생성합니다.

    변경 모델 구성에 대한 자세한 내용은 변경 관리 구성을 참조하십시오.

    변경 관리 엔드포인트에 액세스하려면 다음 역할이 필요합니다.
    • 삭제: change_manager 또는 관리자
    • GET: change_manager, itil, sn_change_read 또는 admin
    • 패치/게시: change_manager, itil 또는 admin

    또한 관리자는 변경 속성을 설정하여 변경 관리 동작을 구성할 수 있습니다. 이러한 속성의 목록과 사용 가능한 기능에 대한 설명은 변경 관리 속성을 참조하십시오.

    변경 관리 - DELETE /sn_chg_rest/change/{change_sys_id}/task/{task_sys_id}

    지정된 sys_ids로 식별된 변경 요청 작업을 삭제합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task/{task_sys_id}

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/task/{task_sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 작업이 연결된 변경 요청의 Sys_id입니다. 작업이 지정된 변경 요청에 실제로 연결되어 있는지 확인합니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    task_sys_id 삭제할 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 작업 [change_task]

    표 2. 쿼리 매개변수
    이름 설명
    안 함
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 5. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 6. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 삭제 전에 식별된 변경 요청 작업에 대한 연관된 값이 있는 모든 필드(키)입니다.

    데이터 유형: 객체

    상위 이 작업이 연결된 변경 요청에 대한 정보입니다.

    데이터 유형: 객체

    parent: {
      display_value: "String", 
      value: "String"
    }
    parent.display_value UI에 표시할 상위 작업의 Sys_id입니다.

    데이터 유형: 문자열

    parent.value 상위 작업의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id 삭제된 변경 요청에 대한 정보를 Sys_id합니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5" \
    --request DELETE \
    --header "Accept:application/json" \ 
    --user "username":"password"
    {
      result: [
        {
          sys_id: {
            value: "12629ec4b750230096c3e4f6ee11a9d5",
            display_value: "12629ec4b750230096c3e4f6ee11a9d5"
          },
          parent: {
            value: "0f4ac6c4b750230096c3e4f6ee11a9fe", 
            display_value: "CHG0033046 "
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Retire both nodes",
            display_value: "Retire both nodes"
          }
        }
      ]
    }

    변경 관리 - DELETE /sn_chg_rest/change/{sys_id}

    지정된 sys_id과 연결된 변경 요청을 삭제합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}

    기본 URL: /api/sn_chg_rest/change/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 삭제할 변경 요청 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 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 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    결과 삭제된 변경 요청 기록입니다. 이 개체의 각 요소는 변경 요청 [change_request] 테이블의 기록에 있는 필드에 해당합니다.

    데이터 유형: 객체

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
    --request DELETE \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      "result":
        {
          "reason": {
            "display_value": "",
            "value": ""
          },
          "parent": {
            "display_value": "",
            "value": ""
          },
          "watch_list": {
            "display_value": "",
            "value": ""
           },
           "proposed_change": {
             "display_value": "",
             "value": ""
           },
           "upon_reject": {
             "display_value": "Cancel all future Tasks",
             "value": "cancel"
           },
           "sys_updated_on": {
             "display_value": "2015-07-06 11:59:27",
             "value": "2015-07-06 18:59:27",
             "display_value_internal": "2015-07-06 11:59:27"
          },
          "type": {
            "display_value": "Standard",
            "value": "standard"
          },
          "approval_history": {
            "display_value": "",
            "value": ""
          },
          "skills": {
            "display_value": "",
            "value": ""
          },
          "test_plan": {
            "display_value": "--Confirm that there are no monitoring alerts for the router",
            "value": "--Confirm that there are no monitoring alerts for the router"
          },
          "number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "is_bulk": {
            "display_value": "false",
            "value": false
          },
          "cab_delegate": {
            "display_value": "",
            "value": ""
          },
          "requested_by_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "ci_class": {
            "display_value": "cmdb_ci",
            "value": "cmdb_ci"
          },
          "state": {
            "display_value": "Closed",
            "value": 3.0
          },
          "sys_created_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "knowledge": {
            "display_value": "false",
            "value": false
          },
          "order": {
            "display_value": "",
            "value": ""
          },
          "phase": {
            "display_value": "Requested",
            "value": "requested"
          },
          "cmdb_ci": {
            "display_value": "",
            "value": ""
          },
          "delivery_plan": {
            "display_value": "",
            "value": ""
          },
          "impact": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "contract": {
            "display_value": "",
            "value": ""
          },
          "active": {
            "display_value": "false",
            "value": false
          },
          "work_notes_list": {
            "display_value": "",
            "value": ""
          },
          "priority": {
            "display_value": "4 - Low",
            "value": 4.0
          },
          "sys_domain_path": {
            "display_value": "/",
            "value": "/"
          },
          "cab_recommendation": {
            "display_value": "",
            "value": ""
          },
          "production_system": {
            "display_value": "false",
            "value": false
          },
          "rejection_goto": {
            "display_value": "",
            "value": ""
          },
          "review_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "requested_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "business_duration": {
            "display_value": "",
            "value": ""
          },
          "group_list": {
            "display_value": "",
            "value": ""
          },
          "change_plan": {
            "display_value": "",
            "value": ""
          },
          "approval_set": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "wf_activity": {
            "display_value": "",
            "value": ""
          },
          "implementation_plan": {
            "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
            "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
          },
          "universal_request": {
            "display_value": "",
            "value": ""
          },
          "end_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "short_description": {
            "display_value": "Reboot the server at 6 am",
            "value": "Reboot the server at 6 am"
          },
          "correlation_display": {
            "display_value": "",
            "value": ""
          },
          "work_start": {
            "display_value": "2015-07-06 11:56:04",
            "value": "2015-07-06 18:56:04",
            "display_value_internal": "2015-07-06 11:56:04"
          },
          "delivery_task": {
            "display_value": "",
            "value": ""
          },
          "outside_maintenance_schedule": {
            "display_value": "false",
            "value": false
          },
          "additional_assignee_list": {
            "display_value": "",
            "value": ""
          },
          "std_change_producer_version": {
            "display_value": "Clear BGP sessions on a Cisco router - 1",
            "value": "16c2273c47010200e90d87e8dee49006"
          },
          "sys_class_name": {
            "display_value": "Change Request",
            "value": "change_request"
          },
          "service_offering": {
            "display_value": "",
            "value": ""
          },
          "closed_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "follow_up": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "review_status": {
            "display_value": "",
            "value": ""
          },
          "reassignment_count": {
            "display_value": "2",
            "value": 2.0
          },
          "start_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "assigned_to": {
            "display_value": "",
            "value": ""
          },
          "variables": {
            "display_value": "variable_pool",
            "value": "variable_pool"
          },
          "sla_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments_and_work_notes": {
            "display_value": "",
            "value": ""
          },
          "escalation": {
            "display_value": "Normal",
            "value": 0.0
          },
          "upon_approval": {
            "display_value": "Proceed to Next Task",
            "value": "proceed"
          },
          "correlation_id": {
            "display_value": "",
            "value": ""
          },
          "made_sla": {
            "display_value": "true",
            "value": true
          },
          "backout_plan": {
            "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
            "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
          },
          "conflict_status": {
            "display_value": "Not Run",
            "value": "Not Run"
          },
          "task_effective_number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "sys_updated_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "opened_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "user_input": {
            "display_value": "",
            "value": ""
          },
          "sys_created_on": {
            "display_value": "2015-07-06 11:55:46",
            "value": "2015-07-06 18:55:46",
            "display_value_internal": "2015-07-06 11:55:46"
          },
          "on_hold_task": {
            "display_value": "",
            "value": ""
          },
          "sys_domain": {
            "display_value": "global",
            "value": "global"
          },
          "route_reason": {
            "display_value": "",
            "value": ""
          },
          "closed_at": {
            "display_value": "2015-07-06 11:56:23",
            "value": "2015-07-06 18:56:23",
            "display_value_internal": "2015-07-06 11:56:23"
          },
          "review_comments": {
            "display_value": "",
            "value": ""
          },
          "business_service": {
            "display_value": "",
            "value": ""
          },
          "time_worked": {
            "display_value": "",
            "value": ""
          },
          "chg_model": {
            "display_value": "",
            "value": ""
          },
          "expected_start": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "opened_at": {
            "display_value": "2015-06-09 11:55:46",
            "value": "2015-06-09 18:55:46",
            "display_value_internal": "2015-06-09 11:55:46"
          },
          "work_end": {
            "display_value": "2015-07-06 11:56:10",
            "value": "2015-07-06 18:56:10",
            "display_value_internal": "2015-07-06 11:56:10"
          },
          "phase_state": {
            "display_value": "Open",
            "value": "open"
          },
          "cab_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "work_notes": {
            "display_value": "",
            "value": ""
          },
          "close_code": {
            "display_value": "Successful",
            "value": "successful"
          },
          "assignment_group": {
            "display_value": "Network",
            "value": "287ebd7da9fe198100f92cc8d1d2154e"
          },
          "description": {
            "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
            "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
          },
          "on_hold_reason": {
            "display_value": "",
            "value": ""
          },
          "calendar_duration": {
            "display_value": "",
            "value": ""
          },
          "close_notes": {
            "display_value": "Completed without issues",
            "value": "Completed without issues"
          },
          "sys_id": {
            "display_value": "b0dbda5347c12200e0ef563dbb9a718f",
            "value": "b0dbda5347c12200e0ef563dbb9a718f"
          },
          "contact_type": {
            "display_value": "Phone",
            "value": "phone"
          },
          "cab_required": {
            "display_value": "false",
            "value": false
          },
          "urgency": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "scope": {
            "display_value": "Medium",
            "value": 3.0
          },
          "company": {
            "display_value": "",
            "value": ""
          },
          "justification": {
            "display_value": "",
            "value": ""
          },
          "activity_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments": {
            "display_value": "",
            "value": ""
          },
          "approval": {
            "display_value": "Approved",
            "value": "approved"
          },
          "due_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "sys_mod_count": {
            "display_value": "10",
            "value": 10.0
          },
          "on_hold": {
            "display_value": "false",
            "value": false
          },
          "sys_tags": {
            "display_value": "",
            "value": ""
          },
          "conflict_last_run": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "risk_value": {
            "display_value": "",
            "value": ""
          },
          "unauthorized": {
            "display_value": "false",
            "value": false
          },
          "risk": {
            "display_value": "Moderate",
            "value": 3.0
          },
          "location": {
            "display_value": "",
            "value": ""
          },
          "category": {
            "display_value": "Other",
            "value": "Other"
          },
          "risk_impact_analysis": {
            "display_value": "",
            "value": ""
          }
        }
    }

    변경 관리 - DELETE /sn_chg_rest/change/{sys_id}/conflict

    지정된 변경 요청(sys_id)에 대해 실행 중인 상충 검사 프로세스를 취소합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/conflict

    기본 URL: /api/sn_chg_rest/change/{sys_id}/conflict

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 실행 중인 상충 검사 프로세스를 취소할 변경 요청 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 14. 쿼리 매개변수
    이름 설명
    안 함
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 16. 요청 헤더
    머리글 설명
    없음
    표 17. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 18. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청. 취소 요청에 실패했습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    없음

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
    --request DELETE \
    --user "username":"password"
    
    None

    변경 관리 - DELETE /sn_chg_rest/change/emergency/{sys_id}

    지정된 sys_id로 식별된 긴급 변경 요청을 삭제합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/emergency/{sys_id}

    기본 URL: /api/sn_chg_rest/change/emergency/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 삭제할 긴급 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 20. 쿼리 매개변수
    이름 설명
    안 함
    표 21. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 23. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 24. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \
    --request DELETE \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "b0dbda5347c12200e0ef563dbb9a718f", 
            display_value: "b0dbda5347c12200e0ef563dbb9a718f"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "emergency",
            display_value: "Emergency"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Remove server",
            display_value: "Remove server"
          },
        }, 
      ]
    }

    변경 관리 - DELETE /sn_chg_rest/change/normal/{sys_id}

    지정된 sys_id로 식별된 일반 변경 요청을 삭제합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/normal/{sys_id}

    기본 URL: /api/sn_chg_rest/change/normal/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 삭제할 일반 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 26. 쿼리 매개변수
    이름 설명
    안 함
    표 27. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 29. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 30. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "정상"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "normal"입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \
    --request DELETE \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "normal",
            display_value: "Normal"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Remove server",
            display_value: "Remove server"
          },
        }, 
      ]
    }
    

    변경 관리 - DELETE /sn_chg_rest/change/standard/{sys_id}

    지정된 sys_id로 식별된 표준 변경 요청을 삭제합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard/{sys_id}

    기본 URL: /api/sn_chg_rest/change/standard/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 삭제할 표준 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 32. 쿼리 매개변수
    이름 설명
    안 함
    표 33. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 35. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 36. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 식별된 변경 요청에 대해 연결된 값이 있는 모든 필드(키).
    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청의 고유 식별자입니다.

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177" \
    --request DELETE \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: "1c87925347c12200e0ef563dbb9a7177",
          state: {
            value: "-5", 
            display_value: "New"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Add network switch to cabinet",
            display_value: "Add network switch to cabinet"
          },
        }, 
      ]
    }
    

    변경 관리 - GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule

    계획된 시작 시간을 포함할 수 있는 옵션과 함께 구성 항목 ID 및 기간별로 사용 가능한 시간 슬롯을 검색할 수 있습니다.

    필요한 역할: sn_change_writer.

    주:
    이 엔드포인트를 실행해도 사용 가능한 시작 및 종료 시간이 나열되지 않습니다. 응답 본문 worker.link 속성에 제공된 링크를 사용하여 일정 데이터를 가져옵니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/ci/{cmdb_ci_sys_id}/schedule

    기본 URL: /api/sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    cmdb_ci_sys_id 구성 항목 기록의 Sys_id입니다. 이 엔드포인트에는 변경 요청이 필요하지 않습니다.

    데이터 유형: 문자열

    테이블: 구성 항목 [cmdb_ci]

    표 38. 쿼리 매개변수
    이름 설명
    duration_in_seconds 변경 기간(초)입니다. 즉, 변경 요청 작업을 완료하는 데 필요한 시간입니다.

    데이터 유형: 정수

    planned_start_time 옵션입니다. 변경 요청이 구현을 시작할 예정인 날짜 및 시간(UTC 기준)입니다.

    이 시간 이후의 사용 가능한 시간 슬롯 시작을 검색합니다. 제공되지 않은 경우 시스템은 현재 시간을 시작 시간으로 사용합니다.

    형식: yyyy-mm-dd hh:mm:ss

    데이터 유형: 문자열

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

    헤더

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

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

    기본값: application/json

    표 41. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 42. 상태 코드
    상태 코드 설명
    202 시스템이 요청을 수락했습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    가능한 문제:
    • 제공된 sys_id의 cmdb_ci 찾을 수 없습니다. 기록이 없거나 사용자에게 해당 기록에 대한 읽기 권한이 없습니다.
    • duration_in_seconds 쿼리 매개변수 값이 제공되지 않았습니다.
    • 잘못된 duration_in_seconds 또는 planned_start_time 쿼리 매개변수 값이 제공되었습니다.

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

    이름 설명
    오류 엔드포인트 요청을 처리하는 동안 발생한 오류에 대한 정보입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String",
      "status": "String"
    }
    오류.상세 정보 오류에 대한 추가 정보입니다.

    데이터 유형: 문자열

    오류.메시지 오류를 식별하는 메시지입니다.

    데이터 유형: 문자열

    메시지 메시지 정보입니다.
    데이터 유형: 객체
    "messages": {
      "errorMessages": [Array],
      "infoMessages": [Array],
      "warningMessages": [Array]
    }
    messages.errorMessages 요청을 처리하는 동안 오류 메시지가 발생했습니다.

    데이터 유형: 배열

    messages.infoMessages 요청을 처리하는 동안 발생한 정보 메시지입니다.

    데이터 유형: 배열

    messages.warningMessages 요청을 처리하는 동안 경고 메시지가 표시되었습니다.

    데이터 유형: 배열

    요청 원래 엔드포인트 요청입니다.

    데이터 유형: 문자열

    상태 작업자의 현재 상태에 대한 정보입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: Number
    }
    state.display_value 작업자 상태의 값을 표시합니다. 이러한 값은 매개변수와 직접적인 state.value 상관 관계가 있습니다.

    가능한 값:

    • 완료
    • 오류
    • 진행 중
    • 대기 중

    데이터 유형: 문자열

    상태.값 작업자 상태의 숫자 값입니다.

    가능한 값:

    • 1
    • 2
    • 3
    • 4

    데이터 유형: 숫자

    유형 요청의 유형입니다.

    유효한 값: schedule

    데이터 유형: 문자열

    작업자 연결된 작업자에 대한 정보입니다.

    데이터 유형: 객체

    "worker": {
      "link": "String",
      "sysId": "String"
    }
    worker.link 시간 슬롯 데이터를 검색하기 위한 링크입니다.결과를 보려면 GET /sn_chg_rest/change/worker/{sys_id}의 sys_id를 사용합니다.

    데이터 유형: 문자열

    worker.sysId 변경 요청과 연결된 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    상태 오류가 발생한 경우에만 나타납니다. 엔드포인트 처리의 상태입니다.

    가능한 값: 실패

    데이터 유형: 문자열

    사용 가능한 시간 슬롯 가져오기

    일정 창 상세 정보를 가져오려면 제공된 값을 사용합니다 worker.link . 값은 다음과 같은 형식입니다.

    https://instance.service-now.com/api/sn_chg_rest/change/worker/<worker_sys_id>

    결과를 보려면 GET /sn_chg_rest/change/worker/{sys_id}의 worker_sys_id를 사용하십시오.

    응답 본문에는 상태가 포함되어 있으며 처리가 완료되면 결과를 제공합니다.

    작업자 응답 본문 매개변수 결과는 시간 슬롯 가용성에 따라 달라집니다.
    • 제공된 시간 슬롯을 일정 시간 슬롯 내에서 변경 요청에 사용할 수 있는 경우 작업자 API는 속성에서 payload.spans 사용 가능한 시간 슬롯을 나열합니다. 그렇지 않으면 속성이 payload.spans 결과에 나열되지 않습니다.
    • 정의된 예약 시간 슬롯 messages.infoMessages 내에 제공된 변경 요청 기간에 사용할 수 있는 시간 슬롯이 없는 경우 다음과 같이 상태가 됩니다. D
      주:
      변경 요청 예약 시간 슬롯의 기본값은 90일입니다. 이 값을 변경하려면 속성을 수정합니다 change.conflict.next_available.schedule_window . 자세한 내용은 상충 분석 속성 구성을 참조하십시오.

    다음 GET /sn_chg_rest/change/worker/{sys_id} 예시는 worker.link 상세 정보에 제공된 ID를 사용하여 제공된 출력을 보여줍니다. 결과 목록은 작업 기간에 사용할 수 있는 열린 시간 범위입니다.

    {
      "result": {
        "worker": {
          "sysId": "d7d1f2b4a444b010f87712198fe9caae",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/d7d1f2b4a444b010f87712198fe9caae"
        },
        "request": "{\"cmdb_ci_sys_id\":\"82967cdd0ad3370236092104ce988d76\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
        "state": {
          "value": 3,
          "display_value": "Complete"
        },
        "type": "schedule",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        },
        "payload": {
          "spans": [
            {
              "start": {
                "value": "2021-05-15 08:00:00",
                "display_value": "2021-05-15 01:00:00"
              },
              "end": {
                "value": "2021-05-15 11:00:00",
                "display_value": "2021-05-15 04:00:00"
              }
            },
            {
              "start": {
                "value": "2021-05-22 08:00:00",
                "display_value": "2021-05-22 01:00:00"
              },
              "end": {
                "value": "2021-05-22 11:00:00",
                "display_value": "2021-05-22 04:00:00"
              }
            },
            ...
          ]
        }
      }
    }

    cURL 요청

    curl "https://instance.service-now.com/api/sn_chg_rest/change/ci/<cmdb_ci_sys_id>/schedule?duration_in_seconds=10800" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    결과에는 GET /sn_chg_rest/change/worker/ 엔드포인트에서 제공된 sys_id 실행하는 데 사용할 수 있는 worker.link 상세 정보가 포함됩니다.

    {
      "result": {
        "worker": {
          "sysId": "1049419c1b4c3010f58a6572604bcb7a",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/1049419c1b4c3010f58a6572604bcb7a"
        },
        "request": "{\"cmdb_ci_sys_id\":\"<cmdb_ci_sys_id>\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
        "state": {
          "value": 1,
          "display_value": "Waiting"
        },
        "type": "schedule",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        }
      }
    }

    변경 관리 - GET /sn_chg_rest/change

    지정된 기준에 따라 하나 이상의 변경 요청을 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change

    기본 URL: /api/sn_chg_rest/change

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 44. 쿼리 매개변수
    이름 설명
    이름-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    순서 반환된 변경 요청을 정렬할 필드입니다.

    데이터 유형: 문자열

    기본값: 이름

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    텍스트검색 모든 일반 변경 요청 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 전체 텍스트 검색 플랫폼 기능을 사용합니다 ServiceNow . 검색 기능에 대한 ServiceNow 자세한 내용은 검색 관리를 참조하세요.

    기본값: IR_AND_OR_QUERY

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

    헤더

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

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

    기본값: application/json

    표 47. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 48. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    요소 설명
    결과 하나 이상의 변경 요청 기록 객체가 포함된 목록입니다. 각 객체는 변경 요청을 설명합니다. 변경 요청 개체의 각 요소는 변경 요청 [change_request] 테이블의 관련 기록에 있는 필드에 해당합니다.

    모든 요소에는 display_value 이름-값 쌍이 포함됩니다. 날짜 필드에는 display_value_internal 이름-값 쌍도 포함됩니다.

    데이터 유형: 배열

    action_status 연결된 변경 요청의 현재 작업 상태입니다.

    가능한 값:

    • 1: 내부적으로 차단
    • 2: 고객에 의해 차단됨
    • 3: 내부적 및 고객에 의해 차단됨
    • 4: 주의 필요

    데이터 유형: 숫자

    활성 변경 요청이 활성 상태인지 여부를 나타내는 플래그입니다.

    가능한 값:

    • true: 변경 요청이 활성 상태입니다.
    • false: 변경 요청이 활성 상태가 아닙니다.

    데이터 유형: 부울

    기본값: true

    activity_due 관련 케이스가 완료될 것으로 예상되는 날짜 및 시간입니다.

    데이터 유형: 문자열

    additional_assignee_list 변경 요청 작업에 할당된 추가 사용자 sys_ids 목록입니다.

    데이터 유형: 배열

    승인 필요한 승인 프로세스의 유형입니다.

    데이터 유형: 문자열

    기본값: 요청되지 않음

    approval_history 가장 최근의 승인 이력 저널 항목입니다.

    데이터 유형: 문자열

    approval_set 연결된 작업이 승인된 날짜 및 시간입니다.

    데이터 유형: 문자열

    assigned_to 변경 요청에 할당된 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    assignment_group 변경 요청에 할당된 그룹 Sys_id입니다.

    데이터 유형: 문자열

    backout_plan 변경을 되돌려야 하는 경우 실행할 계획에 대한 설명입니다.

    데이터 유형: 문자열

    business_duration 변경을 완료하는 데 걸린 예약된 작업 시간, 근무일 및 작업 주의 길이입니다.

    데이터 유형: 문자열

    business_service 변경 요청과 연결된 비즈니스 서비스의 Sys_id입니다. 서비스 [cmdb_ci_service] 테이블에 있습니다.

    데이터 유형: 문자열

    cab_date 변경심의위원회(CAB)가 열리는 날짜입니다.

    데이터 유형: 문자열

    cab_delegate CAB 회의 중에 CAB 관리자를 대신할 수 있는 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있음

    데이터 유형: 문자열

    cab_recommendation 변경 요청에 대한 CAB 권장 사항에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    cab_required CAB가 필요한지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 변경심의위원회가 필요합니다.
    • false: 변경심의위원회가 필요하지 않습니다.

    데이터 유형: 부울

    기본값: false

    calendar_duration 변경 관리에서 현재 사용하지 않습니다.

    데이터 유형: 문자열

    범주 변경 범주입니다(예: 하드웨어, 네트워크 또는 소프트웨어).

    데이터 유형: 문자열

    기본값: 기타

    change_plan 변경 요청을 관리하고 통제하기 위한 활동 및 역할입니다.

    데이터 유형: 문자열

    chg_model 연결된 변경 요청의 기반이 되는 변경 모델의 Sys_id입니다. 변경 모델은 변경 요청에 대해 완료해야 하는 상태 흐름, 전환, 프로세스 활동을 정의합니다.

    데이터 유형: 문자열

    테이블: 변경 모델 [chg_model]

    closed_at 연결된 변경 요청이 종결된 날짜 및 시간입니다.

    데이터 유형: 문자열

    closed_by 변경 요청을 종결한 사람의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    close_code 변경 요청이 종결되었을 때 변경 요청에 할당된 코드입니다. 예를 들어 성공, 성공(문제 발생) 및 실패가 있습니다.

    데이터 유형: 문자열

    close_notes 변경 요청을 종결할 때 사용자가 입력한 내용을 메모합니다.

    데이터 유형: 문자열

    cmdb_ci 변경 요청과 연결된 구성 항목의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 구성 항목 [cmdb_ci]

    댓글 연결된 변경 요청에 입력한 고객 대면 작업 메모 목록입니다.

    데이터 유형: 배열

    comments_and_work_notes 관련 변경 요청에 대해 입력한 내부 및 고객 대면 작업 메모의 목록입니다.

    데이터 유형: 배열

    최대 길이: 4,000

    회사 변경 요청과 연결된 회사의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 회사 [core_company]

    conflict_last_run 변경 요청에서 상충 탐지 스크립트가 마지막으로 실행된 날짜 및 시간입니다.

    데이터 유형: 문자열

    conflict_status 상충 탐지 스크립트에서 탐지한 현재 상충 상태(예: 상충 및 실행되지 않음)입니다.

    데이터 유형: 문자열

    최대 길이: 40

    기본값: 실행되지 않음

    contact_type 변경 요청을 처음 요청한 방법입니다.
    가능한 값:
    • 채팅
    • 이메일
    • 전화
    • 소셜

    데이터 유형: 문자열

    계약 변경 요청과 연결된 계약의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 계약 [ast_contract]

    correlation_display 의 사용자 친화적인 이름입니다 correlation_id.

    데이터 유형: 문자열

    최대 길이: 100

    correlation_id 외부 공급업체 시스템에서 일치하는 변경 요청 기록의 GUID(전역 고유 식별자)입니다.

    데이터 유형: 문자열

    최대 길이: 100

    delivery_plan 더 이상 사용되지 않습니다. 변경 요청과 연결된 제공 계획의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 실행 계획 [sc_cat_item_delivery_plan]

    delivery_task 더 이상 사용되지 않습니다. 변경 요청과 연결된 제공 작업의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 실행 계획 작업 [sc_cat_item_delivery_task]

    설명 변경 요청에 대한 자세한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    due_date 작업 기한. 변경 요청 프로세스에서 사용되지 않습니다.

    데이터 유형: 문자열

    end_date 변경 요청이 완료되는 날짜 및 시간입니다.

    데이터 유형: 문자열

    에스컬레이션 현재 에스컬레이션 수준입니다.

    가능한 값:

    • 0: 정상
    • 1: 보통
    • 2: 높음
    • 3: 기한 초과

    데이터 유형: 숫자(정수)

    기본값: 0

    expected_start 작업이 시작되는 날짜 및 시간입니다. 변경 요청 프로세스에 사용되지 않습니다.

    데이터 유형: 문자열

    follow_up 사용자가 변경 요청을 요청한 사람에 대한 후속 조치를 취한 날짜 및 시간입니다.

    데이터 유형: 문자열

    group_list 변경 요청과 관련된 그룹의 sys_ids 및 이름 목록입니다.

    데이터 유형: 배열

    최대 길이: 4,000

    영향도 변경 요청에 미치는 영향이 고객에게 미칠 영향입니다.

    가능한 값:

    • 1: 높음
    • 2: 중간
    • 3: 낮음

    데이터 유형: 숫자(정수)

    기본값: 3

    implementation_plan 이 변경을 구현하기 위해 실행할 순차적 단계입니다. 또한 단계와 각 단계에 대한 담당자 정보 간의 종속성도 포함합니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    근거 이 변경 구현의 이점과 이 변경이 구현되지 않을 경우의 영향입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    knowledge 변경 요청과 관련된 지식베이스()KB) 문서가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 관련된 KB 문서
    • false: 연결된 KB 문서 없음

    데이터 유형: 부울

    위치 변경 요청에서 참조되는 장비 위치의 Sys_id 및 이름입니다.

    데이터 유형: 문자열

    테이블: 위치 [cmn_location]

    made_sla 더 이상 사용되지 않습니다. 변경 요청이 연결된 서비스 수준 계약에 따라 구현되었는지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울

    needs_attention 변경 요청에 주의가 필요한지 여부를 나타내는 플래그입니다.

    가능한 값:

    • true: 변경 요청에 추가적인 주의가 필요합니다.
    • false: 변경 요청에 추가적인 주의가 필요하지 않습니다.

    데이터 유형: 부울

    기본값: false

    번호 CHG0040007와 같이 시스템에서 변경 요청에 할당된 변경 번호입니다.

    데이터 유형: 문자열

    on_hold 변경 요청이 현재 보류 중인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 보류 중
    • false: 보류 중 없음

    데이터 유형: 부울

    기본값: false

    on_hold_reason 매개변수가 on_hold "예"이면 변경 요청이 보류되는 이유에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    on_hold_task 매개변수가 on_hold "예"이면 보류가 해제되기 전에 완료해야 하는 작업 sys_ids 목록입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    opened_at 변경 릴리스가 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    opened_by 변경 릴리스를 생성한 사용자의 Sys_id 및 이름입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    순서 에서 사용하지 않습니다.변경 관리 데이터베이스에서 검색할 때와 같이 기록을 정렬하는 데 사용할 수 있는 선택적 숫자 필드입니다.

    데이터 유형: 숫자(정수)

    outside_maintenance_schedule 변경 요청에 대해 외부 회사의 유지관리가 예약되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • 예: 외부 유지관리 예약됨
    • false: 예약된 외부 유지관리 없음

    데이터 유형: 부울

    기본값: false

    상위 이 변경 요청에 대한 상위 작업의 Sys_id 및 이름입니다(있는 경우).

    데이터 유형: 문자열

    테이블: 작업 [task]

    단계 변경 요청의 현재 단계입니다. 이는 변경이 수행하는 작업을 보다 자세히 정의합니다.
    가능한 값:
    • 수용
    • 빌드
    • 계획
    • 요청됨

    데이터 유형: 문자열

    phase_state 변경을 위해 생성해야 하는 Change_phase 기록입니다. 범주에 따라 다르므로 각 변경 유형마다 다른 change_phase 기록이 있을 수 있습니다. change_phase 기록은 각 change_phase에 일정과 승인자 세트가 있을 수 있으므로 승인 프로세스를 제어할 수 있는 기회를 제공합니다.
    가능한 값:
    • 완료
    • 보류 중
    • 오픈
    • 거부됨
    • 요청됨
    • 작업 진행 중

    데이터 유형: 문자열

    우선순위 변경 요청의 우선순위입니다.
    가능한 값:
    • 1: 중요
    • 2: 높음
    • 3: 보통
    • 4: 낮음

    데이터 유형: 숫자(정수)

    기본값: 4

    production_system 변경 요청이 프로덕션 환경의 인스턴스에 ServiceNow 대한 것인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 프로덕션 환경
    • false: 비프로덕션 환경

    데이터 유형: 부울

    이유 변경 요청을 시작한 이유에 대한 설명입니다.
    가능한 값:
    • 비즈니스 요구 사항
    • 하드웨어 업그레이드
    • 법률
    • 위치 변경
    • 네트워크 요구 사항
    • 새 CI 또는 제거된 CI
    • 기타
    • 문제 해결됨
    • 제품 또는 서비스 변경됨
    • 소프트웨어 업그레이드
    • 사용자가 요청함

    데이터 유형: 문자열

    최대 길이: 40

    reassignment_count 변경 요청이 새 소유자에게 재할당된 횟수입니다.

    데이터 유형: 숫자(정수)

    기본값: 0

    rejection_goto 변경 요청이 거부될 경우 수행할 작업 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 작업 [task]

    requested_by 변경을 요청한 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    requested_by_date 변경을 구현하도록 요청한 날짜 및 시간입니다.

    데이터 유형: 문자열

    review_comments 변경 요청을 검토할 때 입력한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    review_date 변경 요청을 검토한 날짜입니다.

    데이터 유형: 문자열

    review_status 요청된 변경 요청 검토의 현재 상태입니다.

    데이터 유형: 문자열

    risk 변경 요청과 관련된 위험 수준입니다.
    유효한 값은 다음과 같습니다.
    • 1: 높음
    • 2: 보통
    • 3: 낮음

    데이터 유형: 숫자

    기본값: 3

    risk_impact_analysis 변경 요청 구현의 위험 설명 및 분석입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    route_reason 에서 현재 사용하지 않습니다.변경 관리 변경 요청이 전송된 이유입니다.
    가능한 값:
    • 1: 해결하고 이전
    • 9: 해결하지 않고 이전

    데이터 유형: 숫자

    범위 변경 요청의 크기입니다.
    가능한 값:
    • 1: 대량
    • 2: 대형
    • 3: 중간
    • 4: 소형
    • 5: 작은

    데이터 유형: 숫자

    기본값: 3

    service_offering 변경 요청과 연결된 서비스 오퍼링의 Sys_id입니다. 서비스 오퍼링은 가용성, 범위, 가격 및 패키징 옵션 측면에서 서비스 수준을 고유하게 정의합니다.

    데이터 유형: 문자열

    테이블: 오퍼링 [service_offering]

    short_description 변경 요청에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 40

    기술 변경 요청을 구현하는 데 필요한 모든 기술의 sys_ids 목록입니다.

    데이터 유형: 배열

    테이블: 기술 [cmn_skill]

    sla_due 더 이상 사용되지 않습니다. 연결된 서비스 수준 계약에 따라 변경 요청을 완료해야 하는 날짜 및 시간입니다.

    데이터 유형: 문자열

    sn_esign_document 변경 요청에 첨부된 전자 서명 문서의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    sn_esign_esignature_configuration 연결된 문서에 사용되는 전자 서명 서명 템플릿의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 전자 서명 템플릿 [sn_esign_configuration]

    start_date 변경 요청이 구현을 시작할 날짜 및 시간입니다.

    데이터 유형: 문자열

    상태 변경 요청의 현재 상태입니다. 가능한 값은 변경 모델에 정의되어 있습니다.

    데이터 유형: 숫자(정수)

    기본값: 1

    std_change_producer_version 변경 요청과 관련된 기록 생성자 및 변경 제안의 Sys_id입니다. 제안서에서 만든 성공 및 실패 변경 요청 수와 백분율도 포함됩니다.

    데이터 유형: 문자열

    테이블: 표준 변경 템플릿 버전 [std_change_producer_version]

    sys_class_name 변경 요청이 있는 테이블의 이름입니다.

    데이터 유형: 문자열

    sys_created_by 변경 요청을 처음 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    최대 길이: 40

    sys_created_on 연결된 변경 요청 기록이 원래 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    sys_domain 인스턴스에서 도메인을 사용하는 경우 변경 모듈 기록이 연결된 도메인의 이름입니다.

    데이터 유형: 문자열

    sys_domain_path 인스턴스에서 도메인을 사용하는 경우 연결된 변경 모듈 기록이 있는 도메인 경로입니다.

    데이터 유형: 문자열

    sys_id 연결된 변경 요청 기록의 고유 식별자입니다.

    데이터 유형: 문자열

    sys_mod_count 케이스가 처음 만들어진 이후 업데이트된 수입니다.

    데이터 유형: 숫자(정수)

    sys_updated_by 케이스를 마지막으로 업데이트한 사람입니다.

    데이터 유형: 문자열

    최대 길이: 40

    sys_updated_on 케이스가 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    task_effective_number 범용 요청 번호입니다.

    데이터 유형: 문자열

    최대 길이: 40

    task_for 에서 사용하지 않습니다.변경 관리 작업이 생성된 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    test_plan 변경에 대해 연결된 테스트 계획에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    time_worked 변경 요청에 대해 작업한 총 시간입니다.

    데이터 유형: 문자열

    유형 변경 요청 유형입니다.
    가능한 값:
    • 긴급
    • 일반
    • 표준

    데이터 유형: 문자열

    최대 길이: 40

    권한 해제됨 변경 요청이 승인되지 않았는지 여부를 나타내는 플래그
    가능한 값:
    • true: 권한 해제됨
    • false: 인증됨

    데이터 유형: 부울

    universal_request 이 변경 요청이 속한 상위 범용 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 작업 [task]

    upon_approval 변경 요청이 승인될 경우 수행할 동작입니다.

    가능한 값:

    • do_nothing
    • 계속 진행

    데이터 유형: 문자열

    최대 길이: 40

    기본값: 계속 진행

    upon_reject 변경 요청이 거부될 경우 수행할 동작입니다.

    가능한 값:

    • cancel
    • 이동

    데이터 유형: 문자열

    최대 길이: 40

    기본값: 취소

    긴급도 변경 요청의 긴급도입니다.

    가능한 값:

    • 1: 높음
    • 2: 중간
    • 3: 낮음

    데이터 유형: 숫자(정수)

    기본값: 3

    user_input 추가 사용자 입력.

    데이터 유형: 문자열

    최대 길이: 4,000

    variables 변경 요청과 관련된 변수의 이름-값 쌍입니다.

    데이터 유형: 문자열

    최대 길이: 40

    watch_list 추가 코멘트가 추가되거나 변경 요청의 상태가 해결됨 또는 종결됨으로 변경될 경우 이 변경 요청에 대한 알림을 받는 사용자 sys_ids 목록입니다.

    데이터 유형: 배열

    테이블: 사용자 [sys_user]

    wf_activity 변경 요청과 관련된 워크플로우 활동 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 워크플로우 활동 [wf_activity]

    work_end 변경 요청에 대한 작업이 종료된 날짜 및 시간입니다.

    데이터 유형: 문자열

    work_notes 변경 요청을 해결하는 방법 또는 이를 해결하기 위해 수행한 단계에 대한 정보입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    work_notes_list 작업 메모가 추가될 때 이 변경 요청에 대한 알림을 받는 내부 사용자 sys_ids의 목록입니다.

    데이터 유형: 배열

    테이블: 사용자 [sys_user]

    work_start 변경 요청에서 작업이 시작된 날짜 및 시간입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?sysparm_query=active=true^ORDERBYnumber" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    

    간결성을 위해 결과에는 단일 변경 요청 기록만 포함됩니다.

    {
      "result": [
        {
          "reason": {
            "display_value": "",
            "value": ""
          },
          "parent": {
            "display_value": "",
            "value": ""
          },
          "watch_list": {
            "display_value": "",
            "value": ""
           },
           "proposed_change": {
             "display_value": "",
             "value": ""
           },
           "upon_reject": {
             "display_value": "Cancel all future Tasks",
             "value": "cancel"
           },
           "sys_updated_on": {
             "display_value": "2015-07-06 11:59:27",
             "value": "2015-07-06 18:59:27",
             "display_value_internal": "2015-07-06 11:59:27"
          },
          "type": {
            "display_value": "Standard",
            "value": "standard"
          },
          "approval_history": {
            "display_value": "",
            "value": ""
          },
          "skills": {
            "display_value": "",
            "value": ""
          },
          "test_plan": {
            "display_value": "--Confirm that there are no monitoring alerts for the router",
            "value": "--Confirm that there are no monitoring alerts for the router"
          },
          "number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "is_bulk": {
            "display_value": "false",
            "value": false
          },
          "cab_delegate": {
            "display_value": "",
            "value": ""
          },
          "requested_by_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "ci_class": {
            "display_value": "cmdb_ci",
            "value": "cmdb_ci"
          },
          "state": {
            "display_value": "Closed",
            "value": 3.0
          },
          "sys_created_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "knowledge": {
            "display_value": "false",
            "value": false
          },
          "order": {
            "display_value": "",
            "value": ""
          },
          "phase": {
            "display_value": "Requested",
            "value": "requested"
          },
          "cmdb_ci": {
            "display_value": "",
            "value": ""
          },
          "delivery_plan": {
            "display_value": "",
            "value": ""
          },
          "impact": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "contract": {
            "display_value": "",
            "value": ""
          },
          "active": {
            "display_value": "false",
            "value": false
          },
          "work_notes_list": {
            "display_value": "",
            "value": ""
          },
          "priority": {
            "display_value": "4 - Low",
            "value": 4.0
          },
          "sys_domain_path": {
            "display_value": "/",
            "value": "/"
          },
          "cab_recommendation": {
            "display_value": "",
            "value": ""
          },
          "production_system": {
            "display_value": "false",
            "value": false
          },
          "rejection_goto": {
            "display_value": "",
            "value": ""
          },
          "review_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "requested_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "business_duration": {
            "display_value": "",
            "value": ""
          },
          "group_list": {
            "display_value": "",
            "value": ""
          },
          "change_plan": {
            "display_value": "",
            "value": ""
          },
          "approval_set": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "wf_activity": {
            "display_value": "",
            "value": ""
          },
          "implementation_plan": {
            "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
            "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
          },
          "universal_request": {
            "display_value": "",
            "value": ""
          },
          "end_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "short_description": {
            "display_value": "Clear BGP sessions on a Cisco router",
            "value": "Clear BGP sessions on a Cisco router"
          },
          "correlation_display": {
            "display_value": "",
            "value": ""
          },
          "work_start": {
            "display_value": "2015-07-06 11:56:04",
            "value": "2015-07-06 18:56:04",
            "display_value_internal": "2015-07-06 11:56:04"
          },
          "delivery_task": {
            "display_value": "",
            "value": ""
          },
          "outside_maintenance_schedule": {
            "display_value": "false",
            "value": false
          },
          "additional_assignee_list": {
            "display_value": "",
            "value": ""
          },
          "std_change_producer_version": {
            "display_value": "Clear BGP sessions on a Cisco router - 1",
            "value": "16c2273c47010200e90d87e8dee49006"
          },
          "sys_class_name": {
            "display_value": "Change Request",
            "value": "change_request"
          },
          "service_offering": {
            "display_value": "",
            "value": ""
          },
          "closed_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "follow_up": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "review_status": {
            "display_value": "",
            "value": ""
          },
          "reassignment_count": {
            "display_value": "2",
            "value": 2.0
          },
          "start_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "assigned_to": {
            "display_value": "",
            "value": ""
          },
          "variables": {
            "display_value": "variable_pool",
            "value": "variable_pool"
          },
          "sla_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments_and_work_notes": {
            "display_value": "",
            "value": ""
          },
          "escalation": {
            "display_value": "Normal",
            "value": 0.0
          },
          "upon_approval": {
            "display_value": "Proceed to Next Task",
            "value": "proceed"
          },
          "correlation_id": {
            "display_value": "",
            "value": ""
          },
          "made_sla": {
            "display_value": "true",
            "value": true
          },
          "backout_plan": {
            "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
            "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
          },
          "conflict_status": {
            "display_value": "Not Run",
            "value": "Not Run"
          },
          "task_effective_number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "sys_updated_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "opened_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "user_input": {
            "display_value": "",
            "value": ""
          },
          "sys_created_on": {
            "display_value": "2015-07-06 11:55:46",
            "value": "2015-07-06 18:55:46",
            "display_value_internal": "2015-07-06 11:55:46"
          },
          "on_hold_task": {
            "display_value": "",
            "value": ""
          },
          "sys_domain": {
            "display_value": "global",
            "value": "global"
          },
          "route_reason": {
            "display_value": "",
            "value": ""
          },
          "closed_at": {
            "display_value": "2015-07-06 11:56:23",
            "value": "2015-07-06 18:56:23",
            "display_value_internal": "2015-07-06 11:56:23"
          },
          "review_comments": {
            "display_value": "",
            "value": ""
          },
          "business_service": {
            "display_value": "",
            "value": ""
          },
          "time_worked": {
            "display_value": "",
            "value": ""
          },
          "chg_model": {
            "display_value": "",
            "value": ""
          },
          "expected_start": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "opened_at": {
            "display_value": "2015-06-09 11:55:46",
            "value": "2015-06-09 18:55:46",
            "display_value_internal": "2015-06-09 11:55:46"
          },
          "work_end": {
            "display_value": "2015-07-06 11:56:10",
            "value": "2015-07-06 18:56:10",
            "display_value_internal": "2015-07-06 11:56:10"
          },
          "phase_state": {
            "display_value": "Open",
            "value": "open"
          },
          "cab_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "work_notes": {
            "display_value": "",
            "value": ""
          },
          "close_code": {
            "display_value": "Successful",
            "value": "successful"
          },
          "assignment_group": {
            "display_value": "Network",
            "value": "287ebd7da9fe198100f92cc8d1d2154e"
          },
          "description": {
            "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
            "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
          },
          "on_hold_reason": {
            "display_value": "",
            "value": ""
          },
          "calendar_duration": {
            "display_value": "",
            "value": ""
          },
          "close_notes": {
            "display_value": "Completed without issues",
            "value": "Completed without issues"
          },
          "sys_id": {
            "display_value": "1766f1de47410200e90d87e8dee490f6",
            "value": "1766f1de47410200e90d87e8dee490f6"
          },
          "contact_type": {
            "display_value": "Phone",
            "value": "phone"
          },
          "cab_required": {
            "display_value": "false",
            "value": false
          },
          "urgency": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "scope": {
            "display_value": "Medium",
            "value": 3.0
          },
          "company": {
            "display_value": "",
            "value": ""
          },
          "justification": {
            "display_value": "",
            "value": ""
          },
          "activity_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments": {
            "display_value": "",
            "value": ""
          },
          "approval": {
            "display_value": "Approved",
            "value": "approved"
          },
          "due_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "sys_mod_count": {
            "display_value": "10",
            "value": 10.0
          },
          "on_hold": {
            "display_value": "false",
            "value": false
          },
          "sys_tags": {
            "display_value": "",
            "value": ""
          },
          "conflict_last_run": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "risk_value": {
            "display_value": "",
            "value": ""
          },
          "unauthorized": {
            "display_value": "false",
            "value": false
          },
          "risk": {
            "display_value": "Moderate",
            "value": 3.0
          },
          "location": {
            "display_value": "",
            "value": ""
          },
          "category": {
            "display_value": "Other",
            "value": "Other"
          },
          "risk_impact_analysis": {
            "display_value": "",
            "value": ""
          }
        }
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/{change_sys_id}/nextstates

    현재 상태를 포함하여 지정된 변경 요청에 사용할 수 있는 상태 목록을 조회합니다.

    사용 가능한 경우 구현된 Change Management의 버전에 따라 다음 상태로 전환하는 방법도 제공합니다. 변경 모델에 의해 변경되는 경우 엔드포인트는 통과했거나 통과하지 않은 조건을 반환합니다. 또한 지정된 전환에 대해 모든 조건이 통과되었는지 여부에 대한 정보도 제공합니다. 유형 기반 및 레거시 변경 요청에는 이 정보를 사용할 수 없습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/nextstates

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/nextstates

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 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 성공입니다. 요청이 성공적으로 처리되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    available_states 현재 상태를 포함하여 지정된 변경 요청에 사용할 수 있는 상태의 값입니다.

    데이터 유형: 배열

    state_label 레이블을 사용 가능한 상태와 연결하는 키-값 쌍입니다.

    데이터 유형: 객체

    state_transitions 사용 가능한 각 상태로 전환하는 데 필요한 사항에 대한 정보입니다. 사용 가능한 각각의 고유한 "to state"는 자체 Object에 있는 상태에 대한 각각의 서로 다른 조건 세트와 함께 자체 배열에 있습니다.

    데이터 유형: 배열

    "state_transitions": [
      {
        "automatic_transition": Boolean,
        "conditions": [Array],
        "display_value": "String",
        "from_state": "String",
        "sys_id": "String",
        "to_state": "String",
        "transition_available": Boolean
      }
    ]
    state_transitions.automatic_transition

    이 상태로 자동으로 전환할지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 변경 요청이 자동으로 이 상태로 전환됩니다.
    • false: 변경 요청이 자동으로 이 상태로 전환되지 않습니다.

    데이터 유형: 부울

    state_transitions.conditions 상태와 연결된 조건의 목록입니다.

    데이터 유형: 객체 배열

    "conditions": [
      {
        "condition": {Object},
        "passed": Boolean
      }
    ]
    state_transitions.conditions.condition 특정 조건의 값입니다.

    데이터 유형: 객체

    "condition": {
      "description": "String",
      "name": "String",
      "sys_id": "String"
    }
    state_transitions.conditions.condition.description 조건에 대한 설명입니다.

    데이터 유형: 문자열

    state_transitions.conditions.condition.name 조건의 이름입니다.

    데이터 유형: 문자열

    state_transitions.conditions.condition.sys_id 조건의 Sys_id입니다.

    데이터 유형: 문자열

    state_transitions.conditions.passed

    변경 요청이 관련 조건을 충족하는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 조건을 충족했습니다.
    • false: 조건을 충족하지 못했습니다.
    state_transitions.display_value 상태에 대한 설명이 표시됩니다.

    데이터 유형: 문자열

    state_transitions.from_state 변경 요청이 전환되는 상태의 값입니다.

    데이터 유형: 문자열

    state_transitions.sys_id 전환 상태의 Sys_id입니다.

    데이터 유형: 문자열

    state_transitions.to_state 변경 요청이 전환되는 상태의 값입니다.

    데이터 유형: 문자열

    state_transitions.transition_available

    변경 요청이 현재 상태에서 이 상태로 전환될 수 있는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 이 상태로 전환할 수 있습니다.
    • false: 이 상태로 전환할 수 없습니다.

    cURL 요청

    다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f"/nextstates \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    

    반환 결과:

    {
      "result": {
        "available_states": [ "0", "4", "-1" ], // State values
        "state_transitions": [
          [
            {
              "sys_id": "7a0d2ccdc343101035ae3f52c1d3ae2e", // sttrm_state_transition sys id
              "display_value": "Implement to Review",
              "from_state": "-1",
              "to_state": "0",
              "transition_available": false, // If true, can move to this state
              "automatic_transition": true, // If true, automatically moves to this state
              "conditions": [
                {
                  "passed": false, // If true, change request met this condition
                  "condition": {
                    "name": "No active Change Tasks",
                    "description": null,
                    "sys_id": "3c1d2ccdc343101035ae3f52c1d3aea4"
                  }
                }
              ]
            },
            {
              "sys_id": "db401481c343101035ae3f52c1d3aedd",
              "display_value": "Implement to Review",
              "from_state": "-1",
              "to_state": "0",
              "transition_available": true,
              "automatic_transition": false,
              "conditions": [
                {
                  "passed": true,
                  "condition": {
                    "name": "Not On hold",
                    "description": null,
                    "sys_id": "2132deb6c303101035ae3f52c1d3ae8c"
                  }
                }
              ]
            }
          ],
          [
            {
              "sys_id": "5327c551c343101035ae3f52c1d3aeec",
              "display_value": "Implement to Canceled",
              "from_state": "-1",
              "to_state": "4",
              "transition_available": true,
              "automatic_transition": false,
              "conditions": []
            }
          ]
        ],
        "state_label": { // state value to label pairs
          "0": "Review",
          "4": "Canceled",
          "-1": "Implement"
        }
      }
    }

    변경 관리 - GET /sn_chg_rest/change/{change_sys_id}/schedule

    변경 요청에 사용 가능한 시간 슬롯을 검색할 수 있습니다.

    필요한 역할: sn_change_writer.

    주:
    이 엔드포인트를 실행해도 사용 가능한 시작 및 종료 시간이 나열되지 않습니다. 응답 본문 worker.link 속성에 제공된 링크를 사용하여 일정 데이터를 가져옵니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/schedule

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/schedule

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 사용 가능한 다음 시간 슬롯을 찾을 변경 요청의 Sys_id입니다.

    선택한 변경 요청에는 계획된 시작 시간과 계획된 종료 시간이 있는 cmdb_ci(구성 항목)이 있어야 합니다.

    테이블: 변경 요청 [change_request]

    표 56. 쿼리 매개변수
    이름 설명
    안 함
    표 57. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 59. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 60. 상태 코드
    상태 코드 설명
    202 시스템이 요청을 수락했습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    가능한 문제:
    • 지정된 변경 요청에 계획된 시작 및 종료 시간이 누락되었습니다.
    • 지정된 변경 요청에 연결된 cmdb_ci(구성 항목)이 없습니다.
    • 사용자에게 변경 요청 필드에 대한 읽기 액세스 권한이 없습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    가능한 문제:
    • 시스템이 제공된 정보에 따라 변경 요청을 찾을 수 없습니다.
    • 사용자에게 기록에 대한 읽기 액세스 권한이 없습니다.

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

    이름 설명
    오류 엔드포인트 요청을 처리하는 동안 발생한 오류에 대한 정보입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String",
      "status": "String"
    }
    오류.상세 정보 오류에 대한 추가 정보입니다.

    데이터 유형: 문자열

    오류.메시지 오류를 식별하는 메시지입니다.

    데이터 유형: 문자열

    메시지 메시지 정보입니다.
    데이터 유형: 객체
    "messages": {
      "errorMessages": [Array],
      "infoMessages": [Array],
      "warningMessages": [Array]
    }
    messages.errorMessages 요청을 처리하는 동안 오류 메시지가 발생했습니다.

    데이터 유형: 배열

    messages.infoMessages 요청을 처리하는 동안 발생한 정보 메시지입니다.

    데이터 유형: 배열

    messages.warningMessages 요청을 처리하는 동안 경고 메시지가 표시되었습니다.

    데이터 유형: 배열

    요청 원래 엔드포인트 요청입니다.

    데이터 유형: 문자열

    상태 작업자의 현재 상태에 대한 정보입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: Number
    }
    state.display_value 작업자 상태의 값을 표시합니다. 이러한 값은 매개변수와 직접적인 state.value 상관 관계가 있습니다.

    가능한 값:

    • 완료
    • 오류
    • 진행 중
    • 대기 중

    데이터 유형: 문자열

    상태.값 작업자 상태의 숫자 값입니다.

    가능한 값:

    • 1
    • 2
    • 3
    • 4

    데이터 유형: 숫자

    유형 요청의 유형입니다.

    유효한 값: schedule

    데이터 유형: 문자열

    작업자 연결된 작업자에 대한 정보입니다.

    데이터 유형: 객체

    "worker": {
      "link": "String",
      "sysId": "String"
    }
    worker.link 시간 슬롯 데이터를 검색하기 위한 링크입니다.결과를 보려면 GET /sn_chg_rest/change/worker/{sys_id}의 sys_id를 사용합니다.

    데이터 유형: 문자열

    worker.sysId 변경 요청과 연결된 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    상태 오류가 발생한 경우에만 나타납니다. 엔드포인트 처리의 상태입니다.

    가능한 값: 실패

    데이터 유형: 문자열

    사용 가능한 시간 슬롯 가져오기

    일정 창 상세 정보를 가져오려면 제공된 값을 사용합니다 worker.link . 값은 다음과 같은 형식입니다.

    https://instance.service-now.com/api/sn_chg_rest/change/worker/<worker_sys_id>

    결과를 보려면 GET /sn_chg_rest/change/worker/{worker_sys_id}의 worker_sys_id를 사용하십시오.

    응답 본문에는 상태가 포함되어 있으며 처리가 완료되면 결과를 제공합니다.

    작업자 응답 본문 매개변수 결과는 시간 슬롯 가용성에 따라 달라집니다.
    • 제공된 시간 슬롯을 일정 시간 슬롯 내에서 변경 요청에 사용할 수 있는 경우 작업자 API는 속성에서 payload.spans 사용 가능한 시간 슬롯을 나열합니다. 그렇지 않으면 속성이 payload.spans 결과에 나열되지 않습니다.
    • 정의된 예약 시간 슬롯 messages.infoMessages 내에 제공된 변경 요청 기간에 사용할 수 있는 시간 슬롯이 없는 경우 다음과 같이 상태가 됩니다. D
      주:
      변경 요청 예약 시간 슬롯의 기본값은 90일입니다. 이 값을 변경하려면 속성을 수정합니다 change.conflict.next_available.schedule_window . 자세한 내용은 상충 분석 속성 구성을 참조하십시오.

    다음 GET /sn_chg_rest/change/worker/{sys_id} 예시는 worker.link 상세 정보에 제공된 ID를 사용하여 제공된 출력을 보여줍니다. 결과 목록은 작업 기간에 사용할 수 있는 열린 시간 범위입니다.

    {
      "result": {
        "worker": {
          "sysId": "9b3f62e0a4c87010f87712198fe9cad1",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1"
        },
        "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}",
        "state": {
          "value": 3,
          "display_value": "Complete"
        },
        "type": "schedule",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        },
        "payload": {
          "spans": [
            {
              "start": {
                "value": "2021-05-08 08:00:00",
                "display_value": "2021-05-08 01:00:00"
              },
              "end": {
                "value": "2021-05-08 11:00:00",
                "display_value": "2021-05-08 04:00:00"
              }
            },
            {
              "start": {
                "value": "2021-05-15 08:00:00",
                "display_value": "2021-05-15 01:00:00"
              },
              "end": {
                "value": "2021-05-15 11:00:00",
                "display_value": "2021-05-15 04:00:00"
              }
            },
            ...
          ]
        }
      }
    }

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/change/{change_sys_id}/schedule" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    

    결과에는 GET /sn_chg_rest/change/worker/ 엔드포인트에서 제공된 sys_id 실행하는 데 사용할 수 있는 worker.link 상세 정보가 포함됩니다.

    {
      "result": {
        "worker": {
          "sysId": "9b3f62e0a4c87010f87712198fe9cad1",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1"
        },
        "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}",
        "state": {
          "value": 1,
          "display_value": "Waiting"
        },
        "type": "schedule",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        }
      }
    }

    변경 관리 - GET /sn_chg_rest/change/{change_sys_id}/task

    지정된 기준에 따라 지정된 변경 요청과 연결된 하나 이상의 작업을 검색합니다.

    URL 형식

    버전 관리 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/task

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 작업을 검색할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 62. 쿼리 매개변수
    이름 설명
    키-값 쌍 요청을 만들 때 수정할 필드입니다. 키는 템플릿 내의 필드 이름이고 값은 필드에 채울 정보입니다.
    수정할 수 없으며 전달될 경우 무시되는 필드:
    • 비즈니스 규칙
    • ACL에 정의된 읽기 전용 필드
    • 존재하지 않는 필드

    데이터 유형: 문자열

    순서 반환된 변경 요청을 정렬할 필드입니다.

    데이터 유형: 문자열

    sysparm_limit 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다.

    데이터 유형: 숫자

    기본값: 500

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    텍스트검색 모든 변경 작업 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 전체 텍스트 검색 플랫폼 기능을 사용하며 ServiceNow 기본값은 IR_AND_OR_QUERY입니다.

    데이터 유형: 문자열

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

    헤더

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

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

    기본값: application/json

    표 65. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 66. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 삭제 전에 식별된 변경 요청 작업에 대한 연관된 값이 있는 모든 필드(키)입니다.

    데이터 유형: 객체

    상위 작업과 연관된 변경 요청에 대한 정보입니다.

    데이터 유형: 객체

    parent: {
      display_value: "String", 
      value: "String"
    }
    parent.display_value UI에 표시할 변경 요청 정보입니다.

    데이터 유형: 문자열

    parent.value 작업과 연결된 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id 변경 요청 작업에 대한 정보를 Sys_id합니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?sysparm_query=active=true^ORDERBYnumber" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'
    
    {
        result: [
            {
                sys_id: {
                    value: "12629ec4b750230096c3e4f6ee11a9d5",
                    display_value: "12629ec4b750230096c3e4f6ee11a9d5"
                },
                parent: {
                    value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", 
                    display_value: "CHG0033046 "
                },
                ..., // all valid fields in record, example below
                short_description: {
                    value: "Retire node",
                    display_value: "Retire node"
                }
            }, 
            { // next record found }, ... // and so on
        ]
    }
    

    변경 관리 - GET /sn_chg_rest/change/{sys_id}

    지정된 sys_id로 식별된 변경 요청을 조회합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}

    기본 URL: /api/sn_chg_rest/change/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 변경 요청 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 68. 쿼리 매개변수
    이름 설명
    안 함
    표 69. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 71. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 72. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    요소 설명
    결과 하나 이상의 변경 요청 기록 객체가 포함된 목록입니다. 각 객체는 변경 요청을 설명합니다. 변경 요청 개체의 각 요소는 변경 요청 [change_request] 테이블의 관련 기록에 있는 필드에 해당합니다.

    모든 요소에는 display_value 이름-값 쌍이 포함됩니다. 날짜 필드에는 display_value_internal 이름-값 쌍도 포함됩니다.

    데이터 유형: 배열

    action_status 연결된 변경 요청의 현재 작업 상태입니다.

    가능한 값:

    • 1: 내부적으로 차단
    • 2: 고객에 의해 차단됨
    • 3: 내부적 및 고객에 의해 차단됨
    • 4: 주의 필요

    데이터 유형: 숫자

    활성 변경 요청이 활성 상태인지 여부를 나타내는 플래그입니다.

    가능한 값:

    • true: 변경 요청이 활성 상태입니다.
    • false: 변경 요청이 활성 상태가 아닙니다.

    데이터 유형: 부울

    기본값: true

    activity_due 관련 케이스가 완료될 것으로 예상되는 날짜 및 시간입니다.

    데이터 유형: 문자열

    additional_assignee_list 변경 요청 작업에 할당된 추가 사용자 sys_ids 목록입니다.

    데이터 유형: 배열

    승인 필요한 승인 프로세스의 유형입니다.

    데이터 유형: 문자열

    기본값: 요청되지 않음

    approval_history 가장 최근의 승인 이력 저널 항목입니다.

    데이터 유형: 문자열

    approval_set 연결된 작업이 승인된 날짜 및 시간입니다.

    데이터 유형: 문자열

    assigned_to 변경 요청에 할당된 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    assignment_group 변경 요청에 할당된 그룹 Sys_id입니다.

    데이터 유형: 문자열

    backout_plan 변경을 되돌려야 하는 경우 실행할 계획에 대한 설명입니다.

    데이터 유형: 문자열

    business_duration 변경을 완료하는 데 걸린 예약된 작업 시간, 근무일 및 작업 주의 길이입니다.

    데이터 유형: 문자열

    business_service 변경 요청과 연결된 비즈니스 서비스의 Sys_id입니다. 서비스 [cmdb_ci_service] 테이블에 있습니다.

    데이터 유형: 문자열

    cab_date 변경심의위원회(CAB)가 열리는 날짜입니다.

    데이터 유형: 문자열

    cab_delegate CAB 회의 중에 CAB 관리자를 대신할 수 있는 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있음

    데이터 유형: 문자열

    cab_recommendation 변경 요청에 대한 CAB 권장 사항에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    cab_required CAB가 필요한지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 변경심의위원회가 필요합니다.
    • false: 변경심의위원회가 필요하지 않습니다.

    데이터 유형: 부울

    기본값: false

    calendar_duration 변경 관리에서 현재 사용하지 않습니다.

    데이터 유형: 문자열

    범주 변경 범주입니다(예: 하드웨어, 네트워크 또는 소프트웨어).

    데이터 유형: 문자열

    기본값: 기타

    change_plan 변경 요청을 관리하고 통제하기 위한 활동 및 역할입니다.

    데이터 유형: 문자열

    chg_model 연결된 변경 요청의 기반이 되는 변경 모델의 Sys_id입니다. 변경 모델은 변경 요청에 대해 완료해야 하는 상태 흐름, 전환, 프로세스 활동을 정의합니다.

    데이터 유형: 문자열

    테이블: 변경 모델 [chg_model]

    closed_at 연결된 변경 요청이 종결된 날짜 및 시간입니다.

    데이터 유형: 문자열

    closed_by 변경 요청을 종결한 사람의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    close_code 변경 요청이 종결되었을 때 변경 요청에 할당된 코드입니다. 예를 들어 성공, 성공(문제 발생) 및 실패가 있습니다.

    데이터 유형: 문자열

    close_notes 변경 요청을 종결할 때 사용자가 입력한 내용을 메모합니다.

    데이터 유형: 문자열

    cmdb_ci 변경 요청과 연결된 구성 항목의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 구성 항목 [cmdb_ci]

    댓글 연결된 변경 요청에 입력한 고객 대면 작업 메모 목록입니다.

    데이터 유형: 배열

    comments_and_work_notes 관련 변경 요청에 대해 입력한 내부 및 고객 대면 작업 메모의 목록입니다.

    데이터 유형: 배열

    최대 길이: 4,000

    회사 변경 요청과 연결된 회사의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 회사 [core_company]

    conflict_last_run 변경 요청에서 상충 탐지 스크립트가 마지막으로 실행된 날짜 및 시간입니다.

    데이터 유형: 문자열

    conflict_status 상충 탐지 스크립트에서 탐지한 현재 상충 상태(예: 상충 및 실행되지 않음)입니다.

    데이터 유형: 문자열

    최대 길이: 40

    기본값: 실행되지 않음

    contact_type 변경 요청을 처음 요청한 방법입니다.
    가능한 값:
    • 채팅
    • 이메일
    • 전화
    • 소셜

    데이터 유형: 문자열

    계약 변경 요청과 연결된 계약의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 계약 [ast_contract]

    correlation_display 의 사용자 친화적인 이름입니다 correlation_id.

    데이터 유형: 문자열

    최대 길이: 100

    correlation_id 외부 공급업체 시스템에서 일치하는 변경 요청 기록의 GUID(전역 고유 식별자)입니다.

    데이터 유형: 문자열

    최대 길이: 100

    delivery_plan 더 이상 사용되지 않습니다. 변경 요청과 연결된 제공 계획의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 실행 계획 [sc_cat_item_delivery_plan]

    delivery_task 더 이상 사용되지 않습니다. 변경 요청과 연결된 제공 작업의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 실행 계획 작업 [sc_cat_item_delivery_task]

    설명 변경 요청에 대한 자세한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    due_date 작업 기한. 변경 요청 프로세스에서 사용되지 않습니다.

    데이터 유형: 문자열

    end_date 변경 요청이 완료되는 날짜 및 시간입니다.

    데이터 유형: 문자열

    에스컬레이션 현재 에스컬레이션 수준입니다.

    가능한 값:

    • 0: 정상
    • 1: 보통
    • 2: 높음
    • 3: 기한 초과

    데이터 유형: 숫자(정수)

    기본값: 0

    expected_start 작업이 시작되는 날짜 및 시간입니다. 변경 요청 프로세스에 사용되지 않습니다.

    데이터 유형: 문자열

    follow_up 사용자가 변경 요청을 요청한 사람에 대한 후속 조치를 취한 날짜 및 시간입니다.

    데이터 유형: 문자열

    group_list 변경 요청과 관련된 그룹의 sys_ids 및 이름 목록입니다.

    데이터 유형: 배열

    최대 길이: 4,000

    영향도 변경 요청에 미치는 영향이 고객에게 미칠 영향입니다.

    가능한 값:

    • 1: 높음
    • 2: 중간
    • 3: 낮음

    데이터 유형: 숫자(정수)

    기본값: 3

    implementation_plan 이 변경을 구현하기 위해 실행할 순차적 단계입니다. 또한 단계와 각 단계에 대한 담당자 정보 간의 종속성도 포함합니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    근거 이 변경 구현의 이점과 이 변경이 구현되지 않을 경우의 영향입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    knowledge 변경 요청과 관련된 지식베이스()KB) 문서가 있는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 관련된 KB 문서
    • false: 연결된 KB 문서 없음

    데이터 유형: 부울

    위치 변경 요청에서 참조되는 장비 위치의 Sys_id 및 이름입니다.

    데이터 유형: 문자열

    테이블: 위치 [cmn_location]

    made_sla 더 이상 사용되지 않습니다. 변경 요청이 연결된 서비스 수준 계약에 따라 구현되었는지 여부를 나타내는 플래그입니다.

    데이터 유형: 부울

    needs_attention 변경 요청에 주의가 필요한지 여부를 나타내는 플래그입니다.

    가능한 값:

    • true: 변경 요청에 추가적인 주의가 필요합니다.
    • false: 변경 요청에 추가적인 주의가 필요하지 않습니다.

    데이터 유형: 부울

    기본값: false

    번호 CHG0040007와 같이 시스템에서 변경 요청에 할당된 변경 번호입니다.

    데이터 유형: 문자열

    on_hold 변경 요청이 현재 보류 중인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 보류 중
    • false: 보류 중 없음

    데이터 유형: 부울

    기본값: false

    on_hold_reason 매개변수가 on_hold "예"이면 변경 요청이 보류되는 이유에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    on_hold_task 매개변수가 on_hold "예"이면 보류가 해제되기 전에 완료해야 하는 작업 sys_ids 목록입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    opened_at 변경 릴리스가 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    opened_by 변경 릴리스를 생성한 사용자의 Sys_id 및 이름입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    순서 에서 사용하지 않습니다.변경 관리 데이터베이스에서 검색할 때와 같이 기록을 정렬하는 데 사용할 수 있는 선택적 숫자 필드입니다.

    데이터 유형: 숫자(정수)

    outside_maintenance_schedule 변경 요청에 대해 외부 회사의 유지관리가 예약되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • 예: 외부 유지관리 예약됨
    • false: 예약된 외부 유지관리 없음

    데이터 유형: 부울

    기본값: false

    상위 이 변경 요청에 대한 상위 작업의 Sys_id 및 이름입니다(있는 경우).

    데이터 유형: 문자열

    테이블: 작업 [task]

    단계 변경 요청의 현재 단계입니다. 이는 변경이 수행하는 작업을 보다 자세히 정의합니다.
    가능한 값:
    • 수용
    • 빌드
    • 계획
    • 요청됨

    데이터 유형: 문자열

    phase_state 변경을 위해 생성해야 하는 Change_phase 기록입니다. 범주에 따라 다르므로 각 변경 유형마다 다른 change_phase 기록이 있을 수 있습니다. change_phase 기록은 각 change_phase에 일정과 승인자 세트가 있을 수 있으므로 승인 프로세스를 제어할 수 있는 기회를 제공합니다.
    가능한 값:
    • 완료
    • 보류 중
    • 오픈
    • 거부됨
    • 요청됨
    • 작업 진행 중

    데이터 유형: 문자열

    우선순위 변경 요청의 우선순위입니다.
    가능한 값:
    • 1: 중요
    • 2: 높음
    • 3: 보통
    • 4: 낮음

    데이터 유형: 숫자(정수)

    기본값: 4

    production_system 변경 요청이 프로덕션 환경의 인스턴스에 ServiceNow 대한 것인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 프로덕션 환경
    • false: 비프로덕션 환경

    데이터 유형: 부울

    이유 변경 요청을 시작한 이유에 대한 설명입니다.
    가능한 값:
    • 비즈니스 요구 사항
    • 하드웨어 업그레이드
    • 법률
    • 위치 변경
    • 네트워크 요구 사항
    • 새 CI 또는 제거된 CI
    • 기타
    • 문제 해결됨
    • 제품 또는 서비스 변경됨
    • 소프트웨어 업그레이드
    • 사용자가 요청함

    데이터 유형: 문자열

    최대 길이: 40

    reassignment_count 변경 요청이 새 소유자에게 재할당된 횟수입니다.

    데이터 유형: 숫자(정수)

    기본값: 0

    rejection_goto 변경 요청이 거부될 경우 수행할 작업 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 작업 [task]

    requested_by 변경을 요청한 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    requested_by_date 변경을 구현하도록 요청한 날짜 및 시간입니다.

    데이터 유형: 문자열

    review_comments 변경 요청을 검토할 때 입력한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    review_date 변경 요청을 검토한 날짜입니다.

    데이터 유형: 문자열

    review_status 요청된 변경 요청 검토의 현재 상태입니다.

    데이터 유형: 문자열

    risk 변경 요청과 관련된 위험 수준입니다.
    유효한 값은 다음과 같습니다.
    • 1: 높음
    • 2: 보통
    • 3: 낮음

    데이터 유형: 숫자

    기본값: 3

    risk_impact_analysis 변경 요청 구현의 위험 설명 및 분석입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    route_reason 에서 현재 사용하지 않습니다.변경 관리 변경 요청이 전송된 이유입니다.
    가능한 값:
    • 1: 해결하고 이전
    • 9: 해결하지 않고 이전

    데이터 유형: 숫자

    범위 변경 요청의 크기입니다.
    가능한 값:
    • 1: 대량
    • 2: 대형
    • 3: 중간
    • 4: 소형
    • 5: 작은

    데이터 유형: 숫자

    기본값: 3

    service_offering 변경 요청과 연결된 서비스 오퍼링의 Sys_id입니다. 서비스 오퍼링은 가용성, 범위, 가격 및 패키징 옵션 측면에서 서비스 수준을 고유하게 정의합니다.

    데이터 유형: 문자열

    테이블: 오퍼링 [service_offering]

    short_description 변경 요청에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 40

    기술 변경 요청을 구현하는 데 필요한 모든 기술의 sys_ids 목록입니다.

    데이터 유형: 배열

    테이블: 기술 [cmn_skill]

    sla_due 더 이상 사용되지 않습니다. 연결된 서비스 수준 계약에 따라 변경 요청을 완료해야 하는 날짜 및 시간입니다.

    데이터 유형: 문자열

    sn_esign_document 변경 요청에 첨부된 전자 서명 문서의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    sn_esign_esignature_configuration 연결된 문서에 사용되는 전자 서명 서명 템플릿의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 전자 서명 템플릿 [sn_esign_configuration]

    start_date 변경 요청이 구현을 시작할 날짜 및 시간입니다.

    데이터 유형: 문자열

    상태 변경 요청의 현재 상태입니다. 가능한 값은 변경 모델에 정의되어 있습니다.

    데이터 유형: 숫자(정수)

    기본값: 1

    std_change_producer_version 변경 요청과 관련된 기록 생성자 및 변경 제안의 Sys_id입니다. 제안서에서 만든 성공 및 실패 변경 요청 수와 백분율도 포함됩니다.

    데이터 유형: 문자열

    테이블: 표준 변경 템플릿 버전 [std_change_producer_version]

    sys_class_name 변경 요청이 있는 테이블의 이름입니다.

    데이터 유형: 문자열

    sys_created_by 변경 요청을 처음 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    최대 길이: 40

    sys_created_on 연결된 변경 요청 기록이 원래 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    sys_domain 인스턴스에서 도메인을 사용하는 경우 변경 모듈 기록이 연결된 도메인의 이름입니다.

    데이터 유형: 문자열

    sys_domain_path 인스턴스에서 도메인을 사용하는 경우 연결된 변경 모듈 기록이 있는 도메인 경로입니다.

    데이터 유형: 문자열

    sys_id 연결된 변경 요청 기록의 고유 식별자입니다.

    데이터 유형: 문자열

    sys_mod_count 케이스가 처음 만들어진 이후 업데이트된 수입니다.

    데이터 유형: 숫자(정수)

    sys_updated_by 케이스를 마지막으로 업데이트한 사람입니다.

    데이터 유형: 문자열

    최대 길이: 40

    sys_updated_on 케이스가 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    task_effective_number 범용 요청 번호입니다.

    데이터 유형: 문자열

    최대 길이: 40

    task_for 에서 사용하지 않습니다.변경 관리 작업이 생성된 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    test_plan 변경에 대해 연결된 테스트 계획에 대한 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    time_worked 변경 요청에 대해 작업한 총 시간입니다.

    데이터 유형: 문자열

    유형 변경 요청 유형입니다.
    가능한 값:
    • 긴급
    • 일반
    • 표준

    데이터 유형: 문자열

    최대 길이: 40

    권한 해제됨 변경 요청이 승인되지 않았는지 여부를 나타내는 플래그
    가능한 값:
    • true: 권한 해제됨
    • false: 인증됨

    데이터 유형: 부울

    universal_request 이 변경 요청이 속한 상위 범용 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 작업 [task]

    upon_approval 변경 요청이 승인될 경우 수행할 동작입니다.

    가능한 값:

    • do_nothing
    • 계속 진행

    데이터 유형: 문자열

    최대 길이: 40

    기본값: 계속 진행

    upon_reject 변경 요청이 거부될 경우 수행할 동작입니다.

    가능한 값:

    • cancel
    • 이동

    데이터 유형: 문자열

    최대 길이: 40

    기본값: 취소

    긴급도 변경 요청의 긴급도입니다.

    가능한 값:

    • 1: 높음
    • 2: 중간
    • 3: 낮음

    데이터 유형: 숫자(정수)

    기본값: 3

    user_input 추가 사용자 입력.

    데이터 유형: 문자열

    최대 길이: 4,000

    variables 변경 요청과 관련된 변수의 이름-값 쌍입니다.

    데이터 유형: 문자열

    최대 길이: 40

    watch_list 추가 코멘트가 추가되거나 변경 요청의 상태가 해결됨 또는 종결됨으로 변경될 경우 이 변경 요청에 대한 알림을 받는 사용자 sys_ids 목록입니다.

    데이터 유형: 배열

    테이블: 사용자 [sys_user]

    wf_activity 변경 요청과 관련된 워크플로우 활동 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 워크플로우 활동 [wf_activity]

    work_end 변경 요청에 대한 작업이 종료된 날짜 및 시간입니다.

    데이터 유형: 문자열

    work_notes 변경 요청을 해결하는 방법 또는 이를 해결하기 위해 수행한 단계에 대한 정보입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    work_notes_list 작업 메모가 추가될 때 이 변경 요청에 대한 알림을 받는 내부 사용자 sys_ids의 목록입니다.

    데이터 유형: 배열

    테이블: 사용자 [sys_user]

    work_start 변경 요청에서 작업이 시작된 날짜 및 시간입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      "result":
        {
          "reason": {
            "display_value": "",
            "value": ""
          },
          "parent": {
            "display_value": "",
            "value": ""
          },
          "watch_list": {
            "display_value": "",
            "value": ""
           },
           "proposed_change": {
             "display_value": "",
             "value": ""
           },
           "upon_reject": {
             "display_value": "Cancel all future Tasks",
             "value": "cancel"
           },
           "sys_updated_on": {
             "display_value": "2015-07-06 11:59:27",
             "value": "2015-07-06 18:59:27",
             "display_value_internal": "2015-07-06 11:59:27"
          },
          "type": {
            "display_value": "Standard",
            "value": "standard"
          },
          "approval_history": {
            "display_value": "",
            "value": ""
          },
          "skills": {
            "display_value": "",
            "value": ""
          },
          "test_plan": {
            "display_value": "--Confirm that there are no monitoring alerts for the router",
            "value": "--Confirm that there are no monitoring alerts for the router"
          },
          "number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "is_bulk": {
            "display_value": "false",
            "value": false
          },
          "cab_delegate": {
            "display_value": "",
            "value": ""
          },
          "requested_by_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "ci_class": {
            "display_value": "cmdb_ci",
            "value": "cmdb_ci"
          },
          "state": {
            "display_value": "Closed",
            "value": 3.0
          },
          "sys_created_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "knowledge": {
            "display_value": "false",
            "value": false
          },
          "order": {
            "display_value": "",
            "value": ""
          },
          "phase": {
            "display_value": "Requested",
            "value": "requested"
          },
          "cmdb_ci": {
            "display_value": "",
            "value": ""
          },
          "delivery_plan": {
            "display_value": "",
            "value": ""
          },
          "impact": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "contract": {
            "display_value": "",
            "value": ""
          },
          "active": {
            "display_value": "false",
            "value": false
          },
          "work_notes_list": {
            "display_value": "",
            "value": ""
          },
          "priority": {
            "display_value": "4 - Low",
            "value": 4.0
          },
          "sys_domain_path": {
            "display_value": "/",
            "value": "/"
          },
          "cab_recommendation": {
            "display_value": "",
            "value": ""
          },
          "production_system": {
            "display_value": "false",
            "value": false
          },
          "rejection_goto": {
            "display_value": "",
            "value": ""
          },
          "review_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "requested_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "business_duration": {
            "display_value": "",
            "value": ""
          },
          "group_list": {
            "display_value": "",
            "value": ""
          },
          "change_plan": {
            "display_value": "",
            "value": ""
          },
          "approval_set": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "wf_activity": {
            "display_value": "",
            "value": ""
          },
          "implementation_plan": {
            "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
            "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
          },
          "universal_request": {
            "display_value": "",
            "value": ""
          },
          "end_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "short_description": {
            "display_value": "Clear BGP sessions on a Cisco router",
            "value": "Clear BGP sessions on a Cisco router"
          },
          "correlation_display": {
            "display_value": "",
            "value": ""
          },
          "work_start": {
            "display_value": "2015-07-06 11:56:04",
            "value": "2015-07-06 18:56:04",
            "display_value_internal": "2015-07-06 11:56:04"
          },
          "delivery_task": {
            "display_value": "",
            "value": ""
          },
          "outside_maintenance_schedule": {
            "display_value": "false",
            "value": false
          },
          "additional_assignee_list": {
            "display_value": "",
            "value": ""
          },
          "std_change_producer_version": {
            "display_value": "Clear BGP sessions on a Cisco router - 1",
            "value": "16c2273c47010200e90d87e8dee49006"
          },
          "sys_class_name": {
            "display_value": "Change Request",
            "value": "change_request"
          },
          "service_offering": {
            "display_value": "",
            "value": ""
          },
          "closed_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "follow_up": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "review_status": {
            "display_value": "",
            "value": ""
          },
          "reassignment_count": {
            "display_value": "2",
            "value": 2.0
          },
          "start_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "assigned_to": {
            "display_value": "",
            "value": ""
          },
          "variables": {
            "display_value": "variable_pool",
            "value": "variable_pool"
          },
          "sla_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments_and_work_notes": {
            "display_value": "",
            "value": ""
          },
          "escalation": {
            "display_value": "Normal",
            "value": 0.0
          },
          "upon_approval": {
            "display_value": "Proceed to Next Task",
            "value": "proceed"
          },
          "correlation_id": {
            "display_value": "",
            "value": ""
          },
          "made_sla": {
            "display_value": "true",
            "value": true
          },
          "backout_plan": {
            "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
            "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
          },
          "conflict_status": {
            "display_value": "Not Run",
            "value": "Not Run"
          },
          "task_effective_number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "sys_updated_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "opened_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "user_input": {
            "display_value": "",
            "value": ""
          },
          "sys_created_on": {
            "display_value": "2015-07-06 11:55:46",
            "value": "2015-07-06 18:55:46",
            "display_value_internal": "2015-07-06 11:55:46"
          },
          "on_hold_task": {
            "display_value": "",
            "value": ""
          },
          "sys_domain": {
            "display_value": "global",
            "value": "global"
          },
          "route_reason": {
            "display_value": "",
            "value": ""
          },
          "closed_at": {
            "display_value": "2015-07-06 11:56:23",
            "value": "2015-07-06 18:56:23",
            "display_value_internal": "2015-07-06 11:56:23"
          },
          "review_comments": {
            "display_value": "",
            "value": ""
          },
          "business_service": {
            "display_value": "",
            "value": ""
          },
          "time_worked": {
            "display_value": "",
            "value": ""
          },
          "chg_model": {
            "display_value": "",
            "value": ""
          },
          "expected_start": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "opened_at": {
            "display_value": "2015-06-09 11:55:46",
            "value": "2015-06-09 18:55:46",
            "display_value_internal": "2015-06-09 11:55:46"
          },
          "work_end": {
            "display_value": "2015-07-06 11:56:10",
            "value": "2015-07-06 18:56:10",
            "display_value_internal": "2015-07-06 11:56:10"
          },
          "phase_state": {
            "display_value": "Open",
            "value": "open"
          },
          "cab_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "work_notes": {
            "display_value": "",
            "value": ""
          },
          "close_code": {
            "display_value": "Successful",
            "value": "successful"
          },
          "assignment_group": {
            "display_value": "Network",
            "value": "287ebd7da9fe198100f92cc8d1d2154e"
          },
          "description": {
            "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
            "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
          },
          "on_hold_reason": {
            "display_value": "",
            "value": ""
          },
          "calendar_duration": {
            "display_value": "",
            "value": ""
          },
          "close_notes": {
            "display_value": "Completed without issues",
            "value": "Completed without issues"
          },
          "sys_id": {
            "display_value": "1766f1de47410200e90d87e8dee490f6",
            "value": "1766f1de47410200e90d87e8dee490f6"
          },
          "contact_type": {
            "display_value": "Phone",
            "value": "phone"
          },
          "cab_required": {
            "display_value": "false",
            "value": false
          },
          "urgency": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "scope": {
            "display_value": "Medium",
            "value": 3.0
          },
          "company": {
            "display_value": "",
            "value": ""
          },
          "justification": {
            "display_value": "",
            "value": ""
          },
          "activity_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments": {
            "display_value": "",
            "value": ""
          },
          "approval": {
            "display_value": "Approved",
            "value": "approved"
          },
          "due_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "sys_mod_count": {
            "display_value": "10",
            "value": 10.0
          },
          "on_hold": {
            "display_value": "false",
            "value": false
          },
          "sys_tags": {
            "display_value": "",
            "value": ""
          },
          "conflict_last_run": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "risk_value": {
            "display_value": "",
            "value": ""
          },
          "unauthorized": {
            "display_value": "false",
            "value": false
          },
          "risk": {
            "display_value": "Moderate",
            "value": 3.0
          },
          "location": {
            "display_value": "",
            "value": ""
          },
          "category": {
            "display_value": "Other",
            "value": "Other"
          },
          "risk_impact_analysis": {
            "display_value": "",
            "value": ""
          }
        }
    }

    변경 관리 - GET /sn_chg_rest/change/{sys_id}/ci

    지정된 연결 유형을 기반으로 지정된 변경 요청과 연결된 여러 CI(구성 항목)를 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/ci

    기본 URL: /api/sn_chg_rest/change/{sys_id}/ci

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 연결된 CMDB CI를 반환할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    표 74. 쿼리 매개변수
    이름 설명
    association_type 필수 CMDB CI와 변경 요청 간의 연결 유형입니다.

    유효한 값은 다음과 같습니다.

    • affected: 변경 요청의 영향을 받는 CI
    • 영향: 변경 요청의 영향을 받는 서비스
    • 오퍼링: 영향을 받는 서비스 오퍼링

    데이터 유형: 문자열

    이름-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    sysparm_limit 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다.

    데이터 유형: 숫자

    기본값: 500

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

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

    헤더

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

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

    기본값: application/json

    표 77. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

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

    오류 응답에는 문제 해결에 도움이 되는 관련 메시지가 포함되어 있습니다.

    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    ci_item|cmdb_ci_service 연결 유형에 따라 ci_item 또는 cmdb_ci_service 변수입니다.

    데이터 유형: 배열

    ci_item|cmdb_ci_service : {
      display_value: "String", 
      value: "String"
    }
    ci_item|cmdb_ci_service.값 ci_item 또는 cmdb_ci_service의 Sys_id입니다.

    데이터 유형: 문자열

    ci_item|cmdb_ci_service.display_value ci_item 또는 cmdb_ci_service의 값을 표시합니다.

    데이터 유형: 문자열

    sys_id 변경 요청 sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    <record_fields> ci_item 또는 cmdb_ci_service 기록의 모든 유효 필드입니다. 연결 유형에 따른 테이블입니다.

    데이터 유형: 객체

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci?association_type=affected" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'
    
    {
      result: [
        {
          sys_id: {
            value: "92b8544047810200e90d87e8dee490b0",
            display_value: "92b8544047810200e90d87e8dee490b0"
          },
          ci_item|cmdb_ci_service : {
            value: "3a27d4370a0a0bb4006316812bf45439", 
            display_value: "PS Apache01"
          },
          ..., // all valid fields in record, table based on association type
        }, 
        { // next record found }, ... // and so on
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/{sys_id}/conflict

    현재 실행 중인 변경 요청 상충 검사 프로세스의 상태 또는 지정된 변경 요청에 대해 마지막으로 완료된 상충 검사 프로세스의 결과를 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/conflict

    기본 URL: /api/sn_chg_rest/change/{sys_id}/conflict

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 실행 중/완료된 상충 검사 프로세스의 상태를 반환할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 80. 쿼리 매개변수
    이름 설명
    안 함
    표 81. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 83. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 84. 상태 코드
    상태 코드 설명
    200 상충 확인 프로세스의 현재 상태; 탐지된 경우 상충을 포함합니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    상충 변경 요청과 관련하여 발견된 상충 목록입니다. 빈 객체는 상충이 탐지되지 않았음을 나타냅니다.

    데이터 유형: 배열

    job_status 실제 상충 검사 작업의 상태입니다.

    데이터 유형: 문자열

    last_run 마지막 상충 검사 프로세스가 시작된 날짜 및 시간입니다.

    데이터 유형: 문자열

    record_count 확인된 기록 수입니다.

    데이터 유형: 문자열

    상태 "상충" 또는 "실행되지 않음"과 같은 상충 검사 프로세스의 결과입니다.
    주:
    변경 요청에 상충이 없더라도 이 필드는 "상충"으로 설정됩니다. 그러나 객체는 conflicts 비어 있습니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    성공적인 응답 - 상충 없음

    {
      result: {
        status: "Conflict",
        last_run": "2018-08-30 12:58:05",
        record_count: "1",
        job_status: "2",
        conflicts: []
      }
    }

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    

    성공적인 응답 - 상충 있음

    {
      result: {
        status: "Conflict",
        last_run": "2018-08-30 12:58:05",
        record_count: "1",
        job_status: "2",
        conflicts: [
          {
            change: {
              display_value: "CHG0030001",
              value: "afbffb24b758230096c3e4f6ee11a972"
            },
            type: {
              display_value: "Not In Maintenance Window",
              value: "not_in_maintenance_window"
            }
            ..., // all valid fields in record, example below
          }
        ]
      }
    }

    변경 관리 - GET /sn_chg_rest/change/emergency

    지정된 기준에 따라 하나 이상의 긴급 변경 요청을 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/emergency

    기본 URL: /api/sn_chg_rest/change/emergency

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 86. 쿼리 매개변수
    이름 설명
    순서 반환된 변경 요청을 정렬할 필드입니다.

    데이터 유형: 문자열

    기본값: number

    sysparm_limit 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다.

    데이터 유형: 숫자

    기본값: 500

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    키-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    텍스트검색 모든 긴급 변경 요청 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 전체 텍스트 검색 플랫폼 기능을 사용하며 ServiceNow 기본값은 IR_AND_OR_QUERY입니다.

    데이터 유형: 문자열

    표 87. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 89. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 90. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?sysparm_query=active=true^ORDERBYnumber" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "1c87925347c12200e0ef563dbb9a7177",
            display_value: "1c87925347c12200e0ef563dbb9a7177"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "emergency",
            display_value: "Emergency"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Reboot server",
            display_value: "Reboot server"
          },
        }, 
        { // next record found }, ... // and so on
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/emergency/{sys_id}

    지정된 sys_id로 식별된 긴급 변경 요청을 조회합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/emergency/{sys_id}

    기본 URL: /api/sn_chg_rest/change/emergency/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 검색할 긴급 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 92. 쿼리 매개변수
    이름 설명
    안 함
    표 93. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 95. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 96. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "b0dbda5347c12200e0ef563dbb9a718f", 
            display_value: "b0dbda5347c12200e0ef563dbb9a718f"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "emergency",
            display_value: "Emergency"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Reboot server",
            display_value: "Reboot server"
          },
        },
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/model

    지정된 기준에 따라 하나 이상의 변경 모델을 검색합니다.

    이 엔드포인트를 사용하여 만들려는 변경 요청에 가장 적합한 변경 모델을 찾을 수 있습니다. 자세한 내용은 변경 모델을 참조하십시오.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/model

    기본 URL: /api/sn_chg_rest/change/model

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 98. 쿼리 매개변수
    이름 설명
    이름-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    순서 반환된 변경 모델을 정렬할 필드입니다.

    데이터 유형: 문자열

    기본값: 이름

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    텍스트검색 모든 변경 모델 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 전체 텍스트 검색 플랫폼 기능을 사용합니다 ServiceNow . 검색 기능에 대한 ServiceNow 자세한 내용은 검색 관리를 참조하세요.

    데이터 유형: 문자열

    기본값: IR_AND_OR_QUERY

    표 99. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 101. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 102. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    결과 하나 이상의 변경 모델 기록 객체가 포함된 목록입니다. 각 객체는 변경 모델을 설명합니다. 변경 모델 객체의 각 요소는 변경 모델 [chg_model] 테이블의 관련 기록에 있는 필드에 해당합니다.

    모든 요소에는 display_value 이름-값 쌍이 포함됩니다. 일부는 display_value_internal 이름-값 쌍을 포함합니다.

    데이터 유형: 배열

    결과.활성 연결된 변경 모델 기록이 활성 상태이고 인스턴스 내에서 사용할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 변경 모델이 활성 상태입니다.
    • false: 변경 모델이 활성화되어 있지 않습니다.

    데이터 유형: 부울

    기본값: true

    result.available_in_ui 연결된 변경 모델 기록을 사용자 인터페이스 내에서 사용할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자 인터페이스에서 변경 모델을 사용할 수 있습니다.
    • false: 사용자 인터페이스에서 변경 모델을 사용할 수 없습니다.

    데이터 유형: 부울

    기본값: true

    결과.색상 변경 요청 방문 페이지에 있는 연결된 변경 모델의 색상입니다.

    데이터 유형: 문자열

    기본값: #cbcbcb

    result.default_change_model 연결된 변경 모델 기록이 기본 변경 모델인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 기본값
    • false: 기본값이 아님

    데이터 유형: 부울

    기본값: false

    결과.설명 변경 모델의 목적에 대한 짧은 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    result.name 변경 모델의 이름입니다.

    데이터 유형: 문자열

    최대 길이: 200

    result.record_preset 새 변경 요청 기록이 생성될 때 연결된 값으로 자동으로 채워져야 하는 필드의 이름-값 쌍입니다. 값은 캐럿 기호로 구분됩니다.

    예:

    "유형=정상^assignment_group=a715cd759f2002002920bde8132e7018^short_description=자동화: 변경^EQ"

    데이터 유형: 문자열

    result.state_field 다음에 table_name제공된 항목을 기반으로 선택 항목을 수집할 선택 목록 필드입니다. 변경 모델의 경우 항상 "상태"로 설정됩니다.

    데이터 유형: 문자열

    result.sys_class_name 모듈 테이블 이름을 변경합니다. 항상 모델/chg_model를 변경합니다.

    데이터 유형: 문자열

    result.sys_created_by 연결된 변경 모듈 기록을 처음 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    result.sys_created_on 변경 모듈 기록이 처음 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    result.sys_도메인 인스턴스에서 도메인을 사용하는 경우 변경 모듈 기록이 연결된 도메인의 이름입니다.

    데이터 유형: 문자열

    result.sys_domain_path 인스턴스에서 도메인을 사용하는 경우 연결된 변경 모듈 기록이 있는 도메인 경로입니다.

    데이터 유형: 문자열

    result.sys_id 연결된 변경 모델 기록의 고유 식별자입니다.

    데이터 유형: 문자열

    result.sys_mod_count 연결된 변경 모델 기록이 수정된 횟수입니다.

    데이터 유형: 숫자

    result.sys_이름 변경 모델의 이름입니다. 항상 매개변수와 동일합니다 name .

    데이터 유형: 문자열

    result.sys_tags 변경 모델 기록과 연결된 시스템 태그입니다.

    데이터 유형: 문자열

    result.sys_updated_by 연결된 변경 모델 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    최대 길이: 40

    result.sys_updated_on 연결된 변경 모델 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    result.table_name 선택 항목을 수집할 선택 목록 필드를 정의하는 테이블입니다. 변경 모델의 경우 이 값은 항상 "change_request"으로 설정됩니다.

    데이터 유형: 문자열

    최대 길이: 80

    cURL 요청

    이 예는 모든 변경 모델 기록을 가져오기 위한 요청을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    

    간결성을 위해 이 응답은 단일 변경 모델 객체만 표시합니다.

    {
      "result": [
        {
          "record_preset": {
            "display_value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ",
            "value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ"
          },
          "color": {
            "display_value": "#488df4",
            "value": "#488df4"
          },
          "default_change_model": {
            "display_value": "false",
            "value": false
          },
          "sys_mod_count": {
            "display_value": "6",
            "value": 6.0
          },
          "description": {
            "display_value": "This model is intended to capture  a record of an automated change.  There are no approvals associated with this change model.\r\n",
            "value": "This model is intended to capture  a record of an automated change.  There are no approvals associated with this change model.\r\n"
          },
          "active": {
            "display_value": "true",
            "value": true
          },
          "sys_updated_on": {
            "display_value": "2020-10-02 06:24:24",
            "value": "2020-10-02 13:24:24",
            "display_value_internal": "2020-10-02 06:24:24"
          },
          "sys_tags": {
            "display_value": "",
            "value": ""
          },
            "table_name": {
            "display_value": "change_request",
            "value": "change_request"
          },
          "sys_class_name": {
            "display_value": "Change Model",
            "value": "chg_model"
          },
          "sys_id": {
            "display_value": "7840d2515323101034d1ddeeff7b12a6",
            "value": "7840d2515323101034d1ddeeff7b12a6"
          },
          "sys_updated_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "available_in_ui": {
            "display_value": "false",
            "value": false
          },
          "state_field": {
            "display_value": "state",
            "value": "state"
          },
          "sys_created_on": {
            "display_value": "2020-09-28 07:33:25",
            "value": "2020-09-28 14:33:25",
            "display_value_internal": "2020-09-28 07:33:25"
          },
          "name": {
            "display_value": "Change Registration",
            "value": "Change Registration"
          },
          "sys_name": {
            "display_value": "Change Registration",
            "value": "Change Registration"
          },
          "sys_created_by": {
            "display_value": "admin",
            "value": "admin"
          }
        }
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/model/{sys_id}

    지정된 sys_id로 식별된 변경 모델을 조회합니다.

    그런 다음 이 변경 모델을 사용하여 원하는 변경 요청을 만들 수 있습니다. 변경 모델에 대한 자세한 내용은 변경 모델을 참조하십시오.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/model/{sys_id}

    기본 URL: /api/sn_chg_rest/change/model/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 변경 모델 [chg_model] 테이블에서 검색할 변경 모델 기록의 Sys_id입니다.

    데이터 유형: 문자열

    표 104. 쿼리 매개변수
    이름 설명
    안 함
    표 105. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 107. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 108. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    결과 요청된 변경 모델 기록 객체입니다. 이 객체의 각 요소는 변경 모델 [chg_model] 테이블의 기록에 있는 필드에 해당합니다.

    모든 요소에는 및 이름-값 쌍이 display_value 포함되어 value 있습니다. 일부는 이름-값 쌍을 포함합니다 display_value_internal .

    데이터 유형: 객체

    결과.활성 연결된 변경 모델 기록이 활성 상태이고 인스턴스 내에서 사용할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 변경 모델이 활성 상태입니다.
    • false: 변경 모델이 활성화되어 있지 않습니다.

    데이터 유형: 부울

    기본값: true

    result.available_in_ui 연결된 변경 모델 기록을 사용자 인터페이스 내에서 사용할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자 인터페이스에서 변경 모델을 사용할 수 있습니다.
    • false: 사용자 인터페이스에서 변경 모델을 사용할 수 없습니다.

    데이터 유형: 부울

    기본값: true

    결과.색상 변경 요청 방문 페이지에 있는 연결된 변경 모델의 색상입니다.

    데이터 유형: 문자열

    기본값: #cbcbcb

    result.default_change_model 연결된 변경 모델 기록이 기본 변경 모델인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 기본값
    • false: 기본값이 아님

    데이터 유형: 부울

    기본값: false

    결과.설명 변경 모델의 목적에 대한 짧은 설명입니다.

    데이터 유형: 문자열

    최대 길이: 4,000

    result.name 변경 모델의 이름입니다.

    데이터 유형: 문자열

    최대 길이: 200

    result.record_preset 새 변경 요청 기록이 생성될 때 연결된 값으로 자동으로 채워져야 하는 필드의 이름-값 쌍입니다. 값은 캐럿 기호로 구분됩니다.

    예:

    "유형=정상^assignment_group=a715cd759f2002002920bde8132e7018^short_description=자동화: 변경^EQ"

    데이터 유형: 문자열

    result.state_field 다음에 table_name제공된 항목을 기반으로 선택 항목을 수집할 선택 목록 필드입니다. 변경 모델의 경우 항상 "상태"로 설정됩니다.

    데이터 유형: 문자열

    result.sys_class_name 모듈 테이블 이름을 변경합니다. 항상 모델/chg_model를 변경합니다.

    데이터 유형: 문자열

    result.sys_created_by 연결된 변경 모듈 기록을 처음 생성한 사용자의 이름입니다.

    데이터 유형: 문자열

    result.sys_created_on 변경 모듈 기록이 처음 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    result.sys_도메인 인스턴스에서 도메인을 사용하는 경우 변경 모듈 기록이 연결된 도메인의 이름입니다.

    데이터 유형: 문자열

    result.sys_domain_path 인스턴스에서 도메인을 사용하는 경우 연결된 변경 모듈 기록이 있는 도메인 경로입니다.

    데이터 유형: 문자열

    result.sys_id 연결된 변경 모델 기록의 고유 식별자입니다.

    데이터 유형: 문자열

    result.sys_mod_count 연결된 변경 모델 기록이 수정된 횟수입니다.

    데이터 유형: 숫자

    result.sys_이름 변경 모델의 이름입니다. 항상 매개변수와 동일합니다 name .

    데이터 유형: 문자열

    result.sys_tags 변경 모델 기록과 연결된 시스템 태그입니다.

    데이터 유형: 문자열

    result.sys_updated_by 연결된 변경 모델 기록을 마지막으로 업데이트한 사용자의 이름입니다.

    데이터 유형: 문자열

    최대 길이: 40

    result.sys_updated_on 연결된 변경 모델 기록이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    result.table_name 선택 항목을 수집할 선택 목록 필드를 정의하는 테이블입니다. 변경 모델의 경우 이 값은 항상 "change_request"으로 설정됩니다.

    데이터 유형: 문자열

    최대 길이: 80

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model/c0efda5347c12200e0ef563dbb9a81e3" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      "result": {
        "record_preset": {
          "display_value": "type=emergency^EQ",
          "value": "type=emergency^EQ"
        },
        "color": {
          "display_value": "#ea3423",
          "value": "#ea3423"
        },
        "default_change_model": {
          "display_value": "false",
          "value": false
        },
        "sys_mod_count": {
          "display_value": "2",
          "value": 2.0
        },
        "description": {
          "display_value": "ITIL Mode 1 Emergency Change",
          "value": "ITIL Mode 1 Emergency Change"
        },
        "active": {
          "display_value": "true",
          "value": true
        },
        "sys_updated_on": {
          "display_value": "2020-09-28 08:53:12",
          "value": "2020-09-28 15:53:12",
          "display_value_internal": "2020-09-28 08:53:12"
        },
        "sys_tags": {
          "display_value": "",
          "value": ""
        },
        "table_name": {
          "display_value": "change_request",
          "value": "change_request"
        },
        "sys_class_name": {
          "display_value": "Change Model",
          "value": "chg_model"
        },
        "sys_id": {
          "display_value": "c0efda5347c12200e0ef563dbb9a81e3",
          "value": "c0efda5347c12200e0ef563dbb9a81e3"
        },
        "sys_updated_by": {
          "display_value": "admin",
          "value": "admin"
        },
        "available_in_ui": {
          "display_value": "true",
          "value": true
        },
        "state_field": {
          "display_value": "state",
          "value": "state"
        },
        "sys_created_on": {
          "display_value": "2020-09-04 09:16:03",
          "value": "2020-09-04 16:16:03",
          "display_value_internal": "2020-09-04 09:16:03"
        },
        "name": {
          "display_value": "Emergency",
          "value": "Emergency"
        },
        "sys_name": {
          "display_value": "Emergency",
          "value": "Emergency"
        },
        "sys_created_by": {
          "display_value": "admin",
          "value": "admin"
        }
      }
    }

    변경 관리 - GET /sn_chg_rest/change/normal

    지정된 기준에 따라 하나 이상의 일반 변경 요청을 조회합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/normal

    기본 URL: /api/sn_chg_rest/change/normal

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 110. 쿼리 매개변수
    이름 설명
    이름-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    순서 반환된 변경 요청을 정렬할 필드입니다.

    데이터 유형: 문자열

    sysparm_limit 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다.

    데이터 유형: 숫자

    기본값: 500

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    텍스트검색 모든 일반 변경 요청 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 ServiceNow 전체 텍스트 검색 플랫폼 기능을 사용하며 기본값 은 IR_AND_OR_QUERY입니다.

    데이터 유형: 문자열

    표 111. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 113. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 114. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "정상"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "normal"입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?sysparm_query=active=true^ORDERBYnumber" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: {
            value: "1c87925347c12200e0ef563dbb9a7177",
            display_value: "1c87925347c12200e0ef563dbb9a7177"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "normal",
            display_value: "Normal"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Add network switch to cabinet",
            display_value: "Add network switch to cabinet"
          },
        },
        { // next record found }, ... // and so on
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/normal/{sys_id}

    지정된 sys_id로 식별된 일반 변경 요청을 조회합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/normal/{sys_id}

    기본 URL: /api/sn_chg_rest/change/normal/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 검색할 일반 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 116. 쿼리 매개변수
    이름 설명
    안 함
    표 117. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 119. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 120. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "정상"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "normal"입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "normal",
            display_value: "Normal"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Add network switch to cabinet",
            display_value: "Add network switch to cabinet"
          },
        },
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/standard

    지정된 기준에 따라 하나 이상의 표준 변경 요청을 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard

    기본 URL: /api/sn_chg_rest/change/standard

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 122. 쿼리 매개변수
    이름 설명
    이름-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    순서 반환된 변경 요청을 정렬할 필드입니다.

    데이터 유형: 문자열

    sysparm_limit 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다.

    데이터 유형: 문자열

    기본값: 500

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    텍스트검색 모든 표준 변경 요청 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 전체 텍스트 검색 플랫폼 기능을 사용하며 ServiceNow 기본값은 IR_AND_OR_QUERY입니다.

    데이터 유형: 문자열

    표 123. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 125. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 126. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 식별된 변경 요청에 대해 연결된 값이 있는 모든 필드(키).

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "표준"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "표준"입니다.

    데이터 유형: 문자열

    샘플 cURL 요청

    curl "https://instance.service-now.com/api/sn_chg_rest/v1/change/standard?sysparm_query=active=true^ORDERBYnumber" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: {
            value: "1c87925347c12200e0ef563dbb9a7177",
            display_value: "1c87925347c12200e0ef563dbb9a7177"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "standard",
            display_value: "Standard"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Add network switch to cabinet",
            display_value: "Add network switch to cabinet"
          },
        }, 
        { // next record found }, ... // and so on
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/standard/{sys_id}

    지정된 sys_id로 식별된 표준 변경 요청을 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard/{sys_id}

    기본 URL: /api/sn_chg_rest/change/standard/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 검색할 표준 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 128. 쿼리 매개변수
    이름 설명
    안 함
    표 129. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 131. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 132. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 식별된 변경 요청에 대해 연결된 값이 있는 모든 필드(키).

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/b0dbda5347c12200e0ef563dbb9a718f" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: {
            value: "1c87925347c12200e0ef563dbb9a7177",
            display_value: "1c87925347c12200e0ef563dbb9a7177"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Add network switch to cabinet",
            display_value: "Add network switch to cabinet"
          },
        }, 
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/standard/template

    지정된 기준에 따라 하나 이상의 표준 변경 템플릿을 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard/template

    기본 URL: /api/sn_chg_rest/change/standard/template

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 134. 쿼리 매개변수
    이름 설명
    이름-값 쌍 결과 세트를 필터링하는 데 사용할 이름-값 쌍입니다. 이름은 지정된 값이 필터링되는 필드입니다. 이 매개변수는 상호 배타적 sysparm_query입니다. 예를 들어 &sysparm_query=active=true를 사용하는 대신 &active=true를 사용하여 호출 문을 단순화할 수 있습니다. 필드가 선택 또는 참조 유형 필드인 경우에도 표시 값을 사용할 수 있습니다(예: &state=7 대신 &state=종결됨). 여러 키-값 쌍을 지정하려면 각 쌍을 앰퍼샌드로 구분합니다( 예: &active=true&assigned_to=john.smith).

    데이터 유형: 문자열

    순서 반환된 표준 변경 템플릿을 정렬할 필드입니다.

    데이터 유형: 문자열

    기본값: 숫자

    sysparm_limit 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다.

    데이터 유형: 숫자

    기본값: 500

    sysparm_offset 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다.

    예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 sysparm_offset=sysparm_offset+sysparm_limit를 사용합니다.

    매개변수에 sysparm_offset 음수를 전달하지 마십시오.

    데이터 유형: 숫자

    기본값: 0

    sysparm_query 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. UI 필터를 사용하면 올바르게 인코딩된 쿼리를 얻을 수 있습니다.
    구문: sysparm_query=<col_name><operator><value>. 열 이름, 연산자 및 값은 대/소문자를 구분합니다.
    • <col_name>: 필터링할 테이블 열의 이름입니다.
    • <operator>: 다음 값을 지원합니다.
      • =: <col_name>가 <value>와 정확히 일치합니다.
      • !=: <col_name>가 <value>와 일치하지 않습니다.
      • LIKE: <col_name>에는 지정된 문자열<value>이 포함되어 있습니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • STARTSWITH: 지정된 문자열 <value>로 시작하는 <col_name>입니다. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ENDSWITH: 지정된 문자열<value>로 끝나<col_name>. 데이터 유형이 문자열인 <col_name> 필드에만 작동합니다.
      • ^: 쿼리 조건을 추가하는 AND 연산자입니다. 결과 집합에 포함된 기록이 두 조건과 모두 일치합니다.
      • ^OR: 쿼리 조건을 추가하는 OR 연산자입니다. 결과 집합에 포함된 기록이 조건 중 하나 이상과 일치합니다.
    • <value>: 필터링할 값입니다.
    연산자에 대한 자세한 내용은 다음 문서를 참조하십시오 Operators available for filters and queries.

    쿼리에는 여러 조건이 포함될 수 있습니다. 예를 들어, 다음 쿼리는 호출자가 현재 사용자이고 기록이 활성 상태인 기록을 반환합니다.

    sysparm_query=caller_id=javascript:gs.getUserID()^active=true

    인코딩된 쿼리는 오름차순 및 내림차순 기능으로 순서 정렬도 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 에서 ORDERBYORDERBYDESCsysparm_query을 사용합니다.

    통사론:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    예를 들어, 다음 쿼리는 모든 활성 기록을 가져오고 결과를 번호 순으로 오름차순으로 정렬한 다음 범주별로 내림차순으로 정렬합니다.

    sysparm_query=활성=true^ORDERBYnumber^ORDERBYDESC범주

    기본적으로 잘못된 필드 이름과 같은 쿼리의 일부가 잘못된 경우 인스턴스는 잘못된 부분을 무시합니다. 그런 다음 쿼리의 유효한 부분만 사용하여 행을 반환합니다. 잘못된 쿼리에 행을 반환하지 않으려면 속성을 glide.invalid_query.returns_no_rows 로 설정합니다.
    주:
    glide.invalid_query.returns_no_rows 속성은 목록, 스크립트(GlideRecord.query()) 및 웹 서비스 API와 같은 인스턴스 전체에서 모든 쿼리의 동작을 제어합니다.

    데이터 유형: 문자열

    텍스트검색 모든 표준 변경 요청 기록 필드를 검색하는 데 사용할 문자열입니다. 이 검색은 ServiceNow 전체 텍스트 검색 플랫폼 기능을 사용하며 기본값 은 IR_AND_OR_QUERY입니다.

    데이터 유형: 문자열

    표 135. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 137. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 138. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 식별된 표준 변경 템플릿에 연결된 값이 있는 모든 필드입니다.

    데이터 유형: 객체

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    템플릿 표준 변경 템플릿에 대한 정보입니다.

    데이터 유형: 객체

    template: {
      display_value: "String", 
      value: "String"
    }
    template.display_value UI에 표시할 템플릿 정보입니다.

    데이터 유형: 문자열

    템플릿.값 템플릿 sys_id.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template?sysparm_query=active=true^ORDERBYnumber" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "92b8544047810200e90d87e8dee490b0",
            display_value: "92b8544047810200e90d87e8dee490b0"
          },
          template : {
            value: "1c8e02ec47410200e90d87e8dee49057", 
            display_value: "Add network switch to datacenter cabinet"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Standard change template to add network switch to cabinet",
            display_value: "Standard change template to add network switch to cabinet"
          },
        }, 
        { // next record found }, ... // and so on
      ]
    }

    변경 관리 - GET /sn_chg_rest/change/standard/template/{sys_id}

    지정된 sys_id로 식별된 표준 변경 템플릿을 조회합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard/template/{sys_id}

    기본 URL: /api/sn_chg_rest/change/standard/template/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 검색할 표준 변경 템플릿의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 표준 변경 템플릿 [std_change_record_producer]

    표 140. 쿼리 매개변수
    이름 설명
    안 함
    표 141. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 143. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 144. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 식별된 표준 변경 템플릿에 연결된 값이 있는 모든 필드입니다.

    데이터 유형: 객체

    sys_id 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    템플릿 표준 변경 템플릿에 대한 정보입니다.

    데이터 유형: 객체

    template: {
      display_value: "String", 
      value: "String"
    }
    template.display_value UI에 표시할 템플릿 정보입니다.

    데이터 유형: 문자열

    템플릿.값 템플릿 sys_id.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template/92b8544047810200e90d87e8dee490b0" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: "92b8544047810200e90d87e8dee490b0",
          template : {
            value: "1c8e02ec47410200e90d87e8dee49057", 
            display_value: "Add network switch to datacenter cabinet"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Standard change template to add network switch to cabinet",
            display_value: "Standard change template to add network switch to cabinet"
          },
        }, 
      ]
    }
    

    변경 관리 - GET /sn_chg_rest/change/worker/{sys_id}

    지정된 비동기 작업자에 대한 현재 상태, 정보 및 오류를 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/worker/{sys_id}

    기본 URL: /api/sn_chg_rest/{change/worker/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 변경 관리 비동기 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 관리 작업자 [chg_mgt_worker]

    표 146. 쿼리 매개변수
    이름 설명
    안 함
    표 147. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 149. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 150. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    메시지 메시지 정보입니다.
    데이터 유형: 객체
    "messages": {
      "errorMessages": [Array],
      "infoMessages": [Array],
      "warningMessages": [Array]
    }
    messages.errorMessages 요청을 처리하는 동안 오류 메시지가 발생했습니다. 예:
    잘못된 CMDB_CI sys_id 제공됨

    데이터 유형: 배열

    messages.infoMessages 요청을 처리하는 동안 발생한 정보 메시지입니다. 예:
    CMDB_CI sys_id 이미 제공에 연결되어 있습니다.

    데이터 유형: 배열

    messages.warningMessages 요청을 처리하는 동안 경고 메시지가 표시되었습니다. 예:
    잘못된 CMDB_CI sys_id 제공되었습니다.

    데이터 유형: 배열

    페이로드 스케줄링 엔드포인트의 성공적인 응답 본문에서 작업자 sys_id을 사용할 때 제공되는 고유한 페이로드입니다.
    "payload": {
      "spans": [Array]
    }

    데이터 유형: 객체

    페이로드.범위 일정 엔드포인트에 제공된 기간 내에 시간 범위를 사용할 수 있는 경우 작업자 API는 사용 가능한 시간 범위를 나열합니다.
    "payload": {
      "spans": [
       {
        "end": {Object}, 
        "start": {Object}
       }
      ]
    }

    데이터 유형: 배열

    payload.spans.start
    "start": {
      "display_value": "String",
      "value": "String"
    }

    데이터 유형: 객체

    payload.spans.start.value 변경 요청이 구현을 시작할 날짜 및 시간입니다.

    데이터 유형: 문자열

    payload.spans.start.display_value 변경 요청 시작 시간의 값을 표시합니다.

    시간 형식: yyyy-mm-dd hh:mm:ss

    데이터 유형: 문자열

    페이로드.범위.종료
    "end": {
      "display_value": "String",
      "value": "String"
    }

    데이터 유형: 객체

    payload.spans.end.value 변경 요청이 완료될 예정인 날짜 및 시간입니다.

    시간 형식: yyyy-mm-dd hh:mm:ss

    데이터 유형: 문자열

    payload.spans.end.display_value 변경 요청 완료 시간의 값을 표시합니다.

    데이터 유형: 문자열

    요청 원래 엔드포인트 요청입니다.

    데이터 유형: 문자열

    상태 작업자의 현재 상태에 대한 정보입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: Number
    }
    state.display_value 작업자 상태의 값을 표시합니다. 이러한 값은 매개변수와 직접적인 state.value 상관 관계가 있습니다.

    가능한 값:

    • 완료
    • 오류
    • 진행 중
    • 대기 중

    데이터 유형: 문자열

    상태.값 작업자 상태의 숫자 값입니다.

    가능한 값:

    • 1
    • 2
    • 3
    • 4

    데이터 유형: 숫자

    유형 CMDB CI와 변경 요청 간의 연결 유형입니다.

    데이터 유형: 문자열

    작업자 연결된 작업자에 대한 정보입니다.

    데이터 유형: 객체

    "worker": {
      "link": "String",
      "sysId": "String"
    }
    worker.link 연결된 작업자 및 기타 작업자 관련 정보의 상태를 검색하는 URL입니다.

    데이터 유형: 문자열

    worker.sysId 변경 요청과 연결된 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    <other_params> 프로세스별 다른 매개변수(예 ignored_cmdb_ci_sys_ids: ).

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/worker/0644cd02dbec330084f07ffdbf9619c1" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      "result": {
        "worker": {
          "sysId": "0644cd02dbec330084f07ffdbf9619c1",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/0644cd02dbec330084f07ffdbf9619c1"
        },
        "request": "{\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}",
        "state": {
          "value": 3,
          "display_value": "Complete"
        },
        "type": "impacted",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        }
      }
    }

    변경 관리 - PATCH /sn_chg_rest/change/{sys_id}

    지정된 sys_id로 식별된 변경 요청을 요청 본문 또는 URL의 키-값 쌍으로 업데이트합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}

    기본 URL: /api/sn_chg_rest/change/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 수정할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 152. 쿼리 매개변수
    이름 설명
    이름-값 쌍 업데이트할 필드를 나타내는 이름-값 쌍입니다. 요청 본문 매개변수가 URL 매개변수를 재정의합니다. 그러나 필수 매개변수는 URL에 지정해야 합니다.

    데이터 유형: 문자열

    encrypted_fields 암호화할 쉼표로 구분된 필드 목록입니다. 이러한 필드는 연결된 기록에 저장되기 전에 암호화됩니다. 지정된 경우 엔드포인트는 setValue() 메서드를 호출하는 대신 GlideRecord setDisplayValue() 메서드를 호출합니다.

    따라서 이 매개변수를 사용하여 sys_ids이나 값을 전달하는 대신 참조 또는 선택 필드와 같이 암호화되지 않은 필드에 대한 표시 값을 전달할 수도 있습니다.

    데이터 유형: 문자열

    표 153. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    데이터 연관된 변경 요청에서 업데이트할 필드를 나타내는 이름-값 쌍입니다. 예를 들어, 짧은 설명 파일을 업데이트하려면 다음과 유사한 이름-값 쌍을 입력합니다. --data "{\"short_description\": \"my short desc\" }" \.

    데이터 유형: 문자열

    encrypted_fields 암호화할 쉼표로 구분된 필드 목록입니다. 이러한 필드는 연결된 기록에 저장되기 전에 암호화됩니다. 지정된 경우 엔드포인트는 setValue() 메서드를 호출하는 대신 GlideRecord setDisplayValue() 메서드를 호출합니다.

    따라서 이 매개변수를 사용하여 sys_ids이나 값을 전달하는 대신 참조 또는 선택 필드와 같이 암호화되지 않은 필드에 대한 표시 값을 전달할 수도 있습니다.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 155. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 156. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    결과 업데이트된 변경 요청 기록. 이 개체의 각 요소는 변경 요청 [change_request] 테이블의 기록에 있는 필드에 해당합니다.

    모든 요소에는 및 이름-값 쌍이 display_value 포함되어 value 있습니다. 일부는 이름-값 쌍을 포함합니다 display_value_internal .

    데이터 유형: 객체

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
    --request PATCH \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{\"short_desription\": \"Reboot the server at 6 am\" }" \
    --user "username":"password"
    {
      "result":
        {
          "reason": {
            "display_value": "",
            "value": ""
          },
          "parent": {
            "display_value": "",
            "value": ""
          },
          "watch_list": {
            "display_value": "",
            "value": ""
           },
           "proposed_change": {
             "display_value": "",
             "value": ""
           },
           "upon_reject": {
             "display_value": "Cancel all future Tasks",
             "value": "cancel"
           },
           "sys_updated_on": {
             "display_value": "2015-07-06 11:59:27",
             "value": "2015-07-06 18:59:27",
             "display_value_internal": "2015-07-06 11:59:27"
          },
          "type": {
            "display_value": "Standard",
            "value": "standard"
          },
          "approval_history": {
            "display_value": "",
            "value": ""
          },
          "skills": {
            "display_value": "",
            "value": ""
          },
          "test_plan": {
            "display_value": "--Confirm that there are no monitoring alerts for the router",
            "value": "--Confirm that there are no monitoring alerts for the router"
          },
          "number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "is_bulk": {
            "display_value": "false",
            "value": false
          },
          "cab_delegate": {
            "display_value": "",
            "value": ""
          },
          "requested_by_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "ci_class": {
            "display_value": "cmdb_ci",
            "value": "cmdb_ci"
          },
          "state": {
            "display_value": "Closed",
            "value": 3.0
          },
          "sys_created_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "knowledge": {
            "display_value": "false",
            "value": false
          },
          "order": {
            "display_value": "",
            "value": ""
          },
          "phase": {
            "display_value": "Requested",
            "value": "requested"
          },
          "cmdb_ci": {
            "display_value": "",
            "value": ""
          },
          "delivery_plan": {
            "display_value": "",
            "value": ""
          },
          "impact": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "contract": {
            "display_value": "",
            "value": ""
          },
          "active": {
            "display_value": "false",
            "value": false
          },
          "work_notes_list": {
            "display_value": "",
            "value": ""
          },
          "priority": {
            "display_value": "4 - Low",
            "value": 4.0
          },
          "sys_domain_path": {
            "display_value": "/",
            "value": "/"
          },
          "cab_recommendation": {
            "display_value": "",
            "value": ""
          },
          "production_system": {
            "display_value": "false",
            "value": false
          },
          "rejection_goto": {
            "display_value": "",
            "value": ""
          },
          "review_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "requested_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "business_duration": {
            "display_value": "",
            "value": ""
          },
          "group_list": {
            "display_value": "",
            "value": ""
          },
          "change_plan": {
            "display_value": "",
            "value": ""
          },
          "approval_set": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "wf_activity": {
            "display_value": "",
            "value": ""
          },
          "implementation_plan": {
            "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform",
            "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform"
          },
          "universal_request": {
            "display_value": "",
            "value": ""
          },
          "end_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "short_description": {
            "display_value": "Reboot the server at 6 am",
            "value": "Reboot the server at 6 am"
          },
          "correlation_display": {
            "display_value": "",
            "value": ""
          },
          "work_start": {
            "display_value": "2015-07-06 11:56:04",
            "value": "2015-07-06 18:56:04",
            "display_value_internal": "2015-07-06 11:56:04"
          },
          "delivery_task": {
            "display_value": "",
            "value": ""
          },
          "outside_maintenance_schedule": {
            "display_value": "false",
            "value": false
          },
          "additional_assignee_list": {
            "display_value": "",
            "value": ""
          },
          "std_change_producer_version": {
            "display_value": "Clear BGP sessions on a Cisco router - 1",
            "value": "16c2273c47010200e90d87e8dee49006"
          },
          "sys_class_name": {
            "display_value": "Change Request",
            "value": "change_request"
          },
          "service_offering": {
            "display_value": "",
            "value": ""
          },
          "closed_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "follow_up": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "review_status": {
            "display_value": "",
            "value": ""
          },
          "reassignment_count": {
            "display_value": "2",
            "value": 2.0
          },
          "start_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "assigned_to": {
            "display_value": "",
            "value": ""
          },
          "variables": {
            "display_value": "variable_pool",
            "value": "variable_pool"
          },
          "sla_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments_and_work_notes": {
            "display_value": "",
            "value": ""
          },
          "escalation": {
            "display_value": "Normal",
            "value": 0.0
          },
          "upon_approval": {
            "display_value": "Proceed to Next Task",
            "value": "proceed"
          },
          "correlation_id": {
            "display_value": "",
            "value": ""
          },
          "made_sla": {
            "display_value": "true",
            "value": true
          },
          "backout_plan": {
            "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work",
            "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work"
          },
          "conflict_status": {
            "display_value": "Not Run",
            "value": "Not Run"
          },
          "task_effective_number": {
            "display_value": "CHG0000024",
            "value": "CHG0000024"
          },
          "sys_updated_by": {
            "display_value": "admin",
            "value": "admin"
          },
          "opened_by": {
            "display_value": "System Administrator",
            "value": "6816f79cc0a8016401c5a33be04be441"
          },
          "user_input": {
            "display_value": "",
            "value": ""
          },
          "sys_created_on": {
            "display_value": "2015-07-06 11:55:46",
            "value": "2015-07-06 18:55:46",
            "display_value_internal": "2015-07-06 11:55:46"
          },
          "on_hold_task": {
            "display_value": "",
            "value": ""
          },
          "sys_domain": {
            "display_value": "global",
            "value": "global"
          },
          "route_reason": {
            "display_value": "",
            "value": ""
          },
          "closed_at": {
            "display_value": "2015-07-06 11:56:23",
            "value": "2015-07-06 18:56:23",
            "display_value_internal": "2015-07-06 11:56:23"
          },
          "review_comments": {
            "display_value": "",
            "value": ""
          },
          "business_service": {
            "display_value": "",
            "value": ""
          },
          "time_worked": {
            "display_value": "",
            "value": ""
          },
          "chg_model": {
            "display_value": "",
            "value": ""
          },
          "expected_start": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "opened_at": {
            "display_value": "2015-06-09 11:55:46",
            "value": "2015-06-09 18:55:46",
            "display_value_internal": "2015-06-09 11:55:46"
          },
          "work_end": {
            "display_value": "2015-07-06 11:56:10",
            "value": "2015-07-06 18:56:10",
            "display_value_internal": "2015-07-06 11:56:10"
          },
          "phase_state": {
            "display_value": "Open",
            "value": "open"
          },
          "cab_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "work_notes": {
            "display_value": "",
            "value": ""
          },
          "close_code": {
            "display_value": "Successful",
            "value": "successful"
          },
          "assignment_group": {
            "display_value": "Network",
            "value": "287ebd7da9fe198100f92cc8d1d2154e"
          },
          "description": {
            "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n",
            "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n"
          },
          "on_hold_reason": {
            "display_value": "",
            "value": ""
          },
          "calendar_duration": {
            "display_value": "",
            "value": ""
          },
          "close_notes": {
            "display_value": "Completed without issues",
            "value": "Completed without issues"
          },
          "sys_id": {
            "display_value": "b0dbda5347c12200e0ef563dbb9a718f",
            "value": "b0dbda5347c12200e0ef563dbb9a718f"
          },
          "contact_type": {
            "display_value": "Phone",
            "value": "phone"
          },
          "cab_required": {
            "display_value": "false",
            "value": false
          },
          "urgency": {
            "display_value": "3 - Low",
            "value": 3.0
          },
          "scope": {
            "display_value": "Medium",
            "value": 3.0
          },
          "company": {
            "display_value": "",
            "value": ""
          },
          "justification": {
            "display_value": "",
            "value": ""
          },
          "activity_due": {
            "display_value": "UNKNOWN",
            "value": "",
            "display_value_internal": ""
          },
          "comments": {
            "display_value": "",
            "value": ""
          },
          "approval": {
            "display_value": "Approved",
            "value": "approved"
          },
          "due_date": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "sys_mod_count": {
            "display_value": "10",
            "value": 10.0
          },
          "on_hold": {
            "display_value": "false",
            "value": false
          },
          "sys_tags": {
            "display_value": "",
            "value": ""
          },
          "conflict_last_run": {
            "display_value": "",
            "value": "",
            "display_value_internal": ""
          },
          "risk_value": {
            "display_value": "",
            "value": ""
          },
          "unauthorized": {
            "display_value": "false",
            "value": false
          },
          "risk": {
            "display_value": "Moderate",
            "value": 3.0
          },
          "location": {
            "display_value": "",
            "value": ""
          },
          "category": {
            "display_value": "Other",
            "value": "Other"
          },
          "risk_impact_analysis": {
            "display_value": "",
            "value": ""
          }
        }
    }

    cURL 요청

    다음 예제는 요청 본문에서 암호화된 필드를 전달하는 방법을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"encrypted_fields\":\"short_description,description\",
        \"short_description\":\"my short desc\",
        \"description\":\"my desc\"
    }" \
    --user "username":"password"

    cURL 요청

    다음 예제에서는 암호화된 필드를 쿼리 매개변수로 전달하는 방법을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{}" \
    --user "username":"password"

    변경 관리 - PATCH /sn_chg_rest/change/{sys_id}/approvals

    현재 사용자가 지정된 변경 요청에 대한 변경 요청 승인 기록을 승인하거나 거부할 수 있도록 허용합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/approvals

    기본 URL: /api/sn_chg_rest/change/{sys_id}/approvals

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 승인/거부가 적용되는 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 158. 쿼리 매개변수
    이름 설명
    안 함
    표 159. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    댓글 거부된 경우 state 필요합니다. 변경이 거부된 이유입니다.

    데이터 유형: 문자열

    상태 필수 승인 상태입니다.

    예: --data "{\"state\": \"approved\"}"

    유효한 값은 다음과 같습니다.
    • 승인됨
    • 거부됨

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 161. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 162. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    400 잘못된 요청. 사용자에게 변경 요청을 승인하거나 거부할 권한이 없는 등 잘못된 요청 유형을 나타냅니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 변경 요청의 현재 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 승인/거부 중인 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.
    가능한 값:
    • 응급
    • 표준
    • 표준

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.
    가능한 값:
    • 긴급
    • 일반
    • 표준

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/approvals" \
    --request POST \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{\"state\": \"approved\"}" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: "0f4ac6c4b750230096c3e4f6ee11a9fe",
          state: {
            value: "-2", 
            display_value: "Scheduled"
          },
          type: {
            value: "normal",
            display_value: "Normal"
          },
          ..., // all valid fields in record, single parameter example below
          short_description: {
            value: "Remove server",
            display_value: "Remove server"
          }
        }
      ]
    }

    변경 관리 - PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available

    발견된 첫 번째 사용 가능한 시간 슬롯을 사용하여 변경 요청의 계획된 시작 및 종료 시간을 업데이트합니다.

    필요한 역할: sn_change_writer.

    주:
    응답 본문 worker.link 속성에 제공된 링크를 사용하여 일정 상태를 봅니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/schedule/first_available

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/schedule/first_available

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 사용 가능한 다음 시간 슬롯으로 업데이트할 변경 요청의 Sys_id입니다. 선택한 변경 요청에는 cmdb_ci(구성 항목)이 있어야 합니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 164. 쿼리 매개변수
    이름 설명
    안 함
    표 165. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    duration_in_seconds 변경 기간(초)입니다. 즉, 변경 요청 작업을 완료하는 데 필요한 시간입니다.

    데이터 유형: 정수

    planned_start_time 옵션입니다. 변경 요청이 구현을 시작할 예정인 날짜 및 시간(UTC 기준)입니다.

    이 시간 이후의 사용 가능한 시간 슬롯 시작을 검색합니다. 제공되지 않은 경우 시스템은 현재 시간을 시작 시간으로 사용합니다.

    형식: yyyy-mm-dd hh:mm:ss

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    표 167. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 168. 상태 코드
    상태 코드 설명
    202 시스템이 요청을 수락했습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    가능한 문제:
    • duration_in_seconds 본문 매개변수 값이 잘못되었거나 제공되지 않았습니다.
    • 잘못된 planned_start_time 본문 매개변수 값이 제공되었습니다.
    • 지정된 변경 요청에 연결된 cmdb_ci(구성 항목)이 없습니다.
    • 사용자에게 변경 요청 필드에 대한 읽기 액세스 권한이 없습니다.
    403 금지되었습니다. 사용자에게 변경 요청의 계획된 시작 및 종료 날짜 값에 대한 쓰기 권한이 없습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    가능한 문제:
    • 시스템이 제공된 정보에 따라 변경 요청을 찾을 수 없습니다.
    • 사용자에게 기록에 대한 읽기 액세스 권한이 없습니다.

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

    이름 설명
    오류 엔드포인트 요청을 처리하는 동안 발생한 오류에 대한 정보입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String",
      "status": "String"
    }
    오류.상세 정보 오류에 대한 추가 정보입니다.

    데이터 유형: 문자열

    오류.메시지 오류를 식별하는 메시지입니다.

    데이터 유형: 문자열

    메시지 메시지 정보입니다.
    데이터 유형: 객체
    "messages": {
      "errorMessages": [Array],
      "infoMessages": [Array],
      "warningMessages": [Array]
    }
    messages.errorMessages 요청을 처리하는 동안 오류 메시지가 발생했습니다.

    데이터 유형: 배열

    messages.infoMessages 요청을 처리하는 동안 발생한 정보 메시지입니다.

    데이터 유형: 배열

    messages.warningMessages 요청을 처리하는 동안 경고 메시지가 표시되었습니다.

    데이터 유형: 배열

    요청 원래 엔드포인트 요청입니다.

    데이터 유형: 문자열

    상태 작업자의 현재 상태에 대한 정보입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: Number
    }
    state.display_value 작업자 상태의 값을 표시합니다. 이러한 값은 매개변수와 직접적인 state.value 상관 관계가 있습니다.

    가능한 값:

    • 완료
    • 오류
    • 진행 중
    • 대기 중

    데이터 유형: 문자열

    상태.값 작업자 상태의 숫자 값입니다.

    가능한 값:

    • 1
    • 2
    • 3
    • 4

    데이터 유형: 숫자

    유형 요청의 유형입니다.

    유효한 값: schedule

    데이터 유형: 문자열

    작업자 연결된 작업자에 대한 정보입니다.

    데이터 유형: 객체

    "worker": {
      "link": "String",
      "sysId": "String"
    }
    worker.link 변경 요청 일정 상태를 검색하기 위한 링크입니다. 결과를 보려면 GET /sn_chg_rest/change/worker/{sys_id}의 sys_id을 사용하십시오.

    데이터 유형: 문자열

    worker.sysId 변경 요청과 연결된 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    상태 오류가 발생한 경우에만 나타납니다. 엔드포인트 처리의 상태입니다.

    가능한 값: 실패

    데이터 유형: 문자열

    변경 요청 일정 상태 가져오기

    worker.link 제공된 값을 사용하여 변경 기록이 첫 번째 사용 가능한 시간 슬롯에 대해 성공적으로 예약되었는지 확인합니다. 값은 다음과 같은 형식입니다.

    https://instance.service-now.com/api/sn_chg_rest/change/worker/<worker_sys_id>

    worker.link 상세 정보를 사용하여 GET /sn_chg_rest/change/worker/{sys_id} 에서 제공된 sys_id 실행하여 결과를 봅니다.

    응답 본문에는 상태가 포함되어 있으며 처리가 완료되면 결과를 제공합니다.

    사용 가능한 시간 슬롯이 발견되면 시스템은 사용 가능한 첫 번째 슬롯으로 변경 요청을 업데이트합니다. 상태가 완료 messages.infoMessages 되면 첫 번째 사용 가능한 시간 슬롯이 설정되었음을 알 수 있습니다.

    에 대한 messages.infoMessages 다음 예약 응답 값 중 하나가 응답 본문에 제공됩니다.
    • 변경이 업데이트됨 – 시간 슬롯에 대해 요청된 변경이 업데이트되었습니다.
    • 지금부터 <number>일 동안 슬롯을 찾을 수 없음 – 일정 창에 정의된 일수 내에 제공된 변경 요청 기간에 사용할 수 있는 시간 슬롯이 없습니다.
      주:
      변경 요청 예약 시간 슬롯의 기본값은 90일입니다. 이 값을 변경하려면 속성을 수정합니다 change.conflict.next_available.schedule_window . 자세한 내용은 상충 분석 속성 구성을 참조하십시오.

    다음 GET /sn_chg_rest/change/worker/{sys_id} 예시는 worker.link 상세 정보에 제공된 ID를 사용하여 제공된 출력을 보여줍니다. 결과는 처리가 완료되었고 변경 요청이 첫 번째 사용 가능한 시간 슬롯으로 업데이트되었음을 나타냅니다.

    {
      "result": {
        "worker": {
          "sysId": "355c62e0a4c87010f87712198fe9cacf",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf"
        },
        "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
        "state": {
          "value": 3,
          "display_value": "Complete"
        },
        "type": "schedule",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": [
            "Change has been updated"
          ]
        }
      }
    }

    cURL 요청

    curl "https://instance.service-now.com/api/sn_chg_rest/change/87ae5e900a0a2c3e263e8304e727c646/schedule/first_available" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"duration_in_seconds\":\"10800\"}" \
    --user "username":"password"
    

    결과에는 GET /sn_chg_rest/change/worker/ 엔드포인트에서 제공된 sys_id 실행하는 데 사용할 수 있는 worker.link 상세 정보가 포함됩니다.

    {
      "result": {
        "worker": {
          "sysId": "355c62e0a4c87010f87712198fe9cacf",
          "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf"
        },
        "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}",
        "state": {
          "value": 1,
          "display_value": "Waiting"
        },
        "type": "schedule",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        }
      }
    }

    변경 관리 - PATCH /sn_chg_rest/change/{change_sys_id}/task/{task_sys_id}

    지정된 sys_ids로 식별된 변경 요청 작업을 요청 본문 또는 URL의 키-값 쌍으로 업데이트합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task/{task_sys_id}

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/task/{task_sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 작업이 연결된 변경 요청의 Sys_id입니다. 지정된 작업이 지정된 변경 요청과 연결되어 있는지 확인합니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    task_sys_id 수정할 작업의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 작업 [change_task]

    표 170. 쿼리 매개변수
    이름 설명
    키-값 쌍 업데이트할 필드를 나타내는 이름-값 쌍입니다. 요청 본문 매개변수가 URL 매개변수를 재정의합니다. 그러나 필수 매개변수는 URL에 지정해야 합니다.

    데이터 유형: 문자열

    표 171. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    데이터 연관된 변경 요청에서 업데이트할 필드를 나타내는 이름-값 쌍입니다. 예를 들어, 짧은 설명 파일을 업데이트하려면 다음과 유사한 이름-값 쌍을 입력합니다. --data "{\"short_description\": \"my short desc\" }" \.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 173. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 174. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 삭제 전에 식별된 변경 요청 작업에 대한 연관된 값이 있는 모든 필드(키)입니다.

    데이터 유형: 객체

    sys_id 변경 요청 작업에 대한 정보를 Sys_id합니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    상위 이 작업과 관련된 변경 요청에 대한 고유 식별자 정보입니다.

    데이터 유형: 객체

    parent: {
      display_value: "String", 
      value: "String"
    }
    parent.display_value UI에 표시할 작업 정보입니다.

    데이터 유형: 문자열

    parent.value 상위 작업의 Sys_id입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 키-값 쌍입니다.

    데이터 유형: 배열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5?short_description=Retire both nodes" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type: application/json" \
    --data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: {
            value: "12629ec4b750230096c3e4f6ee11a9d5",
            display_value: "12629ec4b750230096c3e4f6ee11a9d5"
          },
          parent: {
            value: "0f4ac6c4b750230096c3e4f6ee11a9fe", 
            display_value: "CHG0033046 "
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Retire both nodes",
            display_value: "Retire both nodes"
          }
          __meta: {
            ignoredFields: ["no_such_field"]
          }
        }
      ]
    }

    변경 관리 - PATCH /sn_chg_rest/change/emergency/{sys_id}

    지정된 sys_id로 식별된 긴급 변경 요청을 요청 본문 또는 URL의 키-값 쌍으로 업데이트합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/emergency/{sys_id}

    기본 URL: /api/sn_chg_rest/change/emergency/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 수정할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 176. 쿼리 매개변수
    이름 설명
    이름-값 쌍 업데이트할 필드를 나타내는 이름-값 쌍입니다. 요청 본문 매개변수가 URL 매개변수를 재정의합니다. 그러나 필수 매개변수는 URL에 지정해야 합니다.

    데이터 유형: 문자열

    표 177. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    데이터 연관된 변경 요청에서 업데이트할 필드를 나타내는 이름-값 쌍입니다. 예를 들어, 짧은 설명 파일을 업데이트하려면 다음과 유사한 이름-값 쌍을 입력합니다. --data "{\"short_description\": \"my short desc\" }" \.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 179. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 180. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 문자열

    상태 변경 요청의 현재 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 이름-값 쌍입니다.

    데이터 유형: 배열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \
    --request PATCH \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{\"no_such_field\": \"this will be ignored\", }" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: "b0dbda5347c12200e0ef563dbb9a718f",    },
          state: {
            value: "-4", 
            display_value: "Assess"
          },
          type: {
            value: "emergency",
            display_value: "Emergency"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Reboot server",
            display_value: "Reboot server"
          }
          __meta: {
            ignoredFields: ["no_such_field"]
          }
        }
      ]
    }

    변경 관리 - PATCH /sn_chg_rest/change/normal/{sys_id}

    지정된 sys_id로 식별된 일반 변경 요청을 요청 본문 또는 URL의 매개변수로 업데이트합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/normal/{sys_id}

    기본 URL: /api/sn_chg_rest/change/normal/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 수정할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 182. 쿼리 매개변수
    이름 설명
    이름-값 쌍 업데이트할 필드를 나타내는 이름-값 쌍입니다. 요청 본문 매개변수가 URL 매개변수를 재정의합니다. 그러나 필수 매개변수는 URL에 지정해야 합니다.

    데이터 유형: 문자열

    표 183. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    데이터 연관된 변경 요청에서 업데이트할 필드를 나타내는 이름-값 쌍입니다. 예를 들어, 짧은 설명 파일을 업데이트하려면 다음과 유사한 이름-값 쌍을 입력합니다. --data "{\"short_description\": \"my short desc\" }" \.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 185. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 186. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 변경 요청의 현재 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "정상"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "normal"입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 이름-값 쌍입니다.

    데이터 유형: 배열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f?state=assess" \
    --request PATCH \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
          state: {
            value: "-4", 
            display_value: "Assess"
          },
          type: {
            value: "normal",
            display_value: "Normal"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Remove server",
            display_value: "Remove server"
          }
          __meta: {
            ignoredFields: ["no_such_field"]
          }
        }
      ]
    }

    변경 관리 - PATCH /sn_chg_rest/change/standard/{sys_id}

    지정된 sys_id로 식별된 표준 변경 요청을 요청 본문 또는 URL의 매개변수로 업데이트합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard/{sys_id}

    기본 URL: /api/sn_chg_rest/change/standard/{sys_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 수정할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 188. 쿼리 매개변수
    이름 설명
    이름-값 쌍 업데이트할 필드를 나타내는 이름-값 쌍입니다. 요청 본문 매개변수가 URL 매개변수를 재정의합니다. 그러나 필수 매개변수는 URL에 지정해야 합니다.

    데이터 유형: 문자열

    표 189. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    데이터 연관된 변경 요청에서 업데이트할 필드를 나타내는 이름-값 쌍입니다. 예를 들어, 짧은 설명 파일을 업데이트하려면 다음과 유사한 이름-값 쌍을 입력합니다. --data "{\"short_description\": \"my short desc\" }" \.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 191. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 192. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 식별된 변경 요청에 대해 연결된 값이 있는 모든 필드(키).

    데이터 유형: 객체

    상태 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    데이터 유형: 문자열

    sys_id 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177?description=Reboot my email server" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"short_description\": \"my short desc\" }" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "1c87925347c12200e0ef563dbb9a7177",
            display_value: "1c87925347c12200e0ef563dbb9a7177"
          },
          state: {
            value: "-5", 
            display_value: "New"
          },
    
          ..., // all valid fields in record, example below
          short_description: {
            value: "Reboot my email server",
            display_value: "Reboot my email server"
          },
        } 
      ]
    }

    변경 관리 - PATCH /sn_chg_rest/change/standard/{sys_id}/risk

    위험 조건의 평가를 기반으로 지정된 표준 변경의 위험과 영향을 계산합니다.

    변경 위험 평가 플러그인이 설치된 경우 위험 평가가 완료되면 누적 최고 위험도 계산합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/risk

    기본 URL: /api/sn_chg_rest/change/{sys_id}/risk

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 평가할 표준 변경 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 194. 쿼리 매개변수
    이름 설명
    안 함
    표 195. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 197. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 198. 상태 코드
    상태 코드 설명
    200 위험 평가가 성공적으로 완료되었습니다.
    400 위험 평가에 실패했습니다. 오류 유형에 대한 상세 정보가 오류 데이터에 포함됩니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    영향도 지정된 표준 변경과 관련된 영향입니다.

    데이터 유형: 객체

    impact: {
      display_value: "String", 
      value: "String"
    }
    impact.display_value UI에 표시할 영향 정보입니다.

    데이터 유형: 문자열

    영향.값 내부 영향 값입니다.

    데이터 유형: 문자열

    이름-값 쌍 표준 변경 기록 내의 모든 유효한 필드입니다.

    데이터 유형: 객체

    risk 지정된 표준 변경에 대해 계산된 위험입니다.

    데이터 유형: 객체

    risk: {
      display_value: "String", 
      value: "String"
    }
    risk.display_value UI에 표시할 위험 정보입니다.

    데이터 유형: 문자열

    위험.값 내부 위험 값입니다.

    데이터 유형: 문자열

    sys_id 표준 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/1c87925347c12200e0ef563dbb9a7177/risk" \
    --request PATCH \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      sys_id: {
        value: "1c87925347c12200e0ef563dbb9a7177",
        display_value: "1c87925347c12200e0ef563dbb9a7177"
      },
      risk: {
        value: "4", 
        display_value: "Low"
      },
      impact: {
        value: "3",
        display_value: "3 - Low"
      }
      ..., // all valid fields in record
    }

    변경 관리 - POST /sn_chg_rest/change

    변경 요청에 따라 변경 요청 기록을 작성합니다. 단일 호출 내에 여러 변경 요청을 생성하는 것은 지원되지 않습니다.

    또는 변경 관리 - GET /sn_chg_rest/change/model/{sys_id} 엔드포인트를 변경 관리 - GET /sn_chg_rest/change/model 사용하여 사용 가능한 변경 모델 목록을 얻을 수 있습니다.

    변경 요청을 만들 때 변경 모델(chg_model) 또는 type. 와 둘 typechg_model설정되면 유형은 단순히 변경의 범주화입니다. 이러한 값 중 하나 이상을 제공하지 않으면 릴리스에 따라 변경될 수 있는 기본 설정이 됩니다. 이러한 값 중 하나 이상을 설정하는 것이 좋습니다.

    값은 쿼리 매개변수 또는 요청 본문 매개변수로 설정할 수 있습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change

    기본 URL: /api/sn_chg_rest/change

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 200. 쿼리 매개변수
    이름 설명
    이름-값 쌍 업데이트할 필드를 나타내는 이름-값 쌍입니다. 요청 본문 매개변수가 URL 매개변수를 재정의합니다. 그러나 필수 매개변수는 URL에 지정해야 합니다. 대신 동일한 값을 요청 본문 매개변수로 설정할 수 있습니다.
    주:
    변경 요청을 만들 때 변경 모델(chg_model) 또는 type. 와 둘 typechg_model설정되면 유형은 단순히 변경의 범주화입니다. 이러한 값 중 하나 이상을 제공하지 않으면 릴리스에 따라 변경될 수 있는 기본 설정이 됩니다. 이러한 값 중 하나 이상을 설정하는 것이 좋습니다.

    데이터 유형: 문자열

    chg_model 변경 모델 [chg_model] 테이블에 나열된 변경 모델의 이름입니다.

    chg_model=Normal 형식으로 제공됩니다.

    자세한 내용은 변경 모델을 참조하십시오.

    주:
    변경 모델(chg_model) 또는 type 값을 제공하지 않으면 릴리스에 따라 변경될 수 있는 기본 설정이 만들어집니다. 이러한 값 중 하나 이상을 설정하는 것이 좋습니다.

    데이터 유형: 문자열

    encrypted_fields 암호화할 쉼표로 구분된 필드 목록입니다. 이러한 필드는 연결된 기록에 저장되기 전에 암호화됩니다. 지정된 경우 엔드포인트는 setValue() 메서드를 호출하는 대신 GlideRecord setDisplayValue() 메서드를 호출합니다.

    따라서 이 매개변수를 사용하여 sys_ids이나 값을 전달하는 대신 참조 또는 선택 필드와 같이 암호화되지 않은 필드에 대한 표시 값을 전달할 수도 있습니다.

    데이터 유형: 문자열

    유형 선택 [sys_choice] 테이블에 나열된 변경 요청 유형의 이름입니다. 또한 chg_model 채워지는 경우 이 필드는 변경 범주화로만 사용됩니다.

    유형=일반 형식으로 제공됩니다.

    자세한 내용은 새 변경 요청 유형 추가를 참조하세요.

    주:
    변경 모델(chg_model) 또는 type 값을 제공하지 않으면 릴리스에 따라 변경될 수 있는 기본 설정이 만들어집니다. 이러한 값 중 하나 이상을 설정하는 것이 좋습니다.

    데이터 유형: 문자열

    표 201. 요청 본문 매개변수(JSON)
    이름 설명
    객체 연관된 변경 요청에서 업데이트할 필드를 나타내는 이름-값 쌍입니다. 예를 들어, 짧은 설명 파일을 업데이트하려면 다음과 유사한 이름-값 쌍을 입력합니다. --data "{\"short_description\": \"my short desc\" }" \. 대신 동일한 속성을 쿼리 매개변수로 설정할 수 있습니다.

    데이터 유형: 문자열

    Object.chg_model 변경 모델 [chg_model] 테이블에 나열된 변경 모델의 이름입니다.

    {"chg_model" : "Cloud Infrastructure"} 형식으로 이름-값 쌍으로 제공됩니다.

    자세한 내용은 변경 모델을 참조하십시오.

    주:
    변경 모델(chg_model) 또는 type 값을 제공하지 않으면 릴리스에 따라 변경될 수 있는 기본 설정이 만들어집니다. 이러한 값 중 하나 이상을 설정하는 것이 좋습니다.

    데이터 유형: 문자열

    Object.encrypted_fields 암호화할 쉼표로 구분된 필드 목록입니다. 이러한 필드는 연결된 기록에 저장되기 전에 암호화됩니다. 지정된 경우 엔드포인트는 setValue() 메서드를 호출하는 대신 GlideRecord setDisplayValue() 메서드를 호출합니다.

    따라서 이 매개변수를 사용하여 sys_ids이나 값을 전달하는 대신 참조 또는 선택 필드와 같이 암호화되지 않은 필드에 대한 표시 값을 전달할 수도 있습니다.

    데이터 유형: 문자열

    객체.유형 선택 [sys_choice] 테이블에 나열된 변경 요청 유형의 이름입니다. 또한 chg_model 채워지는 경우 이 필드는 변경 범주화로만 사용됩니다.

    {"type" : "emergency"} 형식으로 이름-값 쌍으로 제공됩니다.

    자세한 내용은 새 변경 요청 유형 추가를 참조하세요.

    주:
    변경 모델(chg_model) 또는 type 값을 제공하지 않으면 릴리스에 따라 변경될 수 있는 기본 설정이 만들어집니다. 이러한 값 중 하나 이상을 설정하는 것이 좋습니다.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 203. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 204. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    결과 새 변경 요청 기록. 이 객체의 요소는 변경 요청 [change_request] 테이블의 기록 형식에 해당합니다. 요청에 지정되지 않은 모든 값은 기본값으로 설정되거나 비어 있음/null입니다.

    데이터 유형: 객체

    cURL 요청

    다음 예는 표준 변경 모델 및 표준 유형을 기반으로 변경 요청 기록을 생성하는 방법을 보여줍니다. 이 예시에서는 변경 요청이 모델에 의해 구동되고 유형 필드는 범주화로만 사용됩니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"chg_model\" : \"Standard\",
        \"description\" : \"Describes the change request.\",
        \"short_description\" : \"My change request\",
        \"type\" : \"Standard\"
    }" \
    --user "username":"password"

    결과는 기록이 CHG0030022 값과 함께 변경 요청[change_request] 테이블에 성공적으로 추가되었음을 보여줍니다.

    {
      "result": 
        "upon_reject": {
          "display_value": "Cancel all future Tasks",
          "value": "cancel"
        },
        "sys_updated_on": {
          "display_value": "2022-12-08 17:18:57",
          "value": "2022-12-09 01:18:57",
          "display_value_internal": "2022-12-08 17:18:57"
        },
        "type": {
          "display_value": "Standard",
          "value": "standard"
        }
        "number": {
          "display_value": "CHG0030022",
          "value": "CHG0030022"
        },
        "is_bulk": {
          "display_value": "false",
          "value": false
        }
        "ci_class": {
          "display_value": "cmdb_ci",
          "value": "cmdb_ci"
        },
        "state": {
          "display_value": "New",
          "value": -5
        },
        "sys_created_by": {
          "display_value": "admin",
          "value": "admin"
        },
        "knowledge": {
          "display_value": "false",
          "value": false
        },
        "phase": {
          "display_value": "Requested",
          "value": "requested"
        }
        "impact": {
          "display_value": "3 - Low",
          "value": 3
        },
        "active": {
          "display_value": "true",
          "value": true
        },
        "priority": {
          "display_value": "4 - Low",
          "value": 4
        },
        "sys_domain_path": {
          "display_value": "/",
          "value": "/"
        },
        "production_system": {
          "display_value": "false",
          "value": false
        },
        "requested_by": {
          "display_value": "System Administrator",
          "value": "6816f79cc0a8016401c5a33be04be441"
        }
        "short_description": {
          "display_value": "My change request",
          "value": "My change request"
        },
        "sys_class_name": {
          "display_value": "Change Request",
          "value": "change_request"
        },
        "reassignment_count": {
          "display_value": "0",
          "value": 0
        },
        "variables": {
          "display_value": "variable_pool",
          "value": "variable_pool"
        },
        "sla_due": {
          "display_value": "UNKNOWN",
          "value": "",
          "display_value_internal": ""
        },
        "escalation": {
          "display_value": "Normal",
          "value": 0
        },
        "upon_approval": {
          "display_value": "Proceed to Next Task",
          "value": "proceed"
        },
        "conflict_status": {
          "display_value": "Not Run",
          "value": "Not Run"
        },
        "task_effective_number": {
          "display_value": "CHG0030022",
          "value": "CHG0030022"
        },
        "sys_updated_by": {
          "display_value": "admin",
          "value": "admin"
        },
        "opened_by": {
          "display_value": "System Administrator",
          "value": "6816f79cc0a8016401c5a33be04be441"
        },
        "sys_created_on": {
          "display_value": "2022-12-08 17:18:57",
          "value": "2022-12-09 01:18:57",
          "display_value_internal": "2022-12-08 17:18:57"
        },
        "sys_domain": {
          "display_value": "global",
          "value": "global"
        },
        "chg_model": {
          "display_value": "Standard",
          "value": "e55d0bfec343101035ae3f52c1d3ae49"
        },
        "opened_at": {
          "display_value": "2022-12-08 17:18:57",
          "value": "2022-12-09 01:18:57",
          "display_value_internal": "2022-12-08 17:18:57"
        },
        "description": {
          "display_value": "Describes the change request.",
          "value": "Describes the change request."
        },
        "sys_id": {
          "display_value": "2ac52dd77c6b1510f877be3b096e64fe",
          "value": "2ac52dd77c6b1510f877be3b096e64fe"
        },
        "cab_required": {
          "display_value": "false",
          "value": false
        },
        "urgency": {
          "display_value": "3 - Low",
          "value": 3
        },
        "scope": {
          "display_value": "Medium",
          "value": 3
        },
        "activity_due": {
          "display_value": "UNKNOWN",
          "value": "",
          "display_value_internal": ""
        },
        "approval": {
          "display_value": "Not Yet Requested",
          "value": "not requested"
        },
      }
    }

    cURL 요청

    다음 예제는 요청 본문에서 암호화된 필드를 전달하는 방법을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"encrypted_fields\":\"short_description,description\",
        \"short_description\":\"my short desc\",
        \"description\":\"my desc\"
    }" \
    --user "username":"password"

    cURL 요청

    다음 예제에서는 암호화된 필드를 쿼리 매개변수로 전달하는 방법을 보여줍니다.

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{}" \
    --user "username":"password"

    변경 관리 - POST /sn_chg_rest/change/{sys_id}/ci

    변경 요청과 구성 관리 데이터베이스(CMDB) CI(구성 항목) 간의 연결을 생성합니다.

    연결 생성은 비동기식으로 수행되므로 응답이 즉시 제공되고 작업자에 대한 세부 정보가 포함됩니다. 작업자는 응답 후 실제 작업을 수행합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/ci

    기본 URL: /api/sn_chg_rest/change/{sys_id}/ci

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id CMDB CI와 연결할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    표 206. 쿼리 매개변수
    이름 설명
    안 함
    표 207. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    association_type 필수 CMDB CI와 변경 요청 간의 연결 유형입니다.

    유효한 값은 다음과 같습니다.

    • affected: 변경 요청의 영향을 받는 CI
    • 영향: 변경 요청의 영향을 받는 서비스
    • 오퍼링: 영향을 받는 서비스 오퍼링

    데이터 유형: 문자열

    cmdb_ci_sys_ids 필수 변경 요청에 연결할 CMDB CI sys_ids의 목록입니다.

    데이터 유형: 배열 또는 쉼표로 구분된 문자열

    refresh_impacted_services 영향을 받는 CI 목록을 기반으로 영향을 받는 서비스를 채우는 데 association_type=영향을 받는 경우 사용하는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 영향을 받는 CI 목록에 따라 영향을 받는 서비스 채우기
    • false: 영향을 받는 서비스를 자동으로 채우지 않음

    데이터 유형: 부울

    기본값: false

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 209. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 210. 상태 코드
    상태 코드 설명
    202 수락됨. 처리를 위해 요청이 수락되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.

    오류 응답에는 문제 해결에 도움이 되는 관련 메시지가 포함되어 있습니다.

    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    메시지 메시지 정보입니다.
    데이터 유형: 객체
    "messages": {
      "errorMessages": [Array],
      "infoMessages": [Array],
      "warningMessages": [Array]
    }
    messages.errorMessages 요청을 처리하는 동안 오류 메시지가 발생했습니다. 예:
    잘못된 CMDB_CI sys_id 제공됨

    데이터 유형: 배열

    messages.infoMessages 요청을 처리하는 동안 발생한 정보 메시지입니다. 예:
    CMDB_CI sys_id 이미 제공에 연결되어 있습니다.

    데이터 유형: 배열

    messages.warningMessages 요청을 처리하는 동안 경고 메시지가 표시되었습니다. 예:
    잘못된 CMDB_CI sys_id 제공되었습니다.

    데이터 유형: 배열

    요청 원래 엔드포인트 요청입니다.

    데이터 유형: 문자열

    상태 작업자의 현재 상태에 대한 정보입니다.
    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value 작업자 상태의 값을 표시합니다. 이러한 값은 요소와 직접적인 상관 관계가 있습니다.state.value

    가능한 값:

    • 완료
    • 오류
    • 진행 중
    • 대기 중

    데이터 유형: 문자열

    상태.값 작업자 상태의 숫자 값입니다.

    가능한 값:

    • 1
    • 2
    • 3
    • 4

    데이터 유형: 숫자

    유형 CMDB CI와 변경 요청 간의 연결 유형입니다.

    데이터 유형: 문자열

    작업자 연결된 작업자에 대한 정보입니다.

    데이터 유형: 객체

    "worker": {
      "link": "String",
      "sysId": "String"
    }
    worker.link 연결된 작업자 및 기타 작업자 관련 정보의 상태를 검색하는 URL입니다.

    데이터 유형: 문자열

    worker.sysId 변경 요청과 연결된 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{cmdb_ci_sys_ids:'caf043a3b7fb23000999e4f6ee11a9c0,06f043a3b7fb23000999e4f6ee11a9c1', association_type:'affected'}" \
    --user "username":"password"
    
    {
      "result": {
        "worker": {
          "sysId": "f490f4c6dbac330084f07ffdbf961952",
          "link": "instance.service-now.com/api/sn_chg_rest/change/worker/f490f4c6dbac330084f07ffdbf961952"
        },
        "request": "{\"cmdb_ci_sys_ids\":[\"caf043a3b7fb23000999e4f6ee11a9c0\",\"06f043a3b7fb23000999e4f6ee11a9c1\"],\"association_type\":\"affected\",\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}",
        "state": {
          "value": 1,
          "display_value": "Waiting"
        },
        "type": "affected",
        "messages": {
          "errorMessages": [],
          "warningMessages": [],
          "infoMessages": []
        }
      }
    }

    변경 관리 - POST /sn_chg_rest/change/{sys_id}/conflict

    지정된 변경 요청(sys_id)에 대한 변경 요청 상충 검사 프로세스를 시작합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/conflict

    기본 URL: /api/sn_chg_rest/change/{sys_id}/conflict

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 상충 검사 프로세스를 시작할 변경 관리 요청의 Sys_id입니다. 상충 검사 프로세스에 대한 자세한 내용은 상충 탐지를 참조하십시오.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 212. 쿼리 매개변수
    이름 설명
    안 함
    표 213. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 215. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 216. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 해결할 수 없는 오류로 인해 요청을 시작할 수 없습니다. 반환된 메시지는 추가 세부 정보를 제공할 수 있습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    결과 변경 요청 상충 검사 프로세스의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \
    --request POST \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
        result: "c0b5afe4b710230096c3e4f6ee11a93f"
    }

    변경 관리 - POST /sn_chg_rest/change/emergency

    기본 긴급 변경 요청 기록을 기반으로 하나의 긴급 변경 요청을 작성합니다. 단일 호출에서 여러 긴급 변경 요청을 생성하는 것은 지원되지 않습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/emergency

    기본 URL: /api/sn_chg_rest/change/emergency

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 218. 쿼리 매개변수
    이름 설명
    키-값 쌍 요청을 만들 때 수정할 필드의 키-값 쌍입니다. 키는 템플릿 내의 필드 이름이고 값은 필드에 채울 정보입니다.
    수정할 수 없으며 전달될 경우 무시되는 필드:
    • 비즈니스 규칙
    • ACL에 정의된 읽기 전용 필드
    • 존재하지 않는 필드

    데이터 유형: 문자열

    표 219. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 221. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 222. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 긴급 변경 요청에서 생성된 필드의 이름-값 쌍입니다.

    데이터 유형: 객체

    상태 삭제 전 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    값은 항상 "신규"입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    값은 항상 "-5"입니다.

    데이터 유형: 문자열

    sys_id 새로 생성된 긴급 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "긴급"입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 키-값 쌍입니다.

    데이터 유형: 배열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?no_such_field=something&description=test&short_description=Reboot server" \
    --request POST \
    --header "Accept:application/json" \
    --user "username":"password"
    {
      result: [
        {
          sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "emergency",
            display_value: "Emergency"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Reboot server",
            display_value: "Reboot server"
          }
          __meta: {
            ignoredFields: ["no_such_field"]
          }
        }
      ]
    }

    변경 관리 - POST /sn_chg_rest/change/normal

    기본 일반 변경 요청 기록을 기반으로 하나의 일반 변경 요청을 생성합니다. 단일 호출 내에서 여러 정상 변경 요청을 생성하는 것은 지원되지 않습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/normal

    기본 URL: /api/sn_chg_rest/change/normal

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    표 224. 쿼리 매개변수
    이름 설명
    키-값 쌍 요청을 만들 때 수정할 필드입니다. 키는 템플릿 내의 필드 이름이고 값은 필드에 채울 정보입니다.
    수정할 수 없으며 전달될 경우 무시되는 필드:
    • 비즈니스 규칙
    • ACL에 정의된 읽기 전용 필드
    • 존재하지 않는 필드

    데이터 유형: 문자열

    표 225. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 227. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 228. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 연결된 변경 요청의 모든 필드에 대한 값입니다.

    데이터 유형: 객체

    상태 새로 생성된 변경 요청의 상태입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value UI에 표시할 상태입니다.

    값은 항상 "신규"입니다.

    데이터 유형: 문자열

    상태.값 내부 상태 값입니다.

    값은 항상 "-5"입니다.

    데이터 유형: 문자열

    sys_id 새로 만든 일반 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    유형 변경 요청의 유형입니다.

    데이터 유형: 객체

    type: {
      display_value: "String",
      value: "String"
    }
    type.display_value UI에 표시할 유형을 변경합니다.

    값은 항상 "정상"입니다.

    데이터 유형: 문자열

    유형.값 내부 유형 값입니다.

    값은 항상 "normal"입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 키-값 쌍입니다.

    데이터 유형: 배열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?no_such_field=something&description=test&short_description=Remove server" \
    --request POST \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: "b0dbda5347c12200e0ef563dbb9a718f",
          state: {
            value: "-5", 
            display_value: "New"
          },
          type: {
            value: "normal",
            display_value: "Normal"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Remove server",
            display_value: "Remove server"
          }
          __meta: {
            ignoredFields: ["no_such_field"]
          }
        }
      ]
    }

    변경 관리 - POST /sn_chg_rest/change/{sys_id}/refresh_impacted_services

    기본 CI를 기반으로 영향을 받는 서비스/CI(구성 항목) 관련 목록을 채웁니다.

    기본 CI가 변경 요청 양식 및 영향을 받는 CI 관련 목록에 나타납니다.

    주:
    이 엔드포인트에 대한 모든 작업 항목은 비동기식으로 수행됩니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/{sys_id}/refresh_impacted_services

    기본 URL: /api/sn_chg_rest/change/{sys_id}/refresh_impacted_services

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    sys_id 영향을 받는 서비스를 새로 고치는 데 사용할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    표 230. 쿼리 매개변수
    이름 설명
    안 함
    표 231. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 233. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 234. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    메시지 메시지 정보입니다.
    데이터 유형: 객체
    "messages": {
      "errorMessages": [Array],
      "infoMessages": [Array],
      "warningMessages": [Array]
    }
    messages.errorMessages 요청을 처리하는 동안 오류 메시지가 발생했습니다. 예:
    잘못된 CMDB_CI sys_id 제공됨

    데이터 유형: 배열

    messages.infoMessages 요청을 처리하는 동안 발생한 정보 메시지입니다. 예:
    CMDB_CI sys_id 이미 제공에 연결되어 있습니다.

    데이터 유형: 배열

    messages.warningMessages 요청을 처리하는 동안 경고 메시지가 표시되었습니다. 예:
    잘못된 CMDB_CI sys_id 제공되었습니다.

    데이터 유형: 배열

    요청 원래 엔드포인트 요청입니다.

    데이터 유형: 문자열

    상태 작업자의 현재 상태에 대한 정보입니다.

    데이터 유형: 객체

    state: {
      display_value: "String", 
      value: "String"
    }
    state.display_value 작업자 상태의 값을 표시합니다. 이러한 값은 요소와 직접적인 상관 관계가 있습니다.state.value

    가능한 값:

    • 완료
    • 오류
    • 진행 중
    • 대기 중

    데이터 유형: 문자열

    상태.값 작업자 상태의 숫자 값입니다.

    가능한 값:

    • 1
    • 2
    • 3
    • 4

    데이터 유형: 숫자

    유형 CMDB CI와 변경 요청 간의 연결 유형입니다.

    데이터 유형: 문자열

    작업자 연결된 작업자에 대한 정보입니다.

    데이터 유형: 객체

    "worker": {
      "link": "String",
      "sysId": "String"
    }
    worker.link 연결된 작업자 및 기타 작업자 관련 정보의 상태를 검색하는 URL입니다.

    데이터 유형: 문자열

    worker.sysId 변경 요청과 연결된 작업자의 Sys_id입니다.

    데이터 유형: 문자열

    cURL 요청

    curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/refresh_impacted_services" \ 
    --request POST \ 
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \ 
    --user "username":"password"
    { 
      result: { 
        worker: { 
          sysId: "aa31c308b75033000999e4f6ee11a9c2", 
          link: "http://instance.service-now.com/api/sn_chg_rest/change/worker/aa31c308b75033000999e4f6ee11a9c2" 
        }, 
        request: "", 
        state: { 
          value: 1, 
          display_value: "Waiting" 
        }, 
        type: "impacted", 
        messages: { 
          errorMessages: [], 
          warningMessages: [], 
          infoMessages: [] 
        } 
      } 
    } 

    변경 관리 - POST /sn_chg_rest/change/standard/{standard_change_template_id}

    전달된 템플릿 sys_id에 지정된 대로 기존 표준 변경 템플릿을 기반으로 하나의 표준 변경 요청을 생성합니다. 단일 호출 내에서 여러 표준 변경 요청을 생성하는 것은 지원되지 않습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_chg_rest/{api_version}/change/standard/{standard_change_template_id}

    기본 URL: /api/sn_chg_rest/change/standard/{standard_change_template_id}

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    standard_change_template_id 새 표준 변경 요청의 기반이 되는 표준 변경 템플릿의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 표준 변경 템플릿 [std_change_record_producer]

    표 236. 쿼리 매개변수
    매개변수 설명
    이름-값 쌍 요청을 만들 때 수정할 지정된 표준 변경 템플릿 내의 필드입니다. 키는 템플릿 내의 필드 이름이고 값은 필드에 채울 정보입니다.
    수정할 수 없으며 전달될 경우 무시되는 필드:
    • 설명
    • 원상 복구 계획
    • 테스트 계획
    • 구현 계획
    • ACL에 정의된 읽기 전용 필드
    • 지정된 표준 변경 템플릿에 없는 필드

    데이터 유형: 문자열

    표 237. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 239. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 240. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

    응답 본문

    API는 응답 본문에 이러한 JSON 또는 XML 요소를 반환합니다.

    표 241. 응답 본문에 반환되는 요소
    요소 설명
    이름-값 쌍 표준 변경 요청에서 생성된 필드의 이름-값 쌍입니다.

    데이터 유형: 객체

    sys_id 새로 만든 표준 변경 요청에 대한 Sys_id 정보입니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 표준 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 표준 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 키-값 쌍입니다.

    데이터 유형: 배열

    샘플 cURL 요청

    curl "https://instance.servicenow.com" \
    --request POST \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "1c87925347c12200e0ef563dbb9a7177",
            display_value: "1c87925347c12200e0ef563dbb9a7177"
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Add network switch to cabinet",
            display_value: "Add network switch to cabinet"
          }
          __meta: {
            ignoredFields: ["no_such_field"]
          }
        }
      ]
    }

    변경 관리 - POST /sn_chg_rest/change/{change_sys_id}/task

    기본 변경 요청 작업 기록에 기반하여 하나의 변경 요청 작업을 작성하고 이를 지정된 변경 요청에 연결합니다. 단일 호출 내에서 여러 변경 요청 작업을 생성하는 것은 지원되지 않습니다.

    URL 형식

    버전 관리 URL: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task

    기본 URL: /api/sn_chg_rest/change/{change_sys_id}/task

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열

    change_sys_id 이 작업을 연결할 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 변경 요청 [change_request]

    표 243. 쿼리 매개변수
    이름 설명
    키-값 쌍 요청을 만들 때 수정할 필드입니다. 키는 템플릿 내의 필드 이름이고 값은 필드에 채울 정보입니다.
    수정할 수 없으며 전달될 경우 무시되는 필드:
    • 비즈니스 규칙
    • ACL에 정의된 읽기 전용 필드
    • 존재하지 않는 필드

    데이터 유형: 문자열

    표 244. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    표 246. 응답 헤더
    머리글 설명
    안 함

    상태 코드

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

    표 247. 상태 코드
    상태 코드 설명
    200 요청이 성공적으로 완료되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 지정된 기록을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다.

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

    이름 설명
    이름-값 쌍 변경 요청 작업에서 생성된 필드의 이름-값 쌍입니다.

    데이터 유형: 객체

    상위 작업과 연관된 변경 요청에 대한 정보입니다.

    데이터 유형: 객체

    parent: {
      display_value: "String", 
      value: "String"
    }
    parent.display_value 작업과 연관된 변경 요청에 대해 UI에 표시할 정보입니다.

    데이터 유형: 문자열

    parent.value 작업과 연결된 변경 요청의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id 새로 생성된 변경 요청 작업에 대한 정보를 Sys_id합니다.

    데이터 유형: 객체

    sys_id: {
      display_value: "String", 
      value: "String"
    }
    sys_id.display_value UI에 표시할 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    sys_id.value 변경 요청 작업의 Sys_id입니다.

    데이터 유형: 문자열

    __meta.ignoredFields 호출에 전달되었지만 기본 기록에 없거나 필드가 읽기 전용이므로 변경 요청에 적용되지 않은 키-값 쌍입니다.

    데이터 유형: 배열

    cURL 요청

    curl "https://instance.servicenow.com/api/now/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?short_description=Retire node&no_such_field=test" \
    --request POST \
    --header "Accept:application/json" \
    --user "username":"password"
    
    {
      result: [
        {
          sys_id: {
            value: "12629ec4b750230096c3e4f6ee11a9d5",
            display_value: "12629ec4b750230096c3e4f6ee11a9d5"
          },
          parent: {
            value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", 
            display_value: "CHG0033046 "
          },
          ..., // all valid fields in record, example below
          short_description: {
            value: "Retire node",
            display_value: "Retire node"
          }
          __meta.ignoredFields": ["no_such_field"]
        }
      ]
    }