--- sourceDocument: 호주 API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 서비스 테스트 관리 Open API # 서비스 테스트 관리 Open API {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 211분 서비스 테스트 관리 Open API는 서비스 테스트 정의 및 서비스 테스트를 만들고 검색할 수 있는 엔드포인트를 제공합니다. 이 API를 사용하여 외부 시스템과 ServiceNow AI Platform. 서비스 테스트 관리 오픈 API는 TM Forum 서비스 문제 관리 API REST 사양의 구현입니다ServiceNow. 이 구현은 [TMF653 Service Test Management API 사용자 가이드 v4.1.0](https://www.tmforum.org/resources/specification/tmf653-service-test-management-api-user-guide-v4-1-0/), 2021년 7월을 기반으로 합니다. 이 REST API는 통신 환경 내에서 서비스 테스트를 관리하고 실행하도록 설계되었습니다. 이를 통해 사용자는 서비스 테스트를 정의, 트리거 및 모니터링하여 서비스가 품질 및 성능 표준을 충족하도록 할 수 있습니다. API는 테스트 정의 생성 및 업데이트, 테스트 실행, 테스트 결과 검색, 테스트 일정 관리 등 테스트 관리를 위한 기능을 제공합니다. 서비스 테스트 관리 Open API에는 에서 사용할 수 ServiceNow Store있는 (com.sn_sprb_mgmt) 애플리케이션이 필요합니다 고객 서비스 문제 관리 . 자세한 내용은 [Customer Service Problem Management](https://www.servicenow.com/docs/access?context=cspm-landing-page&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 이 API는 `sn_sprb_mgmt` 네임스페이스에서 실행됩니다. 호출 사용자에게 sn_sprb_mgmt.test_integrator 역할이 있어야 합니다. 서비스 테스트 관리 Open API는 다음 테이블에서 데이터를 생성하거나 업데이트합니다. * 테스트 실행 \[sn_st_mgmt_test\] * 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] * 테스트 정의 특성 \[sn_st_mgmt_test_definition_characteristic\] * 테스트 특성 \[sn_st_mgmt_test_characteristic\] * 사양과 테스트 정의의 관계 \[sn_st_mgmt_test_definition_m2m\] * 테스트 정의 관계 \[sn_st_mgmt_test_definition_rel\] * 테스트 측정 \[sn_st_mgmt_test_measure\] * 측정 결과 \[sn_st_mgmt_measure_consequence\] * 테스트 측정 정의 \[sn_st_mgmt_test_measure_definition\] * 적용된 결과 \[sn_st_mgmt_applied_consequence\] * 임계치 규칙 \[sn_st_mgmt_threshold_rule\] * 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] {#service-test-management-api__ul_a4n_gcw_4bc} ## 서비스 테스트 관리 개방형 API -- GET /sn_sprb_mgmt/servicetestmanagement/serviceTest {#ariaid-title2} 모든 서비스 테스트 목록을 조회합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest ### 지원되는 요청 매개변수 {#servicetestmgmt-GET-serviceTest__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 1. 경로 매개변수] {#servicetestmgmt-GET-serviceTest__entry__6} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 이 매개변수를 사용하지 않으면 모든 필드가 반환됩니다. 서비스 테스트 \[sn_st_mgmt_test\] 테이블에 있습니다. 유효한 필드: * 특성 * 설명 * endDateTime * ID * 모드 * 관련 서비스 * startDateTime * 상태 * 테스트 측정 * 테스트 사양 * 유효한대상 {#servicetestmgmt-GET-serviceTest__ul_mtw_b3v_bcc} 데이터 유형: 문자열 | | 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 최대값: 100 기본값: 20 | | 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 매개변수를 사용하여 작고 관리하기 쉬운 청크로 결과를 페이지 매김합니다. 첫 번째 기록은 0에서 인덱싱됩니다. 데이터 유형: 숫자 기본값: 0 | | 상태 | 테스트의 현재 상태를 기준으로 테스트 정의를 필터링합니다. 지정된 상태의 테스트 정의만 응답에 반환됩니다. 유효한 값은 다음과 같습니다. * 확인됨 * 취소됨 * 완료됨 * 실패 * inProgress * 보류 중 * 거부됨 {#servicetestmgmt-GET-serviceTest__ul_vzj_npn_xbc} 데이터 유형: 문자열 | [표 2. 쿼리 매개변수] {#servicetestmgmt-GET-serviceTest__entry__16} | 이름 | 설명 | |-|-| | 안 함 | | [표 3. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-GET-serviceTest__entry__20} | 머리글 | 설명 | |-|-| | 없음 | | [표 4. 요청 헤더] {#servicetestmgmt-GET-serviceTest__entry__24} | 머리글 | 설명 | |-|-| | 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠 범위를 지정합니다. 예를 들어 `offset=2` 및 `limit=3`인 경우 Content-Range 헤더의 값은 항목 `3-5`입니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#servicetestmgmt-GET-serviceTest__ul_yy3_2fs_pbc} | | X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. | [표 5. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-GET-serviceTest__entry__34}{#servicetestmgmt-GET-serviceTest__entry-200-status-code}{#servicetestmgmt-GET-serviceTest__entry-400-status-code}{#servicetestmgmt-GET-serviceTest__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 206 | 응답으로 반환된 부분 자원입니다(페이지 매김 포함). | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 6. 상태 코드] {#servicetestmgmt-GET-serviceTest__table_ash_mhx_vbc__entry__2} | 이름 | 설명 | |-|-| | 특성 | 관련 서비스 테스트의 특성을 설명하는 목록입니다. 테스트 정의 특성에 대한 자세한 내용은 다음을 참조하십시오. 데이터 유형: 객체 배열 "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | 특성의 Sys_id 또는 external_id입니다. 해당 기록에 대한 external_id이 있으면 응답은 external_id를 반환하고, 그렇지 않으면 sys_id을 반환합니다. 데이터 유형: 문자열 테이블: 특성 \[sn_prd_pm_characteristic\] | | characteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 특성.값 | 서비스 테스트와 관련된 특성 옵션입니다. 특성은 고객 인스턴스에 따라 다릅니다. 데이터 유형: 문자열 | | 특성.값유형 | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-GET-serviceTest__ul_zfr_twr_dcc} 데이터 유형: 문자열 | | 설명 | 서비스 테스트에 대한 설명입니다. 데이터 유형: 문자열 | | endDateTime | 서비스 테스트의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | href | 서비스 테스트에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 모드 | 서비스 테스트가 실행되는 모드입니다. 유효한 값은 다음과 같습니다. * ONDEMAND: 서비스 테스트를 수동으로 트리거합니다. * 사전 예방적: 서비스 테스트를 자동으로 트리거합니다. {#servicetestmgmt-GET-serviceTest__ul_ybc_mqn_xbc} 데이터 유형: 문자열 기본값: ONDEMAND | | 이름 | 필수 서비스 테스트의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 | 필수 서비스 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.id | 제품 인벤토리의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 제품 인벤토리 \[sn_prd_invt_product_inventory\] 테이블의 sys_id 또는 external_id 필드입니다. | | relatedService.name | 제품 인벤토리의 이름입니다. 데이터 유형: 문자열 | | startDateTime | 서비스 테스트의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 상태 | 서비스 테스트가 진행되는 상태입니다. 유효한 값은 다음과 같습니다. * 확인됨 * 취소됨 * 완료됨 * 실패 * inProgress * 보류 중 * 거부됨 {#servicetestmgmt-GET-serviceTest__ul_gym_mqn_xbc} 데이터 유형: 문자열 | | 테스트 측정 | 제품, 서비스 또는 자원 테스트의 특정 측면(예: 손실된 패킷 또는 연결 상태)에 대한 측정값입니다. 데이터 유형: 객체 배열 "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | 관련 메트릭에 대해 캡처된 테스트 측정 정확도를 나타내는 부동 10진수 값입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.captureDateTime | 메트릭이 캡처된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasure.id | 테스트 측정값의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 테이블 \[sn_st_mgmt_test_measure\] 테이블의 sys_id 또는 external_id 필드. | | testMeasure.Measure.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-GET-serviceTest__ul_ed2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasure.metricName | 테스트 측정 메트릭의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation | 임계치 규칙 정의에서 규칙을 정의하기 위한 객체와 규칙이 위반될 경우의 결과입니다. 데이터 유형: 객체 배열 "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] | | testMeasure.ruleViolation.tolerancePeriod.amount | 결과를 적용하기 전의 기간 수입니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.appliedConsequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | 임계치 규칙이 위반될 때 수행할 작업입니다. 예를 들어 경고를 보내거나 보고서를 생성합니다. 적용된 작업은 인스턴스마다 다를 수 있습니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.description | 적용된 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.id | 적용된 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.name | 적용된 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.repeatAction | 두 번째 위반이 발생할 때 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-GET-serviceTest__ul_ld2_gxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComporatorExact | 값이 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 동일합니다. * false: 값이 동일하지 않습니다. {#servicetestmgmt-GET-serviceTest__ul_od2_gxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComporatorLower | 값이 임계치 아래로 떨어지는지 확인하기 위한 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmgmt-GET-serviceTest__ul_sd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComporatorUpper | 값이 임계치를 초과하는지 확인하기 위한 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmgmt-GET-serviceTest__ul_vd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.id | 임계치 규칙 위반의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] | | testMeasure.ruleViolation.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmgmt-GET-serviceTest__ul_xd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.tolerancePeriod | 즉각적인 결과나 작업을 트리거하지 않고 교차 발생을 활성화하는 지정된 시간 간격입니다. 날짜 유형: 객체 "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-GET-serviceTest__ul_qbw_qds_dcc} 데이터 유형: 문자열 | | testMeasure.unitOfMeasure | 테스트 측정의 적합성 대상 값에 대한 측정 단위입니다. 데이터 유형: 문자열 | | testMeasure.value | 테스트 측정값입니다. 데이터 유형: 객체 "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } | | testMeasure.value.id | 테스트 측정 값의 ID입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트 측정 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.value | 테스트 측정값입니다. 데이터 유형: 문자열 | | testMeasure.value.valueType | 숫자, 텍스트 등의 테스트 측정 값 유형입니다. 데이터 유형: 문자열 | | 테스트 사양 | 필수 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | 서비스 테스트 정의에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | testSpecification.id | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] 테이블의 sys_id 또는 external_id 필드. | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime ": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [표 7. 응답 본문 매개변수(XML 또는 JSON)] {#servicetestmgmt-GET-serviceTest__table_ash_mhx_vbc} ### cURL 요청 다음 예제에서는 인스턴스의 두 서비스 테스트에 대한 정보를 검색합니다. curl --location --request GET "https://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest" \ --user 'username': 'password' 응답 본문. [ { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/09d1f42e3be28210d140068aa4e45ae2", "id": "09d1f42e3be28210d140068aa4e45ae2", "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8", "id": "7d3854864316c6500e51203d5fb8f2d8" }, "characteristic": [], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] }, { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/18682a2a3b2682107222bf9985e45a55", "id": "18682a2a3b2682107222bf9985e45a55", "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001012", "startDateTime": "2024-06-05 17:45:07", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8", "id": "7d3854864316c6500e51203d5fb8f2d8" }, "characteristic": [ { "id": "5c682a2a3b2682107222bf9985e45a5a", "name": "url", "valueType": "single_line_text", "value": "http://abc.com" } ], "testMeasure": [ { "id": "7c686a2a3b2682107222bf9985e45a4d", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "38686a2a3b2682107222bf9985e45a4e", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "34686a2a3b2682107222bf9985e45a50", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } ] ## 서비스 테스트 관리 Open API -- GET /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} {#ariaid-title3} 지정된 서비스 테스트 ID를 기준으로 서비스 테스트 엔터티를 검색합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} ### 지원되는 요청 매개변수 {#servicetestmgmt-GET-serviceTest-id__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 서비스 테스트의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | [표 8. 경로 매개변수] {#servicetestmgmt-GET-serviceTest-id__entry__6} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 이 매개변수를 사용하지 않으면 모든 필드가 반환됩니다. 서비스 테스트 \[sn_st_mgmt_test\] 테이블에 있습니다. 유효한 필드: * 특성 * 설명 * endDateTime * ID * 모드 * 관련 서비스 * startDateTime * 상태 * 테스트 측정 * 테스트 사양 * 유효한대상 {#servicetestmgmt-GET-serviceTest-id__ul_mtw_b3v_bcc} 데이터 유형: 문자열 | [표 9. 쿼리 매개변수] {#servicetestmgmt-GET-serviceTest-id__entry__10} | 이름 | 설명 | |-|-| | 안 함 | | [표 10. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-GET-serviceTest-id__entry__14} | 머리글 | 설명 | |-|-| | 없음 | | [표 11. 요청 헤더] {#servicetestmgmt-GET-serviceTest-id__entry__18} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 12. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-GET-serviceTest-id__entry__22}{#servicetestmgmt-GET-serviceTest-id__entry-200-status-code}{#servicetestmgmt-GET-serviceTest-id__entry-400-status-code}{#servicetestmgmt-GET-serviceTest-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 13. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmgmt-GET-serviceTest-id__section_vkd_xwr_pbc} {#servicetestmgmt-GET-serviceTest-id__section_vkd_xwr_pbc__entry__2} | 이름 | 설명 | |-|-| | 특성 | 관련 서비스 테스트의 특성을 설명하는 목록입니다. 데이터 유형: 객체 배열 "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | 특성의 Sys_id 또는 external_id입니다. 해당 기록에 대한 external_id이 있으면 응답은 external_id를 반환하고, 그렇지 않으면 sys_id을 반환합니다. 데이터 유형: 문자열 테이블: 특성 \[sn_prd_pm_characteristic\] | | characteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 특성.값 | 서비스 테스트와 관련된 특성 옵션입니다. 특성은 고객 인스턴스에 따라 다릅니다. 데이터 유형: 문자열 | | 특성.값유형 | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-GET-serviceTest-id__ul_egw_twr_dcc} 데이터 유형: 문자열 | | 설명 | 서비스 테스트에 대한 설명입니다. 데이터 유형: 문자열 | | endDateTime | 서비스 테스트의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | href | 서비스 테스트에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 모드 | 서비스 테스트가 실행되는 모드입니다. 유효한 값은 다음과 같습니다. * ONDEMAND: 서비스 테스트를 수동으로 트리거합니다. * 사전 예방적: 서비스 테스트를 자동으로 트리거합니다. {#servicetestmgmt-GET-serviceTest-id__ul_itl_ksn_xbc} 데이터 유형: 문자열 기본값: ONDEMAND | | 이름 | 서비스 테스트의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 | 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.id | 제품 인벤토리의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 제품 인벤토리 \[sn_prd_invt_product_inventory\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedService.name | 제품 인벤토리 항목의 이름입니다. 데이터 유형: 문자열 | | startDateTime | 서비스 테스트의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 상태 | 서비스 테스트의 상태입니다. 유효한 값은 다음과 같습니다. * 확인됨 * 취소됨 * 완료됨 * 실패 * inProgress * 보류 중 * 거부됨 {#servicetestmgmt-GET-serviceTest-id__ul_prs_txv_xbc} 데이터 유형: 문자열 | | 테스트 측정 | 제품, 서비스 또는 자원 테스트의 특정 측면(예: 손실된 패킷 또는 연결 상태)에 대한 측정값입니다. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | 관련 메트릭에 대해 캡처된 테스트 측정 정확도를 나타내는 부동 10진수 값입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.captureDateTime | 메트릭이 캡처된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasure.capture메서드 | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-GET-serviceTest-id__ul_zrs_txv_xbc} 데이터 유형: 문자열 | | testMeasure.id | 테스트 측정의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 표: 테스트 측정 \[sn_st_mgmt_test_measure\] | | testMeasure.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasure.metricName | 테스트 측정의 메트릭 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation | 규칙이 위반될 경우의 결과와 함께 임계치 규칙 정의에서 규칙을 정의하기 위한 객체입니다. 데이터 유형: 객체 배열 "RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ] | | testMeasure.ruleViolation.appliedConsequence | 임계치 규칙이 위반될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | 임계치 규칙이 위반될 때 수행할 작업입니다. 예를 들어 경고를 보내거나 보고서를 생성합니다. 적용된 작업은 인스턴스마다 다를 수 있습니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | 적용된 작업을 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-GET-serviceTest-id__ul_kss_txv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.appliedConsequence.description | 적용된 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.id | 적용된 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.name | 적용된 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComparatorExact | 값이 의 값 conformanceTargetExact과 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 동일합니다. * false: 값이 동일하지 않습니다. {#servicetestmgmt-GET-serviceTest-id__ul_uss_txv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 다음과 같음 {#servicetestmgmt-GET-serviceTest-id__ul_fts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 다음과 같음 * 보다 작음 {#servicetestmgmt-GET-serviceTest-id__ul_mts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.description | 임계치 규칙 위반에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.id | 임계치 규칙 위반의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] | | testMeasure.ruleViolation.name | 임계치 규칙 위반의 이름입니다. 날짜 유형: 문자열 | | testMeasure.ruleViolation.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대: 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 낮음 * 보통 {#servicetestmgmt-GET-serviceTest-id__ul_tts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.tolerancePeriod | 결과가 시작되기 전에 허용된 교차가 발생할 수 있는 기간 또는 시간 간격입니다. 날짜 유형: 객체 "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | 기간의 양(수)입니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.tolerancePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-GET-serviceTest-id__ul_my3_qds_dcc} 데이터 유형: 문자열 | | testMeasure.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasure.value | 테스트의 메트릭 값입니다. 데이터 유형: 객체 "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } | | testMeasure.value.id | 테스트의 메트릭 값 ID입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트에 있는 메트릭 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.value | 테스트의 메트릭 값입니다. 데이터 유형: 문자열 | | testMeasure.value.valueType | 숫자, 텍스트 등의 테스트 측정 값 유형입니다. 데이터 유형: 문자열 | | 테스트 사양 | 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | 서비스 테스트 정의에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | testSpecification.id | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 종료 날짜 및 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 시작 날짜 및 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] ### cURL 요청 {#servicetestmgmt-GET-serviceTest-id__example_z5y_hvr_rbc} 다음 예제에서는 지정된 ID 44b7a8ea3b6a42107222bf9985e45a45와 연결된 서비스 테스트 엔터티에 대한 상세 정보를 검색합니다. curl --location --request GET "https://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/44b7a8ea3b6a42107222bf9985e45a45 \ --user 'username': 'password' 응답 본문. { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/44b7a8ea3b6a42107222bf9985e45a45", "id": "44b7a8ea3b6a42107222bf9985e45a45", "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001001", "startDateTime": "2024-06-05 08:22:52", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8", "id": "7d3854864316c6500e51203d5fb8f2d8" }, "characteristic": [ { "id": "5c682a2a3b2682107222bf9985e45a5a", "name": "url", "valueType": "single_line_text", "value": "test" } ], "testMeasure": [ { "id": "62ade42a3ba28210d140068aa4e45a71", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Downstream Speed", "unitOfMeasure": "", "value": "16", "ruleViolation": [ { "id": "b9bee4ae3ba28210d140068aa4e45a3a", "description": "This speed is less than the target upper", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetUpper": "75", "conformanceComparatorUpper": "less than", "appliedConsequence": [ { "id": "489074aa3be28210d140068aa4e45a42", "appliedAction": "generateReport", "description": "", "name": "generateReport", "repeatAction": "0" }, { "id": "785f2ce23be28210d140068aa4e45a75", "appliedAction": "sendWarning", "description": "", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } ## 서비스 테스트 관리 Open API - GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification {#ariaid-title4} 모든 서비스 테스트 정의 목록을 조회합니다. ### URL 형식 기본 URL: GET /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification ### 지원되는 요청 매개변수 {#servicetestmgmt-GET-servTestSpecif__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 14. 경로 매개변수] {#servicetestmgmt-GET-servTestSpecif__entry__6} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 이 매개변수를 사용하지 않으면 모든 필드가 반환됩니다. 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] 테이블에 있습니다. 유효한 값은 다음과 같습니다. * 설명 * ID * 이름 * 관련 서비스 사양 * serviceTestSpecRelationship * specCharacteristic * testMeasureDefinition * 유효한대상 {#servicetestmgmt-GET-servTestSpecif__ul_hss_b3v_bcc} 데이터 유형: 문자열 | | 제한 | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 최대값: 100 기본값: 20 | | 오프셋 | 기록 검색을 시작할 시작 인덱스입니다. 이 매개변수를 사용하여 작고 관리하기 쉬운 청크로 결과를 페이지 매김합니다. 첫 번째 기록은 0에서 인덱싱됩니다. 데이터 유형: 숫자 기본값: 0 | | 상태 | 테스트의 현재 상태를 기준으로 테스트 정의를 필터링합니다. 지정된 상태의 테스트 정의만 응답에 반환됩니다. 유효한 값은 다음과 같습니다. * 보관됨 * 초안 * 게시 날짜: * 폐기됨 데이터 유형: 문자열 | [표 15. 쿼리 매개변수] {#servicetestmgmt-GET-servTestSpecif__entry__16} | 이름 | 설명 | |-|-| | 안 함 | | [표 16. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-GET-servTestSpecif__entry__20}{#servicetestmgmt-GET-servTestSpecif__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 17. 요청 헤더] {#servicetestmgmt-GET-servTestSpecif__entry__24} | 머리글 | 설명 | |-|-| | 컨텐츠-범위 | 페이지 매김된 호출에서 반환되는 콘텐츠 범위를 지정합니다. 예를 들어 `offset=2` 및 `limit=3`인 경우 Content-Range 헤더의 값은 항목 `3-5`입니다. | | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 링크 | 쿼리 결과를 탐색하는 다음 링크가 포함되어 있습니다. * 첫 번째 * 마지막 * 다음 * 이전 {#servicetestmgmt-GET-servTestSpecif__ul_acj_pkx_4bc} | | X-합계-카운트 | 페이지 매김된 쿼리의 경우 이 헤더는 서버에서 사용할 수 있는 총 기록 수를 지정합니다. | [표 18. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-GET-servTestSpecif__entry__34}{#servicetestmgmt-GET-servTestSpecif__entry-200-status-code}{#servicetestmgmt-GET-servTestSpecif__entry-400-status-code}{#servicetestmgmt-GET-servTestSpecif__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 206 | 응답으로 반환된 부분 자원입니다(페이지 매김 포함). | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 19. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmgmt-GET-servTestSpecif__section_xvz_1lx_4bc} {#servicetestmgmt-GET-servTestSpecif__table_yvz_1lx_4bc__entry__2} | 이름 | 설명 | |-|-| | 설명 | 서비스 테스트 정의에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | | 이름 | 필수 서비스 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 사양 | 필수 테스트 정의의 서비스 사양입니다. 데이터 유형: 객체 배열 "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | 서비스 사양의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 사양 \[sn_prd_pm_specification\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedServiceSpecification.name | 서비스 사양의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship | 관련 서비스 테스트 정의입니다. 데이터 유형: 객체 배열 "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | 관련 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 정의 \[sn_st_mgmt_test_definition\] | | serviceTestSpecRelationship.name | 관련 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship.relationshipType | 관계의 유형입니다. 허용되는 값: * 종속성 * 독점성 * 대체 {#servicetestmgmt-GET-servTestSpecif__ul_hpg_xtr_dcc} 데이터 유형: 문자열 | | specCharacteristic | 테스트 정의의 특성입니다. 데이터 유형: 객체 배열 "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | 특성의 가능한 값입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | 특성의 값입니다. 데이터 유형: 문자열 | | specCharacteristic.description | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | specCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | specCharacteristic.validFor | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | 특성의 종료 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.validFor.startDateTime | 특성의 시작 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.valueType | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-GET-servTestSpecif__ul_i3m_twr_dcc} 데이터 유형: 문자열 | | testMeasureDefinition | 이 서비스 테스트 정의에 대한 테스트 측정 정의입니다. 자세한 내용은 [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | 메트릭을 캡처할 빈도입니다. 유효한 값은 다음과 같습니다. * 매일 * 월별 * 없음 * 한 번 * 주별 {#servicetestmgmt-GET-servTestSpecif__ul_lsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * none: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-GET-servTestSpecif__ul_gsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.capturePeriod | 메트릭 캡처의 기간 또는 기간입니다. 데이터 유형: 객체 "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | 캡처 기간 수입니다. 데이터 유형: 숫자 | | testMeasureDefinition.capturePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-GET-servTestSpecif__ul_rn1_3ds_dcc} 데이터 유형: 문자열 | | testMeasureDefinition.id | 테스트 측정 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 정의 테이블 \[sn_st_mgmt_test_measure_definition\] | | testMeasureDefinition.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.metricName | 테스트 측정에 있는 메트릭의 사용자 정의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.name | 테스트 측정 정의의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule | 테스트 측정 정의에서 임계치를 초과(또는 초과하지 않음)할 때 결과를 적용하기 전에 달성할 조건을 정의하는 규칙입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 { "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | 값이 대해 설정된 testMeasureDefinition.thresholdRule.conformanceTargetExact값과 동일한지 여부를 나타내는 플래그입니다. true로 설정된 경우 testMeasureDefinition.thresholdRule.conformanceTargetExact 필수입니다. 유효한 값은 다음과 같습니다. * true: 값이 의 값과 동일합니다.conformanceTargetExact * false: 값이 동일 conformanceTargetExact하지 않습니다. {#servicetestmgmt-GET-servTestSpecif__ul_bsw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmgmt-GET-servTestSpecif__ul_zrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmgmt-GET-servTestSpecif__ul_wrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.consequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.id | 측정 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.name | 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | 임계치 위반에 대해 수행할 사용자 정의 작업입니다. 작업은 인스턴스마다 다릅니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.repeatAction | 적용된 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-GET-servTestSpecif__ul_srw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.consequence.validFor | 결과가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | 결과의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | 결과의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.id | 임계치 규칙의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 \[sn_st_mgmt_threshold_rule\] 테이블의 sys_id 또는 external_id 필드 | | testMeasureDefinition.thresholdRule.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | 임계치 규칙의 심각도 수준입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmgmt-GET-servTestSpecif__ul_orw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasureDefinition.validFor | 테스트 측정 정의가 유효한 날짜 범위입니다. 데이터 유형: 문자열 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | 테스트 측정 정의의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.validFor.startDateTime | 테스트 측정 정의의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 유효한대상 | 테스트 정의가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 테스트 정의의 상태가 폐기된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 상태가 게시되는 테스트 정의의 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] {#servicetestmgmt-GET-servTestSpecif__table_yvz_1lx_4bc} ### cURL 요청 이 예제에서는 인스턴스의 모든 테스트 서비스 테스트 정의에 대한 상세 정보를 검색합니다. 이 경우 두 개의 정의가 반환됩니다. curl --location --request GET "https://instance.servicenow.com//api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification" \ --user 'username': 'password' 응답 본문. [ { "description": "Operation, Administration and Maintenance", "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "validFor": { "startDateTime": "", "endDateTime": "" }, "testMeasureDefinition": [ { "id": "77b9b964432a02104fefe4511fb8f26e", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the Rx signal level", "metricName": "Rx Optical Signal Level", "name": "Rx Optical Signal Level", "unitOfMeasure": "a minute", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [ { "id": "d3e97d64432a02104fefe4511fb8f281", "description": "", "name": "gponOntAniOpInfoRxOpticalSignalLevel", "numberOfAllowedCrossing": "", "thresholdRuleSeverity": "", "tolerancePeriod": "", "conformanceTargetUpper": "0", "conformanceComparatorUpper": "less than", "conformanceTargetLower": "-50", "conformanceComparatorLower": "greater than", "consequence": [] } ] }, { "id": "878afd64432a02104fefe4511fb8f28d", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the Tx signal level", "metricName": "TX Optical Signal Level", "name": "TX Optical Signal Level", "unitOfMeasure": "a minute", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [ { "id": "b3dab5a4432a02104fefe4511fb8f2d3", "description": "", "name": "gponOntAniOpInfoTxOpticalSignalLevel", "numberOfAllowedCrossing": "", "thresholdRuleSeverity": "", "tolerancePeriod": "", "conformanceTargetUpper": "65", "conformanceComparatorUpper": "less than", "conformanceTargetLower": "-65", "conformanceComparatorLower": "greater than", "consequence": [] } ] } ], "specCharacteristic": [ { "name": "AccessRequired", "description": "AccessRequired", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 09:09:57" }, "characteristicValueSpecification": [ { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [], "relatedServiceSpecification": [ { "id": "f559b564432a02104fefe4511fb8f2e0", "name": "OAM" } ] }, { "description": "Upstream and Downstream speed ", "id": "89d2b920432a02104fefe4511fb8f22e", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } ] ## 서비스 테스트 관리 Open API - GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} {#ariaid-title5} 서비스 테스트 정의 엔터티를 검색합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} ### 지원되는 요청 매개변수 {#servicetestmanagement-GET-id__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | [표 20. 경로 매개변수] {#servicetestmanagement-GET-id__entry__6} | 이름 | 설명 | |-|-| | 필드 | 응답에서 반환할 필드 목록입니다. 잘못된 필드는 무시됩니다. 이 매개변수를 사용하지 않으면 모든 필드가 반환됩니다. 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] 테이블에 있습니다. 유효한 값은 다음과 같습니다. * 설명 * ID * 이름 * 관련 서비스 사양 * serviceTestSpecRelationship * specCharacteristic * testMeasureDefinition * 유효한대상 {#servicetestmanagement-GET-id__ul_hss_b3v_bcc} 데이터 유형: 문자열 | | 상태 | 테스트의 현재 상태를 기준으로 테스트 정의를 필터링합니다. 지정된 상태의 테스트 정의만 응답에 반환됩니다. 유효한 값은 다음과 같습니다. * 보관됨 * 초안 * 게시 날짜: * 폐기됨 데이터 유형: 문자열 | [표 21. 쿼리 매개변수] {#servicetestmanagement-GET-id__entry__12} | 이름 | 설명 | |-|-| | 안 함 | | [표 22. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmanagement-GET-id__entry__16}{#servicetestmanagement-GET-id__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 23. 요청 헤더] {#servicetestmanagement-GET-id__entry__20}{#servicetestmanagement-GET-id__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 24. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmanagement-GET-id__entry__24}{#servicetestmanagement-GET-id__entry-200-status-code}{#servicetestmanagement-GET-id__entry-400-status-code}{#servicetestmanagement-GET-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 25. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmanagement-GET-id__entry__32} | 이름 | 설명 | |-|-| | 설명 | 서비스 테스트 정의에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | | 이름 | 필수 서비스 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 사양 | 필수 테스트 정의의 서비스 사양입니다. 데이터 유형: 객체 배열 "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | 서비스 사양의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 사양 \[sn_prd_pm_specification\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedServiceSpecification.name | 서비스 사양의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship | 관련 서비스 테스트 정의입니다. 데이터 유형: 객체 배열 "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | 관련 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 정의 \[sn_st_mgmt_test_definition\] | | serviceTestSpecRelationship.name | 관련 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship.relationshipType | 관계의 유형입니다. 허용되는 값: * 종속성 * 독점성 * 대체 {#servicetestmanagement-GET-id__ul_hpg_xtr_dcc} 데이터 유형: 문자열 | | specCharacteristic | 테스트 정의의 특성입니다. 데이터 유형: 객체 배열 "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | 특성의 가능한 값입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | 특성의 값입니다. 데이터 유형: 문자열 | | specCharacteristic.description | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | specCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | specCharacteristic.validFor | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | 특성의 종료 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.validFor.startDateTime | 특성의 시작 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.valueType | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmanagement-GET-id__ul_i3m_twr_dcc} 데이터 유형: 문자열 | | testMeasureDefinition | 이 서비스 테스트 정의에 대한 테스트 측정 정의입니다. 자세한 내용은 [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | 메트릭을 캡처할 빈도입니다. 유효한 값은 다음과 같습니다. * 매일 * 월별 * 없음 * 한 번 * 주별 {#servicetestmanagement-GET-id__ul_lsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * none: 메트릭을 캡처하지 않습니다. {#servicetestmanagement-GET-id__ul_gsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.capturePeriod | 메트릭 캡처의 기간 또는 기간입니다. 데이터 유형: 객체 "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | 캡처 기간 수입니다. 데이터 유형: 숫자 | | testMeasureDefinition.capturePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmanagement-GET-id__ul_rn1_3ds_dcc} 데이터 유형: 문자열 | | testMeasureDefinition.id | 테스트 측정 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 정의 테이블 \[sn_st_mgmt_test_measure_definition\] | | testMeasureDefinition.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.metricName | 테스트 측정에 있는 메트릭의 사용자 정의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.name | 테스트 측정 정의의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule | 테스트 측정 정의에서 임계치를 초과(또는 초과하지 않음)할 때 결과를 적용하기 전에 달성할 조건을 정의하는 규칙입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 { "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | 값이 대해 설정된 testMeasureDefinition.thresholdRule.conformanceTargetExact값과 동일한지 여부를 나타내는 플래그입니다. true로 설정된 경우 testMeasureDefinition.thresholdRule.conformanceTargetExact 필수입니다. 유효한 값은 다음과 같습니다. * true: 값이 의 값과 동일합니다.conformanceTargetExact * false: 값이 동일 conformanceTargetExact하지 않습니다. {#servicetestmanagement-GET-id__ul_bsw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmanagement-GET-id__ul_zrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmanagement-GET-id__ul_wrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.consequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.id | 측정 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.name | 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | 임계치 위반에 대해 수행할 사용자 정의 작업입니다. 작업은 인스턴스마다 다릅니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.repeatAction | 적용된 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmanagement-GET-id__ul_srw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.consequence.validFor | 결과가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | 결과의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | 결과의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.id | 임계치 규칙의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 \[sn_st_mgmt_threshold_rule\] 테이블의 sys_id 또는 external_id 필드 | | testMeasureDefinition.thresholdRule.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | 임계치 규칙의 심각도 수준입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmanagement-GET-id__ul_orw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasureDefinition.validFor | 테스트 측정 정의가 유효한 날짜 범위입니다. 데이터 유형: 문자열 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | 테스트 측정 정의의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.validFor.startDateTime | 테스트 측정 정의의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 유효한대상 | 테스트 정의가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 테스트 정의의 상태가 폐기된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 상태가 게시되는 테스트 정의의 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] ### cURL 요청 이 예에서는 지정된 ID로 서비스 테스트 정의의 상세 정보를 검색합니다. curl --location --request GET "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/89d2b920432a02104fefe4511fb8f22e" \ --user 'username': 'password' 응답 본문. { "description": "Upstream and Downstream speed ", "id": "89d2b920432a02104fefe4511fb8f22e", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } ## 서비스 테스트 관리 Open API - 패치 /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} {#ariaid-title6} 서비스 테스트 엔터티를 업데이트합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} ### 지원되는 요청 매개변수 {#servicetestmgmt-PATCH-serviceTestid__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 서비스 테스트의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | [표 26. 경로 매개변수] {#servicetestmgmt-PATCH-serviceTestid__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 27. 쿼리 매개변수] {#servicetestmgmt-PATCH-serviceTestid__entry__10} | 이름 | 설명 | |-|-| | 특성 | 관련 서비스 테스트의 특성을 설명하는 목록입니다. 테스트 정의 특성에 대한 자세한 내용은 다음을 참조하십시오. 데이터 유형: 객체 배열 "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | 특성의 Sys_id 또는 external_id입니다. 해당 기록에 대한 external_id이 있으면 응답은 external_id를 반환하고, 그렇지 않으면 sys_id을 반환합니다. 데이터 유형: 문자열 테이블: 특성 \[sn_prd_pm_characteristic\] | | characteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 특성.값 | 서비스 테스트와 관련된 특성 옵션입니다. 특성은 고객 인스턴스에 따라 다릅니다. 데이터 유형: 문자열 | | 특성.값유형 | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-PATCH-serviceTestid__ul_zfr_twr_dcc} 데이터 유형: 문자열 | | 설명 | 서비스 테스트에 대한 설명입니다. 데이터 유형: 문자열 | | endDateTime | 서비스 테스트의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 모드 | 서비스 테스트가 실행되는 모드입니다. 유효한 값은 다음과 같습니다. * ONDEMAND: 서비스 테스트를 수동으로 트리거합니다. * 사전 예방적: 서비스 테스트를 자동으로 트리거합니다. {#servicetestmgmt-PATCH-serviceTestid__ul_ybc_mqn_xbc} 데이터 유형: 문자열 기본값: ONDEMAND | | 이름 | 필수 서비스 테스트의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 | 필수 서비스 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.href | 관련 서비스에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | relatedService.id | 제품 인벤토리의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 제품 인벤토리 \[sn_prd_invt_product_inventory\] 테이블의 sys_id 또는 external_id 필드입니다. | | startDateTime | 서비스 테스트의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 상태 | 서비스 테스트가 진행되는 상태입니다. 유효한 값은 다음과 같습니다. * 확인됨 * 취소됨 * 완료됨 * 실패 * inProgress * 보류 중 * 거부됨 {#servicetestmgmt-PATCH-serviceTestid__ul_gym_mqn_xbc} 데이터 유형: 문자열 | | 테스트 측정 | 제품, 서비스 또는 자원 테스트의 특정 측면(예: 손실된 패킷 또는 연결 상태)에 대한 측정값입니다. 데이터 유형: 객체 배열 "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | 관련 메트릭에 대해 캡처된 테스트 측정 정확도를 나타내는 부동 10진수 값입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.captureDateTime | 메트릭이 캡처된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasure.id | 테스트 측정값의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 테이블 \[sn_st_mgmt_test_measure\] 테이블의 sys_id 또는 external_id 필드. | | testMeasure.Measure.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-PATCH-serviceTestid__ul_ed2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasure.metricName | 테스트 측정 메트릭의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation | 임계치 규칙 정의에서 규칙을 정의하기 위한 객체와 규칙이 위반될 경우의 결과입니다. 데이터 유형: 객체 배열 "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] | | testMeasure.ruleViolation.tolerancePeriod.amount | 결과를 적용하기 전의 기간 수입니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.appliedConsequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | 임계치 규칙이 위반될 때 수행할 작업입니다. 예를 들어 경고를 보내거나 보고서를 생성합니다. 적용된 작업은 인스턴스마다 다를 수 있습니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.description | 적용된 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.id | 적용된 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.name | 적용된 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.repeatAction | 두 번째 위반이 발생할 때 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-PATCH-serviceTestid__ul_ld2_gxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComporatorExact | 값이 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 동일합니다. * false: 값이 동일하지 않습니다. {#servicetestmgmt-PATCH-serviceTestid__ul_od2_gxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComporatorLower | 값이 임계치 아래로 떨어지는지 확인하기 위한 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmgmt-PATCH-serviceTestid__ul_sd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComporatorUpper | 값이 임계치를 초과하는지 확인하기 위한 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmgmt-PATCH-serviceTestid__ul_vd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.id | 임계치 규칙 위반의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] | | testMeasure.ruleViolation.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmgmt-PATCH-serviceTestid__ul_xd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.tolerancePeriod | 즉각적인 결과나 작업을 트리거하지 않고 교차 발생을 활성화하는 지정된 시간 간격입니다. 날짜 유형: 객체 "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-PATCH-serviceTestid__ul_qbw_qds_dcc} 데이터 유형: 문자열 | | testMeasure.unitOfMeasure | 테스트 측정의 적합성 대상 값에 대한 측정 단위입니다. 데이터 유형: 문자열 | | testMeasure.value | 테스트 측정값입니다. 데이터 유형: 객체 "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } | | testMeasure.value.id | 테스트 측정 값의 ID입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트 측정 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.value | 테스트 측정값입니다. 데이터 유형: 문자열 | | testMeasure.value.valueType | 숫자, 텍스트 등의 테스트 측정 값 유형입니다. 데이터 유형: 문자열 | | 테스트 사양 | 필수 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | 서비스 테스트 정의에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | testSpecification.id | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] 테이블의 sys_id 또는 external_id 필드. | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime ": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [표 28. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-PATCH-serviceTestid__entry__120}{#servicetestmgmt-PATCH-serviceTestid__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 29. 요청 헤더] {#servicetestmgmt-PATCH-serviceTestid__entry__124} | 머리글 | 설명 | |-|-| | 안 함 | | [표 30. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-PATCH-serviceTestid__entry__128}{#servicetestmgmt-PATCH-serviceTestid__entry-200-status-code}{#servicetestmgmt-PATCH-serviceTestid__entry-400-status-code}{#servicetestmgmt-PATCH-serviceTestid__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 31. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmgmt-PATCH-serviceTestid__entry__136} | 이름 | 설명 | |-|-| | 특성 | 관련 서비스 테스트의 특성을 설명하는 목록입니다. 데이터 유형: 객체 배열 "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | 특성의 Sys_id 또는 external_id입니다. 해당 기록에 대한 external_id이 있으면 응답은 external_id를 반환하고, 그렇지 않으면 sys_id을 반환합니다. 데이터 유형: 문자열 테이블: 특성 \[sn_prd_pm_characteristic\] | | characteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 특성.값 | 서비스 테스트와 관련된 특성 옵션입니다. 특성은 고객 인스턴스에 따라 다릅니다. 데이터 유형: 문자열 | | 특성.값유형 | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 데이터 유형: 문자열 | | 설명 | 서비스 테스트에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 이름 | 서비스 테스트의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 | 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "relatedService": { "href": "string", "id": "String", "name": "String" } | | relatedService.id | 제품 인벤토리의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 제품 인벤토리 \[sn_prd_invt_product_inventory\] | | relatedService.name | 제품 인벤토리의 이름입니다. 데이터 유형: 문자열 | | 테스트 측정 | 제품, 서비스 또는 자원 테스트의 특정 측면(예: 손실된 패킷 또는 연결 상태)에 대한 측정값입니다. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | 관련 메트릭에 대해 캡처된 테스트 측정 정확도를 나타내는 부동 10진수 값입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.captureDateTime | 메트릭이 캡처된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasure.capture메서드 | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-PATCH-serviceTestid__ul_zrs_txv_xbc} 데이터 유형: 문자열 | | testMeasure.id | 테스트 측정의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 표: 테스트 측정 \[sn_st_mgmt_test_measure\] | | testMeasure.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasure.metricName | 테스트 측정의 메트릭 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation | 규칙이 위반될 경우의 결과와 함께 임계치 규칙 정의에서 규칙을 정의하기 위한 객체입니다. 데이터 유형: 객체 배열 "RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ] | | testMeasure.ruleViolation.appliedConsequence | 임계치 규칙이 위반될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | 임계치 규칙이 위반될 때 수행할 작업입니다. 예를 들어 경고를 보내거나 보고서를 생성합니다. 적용된 작업은 인스턴스마다 다를 수 있습니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | 적용된 작업을 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-PATCH-serviceTestid__ul_kss_txv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.appliedConsequence.description | 적용된 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.id | 적용된 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.name | 적용된 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComparatorExact | 값이 의 값 conformanceTargetExact과 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 동일합니다. * false: 값이 동일하지 않습니다. {#servicetestmgmt-PATCH-serviceTestid__ul_uss_txv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 다음과 같음 {#servicetestmgmt-PATCH-serviceTestid__ul_fts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 다음과 같음 * 보다 작음 {#servicetestmgmt-PATCH-serviceTestid__ul_mts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.description | 임계치 규칙 위반에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.id | 임계치 규칙 위반의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] | | testMeasure.ruleViolation.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대: 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 낮음 * 보통 {#servicetestmgmt-PATCH-serviceTestid__ul_tts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.tolerancePeriod | 결과가 시작되기 전에 허용된 교차가 발생할 수 있는 기간 또는 시간 간격입니다. 날짜 유형: 객체 "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | 기간의 양(수)입니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.tolerancePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-PATCH-serviceTestid__ul_my3_qds_dcc} 데이터 유형: 문자열 | | testMeasure.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasure.value | 테스트의 메트릭 값입니다. 데이터 유형: 객체 "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } | | testMeasure.value.id | 테스트의 메트릭 값 ID입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트에 있는 메트릭 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.value | 테스트의 메트릭 값입니다. 데이터 유형: 문자열 | | testMeasure.value.valueType | 숫자, 텍스트 등의 테스트 측정 값 유형입니다. 데이터 유형: 문자열 | | 테스트 사양 | 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | 서비스 테스트 정의에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | testSpecification.id | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 종료 날짜 및 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 시작 날짜 및 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] ### cURL 요청 다음 예에서는 요청 본문에 제공된 상세 정보에 따라 지정된 서비스 테스트 엔터티를 업데이트합니다. curl "http://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/2b406ec043b202104fefe4511fb8f211" \ --request PATCH \ --header "Accept:application/json" \ --user 'username':'password' --data { "description": "Service test description", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "No" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } 응답은 지정된 테스트 서비스에서 수정된 정보를 반환하여 업데이트가 성공했음을 보여줍니다. { "description": "Service test description", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "yes" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } ## 서비스 테스트 관리 Open API - 패치 /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} {#ariaid-title7} 서비스 테스트 정의 엔터티의 부분 업데이트를 허용합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} ### 지원되는 요청 매개변수 {#servicetestmgmt-PATCH-servTestSp-id__entry__2} | 이름 | 설명 | |-|-| | ID | 검색할 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | [표 32. 경로 매개변수] {#servicetestmgmt-PATCH-servTestSp-id__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 33. 쿼리 매개변수] {#servicetestmgmt-PATCH-servTestSp-id__entry__10} | 이름 | 설명 | |-|-| | 설명 | 서비스 테스트 정의에 대한 설명입니다. 데이터 유형: 문자열 | | 이름 | 필수 서비스 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 사양 | 필수 테스트 정의의 서비스 사양입니다. 데이터 유형: 객체 배열 "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | 서비스 사양의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 사양 \[sn_prd_pm_specification\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedServiceSpecification.name | 서비스 사양의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship | 관련 서비스 테스트 정의입니다. 데이터 유형: 객체 배열 "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | 관련 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 정의 \[sn_st_mgmt_test_definition\] | | serviceTestSpecRelationship.name | 관련 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship.relationshipType | 관계의 유형입니다. 허용되는 값: * 종속성 * 독점성 * 대체 {#servicetestmgmt-PATCH-servTestSp-id__ul_hpg_xtr_dcc} 데이터 유형: 문자열 | | specCharacteristic | 테스트 정의의 특성입니다. 데이터 유형: 객체 배열 "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | 특성의 가능한 값입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | 특성의 값입니다. 데이터 유형: 문자열 | | specCharacteristic.description | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | specCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | specCharacteristic.validFor | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | 특성의 종료 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.validFor.startDateTime | 특성의 시작 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.valueType | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-PATCH-servTestSp-id__ul_i3m_twr_dcc} 데이터 유형: 문자열 | | testMeasureDefinition | 이 서비스 테스트 정의에 대한 테스트 측정 정의입니다. 자세한 내용은 [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | 메트릭을 캡처할 빈도입니다. 유효한 값은 다음과 같습니다. * 매일 * 월별 * 없음 * 한 번 * 주별 {#servicetestmgmt-PATCH-servTestSp-id__ul_lsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * none: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-PATCH-servTestSp-id__ul_gsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.capturePeriod | 메트릭 캡처의 기간 또는 기간입니다. 데이터 유형: 객체 "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | 캡처 기간 수입니다. 데이터 유형: 숫자 | | testMeasureDefinition.capturePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-PATCH-servTestSp-id__ul_rn1_3ds_dcc} 데이터 유형: 문자열 | | testMeasureDefinition.id | 테스트 측정 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 정의 테이블 \[sn_st_mgmt_test_measure_definition\] | | testMeasureDefinition.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.metricName | 테스트 측정에 있는 메트릭의 사용자 정의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.name | 테스트 측정 정의의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule | 테스트 측정 정의에서 임계치를 초과(또는 초과하지 않음)할 때 결과를 적용하기 전에 달성할 조건을 정의하는 규칙입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 { "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | 값이 대해 설정된 testMeasureDefinition.thresholdRule.conformanceTargetExact값과 동일한지 여부를 나타내는 플래그입니다. true로 설정된 경우 testMeasureDefinition.thresholdRule.conformanceTargetExact 필수입니다. 유효한 값은 다음과 같습니다. * true: 값이 의 값과 동일합니다.conformanceTargetExact * false: 값이 동일 conformanceTargetExact하지 않습니다. {#servicetestmgmt-PATCH-servTestSp-id__ul_bsw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmgmt-PATCH-servTestSp-id__ul_zrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmgmt-PATCH-servTestSp-id__ul_wrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.consequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.id | 측정 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.name | 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | 임계치 위반에 대해 수행할 사용자 정의 작업입니다. 작업은 인스턴스마다 다릅니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.repeatAction | 적용된 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-PATCH-servTestSp-id__ul_srw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.consequence.validFor | 결과가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | 결과의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | 결과의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.id | 임계치 규칙의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 \[sn_st_mgmt_threshold_rule\] 테이블의 sys_id 또는 external_id 필드 | | testMeasureDefinition.thresholdRule.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | 임계치 규칙의 심각도 수준입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmgmt-PATCH-servTestSp-id__ul_orw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasureDefinition.validFor | 테스트 측정 정의가 유효한 날짜 범위입니다. 데이터 유형: 문자열 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | 테스트 측정 정의의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.validFor.startDateTime | 테스트 측정 정의의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [표 34. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-PATCH-servTestSp-id__entry__118}{#servicetestmgmt-PATCH-servTestSp-id__accept-RESTAPI}{#servicetestmgmt-PATCH-servTestSp-id__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 35. 요청 헤더] {#servicetestmgmt-PATCH-servTestSp-id__entry__124} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 36. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-PATCH-servTestSp-id__entry__128}{#servicetestmgmt-PATCH-servTestSp-id__entry-200-status-code}{#servicetestmgmt-PATCH-servTestSp-id__entry-400-status-code}{#servicetestmgmt-PATCH-servTestSp-id__entry-404-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | [표 37. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmgmt-PATCH-servTestSp-id__section_h1m_wz4_qbc} {#servicetestmgmt-PATCH-servTestSp-id__table_i1m_wz4_qbc__entry__2} | 이름 | 설명 | |-|-| | 설명 | 서비스 테스트 정의에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 이름 | 서비스 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 사양 | 테스트 정의에 대한 서비스 사양입니다. 데이터 유형: 객체 배열 "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | 서비스 사양의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 사양 \[sn_prd_pm_specification\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedServiceSpecification.name | 서비스 사양의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship | 관련 서비스 테스트 정의입니다. 데이터 유형: 객체 배열 "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | 관련 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 정의 \[sn_st_mgmt_test_definition\] | | serviceTestSpecRelationship.name | 관련 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship.relationshipType | 관계의 유형입니다. 허용되는 값: * 종속성 * 독점성 * 대체 {#servicetestmgmt-PATCH-servTestSp-id__d4708e2411} 데이터 유형: 문자열 | | specCharacteristic | 테스트 정의 특성입니다. 데이터 유형: 객체 배열 "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | 특성의 가능한 값입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | 특성의 값입니다. 데이터 유형: 문자열 | | specCharacteristic.description | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | specCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | specCharacteristic.validFor | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | 특성의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | specCharacteristic.validFor.startDateTime | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | specCharacteristic.valueType | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-PATCH-servTestSp-id__ul_uwb_5wr_dcc} 데이터 유형: 문자열 | | testMeasureDefinition | 이 서비스 테스트 정의에 대한 테스트 측정 정의입니다. 자세한 내용은 다음을 참조하십시오 [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) . 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | 메트릭을 캡처할 빈도입니다. 유효한 값은 다음과 같습니다. * 매일 * 월별 * 없음 * 한 번 * 주별 {#servicetestmgmt-PATCH-servTestSp-id__ul_od2_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-PATCH-servTestSp-id__ul_rd2_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.capturePeriod | 캡처의 기간 또는 기간입니다. 데이터 유형: 객체 "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | 캡처 기간 수입니다. 데이터 유형: 숫자 | | testMeasureDefinition.capturePeriod.units | 기간의 단위입니다. 허용되는 값: * 일 * 시간 * 분 * 초 {#servicetestmgmt-PATCH-servTestSp-id__ul_lfv_dds_dcc} 데이터 유형: 문자열 | | testMeasureDefinition.id | 테스트 측정 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 정의 \[sn_st_mgmt_test_measure_definition\] | | testMeasureDefinition.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.metricName | 테스트 측정에 있는 메트릭의 사용자 정의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.name | 테스트 측정 정의의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule | 특정 테스트 측정 정의에 대해 임계치를 초과하거나 초과하지 않을 때 결과를 적용하기 위해 달성할 조건(상승 또는 해제)을 정의하는 규칙입니다. 데이터 유형: 객체 배열 { "thresholdRule": { "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | 값이 의 값 conformanceTargetExact과 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 의 값과 동일합니다.conformanceTargetExact * false: 값이 동일 conformanceTargetExact하지 않습니다. {#servicetestmgmt-PATCH-servTestSp-id__ul_gyl_vqr_dcc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 다음과 같음 {#servicetestmgmt-PATCH-servTestSp-id__ul_b22_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 다음과 같음 {#servicetestmgmt-PATCH-servTestSp-id__ul_e22_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.consequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.id | 측정 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.name | 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | 임계치 위반에 대해 수행할 사용자 정의 작업입니다. 작업은 인스턴스마다 다릅니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.repeatAction | 적용된 작업을 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-PATCH-servTestSp-id__ul_rjm_pxy_rbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.consequence.validFor | 결과가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | 결과의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | 결과의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.id | 임계치 규칙의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 \[sn_st_mgmt_threshold_rule\] | | testMeasureDefinition.thresholdRule.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 낮음 * 보통 {#servicetestmgmt-PATCH-servTestSp-id__ul_j22_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasureDefinition.validFor | 테스트 측정 정의가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | 테스트 측정 정의의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.validFor.startDateTime | 테스트 측정 정의의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] {#servicetestmgmt-PATCH-servTestSp-id__table_i1m_wz4_qbc} ### cURL 요청 다음 예시에서는 요청 본문에 제공된 수정 사항에 따라 지정된 서비스 테스트 정의 ID를 부분적으로 업데이트합니다. curl "http://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/89d2b920432a02104fefe4511fb8f22e " --request PATCH --header "Accept:application/json" --user 'username':'password' --data { "description": "Upstream and Downstream speed ", "name": "This is my new Speed Test", "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" } } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } 응답 본문은 서비스 테스트 사양의 업데이트된 부분을 반환합니다. { "description": "Upstream and Downstream speed ", "name": "This is my new Speed Test", "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" } } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } ## 서비스 테스트 관리 Open API - POST /sn_sprb_mgmt/servicetestmanagement/serviceTest {#ariaid-title8} 서비스 테스트를 작성합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest ### 지원되는 요청 매개변수 {#servicetestmgmt-POST-serviceTest__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 38. 경로 매개변수] {#servicetestmgmt-POST-serviceTest__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 39. 쿼리 매개변수] {#servicetestmgmt-POST-serviceTest__id_q31_zd1_qbc__entry__2}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.valueType}{#servicetestmgmt-POST-serviceTest__serviceTest-request-description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-endDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-mode}{#servicetestmgmt-POST-serviceTest__serviceTest-request-name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.href}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-startDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-state}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.accuracy}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.captureDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.captureMethod}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.metricDescription}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.metricName}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.appliedAction}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.repeatAction}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorExact}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorLower}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorUpper}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetExact}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetLower}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetUpper}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-test.Measure.ruleViolation.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.numberOfAllowedCrossing}{#servicetestmgmt-POST-serviceTest__serviceTest-request-estMeasure.ruleViolation.thresholdRuleSeverity}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.tolerancePeriod}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.amount}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.tolerancePeriod.units}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.unitOfMeasure}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.valueType}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification.href}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor.endDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor.startDateTime} | 이름 | 설명 | |-|-| | 특성 | 관련 서비스 테스트의 특성을 설명하는 목록입니다. 테스트 정의 특성에 대한 자세한 내용은 다음을 참조하십시오. 데이터 유형: 객체 배열 "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | 특성의 Sys_id 또는 external_id입니다. 해당 기록에 대한 external_id이 있으면 응답은 external_id를 반환하고, 그렇지 않으면 sys_id을 반환합니다. 데이터 유형: 문자열 테이블: 특성 \[sn_prd_pm_characteristic\] | | characteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 특성.값 | 서비스 테스트와 관련된 특성 옵션입니다. 특성은 고객 인스턴스에 따라 다릅니다. 데이터 유형: 문자열 | | 특성.값유형 | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-POST-serviceTest__ul_zfr_twr_dcc} 데이터 유형: 문자열 | | 설명 | 서비스 테스트에 대한 설명입니다. 데이터 유형: 문자열 | | endDateTime | 서비스 테스트의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | ID | 서비스 테스트의 Sys_id 또는 external_id입니다. 이 ID는 서비스 테스트를 생성하고 external_id로 사용됩니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 모드 | 서비스 테스트가 실행되는 모드입니다. 유효한 값은 다음과 같습니다. * ONDEMAND: 서비스 테스트를 수동으로 트리거합니다. * 사전 예방적: 서비스 테스트를 자동으로 트리거합니다. {#servicetestmgmt-POST-serviceTest__ul_ybc_mqn_xbc} 데이터 유형: 문자열 기본값: ONDEMAND | | 이름 | 필수 서비스 테스트의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 | 필수 서비스 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.href | 관련 서비스에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | relatedService.id | 제품 인벤토리의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 제품 인벤토리 \[sn_prd_invt_product_inventory\] 테이블의 sys_id 또는 external_id 필드입니다. | | relatedService.name | 제품 인벤토리 항목의 이름입니다. 데이터 유형: 문자열 | | startDateTime | 서비스 테스트의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 상태 | 서비스 테스트가 진행되는 상태입니다. 유효한 값은 다음과 같습니다. * 확인됨 * 취소됨 * 완료됨 * 실패 * inProgress * 보류 중 * 거부됨 {#servicetestmgmt-POST-serviceTest__ul_gym_mqn_xbc} 데이터 유형: 문자열 | | 테스트 측정 | 제품, 서비스 또는 자원 테스트의 특정 측면(예: 손실된 패킷 또는 연결 상태)에 대한 측정값입니다. 데이터 유형: 객체 배열 "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | 관련 메트릭에 대해 캡처된 테스트 측정 정확도를 나타내는 부동 10진수 값입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.captureDateTime | 메트릭이 캡처된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasure.id | 테스트 측정값의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 테이블 \[sn_st_mgmt_test_measure\] 테이블의 sys_id 또는 external_id 필드. | | testMeasure.Measure.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-POST-serviceTest__ul_ed2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasure.metricName | 테스트 측정 메트릭의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation | 임계치 규칙 정의에서 규칙을 정의하기 위한 객체와 규칙이 위반될 경우의 결과입니다. 데이터 유형: 객체 배열 "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] | | testMeasure.ruleViolation.appliedConsequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | 임계치 규칙이 위반될 때 수행할 작업입니다. 예를 들어 경고를 보내거나 보고서를 생성합니다. 적용된 작업은 인스턴스마다 다를 수 있습니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.description | 적용된 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.id | 적용된 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.name | 적용된 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.repeatAction | 두 번째 위반이 발생할 때 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-POST-serviceTest__ul_ld2_gxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComporatorExact | 값이 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 동일합니다. * false: 값이 동일하지 않습니다. {#servicetestmgmt-POST-serviceTest__ul_od2_gxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComporatorLower | 값이 임계치 아래로 떨어지는지 확인하기 위한 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmgmt-POST-serviceTest__ul_sd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComporatorUpper | 값이 임계치를 초과하는지 확인하기 위한 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmgmt-POST-serviceTest__ul_vd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.id | 임계치 규칙 위반의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] | | testMeasure.ruleViolation.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmgmt-POST-serviceTest__ul_xd2_gxv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.tolerancePeriod | 즉각적인 결과나 작업을 트리거하지 않고 교차 발생을 활성화하는 지정된 시간 간격입니다. 날짜 유형: 객체 "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | 결과를 적용하기 전의 기간 수입니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.tolerancePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-POST-serviceTest__ul_qbw_qds_dcc} 데이터 유형: 문자열 | | testMeasure.unitOfMeasure | 테스트 측정의 적합성 대상 값에 대한 측정 단위입니다. 데이터 유형: 문자열 | | testMeasure.value | 테스트 측정값입니다. 데이터 유형: 객체 "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } | | testMeasure.value.id | 테스트 측정 값의 ID입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트 측정 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.value | 테스트 측정값입니다. 데이터 유형: 문자열 | | testMeasure.value.valueType | 숫자, 텍스트 등의 테스트 측정 값 유형입니다. 데이터 유형: 문자열 | | 테스트 사양 | 필수 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | 서비스 테스트 정의에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | testSpecification.id | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] 테이블의 sys_id 또는 external_id 필드. | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime ": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [표 40. 요청 본문 매개변수(XML 또는 JSON)] {#servicetestmgmt-POST-serviceTest__id_q31_zd1_qbc} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-POST-serviceTest__entry__124}{#servicetestmgmt-POST-serviceTest__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 41. 요청 헤더] {#servicetestmgmt-POST-serviceTest__entry__128} | 머리글 | 설명 | |-|-| | 안 함 | | [표 42. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-POST-serviceTest__entry__132}{#servicetestmgmt-POST-serviceTest__entry-200-status-code}{#servicetestmgmt-POST-serviceTest__entry-400-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | [표 43. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmgmt-POST-serviceTest__table_qzk_r2p_qbc__entry__2} | 이름 | 설명 | |-|-| | 특성 | 관련 서비스 테스트의 특성을 설명하는 목록입니다. 데이터 유형: 객체 배열 "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | 특성의 Sys_id 또는 external_id입니다. 해당 기록에 대한 external_id이 있으면 응답은 external_id를 반환하고, 그렇지 않으면 sys_id을 반환합니다. 데이터 유형: 문자열 테이블: 특성 \[sn_prd_pm_characteristic\] | | characteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | 특성.값 | 서비스 테스트와 관련된 특성 옵션입니다. 특성은 고객 인스턴스에 따라 다릅니다. 데이터 유형: 문자열 | | 특성.값유형 | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 데이터 유형: 문자열 | | 설명 | 서비스 테스트에 대한 설명입니다. 데이터 유형: 문자열 | | endDateTime | 서비스 테스트의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 모드 | 서비스 테스트가 실행되는 모드입니다. 유효한 값은 다음과 같습니다. * ONDEMAND: 서비스 테스트를 수동으로 트리거합니다. * 사전 예방적: 서비스 테스트를 자동으로 트리거합니다. {#servicetestmgmt-POST-serviceTest__ul_itl_ksn_xbc} 데이터 유형: 문자열 기본값: ONDEMAND | | 이름 | 서비스 테스트의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 | 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "relatedService": { "href": "string", "id": "String", "name": "String" } | | relatedService.id | 제품 인벤토리의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 제품 인벤토리 \[sn_prd_invt_product_inventory\] | | relatedService.name | 제품 인벤토리의 이름입니다. 데이터 유형: 문자열 | | startDateTime | 서비스 테스트의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 상태 | 서비스 테스트의 상태입니다. 유효한 값은 다음과 같습니다. * 확인됨 * 취소됨 * 완료됨 * 실패 * inProgress * 보류 중 * 거부됨 {#servicetestmgmt-POST-serviceTest__ul_prs_txv_xbc} 데이터 유형: 문자열 | | 테스트 측정 | 제품, 서비스 또는 자원 테스트의 특정 측면(예: 손실된 패킷 또는 연결 상태)에 대한 측정값입니다. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | 관련 메트릭에 대해 캡처된 테스트 측정 정확도를 나타내는 부동 10진수 값입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasure.captureDateTime | 메트릭이 캡처된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasure.capture메서드 | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-POST-serviceTest__ul_zrs_txv_xbc} 데이터 유형: 문자열 | | testMeasure.id | 테스트 측정의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 표: 테스트 측정 \[sn_st_mgmt_test_measure\] | | testMeasure.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasure.metricName | 테스트 측정의 메트릭 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation | 규칙이 위반될 경우의 결과와 함께 임계치 규칙 정의에서 규칙을 정의하기 위한 객체입니다. 데이터 유형: 객체 배열 "RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ] | | testMeasure.ruleViolation.appliedConsequence | 임계치 규칙이 위반될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | 임계치 규칙이 위반될 때 수행할 작업입니다. 예를 들어 경고를 보내거나 보고서를 생성합니다. 적용된 작업은 인스턴스마다 다를 수 있습니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | 적용된 작업을 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-POST-serviceTest__ul_kss_txv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.appliedConsequence.description | 적용된 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.id | 적용된 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.appliedConsequence.name | 적용된 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComparatorExact | 값이 의 값 conformanceTargetExact과 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 동일합니다. * false: 값이 동일하지 않습니다. {#servicetestmgmt-POST-serviceTest__ul_uss_txv_xbc} 데이터 유형: 부울 기본값: false | | testMeasure.ruleViolation.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 다음과 같음 {#servicetestmgmt-POST-serviceTest__ul_fts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 다음과 같음 * 보다 작음 {#servicetestmgmt-POST-serviceTest__ul_mts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 임계치를 초과했는지 또는 더 이상 초과하지 않는지 여부를 결정합니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.description | 임계치 규칙 위반에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasure.ruleViolation.id | 임계치 규칙 위반의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 위반 \[sn_st_mgmt_threshold_rule_violation\] | | testMeasure.ruleViolation.name | 임계치 규칙 위반의 이름입니다. 날짜 유형: 문자열 | | testMeasure.ruleViolation.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대: 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 낮음 * 보통 {#servicetestmgmt-POST-serviceTest__ul_tts_txv_xbc} 데이터 유형: 문자열 | | testMeasure.ruleViolation.tolerancePeriod | 결과가 시작되기 전에 허용된 교차가 발생할 수 있는 기간 또는 시간 간격입니다. 날짜 유형: 객체 "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | 기간의 양(수)입니다. 데이터 유형: 숫자 | | testMeasure.ruleViolation.tolerancePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-POST-serviceTest__ul_my3_qds_dcc} 데이터 유형: 문자열 | | testMeasure.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasure.value | 테스트의 메트릭 값입니다. 데이터 유형: 객체 "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } | | testMeasure.value.id | 테스트의 메트릭 값 ID입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트에 있는 메트릭 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.name | 테스트에 있는 메트릭 값의 이름입니다. 데이터 유형: 문자열 | | testMeasure.value.value | 테스트의 메트릭 값입니다. 데이터 유형: 문자열 | | testMeasure.value.valueType | 숫자, 텍스트 등의 테스트 측정 값 유형입니다. 데이터 유형: 문자열 | | 테스트 사양 | 이 테스트와 관련된 테스트 정의입니다. 데이터 유형: 객체 "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | 서비스 테스트 정의에 대한 하이퍼링크 참조입니다. 데이터 유형: 문자열 | | testSpecification.id | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 종료 날짜 및 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 시작 날짜 및 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] {#servicetestmgmt-POST-serviceTest__table_qzk_r2p_qbc} ### cURL 요청 {#servicetestmgmt-POST-serviceTest__example_x42_qf1_qbc} 다음 예시에서는 요청 본문에 제공된 특정 상세 정보에 따라 새 서비스 테스트를 만듭니다. curl "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data { "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "Yes" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } 응답은 새 테스트 서비스에 대한 확인 상세 정보를 반환하고 고유 ID인 2b406ec043b202104fefe4511fb8f211을 할당합니다. { "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "Yes" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ], "id": "2b406ec043b202104fefe4511fb8f211" } ## 서비스 테스트 관리 Open API - POST /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification {#ariaid-title9} 새 서비스 테스트 정의를 작성합니다. ### URL 형식 기본 URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification ### 지원되는 요청 매개변수 {#servicetestmgmt-POST-serviceTestSp__entry__2} | 이름 | 설명 | |-|-| | 없음 | | [표 44. 경로 매개변수] {#servicetestmgmt-POST-serviceTestSp__entry__6} | 이름 | 설명 | |-|-| | 안 함 | | [표 45. 쿼리 매개변수] {#servicetestmgmt-POST-serviceTestSp__id_thr_xwn_qbc__entry__2}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristics-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristics.characteristicValueSpecification-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.value-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.descr-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.valueType-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.captureFrequency-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.captureMethod-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod.amount-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod.units-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.metricDescription-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.metricName-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorExact-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorLower-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorUpper-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetExact-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetLower-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetUpper-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.prescribeAction-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.repeatAction-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.numberOfAllowedCrossing-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.thresholdRuleSeverity-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.unitOfMeasure-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor.startDateTime-param} | 이름 | 설명 | |-|-| | 설명 | 서비스 테스트 정의에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 정의 \[sn_st_mgmt_test_definition\] | | 이름 | 필수 서비스 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 사양 | 필수 테스트 정의의 서비스 사양입니다. 데이터 유형: 객체 배열 "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | 서비스 사양의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 사양 \[sn_prd_pm_specification\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedServiceSpecification.name | 서비스 사양의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship | 관련 서비스 테스트 정의입니다. 데이터 유형: 객체 배열 "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | 관련 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 정의 \[sn_st_mgmt_test_definition\] 테이블의 sys_id 또는 external_id 필드 | | serviceTestSpecRelationship.name | 관련 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship.relationshipType | 관계의 유형입니다. 유효한 값은 다음과 같습니다. * 종속성 * 독점성 * 대체 데이터 유형: 문자열 | | specCharacteristic | 테스트 정의의 특성입니다. 데이터 유형: 객체 배열 "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | 특성의 가능한 값입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | 특성의 값입니다. 데이터 유형: 문자열 | | specCharacteristic.description | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | specCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | specCharacteristic.validFor | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | 특성의 종료 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.validFor.startDateTime | 특성의 시작 날짜입니다. 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. 데이터 유형: 문자열 | | specCharacteristic.valueType | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-POST-serviceTestSp__ul_i3m_twr_dcc} 데이터 유형: 문자열 | | testMeasureDefinition | 이 서비스 테스트 정의에 대한 테스트 측정 정의입니다. 자세한 내용은 [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | 메트릭을 캡처할 빈도입니다. 유효한 값은 다음과 같습니다. * 매일 * 월별 * 없음 * 한 번 * 주별 {#servicetestmgmt-POST-serviceTestSp__ul_lsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * none: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-POST-serviceTestSp__ul_gsw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.capturePeriod | 메트릭 캡처의 기간 또는 기간입니다. 데이터 유형: 객체 "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | 캡처 기간 수입니다. 데이터 유형: 숫자 | | testMeasureDefinition.capturePeriod.units | 기간의 단위입니다. 유효한 값은 다음과 같습니다. * 일 * 시간 * 분 * 초 {#servicetestmgmt-POST-serviceTestSp__ul_rn1_3ds_dcc} 데이터 유형: 문자열 | | testMeasureDefinition.id | 테스트 측정 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 정의 테이블 \[sn_st_mgmt_test_measure_definition\] | | testMeasureDefinition.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.metricName | 테스트 측정에 있는 메트릭의 사용자 정의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.name | 테스트 측정 정의의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule | 테스트 측정 정의에서 임계치를 초과(또는 초과하지 않음)할 때 결과를 적용하기 전에 달성할 조건을 정의하는 규칙입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 { "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | 값이 대해 설정된 testMeasureDefinition.thresholdRule.conformanceTargetExact값과 동일한지 여부를 나타내는 플래그입니다. true로 설정된 경우 testMeasureDefinition.thresholdRule.conformanceTargetExact 필수입니다. 유효한 값은 다음과 같습니다. * true: 값이 의 값과 동일합니다.conformanceTargetExact * false: 값이 동일 conformanceTargetExact하지 않습니다. {#servicetestmgmt-POST-serviceTestSp__ul_bsw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 보다 크거나 같음 {#servicetestmgmt-POST-serviceTestSp__ul_zrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 보다 작거나 같음 {#servicetestmgmt-POST-serviceTestSp__ul_wrw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.consequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 자세한 내용은 [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) 문서를 참조하십시오. 데이터 유형: 객체 배열 "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.id | 측정 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.name | 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | 임계치 위반에 대해 수행할 사용자 정의 작업입니다. 작업은 인스턴스마다 다릅니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.repeatAction | 적용된 결과를 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-POST-serviceTestSp__ul_srw_jxv_xbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.consequence.validFor | 결과가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | 결과의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | 결과의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.id | 임계치 규칙의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 \[sn_st_mgmt_threshold_rule\] 테이블의 sys_id 또는 external_id 필드 | | testMeasureDefinition.thresholdRule.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | 임계치 규칙의 심각도 수준입니다. 유효한 값은 다음과 같습니다. * 높음 * 보통 * 낮음 {#servicetestmgmt-POST-serviceTestSp__ul_orw_jxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasureDefinition.validFor | 테스트 측정 정의가 유효한 날짜 범위입니다. 데이터 유형: 문자열 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | 테스트 측정 정의의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.validFor.startDateTime | 테스트 측정 정의의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 유효한대상 | 테스트 정의가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | validFor.endDateTime | 테스트 정의의 상태가 폐기된 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 상태가 게시되는 테스트 정의의 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [표 46. 요청 본문 매개변수(XML 또는 JSON)] {#servicetestmgmt-POST-serviceTestSp__id_thr_xwn_qbc} ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-POST-serviceTestSp__entry__126}{#servicetestmgmt-POST-serviceTestSp__accept-JSON-only-entry-RESTAPI}{#servicetestmgmt-POST-serviceTestSp__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 47. 요청 헤더] {#servicetestmgmt-POST-serviceTestSp__entry__132} | 머리글 | 설명 | |-|-| | 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 48. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#servicetestmgmt-POST-serviceTestSp__entry__136}{#servicetestmgmt-POST-serviceTestSp__entry-200-status-code}{#servicetestmgmt-POST-serviceTestSp__entry-400-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | [표 49. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#servicetestmgmt-POST-serviceTestSp__table_qqg_3s4_qbc__entry__2} | 이름 | 설명 | |-|-| | 설명 | 서비스 테스트 정의에 대한 설명입니다. 데이터 유형: 문자열 | | ID | 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 서비스 테스트 \[sn_st_mgmt_test\] | | 이름 | 서비스 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | 관련 서비스 사양 | 테스트 정의에 대한 서비스 사양입니다. 데이터 유형: 객체 배열 "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | 서비스 사양의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 사양 \[sn_prd_pm_specification\] 테이블의 sys_id 또는 external_id 필드에 있습니다. | | relatedServiceSpecification.name | 서비스 사양의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship | 관련 서비스 테스트 정의입니다. 데이터 유형: 객체 배열 "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | 관련 서비스 테스트 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 정의 \[sn_st_mgmt_test_definition\] | | serviceTestSpecRelationship.name | 관련 테스트 정의의 이름입니다. 데이터 유형: 문자열 | | serviceTestSpecRelationship.relationshipType | 관계의 유형입니다. 허용되는 값: * 종속성 * 독점성 * 대체 {#servicetestmgmt-POST-serviceTestSp__ul_hpg_xtr_dcc} 데이터 유형: 문자열 | | specCharacteristic | 테스트 정의 특성입니다. 데이터 유형: 객체 배열 "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | 특성의 가능한 값입니다. 데이터 유형: 객체 배열 "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | 특성의 값입니다. 데이터 유형: 문자열 | | specCharacteristic.description | 특성에 대한 설명입니다. 데이터 유형: 문자열 | | specCharacteristic.name | 특성의 이름입니다. 데이터 유형: 문자열 | | specCharacteristic.validFor | 특성이 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | 특성의 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | specCharacteristic.validFor.startDateTime | 특성의 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | specCharacteristic.valueType | 특성 값의 유형입니다. * 선택 * 날짜 * 날짜/시간 * 기간 * 이메일 * 레이블 * 단일 라인 테스트 * 예/아니요 {#servicetestmgmt-POST-serviceTestSp__ul_uwb_5wr_dcc} 데이터 유형: 문자열 | | testMeasureDefinition | 이 서비스 테스트 정의에 대한 테스트 측정 정의입니다. 자세한 내용은 다음을 참조하십시오 [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=australia&pubname=australia-telecom-media-technology&ft:locale=en-US) . 데이터 유형: 객체 배열 "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | 메트릭을 캡처할 빈도입니다. 유효한 값은 다음과 같습니다. * 매일 * 월별 * 없음 * 한 번 * 주별 {#servicetestmgmt-POST-serviceTestSp__ul_od2_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.captureMethod | 메트릭을 캡처하는 데 사용되는 방법입니다. 유효한 값은 다음과 같습니다. * automatic: 메트릭을 자동으로 캡처합니다. * 수동: 메트릭을 수동으로 캡처합니다. * 없음: 메트릭을 캡처하지 않습니다. {#servicetestmgmt-POST-serviceTestSp__ul_rd2_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.capturePeriod | 캡처의 기간 또는 기간입니다. 데이터 유형: 객체 "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | 캡처 기간 수입니다. 데이터 유형: 숫자 | | testMeasureDefinition.capturePeriod.units | 기간의 단위입니다. 허용되는 값: * 일 * 시간 * 분 * 초 {#servicetestmgmt-POST-serviceTestSp__ul_lfv_dds_dcc} 데이터 유형: 문자열 | | testMeasureDefinition.id | 테스트 측정 정의의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 테스트 측정 정의 \[sn_st_mgmt_test_measure_definition\] | | testMeasureDefinition.metricDescription | 메트릭에 대한 간략한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.metricName | 테스트 측정에 있는 메트릭의 사용자 정의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.name | 테스트 측정 정의의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule | 특정 테스트 측정 정의에 대해 임계치를 초과하거나 초과하지 않을 때 결과를 적용하기 위해 달성할 조건(상승 또는 해제)을 정의하는 규칙입니다. 데이터 유형: 객체 배열 { "thresholdRule": { "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | 값이 의 값 conformanceTargetExact과 동일한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 값이 의 값과 동일합니다.conformanceTargetExact * false: 값이 동일 conformanceTargetExact하지 않습니다. {#servicetestmgmt-POST-serviceTestSp__ul_gyl_vqr_dcc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | 값이 임계치 아래로 떨어지는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 큼 * 다음과 같음 {#servicetestmgmt-POST-serviceTestSp__ul_b22_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | 값이 임계치를 초과하는지 확인하는 연산자입니다. 유효한 값은 다음과 같습니다. * 보다 작음 * 다음과 같음 {#servicetestmgmt-POST-serviceTestSp__ul_e22_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.conformanceTargetExact | true로 설정된 경우 conformanceComparatorExact 필요합니다. conformanceComparatorExact 값이 true로 설정되면 해당 값은 에 정의된 conformanceTargetExact값과 일치합니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetLower | 테스트 측정 결과를 비교하기 위한 하한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | 테스트 측정 결과를 비교하기 위한 상한 임계값입니다. 데이터 유형: 숫자 | | testMeasureDefinition.thresholdRule.consequence | 임계치 규칙이 초과될 때 수행할 작업(규정된 작업 또는 알림)입니다. 데이터 유형: 객체 배열 "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | 결과에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.id | 측정 결과의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.name | 결과의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | 임계치 위반에 대해 수행할 사용자 정의 작업입니다. 작업은 인스턴스마다 다릅니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.consequence.repeatAction | 적용된 작업을 반복할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 작업을 반복합니다. * false: 작업을 반복하지 않습니다. {#servicetestmgmt-POST-serviceTestSp__ul_rjm_pxy_rbc} 데이터 유형: 부울 기본값: false | | testMeasureDefinition.thresholdRule.consequence.validFor | 결과가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | 결과의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | 결과의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.thresholdRule.description | 임계치 규칙에 대한 설명입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.id | 임계치 규칙의 Sys_id 또는 external_id입니다. 데이터 유형: 문자열 테이블: 임계치 규칙 \[sn_st_mgmt_threshold_rule\] | | testMeasureDefinition.thresholdRule.name | 임계치 규칙의 이름입니다. 데이터 유형: 문자열 | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | 결과가 적용되기 전 허용 오차 기간 내에 허용되는 최대 교차입니다. 데이터 유형: 숫자 최대값: 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | 임계치 규칙의 심각도입니다. 유효한 값은 다음과 같습니다. * 높음 * 낮음 * 보통 {#servicetestmgmt-POST-serviceTestSp__ul_j22_sxv_xbc} 데이터 유형: 문자열 | | testMeasureDefinition.unitOfMeasure | 서비스의 성과를 계산하는 데 사용되는 시간의 측정 가능한 값(일, 분, 초)입니다. 데이터 유형: 문자열 | | testMeasureDefinition.validFor | 테스트 측정 정의가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | 테스트 측정 정의의 유효 종료 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | testMeasureDefinition.validFor.startDateTime | 테스트 측정 정의의 유효 시작 날짜입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | 유효한대상 | 서비스 테스트가 유효한 날짜 범위입니다. 데이터 유형: 객체 "validFor": { "endDateTime ": "String", "startDateTime": "String" } | | validFor.endDateTime | 서비스 테스트의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | | validFor.startDateTime | 서비스 테스트의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD 00:00:00. 예: `2025-01-31 09:35:43`. | [ ] {#servicetestmgmt-POST-serviceTestSp__table_qqg_3s4_qbc} ### cURL 요청 다음 예시에서는 새 서비스 테스트 정의를 만듭니다. curl "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user 'username':'password' -- data { "description": "Upstream and Downstream speed ", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", }, { "value": "Yes", } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } 응답 본문. { "description": "Upstream and Downstream speed ", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] "id": "89d2b920432a02104fefe4511fb8f22e" }