---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SG Services-API

# SG Services-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 25 Minuten Lesedauer

Die SG-Services Die API stellt Endpunkte zum Erstellen und Verwalten von Anwendungsservices und der vorgelagerten Beziehungen zwischen ihnen bereit.

## Apps im Store anfordern {#sg_services-api__section_eck_nxy_pqb}

Besuchen Sie die [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home)-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Informationen zu kumulativen Release-Hinweisen für alle veröffentlichten Apps finden Sie unter [ServiceNow Store-Release-Hinweise](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html). {#sg_services-api__inline-send-to-store}
Diese API kann nur verwendet werden, wenn das Plugin „CMDB-Anwendungs-API" und „CLI" (sn_Service_Graph) aktiviert ist. Diese API wird in verwendet `sn_Service_Graph `Namespace.

Die Verwendung dieser API erfordert keine Details zu Quelltabellen oder Beziehungstypen.

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 CLI der CMDB-Anwendung 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 aktivieren 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, z. B. Geschäftsanwendungen und Business-Serviceangebote
* Ein Anwendungsservice wird mit einem bestimmten Auffüllungstyp ausgefüllt
* Ändern des Status eines Anwendungsservice
{#sg_services-api__ul_q4w_dgj_3qb}

Informationen zur Befehlszeilenlösung finden Sie unter [CLI- und API-verfügbare Befehle der CMDB-Anwendung](https://www.servicenow.com/docs/access?context=cmdb-cli-commands&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

## SG Services: NACH /sg_Services/App_Service/convert {#ariaid-title2}

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.
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-convert__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/convert

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/Convert  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-convert__entry__2}{#sg_svcs-POST-convert__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#sg_svcs-POST-convert__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#sg_svcs-POST-convert__entry__10}{#sg_svcs-POST-convert__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-convert__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-convert__sg_svcs-reqParm-sysid-ph}

| 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 aufgenommen werden sollen. 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 |
[Tabelle : 3. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-convert__entry__20}{#sg_svcs-POST-convert__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#sg_svcs-POST-convert__entry__24}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-convert__entry__28}{#sg_svcs-POST-convert__entry-200-status-code}{#sg_svcs-POST-convert__entry-400-status-code}{#sg_svcs-POST-convert__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON) {#sg_svcs-POST-convert__section_hyx_jnx_gqb}

{#sg_svcs-POST-convert__table_iyx_jnx_gqb__entry__2}

| Name | Beschreibung |
|-|-|
| Status | Gibt Erfolg oder Fehler an. Datentyp: Zeichenfolge |
[ ]

{#sg_svcs-POST-convert__table_iyx_jnx_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Anwendungsservicetyp konvertiert wird.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/convert" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
     \"name\": \"Test Register\",
     \"environment\": \"Test\",
     \"version\": \"1.0\",
     \"levels\" : 8
    }" \
    --user 'username':'password'

Ergebnisse, die eine erfolgreiche Konvertierung in einen berechneten Anwendungsservice anzeigen.

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

## SG-Services: VERÖFFENTLICHEN SIE /sg_Services/App_Service/delete {#ariaid-title3}

Löscht einen Anwendungsservice.
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-delete__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/delete

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/delete  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-delete__entry__2}{#sg_svcs-POST-delete__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#sg_svcs-POST-delete__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#sg_svcs-POST-delete__table_e5t_gwt_gqb__entry__2}{#sg_svcs-POST-delete__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-delete__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-delete__sg_svcs-reqParm-sysid-ph}

| 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 |
[Tabelle : 9. Anforderungstext-Parameter (JSON)]

{#sg_svcs-POST-delete__table_e5t_gwt_gqb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-delete__entry__18}{#sg_svcs-POST-delete__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#sg_svcs-POST-delete__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-delete__entry__26}{#sg_svcs-POST-delete__entry-200-status-code}{#sg_svcs-POST-delete__entry-400-status-code}{#sg_svcs-POST-delete__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON)

{#sg_svcs-POST-delete__table_pvd_l5t_gqb__entry__2}

| Name | Beschreibung |
|-|-|
| Status | Gibt Erfolg oder Fehler an. Datentyp: Zeichenfolge |
[ ]

{#sg_svcs-POST-delete__table_pvd_l5t_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Anwendungsservice gelöscht wird.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/delete" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"name\": \"Test Register\",
       \"environment\": \"Test\",
       \"version\": \"1.0\"
    }" \
    --user 'username':'password'

Ergebnisse, die auf eine erfolgreiche Entfernung eines Anwendungsservice hinweisen.

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

## SG Services -- POSTEN /sg_Services/App_Service/find {#ariaid-title4}

Sucht die Details eines bestimmten Anwendungsservice und seiner vorgelagerten Beziehungen.
Anwender mit der Rolle „App_Service_user" können diese API verwenden, Ergebnisse sind jedoch auf Anwendungsservices im Status „Betrieb" beschränkt. Die Rolle „App_Service_admin" bietet eine unbegrenzte Anzeige von Anwendungsservices.  
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-find__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/Find

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/Find  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-find__entry__2}{#sg_svcs-POST-find__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#sg_svcs-POST-find__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

{#sg_svcs-POST-find__entry__10}{#sg_svcs-POST-find__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-find__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-find__sg_svcs-reqParm-sysid-ph}

| Name | Beschreibung |
|-|-|
| \<IRE fields\> | 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 |
[Tabelle : 15. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-find__entry__18}{#sg_svcs-POST-find__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#sg_svcs-POST-find__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-find__entry__26}{#sg_svcs-POST-find__entry-200-status-code}{#sg_svcs-POST-find__entry-400-status-code}{#sg_svcs-POST-find__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON) {#sg_svcs-POST-find__section_hyx_jnx_gqb}

{#sg_svcs-POST-find__table_iyx_jnx_gqb__entry__2}{#sg_svcs-POST-find__d3353e242}

| 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 |
| operational_status | Betriebsstatus des Anwendungsservice. Beispiel: Aktiv. Datentyp: Zeichenfolge |
| Beziehungen | Liste von Objekten, die die vorgelagerten Beziehungen des Anwendungsservice definieren. Datentyp: Array "relationships": [ { "name": "String", "number": "String", "sys_id": "String", "class_name": "String", "relationship": "String" } ] |
| Beziehungen.class_Name | Name der Klasse, die den Anwendungsservice enthält. Datentyp: Zeichenfolge |
| relationships.name | Name der Beziehung. Datentyp: Zeichenfolge |
| Beziehungen.Nummer | Eindeutige Nummer der Beziehung Datentyp: Zeichenfolge |
| Beziehungen.Beziehung | Die Beziehungsregel. Datentyp: Zeichenfolge |
| Beziehungen.sys_ID | SYS_ID der Beziehung. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz" \[cmdb_ci_service_auto\] aufgeführt ist. Datentyp: Zeichenfolge |
[ ]

{#sg_svcs-POST-find__table_iyx_jnx_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie Details zu einem Anwendungsservice finden.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/find" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"name\": \"Test App Service1\"
     }" \
    --user 'username':'password'

Der Antworttext enthält den Anwendungsservice und Beziehungsinformationen.

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

## SG Services: VERÖFFENTLICHEN SIE /sg_Services/App_Service/ausfüllen {#ariaid-title5}

Füllt einen Anwendungsservice mit einer Service-Auffüllungsmethode aus.
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-populate__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/populate

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/populate  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-populate__entry__2}{#sg_svcs-POST-populate__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 19. Pfad-Parameter]

{#sg_svcs-POST-populate__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 20. Abfrageparameter]

{#sg_svcs-POST-populate__entry__10}{#sg_svcs-POST-populate__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-populate__sg_svcs-reqParm-sysid-ph}

| 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. Gibt die Auffüllungsmethode und die zugehörige Eigenschaft an, 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 mit Hierarchiedaten für die CIs im Anwendungsservice. Alle CIs bilden Paare mit einem übergeordneten und einem untergeordneten CI. Das CI der obersten Ebene, das als Einstiegspunkt eines Anwendungsservice bezeichnet wird, hat kein ü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_hierarchy * Dynamic_Service * Tag_Liste * tag_based_service_family {#sg_svcs-POST-populate__ul_f2v_4by_gqb} |
| sys_id | SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz" \[cmdb_ci_service_auto\] aufgeführt ist. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-populate__entry__40}{#sg_svcs-POST-populate__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 22. Anforderungskopfzeilen.]

{#sg_svcs-POST-populate__entry__44}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-populate__entry__48}{#sg_svcs-POST-populate__entry-200-status-code}{#sg_svcs-POST-populate__entry-400-status-code}{#sg_svcs-POST-populate__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON) {#sg_svcs-POST-populate__section_hyx_jnx_gqb}

{#sg_svcs-POST-populate__table_iyx_jnx_gqb__entry__2}

| Name | Beschreibung |
|-|-|
| Status | Gibt Erfolg oder Fehler an. Datentyp: Zeichenfolge |
[ ]

{#sg_svcs-POST-populate__table_iyx_jnx_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Anwendungsservice mit dem Typ „Dynamic_Service" ausgefüllt wird.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/populate" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\",

     \"population_method\": {
       \"type\": \"dynamic_service\",
       \"levels\" : 8
      }
    }" \
    --user 'username':'password'

Ergebnisse, die eine erfolgreiche Ausfüllung eines Anwendungsservice anzeigen.

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

## SG Services: /sg_Services/App_Service/Register VERÖFFENTLICHEN {#ariaid-title6}

Erstellt einen Anwendungsservice, markiert und erstellt vorgelagerte Beziehungen wie Geschäftsanwendungen, Business-Serviceangebote und andere Anwendungsservices.
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-register__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/Register

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/Register  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-register__entry__2}{#sg_svcs-POST-register__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 25. Pfad-Parameter]

{#sg_svcs-POST-register__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 26. Abfrageparameter]

{#sg_svcs-POST-register__entry__10}{#sg_svcs-POST-register__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-register__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-register__sg_svcs-reqParm-sysid-ph}

| 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 {#sg_svcs-POST-register__ul_gh2_52y_gqb} 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 {#sg_svcs-POST-register__ul_hh2_52y_gqb} 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 {#sg_svcs-POST-register__ul_jh2_52y_gqb} 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 {#sg_svcs-POST-register__ul_ih2_52y_gqb} 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 |
[Tabelle : 27. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-register__entry__34}{#sg_svcs-POST-register__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 28. Anforderungskopfzeilen.]

{#sg_svcs-POST-register__entry__38}

| CHeader | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-register__entry__42}{#sg_svcs-POST-register__entry-200-status-code}{#sg_svcs-POST-register__entry-400-status-code}{#sg_svcs-POST-register__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

### Antworttext-Parameter (JSON)

{#sg_svcs-POST-register__entry__52}

| CHeader | Beschreibung |
|-|-|
| App_Service | Anwendungsservice-Details. Datentyp: Objekt "app_service": { "name": "String", "number": "String", "sys_id": "String" } |
| app_service.name | Name des Anwendungsservice. Datentyp: Zeichenfolge |
| App_Service.number | Eindeutige Nummer, die den Anwendungsservice identifiziert. Datentyp: Zeichenfolge |
| App_Service.sys_ID | SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz" \[cmdb_ci_service_auto\] aufgeführt ist. Datentyp: Zeichenfolge |
| Nachricht | Nachricht, die den Status beschreibt. Mögliche Werte: * Service bereits vorhanden * Service erfolgreich registriert {#sg_svcs-POST-register__ul_jwp_x41_hqb} Datentyp: Zeichenfolge |
| Status | Status, der angibt, ob der Service registriert wurde. Mögliche Werte: * Einfügen: Der Anwendungsservice wurde erfolgreich erstellt. * Keine Aktion: Der Anwendungsservice ist bereits vorhanden. Keine Aktion ausgeführt. {#sg_svcs-POST-register__ul_kwp_x41_hqb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Anwendungsservice registriert wird.

    curl "instance.service-now.com/api/sn_service_graph/sg_services/app_service/register" \--request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --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\"
        }
      ]
    }" \
    --user 'username':'password'

Der Antworttext enthält ID- und Statusinformationen.

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

## SG Services -- POSTEN /sg_Services/App_Service/Relationship/create {#ariaid-title7}

Erstellt vorgelagerte Beziehungen wie Geschäftsanwendungen, Business-Serviceangebote und andere Anwendungsservices.
Diese API erstellt eine Beziehung, die Eingaben mit einem einzelnen übergeordneten Objekt und einem entsprechenden untergeordneten Objekt übernimmt.  
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-rel-create__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/Relationship/create

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/Relationship/create  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-rel-create__entry__2}{#sg_svcs-POST-rel-create__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 31. Pfad-Parameter]

{#sg_svcs-POST-rel-create__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 32. Abfrageparameter]

{#sg_svcs-POST-rel-create__entry__10}

| Name | Beschreibung |
|-|-|
| untergeordnetes Element | Informationen, die den untergeordneten Anwendungsservice identifizieren, mit dem eine Beziehung erstellt werden soll. Eine dynamische CI-Gruppe kann als untergeordnetes Element hinzugefügt werden, kann jedoch nicht übergeordnet sein. Datentyp: Objekt "child": { "<service_app_identifier>": "String" } Tabelle: Serviceinstanz \[cmdb_ci_service_auto\] |
| Untergeordnetes Element.\<service_app_identifier\> | Details zur Identifizierung des untergeordneten Anwendungsservice, mit dem eine Beziehung erstellt werden soll. Es ist nur eine Option erforderlich. Jede Option wird nach Verarbeitungsvorrang aufgelistet: * sys_ID: SYS_ID des untergeordneten Anwendungsservice. * Nummer: Eindeutige Nummer, die den untergeordneten Anwendungsservice identifiziert. * \<Ire-Feldname\>: Ire-Felder, die den Anwendungsservice identifizieren. Beispiel: Name oder Version. {#sg_svcs-POST-rel-create__ul_hfz_zjd_3qb} Datentyp: Zeichenfolge |
| übergeordnet | Details zur Identifizierung des übergeordneten Anwendungsservice, mit dem eine Beziehung erstellt werden soll. Datentyp: Objekt "parent": { "<service_app_identifier>": "String", "class_name": "String" } |
| Übergeordnetes.\<service_app_identifier\> | Informationen, die den Anwendungsservice identifizieren. Es ist nur eine Option erforderlich. Jede Option wird nach Verarbeitungsvorrang aufgelistet: * sys_ID: SYS_ID der Anwendungsservice, der in der Serviceinstanz \[cmdb_ci_service_auto\] aufgeführt ist. * Nummer: Eindeutige Nummer, die den Anwendungsservice identifiziert. * \<Ire-Feldname\>: Mindestens ein Ire-Feld, das den Anwendungsservice identifiziert. Beispiel: Name oder Version. {#sg_svcs-POST-rel-create__ul_jfk_mjd_3qb} 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_business_app * cmdb_ci_service_auto * cmdb_ci_service_by_tags * cmdb_ci_service_calculated * cmdb_ci_service_discovered * Service.Offering {#sg_svcs-POST-rel-create__ul_xlk_nc1_hqb} Standard: cmdb_ci_service_auto Datentyp: Zeichenfolge |
[Tabelle : 33. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-rel-create__entry__22}{#sg_svcs-POST-rel-create__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 34. Anforderungskopfzeilen.]

{#sg_svcs-POST-rel-create__entry__26}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-rel-create__entry__30}{#sg_svcs-POST-rel-create__entry-200-status-code}{#sg_svcs-POST-rel-create__entry-400-status-code}{#sg_svcs-POST-rel-create__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 36. Statuscodes]

### Antworttext-Parameter (JSON) {#sg_svcs-POST-rel-create__section_hyx_jnx_gqb}

{#sg_svcs-POST-rel-create__table_iyx_jnx_gqb__entry__2}

| Name | Beschreibung |
|-|-|
| Status | Gibt Erfolg oder Fehler an. Datentyp: Zeichenfolge |
[ ]

{#sg_svcs-POST-rel-create__table_iyx_jnx_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie eine Beziehung aus einem Anwendungsservice erstellt wird.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/relationship/create" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"child\": {
       \"name\": \"wdfsdf\",
       \"environment\": \"Test\",
       \"version\": \"1.0\"
       },
      \"parent\": {
       \"sys_id\": \"abcdefg\",
       \"name\": \"business App1\",
       \"class_name\": \"service_offering\"
      }
    }" \
    --user 'username':'password'

Ergebnisse, die auf eine erfolgreiche Erstellung einer Anwendungsservicebeziehung hinweisen.

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

## SG Services: VERÖFFENTLICHEN SIE /sg_Services/App_Service/Relationship/delete {#ariaid-title8}

Löscht eine vorgelagerte Anwendungsservice-Beziehung.
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-rel-delete__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/Relationship/delete

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/Relationship/delete  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-rel-delete__entry__2}{#sg_svcs-POST-rel-delete__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 37. Pfad-Parameter]

{#sg_svcs-POST-rel-delete__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 38. Abfrageparameter]

{#sg_svcs-POST-rel-delete__entry__10}{#sg_svcs-POST-rel-delete__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-rel-delete__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-rel-delete__sg_svcs-reqParm-sysid-ph}

| Name | Beschreibung |
|-|-|
| untergeordnetes Element | 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 |
| Parent.number | 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_discovered * cmdb_ci_service_by_tags * cmdb_ci_service_calculated * Service.Offering * cmdb_ci_business_app {#sg_svcs-POST-rel-delete__ul_ktf_45d_3qb} Standard: cmdb_ci_service_auto Datentyp: Zeichenfolge |
[Tabelle : 39. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-rel-delete__entry__30}{#sg_svcs-POST-rel-delete__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 40. Anforderungskopfzeilen.]

{#sg_svcs-POST-rel-delete__entry__34}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 41. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-rel-delete__entry__38}{#sg_svcs-POST-rel-delete__entry-200-status-code}{#sg_svcs-POST-rel-delete__entry-400-status-code}{#sg_svcs-POST-rel-delete__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 42. Statuscodes]

### Antworttext-Parameter (JSON)

{#sg_svcs-POST-rel-delete__entry__48}

| Name | Beschreibung |
|-|-|
| Status | Gibt Erfolg oder Fehler an. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie eine Beziehung aus einem Anwendungsservice entfernen.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/relationship/delete" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"child\": {
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\"

      },
      \"parent\": {
       \"sys_id\": \"abcdefg\",
       \"name\": \"business App1\",
       \"class_name\": \"service_offering\"
         }
     }" \
    --user 'username':'password'

Ergebnisse, die auf eine erfolgreiche Entfernung einer Anwendungsservice-Beziehung hinweisen.

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

## SG Services -- POST /sg_Services/App_Service/State {#ariaid-title9}

Ändert den Lebenszyklusstatus des Anwendungsservice in „Aktivieren", „Deaktivieren" oder „Stilllegen".
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-state__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/State

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/State  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-state__entry__2}{#sg_svcs-POST-state__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 43. Pfad-Parameter]

{#sg_svcs-POST-state__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 44. Abfrageparameter]

{#sg_svcs-POST-state__table_h3q_lsx_gqb__entry__2}{#sg_svcs-POST-state__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-state__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-state__sg_svcs-reqParm-sysid-ph}

| 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. Gültige Werte: * AKTIVIEREN: Lebenszyklus ist funktionsfähig und wird verwendet. * Life_Cycle_stage=betriebsbereit * life_cycle_stage_status=in Gebrauch * Operational_Status=operativ {#sg_svcs-POST-state__ul_mkp_kzd_3qb} * DEAKTIVIEREN: Lebenszyklus ist nicht funktionsfähig und befindet sich in der Designphase. * Life_Cycle_stage=Design * life_cycle_stage_status=Build * Operational_Status=nicht funktionsfähig {#sg_svcs-POST-state__ul_pq4_lzd_3qb} * STILLLEGEN: Ende der Lebensdauer. * Life_Cycle_stage=End of Life * life_cycle_stage_status=stillgelegt * Operational_Status=stillgelegt {#sg_svcs-POST-state__ul_x5w_lzd_3qb} {#sg_svcs-POST-state__ul_cfp_4sx_gqb} Datentyp: Zeichenfolge Gespeichert in: Serviceinstanz \[cmdb_ci_service_auto\] |
| sys_id | SYS_ID des Anwendungsservice, der in der Tabelle „Serviceinstanz" \[cmdb_ci_service_auto\] aufgeführt ist. Datentyp: Zeichenfolge |
[Tabelle : 45. Anforderungstext-Parameter (JSON)]

{#sg_svcs-POST-state__table_h3q_lsx_gqb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-state__entry__20}{#sg_svcs-POST-state__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 46. Anforderungskopfzeilen.]

{#sg_svcs-POST-state__entry__24}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 47. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-state__entry__28}{#sg_svcs-POST-state__entry-200-status-code}{#sg_svcs-POST-state__entry-400-status-code}{#sg_svcs-POST-state__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 48. Statuscodes]

### Antworttext-Parameter (JSON) {#sg_svcs-POST-state__section_hyx_jnx_gqb}

{#sg_svcs-POST-state__table_iyx_jnx_gqb__entry__2}

| Name | Beschreibung |
|-|-|
| Status | Gibt Erfolg oder Fehler an. Datentyp: Zeichenfolge |
[ ]

{#sg_svcs-POST-state__table_iyx_jnx_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie den Lebenszyklusstatus eines Anwendungsservice in „Aktivieren" ändern.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/state" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      {
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\",
      \"state\": \"activate\"
      }
    }" \
    --user 'username':'password'

Ergebnisse, die einen erfolgreichen Vorgang anzeigen.

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

## SG Services -- NACH /sg_Services/App_Service/Update {#ariaid-title10}

Aktualisiert einen vorhandenen bereitgestellten Anwendungsservice und erstellt Tags für den angegebenen Anwendungsservice.
Die folgenden Eigenschaften zum Identifizieren eines CI haben wie folgt Vorrang:

1. sys_ID: Wenn 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 Nummer nicht angegeben ist.
{#sg_svcs-POST-update__ol_qk4_msd_3qb}

### URL-Format

Versionierte URL: /api/sn_Service_Graph/{api_Version}/sg_Services/App_Service/Update

Standard-URL: /api/sn_Service_Graph/sg_Services/App_Service/Update  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#sg_svcs-POST-update__entry__2}{#sg_svcs-POST-update__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 49. Pfad-Parameter]

{#sg_svcs-POST-update__entry__6}{#sg_svcs-POST-update__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-update__sg_svcs-reqParm-sysid-ph}

| 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. Sie können die sys_ID, die Nummer oder die Ire senden, um einen Anwendungsservice zu identifizieren. Keines dieser Felder kann jedoch aktualisiert werden, wenn sie als Bezeichner verwendet werden. Zum Aktualisieren der Ire-Felder muss die Eingabe die sys_ID oder die sys_number als Bezeichner enthalten. 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 |
[Tabelle : 50. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-update__entry__16}{#sg_svcs-POST-update__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 51. Anforderungskopfzeilen.]

{#sg_svcs-POST-update__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 52. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sg_svcs-POST-update__entry__24}{#sg_svcs-POST-update__entry-200-status-code}{#sg_svcs-POST-update__entry-400-status-code}{#sg_svcs-POST-update__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch, oder der Anwender hat nicht die Rolle „App_Service_admin". |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 53. Statuscodes]

### Antworttext-Parameter (JSON) {#sg_svcs-POST-update__section_hyx_jnx_gqb}

{#sg_svcs-POST-update__table_iyx_jnx_gqb__entry__2}{#sg_svcs-POST-update__sg_svcs-reqParm-ire-ph}

| 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 |
| \<updated fields\> | Wenn die Aktualisierung erfolgreich ist, wird jedes geänderte Feld, das in der Nutzlast gesendet wird, im Antworttext aufgeführt. |
[ ]

{#sg_svcs-POST-update__table_iyx_jnx_gqb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Anwendungsservice aktualisiert wird, wobei der Name als Ire-Feld verwendet wird.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/update" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      {
       \"name\": \"Test Register\",
       \"environment\": \"Test\",
       \"version\": \"1.0\"
      }
    }" \
    --user 'username':'password'

Die Antwort enthält Informationen zur Identifizierung des Anwendungsservice und aktualisierte Felder.

    {
      "result": {
      "sys_id": "123456",
      "number": "SVCKji0w9e",
      "name": "Test Register",
      "environment": "Test",
      "version": "1.0"
      }
    }


