---
sourceDocument: 호주 애플리케이션 빌드 또는 수정
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 애플리케이션 빌드 또는 수정

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 애플리케이션 CLI 및 API와 함께 CMDB 설치되는 명령어

# 애플리케이션 CLI 및 API와 함께 CMDB 설치되는 명령어 {#ariaid-title1}

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

app-cmdb-api-cli 플러그인이 설치될 때 사용할 수 있는 ServiceNow CLI 명령 및 명령 그룹입니다.

## 스토어에서 앱 요청 {#cmdb-cli-commands__id_lzg_lxy_pqb}

사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 [ServiceNow Store 버전 기록 릴리스 정보](https://docs.servicenow.com/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html)를 참조하십시오.{#cmdb-cli-commands__inline-send-to-store}
기업 전체의 자동화를 지원하는 중요한 작업을 스크립팅하기 위해 API를 활용하거나 사용자 인터페이스를 사용하는 대신 CMDB 애플리케이션 CLI 및 API 스토어 앱에서 제공하는 명령줄 작업을 실행할 수 있습니다. CMDB 애플리케이션 CLI 및 API 스토어 앱은 애플리케이션 서비스와 관련된 모든 API와 해당 API에 대한 인터페이스에 액세스할 수 있는 명령줄을 통합하는 강력한 프레임워크를 제공합니다.

CMDB 애플리케이션 CLI 및 API 명령을 사용하면 다음 작업을 사용할 수 있습니다.

* 애플리케이션 서비스 등록 및 생성 및 업스트림 관계 설정
* 지정된 애플리케이션 서비스 및 업스트림 관계에 대한 상세 정보 가져오기
* 비즈니스 애플리케이션 및 비즈니스 서비스 오퍼링과 같은 상위 수준 구성 연결
* 지정된 채우기 유형으로 애플리케이션 서비스 채우기
* 애플리케이션 서비스의 상태 변경

{#cmdb-cli-commands__ul_fzw_bgj_3qb}

REST API 솔루션은 [SG Services API](https://www.servicenow.com/docs/access?context=sg_services-api&version=australia&pubname=australia-api-reference&ft:locale=en-US)를 참조하십시오.

## 애플리케이션 서비스 변환 {#cmdb-cli-commands__section_xtm_tdk_ppb}

수동 또는 빈 유형 애플리케이션 서비스를 계산된 애플리케이션 서비스로 변환합니다. 변환하는 동안 애플리케이션 서비스 기록은 새로 할당된 클래스가 있는 \[cmdb_ci_service_calculated\] 테이블로 이동합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_cqd_5mb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service convert --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service convert --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__ol_qk4_msd_3qb}  
    {#cmdb-cli-commands__table_lhc_n2d_3qb__entry__2}{#cmdb-cli-commands__sg_svcs-reqParm-ire-ph}{#cmdb-cli-commands__sg_svcs-reqParm-number-ph}

    | 이름 | 설명 |
    |-|-|
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 수준 | 변환에 포함할 수준의 수입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | sys_id | 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    [표 1. JSON 객체 속성]

    {#cmdb-cli-commands__table_lhc_n2d_3qb}

Mac OS의 예
:

        snc service-graph app-service convert --data '{"name":"Test Register","environment":"Test","version":"1.0","levels":8}'

Windows OS의 예
:

        snc service-graph app-service convert --data "{"name":"Test Register","environment":"Test","version":"1.0","levels":8}"


값 반환
:

        {
          "result": {
          "status": "success"
          }
        }

## 애플리케이션 서비스 관계 생성 {#cmdb-cli-commands__section_ikm_mvc_gqb}

비즈니스 애플리케이션, 비즈니스 서비스 오퍼링 및 기타 애플리케이션 서비스와 같은 업스트림 관계를 구축합니다. 이 명령을 실행하면 단일 상위 객체와 해당 하위 객체로 입력을 받는 관계가 생성됩니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_f3n_5mb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service create-relationship --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service create-relationship --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_ty2_q2d_3qb__entry__2}

    | 이름 | 설명 |
    |-|-|
    | 하위 | 관계를 만들 하위 애플리케이션 서비스를 식별하는 정보입니다. 하위 항목은 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 있습니다. 동적 CI 그룹은 하위로 추가할 수 있지만 상위가 될 수는 없습니다. 데이터 유형: 객체 "child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" } |
    | child.\<IRE 필드 이름\> | 하위 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 자식.번호 | 하위 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | child.sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\]에 나열된 하위 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    | 상위 | 관계를 생성할 상위 애플리케이션 서비스를 식별하는 상세 정보입니다. 데이터 유형: 객체 "parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" } |
    | parent.\<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 상위.번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | parent.sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\]에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    | parent.class_name | 애플리케이션 서비스를 포함하는 클래스의 이름입니다. 상위 클래스 이름은 다음 테이블 중 하나에서 가져와야 합니다. * cmdb_ci_service_auto * cmdb_ci_service_discovered * cmdb_ci_service_by_tags * cmdb_ci_service_calculated * service_offering * cmdb_ci_business_app {#cmdb-cli-commands__ul_xlk_nc1_hqb} 기본값: cmdb_ci_service_auto 데이터 유형: 문자열 |
    [표 2. JSON 객체 속성]

    {#cmdb-cli-commands__table_ty2_q2d_3qb}

Mac OS의 예
:

        snc service-graph app-service create-relationship --data '{"child":{"name":"wdfsdf","environment":"Test","version":"1.0"},"parent":{"sys_id":"abcdefg","name":"business App1","class_name":"service_offering"}}'

Windows OS의 예
:

        snc service-graph app-service create-relationship --data "{"child":{"name":"wdfsdf","environment":"Test","version":"1.0"},"parent":{"sys_id":"abcdefg","name":"business App1","class_name":"service_offering"}}"


값 반환
:

        {
          "result": {
          "status": "success"
          }
        }

## 애플리케이션 서비스 삭제 {#cmdb-cli-commands__section_y2p_mvc_gqb}

애플리케이션 서비스를 삭제합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_sr5_5mb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service delete --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service delete --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_icm_q2d_3qb__entry__2}{#cmdb-cli-commands__d3069e239}{#cmdb-cli-commands__d3069e263}{#cmdb-cli-commands__sg_svcs-reqParm-sysid-ph}

    | 이름 | 설명 |
    |-|-|
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    [표 3. JSON 객체 속성]

    {#cmdb-cli-commands__table_icm_q2d_3qb}

Mac OS의 예
:

        snc service-graph app-service delete --data '{"name":"Test Register","environment":"Test","version":"1.0"}'

Windows OS의 예
:

        snc service-graph app-service delete --data "{"name":"Test Register","environment":"Test","version":"1.0"}"


값 반환
:

        {
          "result": {
          "status": "success"
          }
        }

## 애플리케이션 서비스 관계 삭제 {#cmdb-cli-commands__section_n3r_mvc_gqb}

애플리케이션 서비스 업스트림 관계를 삭제합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_n4d_vmb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service delete-relationship --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service delete-relationship --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_mwt_q2d_3qb__entry__2}{#cmdb-cli-commands__d3069e574}

    | 이름 | 설명 |
    |-|-|
    | 하위 | 서비스 애플리케이션에서 삭제할 하위 관계를 설명하는 정보입니다. 데이터 유형: 객체 "child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" } |
    | child.\<IRE 필드 이름\> | 하위 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 자식.번호 | 하위 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | child.sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\]에 나열된 하위 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    | 상위 | 관계를 제거할 상위 애플리케이션 서비스를 식별하는 상세 정보입니다. 데이터 유형: 객체 "parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" } |
    | parent.\<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 상위.번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | parent.sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    | parent.class_name | 애플리케이션 서비스를 포함하는 클래스의 이름입니다. 상위 클래스 이름은 다음 테이블 중 하나에서 가져와야 합니다. * cmdb_ci_service_auto * cmdb_ci_service_discovered * cmdb_ci_service_by_tags * cmdb_ci_service_calculated * service_offering * cmdb_ci_business_app {#cmdb-cli-commands__ul_ktf_45d_3qb} 기본값: cmdb_ci_service_auto 데이터 유형: 문자열 |
    [표 4. JSON 객체 속성]

    {#cmdb-cli-commands__table_mwt_q2d_3qb}

Mac OS의 예
:

        snc service-graph app-service delete-relationship --data '{"child":{"name":"Test Register","environment":"Test","version":"1.0"},"parent":{"name":"business Service Offering1","class_name":"service_offering"}}'

Windows OS의 예
:

        snc service-graph app-service delete-relationship --data "{"child":{"name":"Test Register","environment":"Test","version":"1.0"},"parent":{"name":"business Service Offering1","class_name":"service_offering"}}"


값 반환
:

        {
          "result": {
          "status": "success"
          }
        }

## 애플리케이션 서비스 찾기 {#cmdb-cli-commands__section_mss_mvc_gqb}

지정된 애플리케이션 서비스 및 업스트림 관계의 상세 정보를 찾습니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_yjr_vmb_3qb}  

필요한 역할
:   app_service_admin - 이 역할은 애플리케이션 서비스를 무제한으로 볼 수 있도록 합니다.
:   app_service_user - 이 역할은 운영 상태의 애플리케이션 서비스 보기만 제공합니다.
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service find --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service find --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_wb1_r2d_3qb__entry__2}{#cmdb-cli-commands__d3069e239}{#cmdb-cli-commands__d3069e263}{#cmdb-cli-commands__d3069e574}

    | 이름 | 설명 |
    |-|-|
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    [표 5. JSON 객체 속성]

    {#cmdb-cli-commands__table_wb1_r2d_3qb}

Mac OS의 예
:

        snc service-graph app-service find --data '{"name" : "Test App Service1"}'

Windows OS의 예
:

        snc service-graph app-service find --data "{"name" : "Test App Service1"}"


값 반환
:

        {
          "result": {
            "aliases": null,
            "asset": null,
            "asset_tag": null,
            "assigned": "",
            "assigned_to": null,
            "assignment_group": null,
            "attestation_score": null,
            "attested": "0",
            "attested_by": null,
            "attested_date": "",
            "attributes": null,
            "bucket": null,
            "business_contact": null,
            "business_need": null,
            "business_relation_manager": null,
            "business_unit": null,
            "busines_criticality": "4 - not critical",
            "can_print": "0",
            "category": null,
            "change_control": null,
            "checked_in": "",
            "checked_out": "",
            "checkout": null,
            "comments": null,
            "company": null,
            "compatibility_dependencies": null,
            "consumer_type": "internal",
            "correlation_id": null,
            "cost": null,
            "cost_cc": "USD",
            "cost_center": null,
            "delivery_date": "",
            "delivery_manager": null,
            "department": null,
            "discovery_source": "Manual Entry",
            "dns_domain": null,
            "due": "",
            "due_in": null,
            "duplicate_of": null,
            "end_date": "",
            "environment": null,
            "fault_count": "0",
            "first_discovered": "2021-07-19 20:09:48",
            "fqdn": null,
            "gl_account": null,
            "hide_from_dashboard": "0",
            "install_date": "",
            "install_status": "1",
            "invoice_number": null,
            "ip_address": null,
            "justification": null,
            "last_discovered": "2021-07-19 20:09:48",
            "last_review_date": "",
            "layer": null,
            "lease_id": null,
            "life_cycle_stage": null,
            "life_cycle_stage_status": null,
            "location": null,
            "mac_address": null,
            "maintenance_schedule": null,
            "managed_by": null,
            "managed_by_group": null,
            "manufacturer": null,
            "model_id": null,
            "model_number": null,
            "monitor": "0",
            "monitoring_requirements": null,
            "name": "Test App Service1",
            "number": "SNSVC0001014",
            "operational_status": "2",
            "order_date": "",
            "owned_by": null,
            "parent": null,
            "portfolio_status": "pipeline",
            "po_number": null,
            "prerequisites": null,
            "price_model": "per_unit",
            "price_unit": null,
            "published_ref": null,
            "purchase_date": "",
            "schedule": null,
            "serial_number": null,
            "service_classification": "Application Service",
            "service_level_requirement": null,
            "service_owner_delegate": null,
            "service_status": "requirements",
            "severity": null,
            "short_description": null,
            "skip_sync": "0",
            "sla": null,
            "spm_service_portfolio": null,
            "spm_taxonomy_node": null,
            "stakeholders": null,
            "start_date": "",
            "state": null,
            "subcategory": null,
            "supported_by": null,
            "support_group": null,
            "sys_class_name": "cmdb_ci_service_auto",
            "sys_class_path": "/!!/!7/!(",
            "sys_created_by": "admin",
            "sys_created_on": "2021-07-19 20:09:48",
            "sys_domain": "global",
            "sys_domain_path": "/",
            "sys_id": "a2f0618040697410f87713b656474255",
            "sys_mod_count": "0",
            "sys_updated_by": "admin",
            "sys_updated_on": "2021-07-19 20:09:48",
            "unit_description": null,
            "unverified": "0",
            "used_for": "Production",
            "user_group": null,
            "vendor": null,
            "version": null,
            "view_service": "61e1cb757f23220002d31ccebefa9120",
            "warranty_expiration": "",
            "relationships": [
              {
                "name": "Test Biz App1",
                "sys_id": "0250a94040697410f87713b656474250",
                "number": "APM0001001",
                "class_name": "cmdb_ci_business_app",
                "relationship": "Consumes::Consumed by"
              },
              {
                "name": "Tech Service Offering1",
                "sys_id": "98d0ed4040697410f87713b6564742ef",
                "number": "BSN0001005",
                "class_name": "service_offering",
                "relationship": "Contains::Contained by"
              }
            ]
          }
        }

## 애플리케이션 서비스 채우기 {#cmdb-cli-commands__section_ext_mvc_gqb}

애플리케이션 서비스에 서비스 채우기 방법을 입력합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_l1y_vmb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service populate --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service populate --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_acn_r2d_3qb__entry__2}{#cmdb-cli-commands__d3069e239}{#cmdb-cli-commands__d3069e263}{#cmdb-cli-commands__d3069e574}

    | 이름 | 설명 |
    |-|-|
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | population_method | 필수 채우기 컨텐츠를 식별하기 위해 채우기 메서드와 그에 수반되는 속성을 식별합니다. 유형당 하나의 수반 객체만 유효합니다. 데이터 유형: 객체 |
    | population_method.group_id | cmdb_group 채우기 유형으로 구성된 CMDB 그룹의 그룹 ID입니다. 데이터 유형: "문자열" "population_method": { "group_id": "String", "type": "cmdb_group" } 연결된 모집단 유형: cmdb_group |
    | population_method.levels | 서비스를 빌드하는 데 사용할 수준의 수입니다. 수준 값이 제공되지 않은 경우 시스템은 sys_property에서 값을 확인합니다. svc.manual.convert.levels.default_value 채워지지 않은 경우 기본값 3이 사용됩니다. 데이터 유형: 숫자 "population_method": { "levels": Number, "type": "dynamic_service" } 연결된 모집단 유형: dynamic_service 기본값: sys_property에 대해 수준 값이 설정되지 않은 경우 3 |
    | population_method.service_candidate | 서비스 후보의 고유 식별자입니다. 데이터 유형: 문자열 "population_method": { "service_candidate": "String", "type": "tag_based_service_family" } 연결된 모집단 유형: tag_based_service_family |
    | population_method.service_relations | 애플리케이션 서비스 내의 CI에 대한 계층 구조 데이터를 포함하는 객체의 목록입니다. 모든 CI는 상위 및 하위 CI와 쌍을 형성합니다. 애플리케이션 서비스의 엔트리포인트라고 하는 최상위 CI에는 상위 CI가 없습니다. 데이터 유형: 배열 "population_method": { "service_relations":[ { "child": "String", "parent": "String" } ], "type": "service_hierarchy" } 연결된 모집단 유형: service_hierarchy |
    | population_method.service_relations.child | CI와 관련된 하위 CI의 이름입니다. 데이터 유형: 문자열 |
    | population_method.service_relations.parent | CI와 관련된 상위 CI의 이름입니다. 데이터 유형: 문자열 |
    | population_method.tags | CI와 연결할 태그를 포함하는 객체의 목록입니다. 이 정보는 키 값 \[cmdb_key_value\] 테이블에 있습니다. 데이터 유형: 배열 "population_method": { "tags": [ { "tag": "String", "value": "String" } ], "type": "tag_list" } 연결된 모집단 유형: tag_list |
    | population_method.tags.tag | 태그 이름입니다. 데이터 유형: 문자열 |
    | population_method.tags.value | 태그 값입니다. 데이터 유형: 문자열 |
    | population_method.type | 필수 애플리케이션 서비스에 추가할 인구 유형입니다. 데이터 유형: 객체 유효한 값은 다음과 같습니다. * cmdb_group * service_hierarchy * dynamic_service * tag_list * tag_based_service_family {#cmdb-cli-commands__ul_f2v_4by_gqb} |
    | sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    [표 6. JSON 객체 속성]

    {#cmdb-cli-commands__table_acn_r2d_3qb}

Mac OS의 예
:

        snc service-graph app-service populate --data '{"name":"Test Register","environment":"Test","version":"1.0","population_method":{"group_id":"String","type":"cmdb_group"}}'

Windows OS의 예
:

        snc service-graph app-service populate --data "{"name":"Test Register","environment":"Test","version":"1.0","population_method":{"group_id":"String","type":"cmdb_group"}}"


값 반환
:

        {
          "result": {
          "status": "success"
          }
        }

## 애플리케이션 서비스 등록 {#cmdb-cli-commands__section_zcv_mvc_gqb}

애플리케이션 서비스를 생성하고 태그를 지정하고 비즈니스 애플리케이션, 비즈니스 서비스 오퍼링 및 기타 애플리케이션 서비스와 같은 업스트림 관계를 구성합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_j2g_shb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service register --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service register --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_mrr_r2d_3qb__entry__2}{#cmdb-cli-commands__d3069e239}{#cmdb-cli-commands__d3069e263}{#cmdb-cli-commands__d3069e574}

    | 이름 | 설명 |
    |-|-|
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | 관계 | 유형별로 분류된 업스트림 관계입니다. 데이터 유형: 객체 "relationships": { "business_app": [Array], "business_service_offering": [Array], "parent_app_service": [Array], "technical_service_offering": [Array] } 최대 관계 수는 25입니다. |
    | relationships.business_app | 비즈니스 애플리케이션 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목 중 하나를 키-값 쌍으로 사용하여 정의할 수 있습니다. * \<IRE 필드 이름\> * 번호 * sys_id {#cmdb-cli-commands__ul_gh2_52y_gqb} 데이터 유형: 배열 |
    | relationships.business_service_offering | 비즈니스 서비스 오퍼링 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목을 키-값 쌍으로 사용하여 정의할 수 있습니다. * \<IRE 필드 이름\> * 번호 * sys_id {#cmdb-cli-commands__ul_hh2_52y_gqb} 데이터 유형: 배열 |
    | relationships.parent_app_service | 애플리케이션 서비스 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목을 키-값 쌍으로 사용하여 정의할 수 있습니다. * \<IRE 필드 이름\> * 번호 * sys_id {#cmdb-cli-commands__ul_jh2_52y_gqb} 데이터 유형: 배열 |
    | relationships.technical_service_offering | 기술 관리 오퍼링(이전의 기술 서비스 오퍼링) 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목을 키-값 쌍으로 사용하여 정의할 수 있습니다. * \<IRE 필드 이름\> * 번호 * sys_id {#cmdb-cli-commands__ul_ih2_52y_gqb} 데이터 유형: 배열 |
    | sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    | 태그 | 태그 정의를 키-값 쌍으로 포함하는 객체의 목록입니다. "tags": [ { "key": "String", "value": "String" }] 데이터 유형: 배열 |
    | tags.key | 태그 범주 이름입니다. 데이터 유형: 문자열 |
    | tags.value | 태그 값입니다. 데이터 유형: 문자열 |
    [표 7. JSON 객체 속성]

    {#cmdb-cli-commands__table_mrr_r2d_3qb}

Mac OS의 예
:

        snc service-graph app-service register --data '{"name":"Test Register","environment":"Test","version":"1.0","number":" SNSVC0001014","relationships":{"business_application":[{"sys_id":"0250a94040697410f87713b656474250"},{"number":"APM0001002"},{"name":"Test Biz App1"}],"business_service_offering":[{"sys_id":"ed32e98040697410f87713b656474259"}],"technical_service_offering":[{"sys_id":"80e12d8040697410f87713b65647421c"},{"number":"BSN0001005"},{"name":"Tech Service Offering2"}],"parent_app_service":[{"sys_id":"a2f0618040697410f87713b656474255"}]},"tags":[{"key":"key1","value":"value1"},{"key":"key2","value":"value2"}]}'

Windows OS의 예
:

        snc service-graph app-service register --data "{"name":"Test Register","environment":"Test","version":"1.0","number":" SNSVC0001014","relationships":{"business_application":[{"sys_id":"0250a94040697410f87713b656474250"},{"number":"APM0001002"},{"name":"Test Biz App1"}],"business_service_offering":[{"sys_id":"ed32e98040697410f87713b656474259"}],"technical_service_offering":[{"sys_id":"80e12d8040697410f87713b65647421c"},{"number":"BSN0001005"},{"name":"Tech Service Offering2"}],"parent_app_service":[{"sys_id":"a2f0618040697410f87713b656474255"}]},"tags":[{"key":"key1","value":"value1"},{"key":"key2","value":"value2"}]}"


값 반환
:

        {
          "result": {
            "app_service": {
              "sys_id": "99b2a54040697410f87713b6564742ad",
              "name": "Test Register",
              "number": "SNSVC0001014"
            },
            "message": "Service registered successfully",
            "status": "INSERT"
          }
        }

## 애플리케이션 서비스 업데이트 {#cmdb-cli-commands__section_fhw_mvc_gqb}

제공된 기존 애플리케이션 서비스를 업데이트하고 지정된 애플리케이션 서비스에 대한 태그를 생성합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_r3j_wmb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service update --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service update --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_vyz_r2d_3qb__entry__2}

    | 이름 | 설명 |
    |-|-|
    | \<업데이트할 필드 또는 태그\> | 키-값 쌍을 사용하여 업데이트할 각 필드 또는 태그를 식별합니다. 기본 정보만 업데이트할 수 있으며 업스트림 관계는 업데이트할 수 없습니다. 데이터 유형: 문자열 |
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\]에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    [표 8. JSON 객체 속성]

    {#cmdb-cli-commands__table_vyz_r2d_3qb}

Mac OS의 예
:

        snc service-graph app-service update --data '{"name": "Test Register", "version": "2.0"}'

Windows OS의 예
:

        snc service-graph app-service update --data "{"name": "Test Register", "version": "2.0"}"


값 반환
:

        {
          "result": {
            "sys_id": "99b2a54040697410f87713b6564742ad",
            "name": "Test Register",
            "number": "SNSVC0001014",
            "version": "2.0"
          }
        }

## 애플리케이션 서비스 상태 업데이트 {#cmdb-cli-commands__section_clr_dxc_gqb}

애플리케이션 서비스 수명주기 상태를 활성화, 비활성화 또는 폐기로 변경합니다.  
명령 그룹:

* 상위 그룹: service-graph
* 하위 그룹: app-service
{#cmdb-cli-commands__ul_v1r_wmb_3qb}  

필요한 역할
:   app_service_admin
:   서비스 매핑 관련 서비스를 사용하는 경우 사용자에게 해당 서비스 매핑 관련 서비스에 필요한 역할이 있어야 합니다.

Mac OS용 명령 구조
:

        snc service-graph app-service update-state --data '{JSON}'

Windows OS용 명령 구조
:

        snc service-graph app-service update-state --data "{JSON}"


인수

:   이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data

    CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.

    1. sys_id -- sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
    2. 숫자 -- sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
    3. \<IRE 필드 이름\> - sys_id 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    {#cmdb-cli-commands__d3069e193}  
    {#cmdb-cli-commands__table_xrh_s2d_3qb__entry__2}

    | 이름 | 설명 |
    |-|-|
    | \<IRE 필드 이름\> | 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다. 데이터 유형: 문자열 |
    | 번호 | 애플리케이션 서비스를 식별하는 고유 번호입니다. 데이터 유형: 문자열 |
    | 상태 | 필수 애플리케이션 서비스의 수명주기 상태입니다. 이러한 값은 서비스 인스턴스 \[cmdb_ci_service_auto\] 테이블에서 업데이트됩니다. 유효한 값은 다음과 같습니다. * 활성화 -- 수명주기가 작동 중이며 사용 중입니다. * operational_status=운영 * life_cycle_stage=운영 * life_cycle_stage_status=사용 중 {#cmdb-cli-commands__ul_xrz_wzd_3qb} * 비활성화 -- 수명주기가 운영되지 않으며 설계 단계에 있습니다. * operational_status=비운영 * life_cycle_stage=디자인 * life_cycle_stage_status=빌드 {#cmdb-cli-commands__ul_yrz_wzd_3qb} * 폐기 -- 수명 종료. * operational_status=폐기됨 * life_cycle_stage=수명 종료 * life_cycle_stage_status=폐기됨 {#cmdb-cli-commands__ul_zrz_wzd_3qb} {#cmdb-cli-commands__ul_wrz_wzd_3qb} 데이터 유형: 문자열 |
    | sys_id | 서비스 인스턴스 \[cmdb_ci_service_auto\]에 나열된 애플리케이션 서비스의 Sys_id입니다. 데이터 유형: 문자열 |
    [표 9. JSON 객체 속성]

    {#cmdb-cli-commands__table_xrh_s2d_3qb}

Mac OS의 예
:

        snc service-graph app-service update-state --data '{"name":"Test Register","environment":"Test","version":"1.0"}'

Windows OS의 예
:

        snc service-graph app-service update-state --data "{"name":"Test Register","environment":"Test","version":"1.0"}"


값 반환
:

        {
          "result": {
          "status": "success"
          }
        }