애플리케이션 CLI 및 API와 함께 CMDB 설치되는 명령어
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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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 - 이 역할은 애플리케이션 서비스를 무제한으로 볼 수 있도록 합니다.
- Mac OS용 명령 구조
snc service-graph app-service find --data '{JSON}'- Windows OS용 명령 구조
-
snc service-graph app-service find --data "{JSON}" - 인수
이 명령은 매개변수를 사용하여 JSON 객체를 전달합니다.data
CI를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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를 식별하기 위한 다음 속성은 다음과 같이 우선합니다.- sys_id – sys_id 경우 시스템은 sys_id만 사용하고 추가 값은 무시합니다.
- 숫자 – sys_id 없이 제공된 경우 시스템은 숫자만 사용하고 추가 값은 무시합니다.
- <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" } }