CMDB アプリケーションの CLI および API とともにインストールされるコマンド

ストアでアプリを要求する

ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

企業全体の自動化をサポートする重要な操作をスクリプト化するために、ユーザーインターフェイスを使用する代わりに、API を活用するか、CMDB アプリケーション CLI および API ストアアプリが提供するコマンドライン操作を実行できます。CMDB アプリケーション CLI および API ストアアプリは、アプリケーションサービスに関連するすべての API と、それらの API へのインターフェイスにアクセスできるようにするコマンドラインを統合する堅牢なフレームワークを提供します。

CMDB アプリケーションの CLI および API コマンドは、次のタスクを有効にします。

アプリケーションサービスの登録と作成、およびアップストリームの関係の確立
指定されたアプリケーションサービスとそのアップストリームの関係の詳細の取得
ビジネスアプリケーションやビジネスサービスオファリングなどの上位レベルの構成要素の接続
指定された入力タイプのアプリケーションサービスへの入力
アプリケーションサービスのステータスの変更

REST API ソリューションについては、「SG サービス API」を参照してください。

アプリケーションサービスへの変換

手動または空のタイプのアプリケーションサービスを計算されたアプリケーションサービスに変換します。変換中、アプリケーションサービスレコードは新しくアサインされたクラスとともに [cmdb_ci_service_calculated] テーブルに移動します。

コマンドグループ：

親グループ：service-graph
子グループ：app-service

必要なロール

app_service_admin

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 1. JSON オブジェクトのプロパティ
名前	説明
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
levels	変換に含めるレベルの数。データタイプ：文字列
number	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
sys_id	アプリケーションサービスの sys_id。データタイプ：文字列

例

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

値を返す

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

アプリケーションサービス関係の作成

ビジネスアプリケーション、ビジネスサービスオファリング、その他のアプリケーションサービスなどのアップストリームの関係をビルドします。このコマンドを実行すると、1 つの親と対応する子オブジェクトを含む入力を取得して、関係が作成されます。

コマンドグループ：

親グループ：service-graph
子グループ：app-service

必要なロール

app_service_admin

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 2. JSON オブジェクトのプロパティ
名前	説明
child	関係を作成する子アプリケーションサービスを特定する情報。アプリケーションサービス [cmdb_ci_service_auto] テーブル内にある子。動的 CI グループは子として追加できますが、親になることはできません。データタイプ：オブジェクト `"child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" }`
child.<IRE field name>	子アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
child.number	子アプリケーションサービスを特定する一意の番号。データタイプ：文字列
child.sys_id	アプリケーションサービス [cmdb_ci_service_auto] にリストされている子アプリケーションサービスの sys_id。データタイプ：文字列
parent	関係の作成に使用する親アプリケーションサービスを特定する詳細情報。データタイプ：オブジェクト `"parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" }`
parent.<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
parent.number	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
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 データタイプ：文字列

例

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

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 3. JSON オブジェクトのプロパティ
名前	説明
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
number	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
sys_id	アプリケーションサービス [cmdb_ci_service_auto] テーブルにリストされるアプリケーションサービスの sys_id。データタイプ：文字列

例

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

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 4. JSON オブジェクトのプロパティ
名前	説明
child	サービスアプリケーションから削除する子の関係を説明する情報。データタイプ：オブジェクト `"child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" }`
child.<IRE field name>	子アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
child.number	子アプリケーションサービスを特定する一意の番号。データタイプ：文字列
child.sys_id	アプリケーションサービス [cmdb_ci_service_auto] にリストされている子アプリケーションサービスの sys_id。データタイプ：文字列
parent	関係の削除元となる親アプリケーションサービスを特定する詳細情報。データタイプ：オブジェクト `"parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" }`
parent.<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
parent.number	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
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 データタイプ：文字列

例

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 – このロールは、運用ステータスのアプリケーションサービスのみを表示できます。

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 5. JSON オブジェクトのプロパティ
名前	説明
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
number	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
sys_id	アプリケーションサービス [cmdb_ci_service_auto] テーブルにリストされるアプリケーションサービスの sys_id。データタイプ：文字列

例

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

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 6. JSON オブジェクトのプロパティ
名前	説明
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
番号	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
population_method	必須。入力するコンテンツを識別するための入力方法とそれに付随するプロパティを識別します。タイプごとに 1 つの付随オブジェクトのみが有効です。データタイプ：オブジェクト
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。データタイプ：文字列

例

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

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 7. JSON オブジェクトのプロパティ
名前	説明
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
number	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
relationships	タイプ別に分類されたアップストリームの関係。データタイプ：オブジェクト `"relationships": { "business_app": [Array], "business_service_offering": [Array], "parent_app_service": [Array], "technical_service_offering": [Array] }` 関係の最大数は 25 です。
relationships.business_app	ビジネスアプリケーション関係タイプを表すオブジェクトのリスト。これらの値は、次のいずれかのアイテムをキーと値のペアとして使用して定義できます。 <IRE field name> number sys_id データタイプ：アレイ
relationships.business_service_offering	ビジネスサービスオファリング関係タイプを表すオブジェクトのリスト。これらの値は、次のアイテムをキーと値のペアとして使用して定義できます。 <IRE field name> number sys_id データタイプ：アレイ
relationships.parent_app_service	アプリケーションサービス関係タイプを表すオブジェクトのリスト。これらの値は、次のアイテムをキーと値のペアとして使用して定義できます。 <IRE field name> number sys_id データタイプ：アレイ
relationships.technical_service_offering	テクニカルサービスオファリング関係タイプを表すオブジェクトのリスト。これらの値は、次のアイテムをキーと値のペアとして使用して定義できます。 <IRE field name> number sys_id データタイプ：アレイ
sys_id	アプリケーションサービス [cmdb_ci_service_auto] テーブルにリストされるアプリケーションサービスの sys_id。データタイプ：文字列
tags	キーと値のペアとしてのタグ定義を含むオブジェクトのリスト。 `"tags": [ { "key": "String", "value": "String" }]` データタイプ：アレイ
tags.key	タグカテゴリ名。データタイプ：文字列
tags.value	タグ値。データタイプ：文字列

例

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

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 8. JSON オブジェクトのプロパティ
名前	説明
<fields or tags to update>	キーと値のペアを使用して、更新する各フィールドまたはタグを特定します。基本的な情報のみを更新できます。アップストリームの関係は更新できません。データタイプ：文字列
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
番号	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
sys_id	アプリケーションサービス [cmdb_ci_service_auto] にリストされるアプリケーションサービスの sys_id。データタイプ：文字列

例

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

サービスマッピング関連サービスを使用する場合、ユーザーはそのサービスマッピング関連サービスに必要なロールを持っている必要があります。

コマンド構造

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

引数

このコマンドは、data パラメーターを使用して JSON オブジェクトを渡します。

CI を識別する以下のプロパティは、次のように優先されます。

sys_id – sys_id の場合、システムは sys_id のみを使用し、追加の値は無視します。
数値 – sys_id なしで指定された場合、システムは数値のみを使用し、追加の値は無視します。
<IRE field name> – sys_id または数値が指定されていない場合のみ、システムはこれらの値を使用します。

表 : 9. JSON オブジェクトのプロパティ
名前	説明
<IRE field name>	アプリケーションサービスを特定する 1 つ以上の IRE フィールド。たとえば、名前やバージョン。データタイプ：文字列
番号	アプリケーションサービスを特定する一意の番号。データタイプ：文字列
state	必須です。アプリケーションサービスのライフサイクル状況。これらの値は、アプリケーションサービス [cmdb_ci_service_auto] テーブル内で更新されます。有効な値： ACTIVATE – ライフサイクルが運用中で、使用中です。 operational_status=Operational life_cycle_stage=Operational life_cycle_stage_status=In Use DEACTIVATE – ライフサイクルが運用されておらず、設計段階です。 operational_status=Non-Operational life_cycle_stage=Design life_cycle_stage_status=Build 廃止 – 提供終了。 operational_status=Retired life_cycle_stage=End Of Life life_cycle_stage_status=Retired データタイプ：文字列
sys_id	アプリケーションサービス [cmdb_ci_service_auto] にリストされるアプリケーションサービスの sys_id。データタイプ：文字列

例

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

戻り値

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