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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 34분

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

    스토어에서 앱 요청

    ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

    기업 전체의 자동화를 지원하는 중요한 작업을 스크립팅하기 위해 API를 활용하거나 사용자 인터페이스를 사용하는 대신 CMDB 애플리케이션 CLI 및 API 스토어 앱에서 제공하는 명령줄 작업을 실행할 수 있습니다. CMDB 애플리케이션 CLI 및 API 스토어 앱은 애플리케이션 서비스와 관련된 모든 API와 해당 API에 대한 인터페이스에 액세스할 수 있는 명령줄을 통합하는 강력한 프레임워크를 제공합니다.

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

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

    REST API 솔루션은 SG Services API를 참조하십시오.

    애플리케이션 서비스 변환

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 1. JSON 객체 속성
    이름 설명
    <IRE 필드 이름> 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다.

    데이터 유형: 문자열
    수준 변환에 포함할 수준의 수입니다.

    데이터 유형: 문자열
    번호 애플리케이션 서비스를 식별하는 고유 번호입니다.

    데이터 유형: 문자열
    sys_id 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 관계 생성

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 2. JSON 객체 속성
    이름 설명
    하위 관계를 만들 하위 애플리케이션 서비스를 식별하는 정보입니다. 하위 항목은 서비스 인스턴스 [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_ci_service_auto

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 삭제

    애플리케이션 서비스를 삭제합니다.

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 3. JSON 객체 속성
    이름 설명
    <IRE 필드 이름> 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다.

    데이터 유형: 문자열
    번호 애플리케이션 서비스를 식별하는 고유 번호입니다.

    데이터 유형: 문자열
    sys_id 서비스 인스턴스 [cmdb_ci_service_auto] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 관계 삭제

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 4. JSON 객체 속성
    이름 설명
    하위 서비스 애플리케이션에서 삭제할 하위 관계를 설명하는 정보입니다.

    데이터 유형: 객체

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

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 찾기

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 5. JSON 객체 속성
    이름 설명
    <IRE 필드 이름> 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다.

    데이터 유형: 문자열
    번호 애플리케이션 서비스를 식별하는 고유 번호입니다.

    데이터 유형: 문자열
    sys_id 서비스 인스턴스 [cmdb_ci_service_auto] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    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"
      }
    ]
  }
}

    애플리케이션 서비스 채우기

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 6. JSON 객체 속성
    이름 설명
    <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
    sys_id 서비스 인스턴스 [cmdb_ci_service_auto] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 등록

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 7. JSON 객체 속성
    이름 설명
    <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

    데이터 유형: 배열
    relationships.business_service_offering
    비즈니스 서비스 오퍼링 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목을 키-값 쌍으로 사용하여 정의할 수 있습니다.
    • <IRE 필드 이름>
    • 번호
    • sys_id

    데이터 유형: 배열
    relationships.parent_app_service
    애플리케이션 서비스 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목을 키-값 쌍으로 사용하여 정의할 수 있습니다.
    • <IRE 필드 이름>
    • 번호
    • sys_id

    데이터 유형: 배열
    relationships.technical_service_offering
    기술 관리 오퍼링(이전의 기술 서비스 오퍼링) 관계 유형을 나타내는 객체의 목록입니다. 이러한 값은 다음 항목을 키-값 쌍으로 사용하여 정의할 수 있습니다.
    • <IRE 필드 이름>
    • 번호
    • sys_id

    데이터 유형: 배열
    sys_id 서비스 인스턴스 [cmdb_ci_service_auto] 테이블에 나열된 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    태그 태그 정의를 키-값 쌍으로 포함하는 객체의 목록입니다.
    "tags": [
 {
  "key": "String",
  "value": "String"
 }]

    데이터 유형: 배열
    tags.key 태그 범주 이름입니다.

    데이터 유형: 문자열
    tags.value 태그 값입니다.

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 업데이트

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 8. JSON 객체 속성
    이름 설명
    <업데이트할 필드 또는 태그> 키-값 쌍을 사용하여 업데이트할 각 필드 또는 태그를 식별합니다.

    기본 정보만 업데이트할 수 있으며 업스트림 관계는 업데이트할 수 없습니다.

    데이터 유형: 문자열
    <IRE 필드 이름> 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다.

    데이터 유형: 문자열
    번호 애플리케이션 서비스를 식별하는 고유 번호입니다.

    데이터 유형: 문자열
    sys_id 서비스 인스턴스 [cmdb_ci_service_auto]에 나열된 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    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"
  }
}

    애플리케이션 서비스 상태 업데이트

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

    명령 그룹:
    • 상위 그룹: service-graph
    • 하위 그룹: app-service
    필요한 역할
    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 또는 번호가 제공되지 않은 경우에만 시스템에서 이 값을 사용합니다.
    표 9. JSON 객체 속성
    이름 설명
    <IRE 필드 이름> 애플리케이션 서비스를 식별하는 하나 이상의 IRE 필드입니다. 예를 들어 이름 또는 버전입니다.

    데이터 유형: 문자열
    번호 애플리케이션 서비스를 식별하는 고유 번호입니다.

    데이터 유형: 문자열
    상태 필수 애플리케이션 서비스의 수명주기 상태입니다. 이러한 값은 서비스 인스턴스 [cmdb_ci_service_auto] 테이블에서 업데이트됩니다.
    유효한 값은 다음과 같습니다.
    • 활성화 – 수명주기가 작동 중이며 사용 중입니다.
      • operational_status=운영
      • life_cycle_stage=운영
      • life_cycle_stage_status=사용 중
    • 비활성화 – 수명주기가 운영되지 않으며 설계 단계에 있습니다.
      • operational_status=비운영
      • life_cycle_stage=디자인
      • life_cycle_stage_status=빌드
    • 폐기 – 수명 종료.
      • operational_status=폐기됨
      • life_cycle_stage=수명 종료
      • life_cycle_stage_status=폐기됨

    데이터 유형: 문자열
    sys_id 서비스 인스턴스 [cmdb_ci_service_auto]에 나열된 애플리케이션 서비스의 Sys_id입니다.

    데이터 유형: 문자열
    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"
  }
}