Befehle mit installiert CMDBAnwendungs-CLI und API

Befehle und Befehlsgruppen, die für verfügbar sind ServiceNow CLIWenn App-cmdb-api-cli Plugin ist installiert.

Apps im Store anfordern

Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

Um kritische Vorgänge zu skripten, die die Automatisierung im gesamten Unternehmen unterstützen, können Sie APIs nutzen oder Befehlszeilenvorgänge ausführen, die die CMDB-AnwendungsCLI und die API Store-App bereitstellen, anstatt die Anwenderoberfläche zu verwenden. Die CMDB-Anwendungs-CLI und die API Store-App bieten ein robustes Framework, das alle APIs konsolidiert, die sich auf Anwendungsservices beziehen, und die Befehlszeilen, mit denen Sie auf die Schnittstelle zu diesen APIs zugreifen können.

CLI- und API-Befehle der CMDB-Anwendung ermöglichen die folgenden Aufgaben:

• Registrieren und Erstellen eines Anwendungsservice und Herstellen vorgelagerter Beziehungen
• Ruft Details eines bestimmten Anwendungsservice und seiner vorgelagerten Beziehungen ab
• Verbinden von Konstrukten auf höherer Ebene wie Geschäftsanwendungen und Business-Service-Angebote
• Ein Anwendungsservice wird mit einem bestimmten Auffüllungstyp ausgefüllt
• Ändern des Status eines Anwendungsservice

Informationen zur REST-API-Lösung finden Sie unter SG Services-API .

Anwendungsservice Konvertieren

Konvertiert einen manuellen oder leeren Anwendungsservice in einen berechneten Anwendungsservice. Während der Konvertierung wird der Anwendungsservice-Datensatz mit der neu zugewiesenen Klasse in die Tabelle [cmdb_ci_Service_calculated] verschoben.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 1. JSON-Objekteigenschaften

Name	Beschreibung
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Ebenen	Anzahl der Ebenen, die in die Konvertierung einbezogen werden sollen. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
sys_id	SYS_ID des Anwendungsservice. Datentyp: Zeichenfolge

Beispiel für Mac OS

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

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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

Erstellen Sie Eine Anwendungsservice-Beziehung

Erstellt vorgelagerte Beziehungen wie Geschäftsanwendungen, Business-Serviceangebote und andere Anwendungsservices. Durch die Ausführung dieses Befehls wird eine Beziehung erstellt, die Eingaben mit einem einzelnen übergeordneten Objekt und einem entsprechenden untergeordneten Objekt enthält.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 2. JSON-Objekteigenschaften

Name	Beschreibung
child	Informationen, die den untergeordneten Anwendungsservice identifizieren, mit dem eine Beziehung erstellt werden soll. Das untergeordnete Element befindet sich in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto]. Eine dynamische CI-Gruppe kann als untergeordnetes Element hinzugefügt werden, kann jedoch nicht übergeordnet sein. Datentyp: Objekt "child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" }
Untergeordnetes Element.<Ire-Feldname>	Mindestens ein Ire-Feld, das den untergeordneten Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Untergeordnetes Element	Eindeutige Nummer, die den untergeordneten Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Child.sys_ID	SYS_ID des untergeordneten Anwendungsservice, der in der Serviceinstanz [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge
übergeordnet	Details zur Identifizierung des übergeordneten Anwendungsservice, mit dem eine Beziehung erstellt werden soll. Datentyp: Objekt "parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" }
Übergeordnetes Element.<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Übergeordnet.Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Parent.sys_ID	SYS_ID des Anwendungsservice, der in der Serviceinstanz [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge
Parent.class_Name	Name der Klasse, die den Anwendungsservice enthält. Der Name der übergeordneten Klasse muss aus einer der folgenden Tabellen stammen: cmdb_ci_Service_Auto cmdb_ci_Service_detected cmdb_ci_Service_by_Tags cmdb_ci_Service_Calculated Service.Offering cmdb_ci_business_app Standard: cmdb_ci_Service_Auto Datentyp: Zeichenfolge

Beispiel für 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"}}'

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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

Anwendungsservice löschen

Löscht einen Anwendungsservice.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 3. JSON-Objekteigenschaften

Name	Beschreibung
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
sys_id	SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge

Beispiel für Mac OS

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

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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

Löschen Sie Die Anwendungsservice-Beziehung

Löscht eine vorgelagerte Anwendungsservice-Beziehung.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 4. JSON-Objekteigenschaften

Name	Beschreibung
child	Informationen, die die untergeordnete Beziehung beschreiben, die aus der Serviceanwendung gelöscht werden soll. Datentyp: Objekt "child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" }
Untergeordnetes Element.<Ire-Feldname>	Mindestens ein Ire-Feld, das den untergeordneten Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Untergeordnetes Element	Eindeutige Nummer, die den untergeordneten Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Child.sys_ID	SYS_ID des untergeordneten Anwendungsservice, der in der Serviceinstanz [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge
übergeordnet	Details zur Identifizierung des übergeordneten Anwendungsservice, aus dem eine Beziehung entfernt werden soll. Datentyp: Objekt "parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" }
Übergeordnetes Element.<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Übergeordnet.Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Parent.sys_ID	SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge
Parent.class_Name	Name der Klasse, die den Anwendungsservice enthält. Der Name der übergeordneten Klasse muss aus einer der folgenden Tabellen stammen: cmdb_ci_Service_Auto cmdb_ci_Service_detected cmdb_ci_Service_by_Tags cmdb_ci_Service_Calculated Service.Offering cmdb_ci_business_app Standard: cmdb_ci_Service_Auto Datentyp: Zeichenfolge

Beispiel für 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"}}'

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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

Anwendungsservice Suchen

Sucht die Details eines bestimmten Anwendungsservice und seiner vorgelagerten Beziehungen.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

App_Service_admin: Diese Rolle bietet eine unbegrenzte Anzeige von Anwendungsservices.

App_Service_user: Diese Rolle bietet nur die Anzeige von Anwendungsservices im Status „Betrieb“.

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 5. JSON-Objekteigenschaften

Name	Beschreibung
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
sys_id	SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge

Beispiel für Mac OS

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

Beispiel für Windows-Betriebssystem

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

Rückgabewert

{
  "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"
      }
    ]
  }
}

Füllen Sie Den Anwendungsservice Aus

Füllt einen Anwendungsservice mit einer Service-Auffüllungsmethode aus.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 6. JSON-Objekteigenschaften

Name	Beschreibung
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Population_method	Erforderlich. Identifiziert die Auffüllungsmethode und die zugehörige Eigenschaft, um den Inhalt für die Auffüllung zu identifizieren. Pro Typ ist nur ein begleitendes Objekt gültig. Datentyp: Objekt
population_method.group_id	Gruppen-ID der CMDB-Gruppe, die mit dem Auffüllungstyp „cmdb_Group“ konfiguriert ist. Datentyp: „Zeichenfolge“ "population_method": { "group_id": "String", "type": "cmdb_group" } Zugeordneter Auffüllungstyp: cmdb_Group
Population_method.levels	Anzahl der Ebenen, die beim Erstellen des Service verwendet werden sollen. Wenn der Ebenenwert nicht angegeben ist, überprüft das System die sys_property auf den Wert. Wenn svc.manual.convert.levels.default_value nicht ausgefüllt ist, wird der Standardwert 3 verwendet. Datentyp: Zahl "population_method": { "levels": Number, "type": "dynamic_service" } Zugeordneter Auffüllungstyp: Dynamic_Service Standard: 3, wenn für die sys_property kein Ebenenwert festgelegt ist
population_method.service_candidate	Eindeutiger Bezeichner des Servicekandidaten. Datentyp: Zeichenfolge "population_method": { "service_candidate": "String", "type": "tag_based_service_family" } Zugeordneter Auffüllungstyp: Tag_based_Service_family
population_method.service_relations	Liste von Objekten, die Hierarchiedaten für die CIs im Anwendungsservice enthalten. Alle CIs bilden Paare mit einem übergeordneten und einem untergeordneten CI. Das oberste CI, als Einstiegspunkt eines Anwendungsservice bezeichnet, verfügt nicht über ein übergeordnetes CI. Datentyp: Array "population_method": { "service_relations":[ { "child": "String", "parent": "String" } ], "type": "service_hierarchy" } Zugeordneter Auffüllungstyp: Service_hierarchy
population_method.service_relations.child	Name eines untergeordneten CI, das sich auf das CI bezieht. Datentyp: Zeichenfolge
population_method.service_relations.parent	Name eines übergeordneten CI, das sich auf das CI bezieht. Datentyp: Zeichenfolge
Population_method.Tags	Liste von Objekten mit Tags, die dem CI zugeordnet werden sollen. Diese Informationen befinden sich in der Tabelle „Schlüsselwerte“ [cmdb_key_value]. Datentyp: Array "population_method": { "tags": [ { "tag": "String", "value": "String" } ], "type": "tag_list" } Zugeordneter Auffüllungstyp: Tag_list
Population_method.Tags.Tag	Tag-Name. Datentyp: Zeichenfolge
Population_method.Tags.value	Tag-Wert. Datentyp: Zeichenfolge
Population_method.type	Erforderlich. Auffüllungstyp, der dem Anwendungsservice hinzugefügt werden soll. Datentyp: Objekt Gültige Werte: cmdb_Gruppe Service_Hierarchie Dynamic_Service Tag_Liste Tag_based_Service_family
sys_id	SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge

Beispiel für 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"}}'

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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

Anwendungsservice Registrieren

Erstellt einen Anwendungsservice, markiert und erstellt vorgelagerte Beziehungen wie Geschäftsanwendungen, Business-Serviceangebote und andere Anwendungsservices.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 7. JSON-Objekteigenschaften

Name	Beschreibung
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Beziehungen	Vorgelagerte Beziehungen kategorisiert nach Typ. Datentyp: Objekt "relationships": { "business_app": [Array], "business_service_offering": [Array], "parent_app_service": [Array], "technical_service_offering": [Array] } Die maximale Anzahl von Beziehungen beträgt 25.
Beziehungen.Business_App	Liste von Objekten, die Beziehungstypen der Geschäftsanwendung darstellen. Diese Werte können mit einem der folgenden Elemente als Schlüssel-Wert-Paare definiert werden. <Ire-Feldname> Nummer sys_id Datentyp: Array
Beziehungen.Business_Service_Offering	Liste von Objekten, die Beziehungstypen des Business-Serviceangebots darstellen. Diese Werte können mithilfe der folgenden Elemente als Schlüssel-Wert-Paare definiert werden. <Ire-Feldname> Nummer sys_id Datentyp: Array
Relations.parent_App_Service	Liste von Objekten, die Anwendungs-Service-Beziehungstypen darstellen. Diese Werte können mithilfe der folgenden Elemente als Schlüssel-Wert-Paare definiert werden. <Ire-Feldname> Nummer sys_id Datentyp: Array
Beziehungen.Technical_Service_Offering	Liste von Objekten, die das Technologiemanagement-Angebot darstellen (ehemals technisches Serviceangebot) Beziehungstypen. Diese Werte können mithilfe der folgenden Elemente als Schlüssel-Wert-Paare definiert werden. <Ire-Feldname> Nummer sys_id Datentyp: Array
sys_id	SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge
tags	Liste von Objekten, die Tag-Definitionen als Schlüssel-Wert-Paare enthalten. "tags": [ { "key": "String", "value": "String" }] Datentyp: Array
tags.key	Tag-Kategoriename. Datentyp: Zeichenfolge
Tags.Wert	Tag-Wert. Datentyp: Zeichenfolge

Beispiel für 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"}]}'

Beispiel für Windows-Betriebssystem

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"}]}"

Rückgabewert

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

Anwendungsservice aktualisieren

Aktualisiert einen vorhandenen bereitgestellten Anwendungsservice und erstellt Tags für den angegebenen Anwendungsservice.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 8. JSON-Objekteigenschaften

Name	Beschreibung
<zu aktualisierende Felder oder Tags>	Verwenden Sie Schlüssel-Wert-Paare, um jedes zu aktualisierende Feld oder Tag zu identifizieren. Nur grundlegende Informationen können aktualisiert werden, keine vorgelagerten Beziehungen können aktualisiert werden. Datentyp: Zeichenfolge
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
sys_id	SYS_ID des Anwendungsservice, der in der Serviceinstanz [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge

Beispiel für Mac OS

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

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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

Aktualisieren Sie Den Anwendungsservicestatus

Ändert den Lebenszyklusstatus des Anwendungsservice in „Aktivieren“, „Deaktivieren“ oder „Stilllegen“.

Befehlsgruppe:

• Übergeordnete Gruppe: Service-Graph
• Untergeordnete Gruppe: App-Service

Erforderliche Rollen

app_service_admin

Wenn der Anwender einen Service-Mapping-bezogenen Service verwendet, muss er über die erforderlichen Rollen für diesen Service-Mapping verfügen.

Befehlsstruktur für Mac OS

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

Befehlsstruktur für Windows-Betriebssystem

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

Argumente

Dieser Befehl übergibt ein JSON-Objekt mit dataParameter.

Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Bei sys_ID verwendet das System nur die sys_ID und ignoriert alle zusätzlichen Werte.
2. Zahl: Wenn ohne sys_ID angegeben, verwendet das System nur die Zahl und ignoriert alle zusätzlichen Werte.
3. <Ire-Feldname>: Das System verwendet diese Werte nur, wenn die sys_ID oder die Zahl nicht angegeben ist.

Tabelle : 9. JSON-Objekteigenschaften

Name	Beschreibung
<Ire-Feldname>	Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. Datentyp: Zeichenfolge
Nummer	Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge
Staat	Erforderlich. Lebenszyklusstatus des Anwendungsservice. Diese Werte werden in der Tabelle „Serviceinstanz“ [cmdb_ci_Service_Auto] aktualisiert. Gültige Werte: AKTIVIEREN: Lebenszyklus ist funktionsfähig und wird verwendet. Operational_Status=operativ Life_Cycle_stage=betriebsbereit Life_Cycle_stage_Status=in Gebrauch DEAKTIVIEREN: Lebenszyklus ist nicht funktionsfähig und befindet sich in der Designphase. Operational_Status=nicht funktionsfähig Life_Cycle_stage=Design Life_Cycle_stage_Status=Build STILLLEGEN: Ende der Lebensdauer. Operational_Status=stillgelegt Life_Cycle_stage=Ende der Lebensdauer Life_Cycle_stage_Status=stillgelegt Datentyp: Zeichenfolge
sys_id	SYS_ID des Anwendungsservice, der in der Serviceinstanz [cmdb_ci_Service_Auto] aufgeführt ist. Datentyp: Zeichenfolge

Beispiel für Mac OS

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

Beispiel für Windows-Betriebssystem

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

Rückgabewert

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