--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Anwendungsservice-API # Anwendungsservice-API {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 15 Minuten Lesedauer Die Anwendungsservice- API stellt Endpunkte bereit, mit denen Sie Anwendungsservices erstellen, ändern und aktualisieren können. Diese API erfordert, dass der Benutzer die Rolle „Anwendungsservice-Administrator" \[app_service_admin\] besitzt. Wichtig: Ab Release Rome wird die Anwendungsservice- API nicht mehr verbessert und unterstützt. Weitere Informationen finden Sie im Artikel [Deprecation Process \[KB0867184\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB0867184) (Abkündigungsprozess) in der Now Support Knowledge Base. ## Anwendungsservice: GET /now/cmdb/app_service/{sys_id}/getContent {#ariaid-title2} Ruft eine Liste von Configuration Items (CI) in einem zugeordneten Anwendungsservice und die Beziehungen zwischen ihnen ab. Ruft nur Inhalte für Services ab, die manuell erstellt wurden. ### URL-Format {#appservice-GET-getContent__section_lwf_psn_wlb} Standard-URL: /api/now/cmdb/app_service/{sys_id}/getContent ### Unterstützte Anforderungsparameter {#appservice-GET-getContent__entry__2} | Name | Beschreibung | |-|-| | sys_id | Sys_id des zugeordneten Anwendungsservice. Befindet sich in der Tabelle „Zugeordneter Anwendungsservice" \[cmdb_ci_service_discovered\]. Datentyp: Zeichenfolge | [Tabelle : 1. Pfadparameter] {#appservice-GET-getContent__entry__6} | Name | Beschreibung | |-|-| | Modus | Menge der zurückzugebenden Beziehungsdaten. Gültige Werte: * Shallow: Gibt über- und untergeordnete Beziehungen zwischen CIs innerhalb eines Service zurück. * Vollständig: Gibt zusätzlich zu den im seichten Modus zurückgegebenen Daten CI-Attribute und Suchinformationen zurück. {#appservice-GET-getContent__ul_mcl_cl4_ndb} Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden. Datentyp: Zeichenfolge | [Tabelle : 2. Abfrageparameter] {#appservice-GET-getContent__entry__10} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 3. Anforderungstextparameter (XML oder JSON)] ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#appservice-GET-getContent__entry__14}{#appservice-GET-getContent__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 4. Anforderungskopfzeilen] {#appservice-GET-getContent__entry__18} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 5. Antwortkopfzeilen] ### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#appservice-GET-getContent__entry__22}{#appservice-GET-getContent__entry-200-status-code}{#appservice-GET-getContent__entry-400-status-code}{#appservice-GET-getContent__entry-401-appservice}{#appservice-GET-getContent__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert Die Anmeldeinformationen des Anwenders sind falsch oder er verfügt nicht über die Rolle „app_service_admin". | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 6. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#appservice-GET-getContent__table_nyj_nl4_wlb__entry__2} | Name | Beschreibung | |-|-| | cmdb | Liste von Objekten, die die CIs beschreiben, die dem angegebenen Anwendungsservice zugeordnet sind. Datentyp: Objekt "cmdb": [ { "items": {Object}, "relations": [Array] } ] | | cmdb.items | CIs innerhalb des Anwendungsservice. Wenn der vollständige Abfrageparameter in der Anforderung übergeben wurde, enthält dieser Abschnitt Attribute und Suchinformationen für jedes CI. Datentyp: Array "items": [ { "className": "String", "values": {Object} } ] | | cmdb.items.className | Name der Klasse, die das CI enthält. Datentyp: Zeichenfolge | | cmdb.items.values | Informationen, die zum Auffinden eines zugeordneten CI verwendet werden. Datentyp: Objekt "values": { "name": "String", "sys_id": "String" } | | cmdb.items.values.name | Name des CI. Datentyp: Zeichenfolge | | cmdb.items.values.sys_id | Sys_id des CI. Datentyp: Zeichenfolge | | CMDB-Beziehungen | Beziehungsdaten für zugeordnete CIs, z. B. Hosts und deren untergeordnete Elemente. Datentyp: Array | | service | Liste der Services, die sich auf den identifizierten Service beziehen. Datentyp: Array "service": [ { "name": "String", "service_relations": [Array], "url": "String" } ] | | service.name | Name des Anwendungsservice. Datentyp: Zeichenfolge | | service.service_beziehungen | Hierarchiedaten für die CIs innerhalb des Anwendungsservice. 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 "service_relations": [ { "child": "String", "parent": "String" } ] | | service.service_beziehungen.untergeordnetes Element | Name eines dem CI zugehörigen untergeordneten CI. Datentyp: Zeichenfolge | | service.service_beziehungen.parent | Name des übergeordneten CI, das sich auf das CI bezieht. Datentyp: Zeichenfolge | | service.url | Relativer Pfad zum Anwendungsservice. Datentyp: Zeichenfolge | [ ] {#appservice-GET-getContent__table_nyj_nl4_wlb} ### Beispiel für eine cURL-Anforderung curl "https://instance.servicenow.com/api/now/cmdb/app_service/2fce42d80a0a0bb4004af34d7e3984c8/getContent?mode=shallow" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' { "service": { "name": "PeopleSoft Portals", "url": "/api/now/table/cmdb_ci_service_discovered/2fce42d80a0a0bb4004af34d7e3984c8", "service_relations": [ { "parent": "", "child": "3a2810c20a0a0bb400268337d6e942ca" }, { "parent": "3a27f1520a0a0bb400ecd6ff7afcf036", "child": "3a5dd3dbc0a8ce0100655f1ec66ed42c" }, { "parent": "3a290cc60a0a0bb400000bdb386af1cf", "child": "3a307c930a0a0bb400353965d0b8861f" }, { "parent": "3a172e820a0a0bb40034228e9f65f1be", "child": "3a27d4370a0a0bb4006316812bf45439" }, { "parent": "", "child": "3a172e820a0a0bb40034228e9f65f1be" }, { "parent": "", "child": "3a27f1520a0a0bb400ecd6ff7afcf036" }, { "parent": "3a2810c20a0a0bb400268337d6e942ca", "child": "3a290cc60a0a0bb400000bdb386af1cf" } ] }, "cmdb": { "relations": [], "items": [ { "values": { "sys_id": "3a172e820a0a0bb40034228e9f65f1be", "name": "PS LoadBal01" }, "className": "cmdb_ci_win_server" }, { "values": { "sys_id": "3a2810c20a0a0bb400268337d6e942ca", "name": "PS Apache03" }, "className": "cmdb_ci_web_server" }, { "values": { "sys_id": "55b35562c0a8010e01cff22378e0aea9", "name": "ny8500-nbxs08" }, "className": "cmdb_ci_netgear" }, { "values": { "sys_id": "3a27f1520a0a0bb400ecd6ff7afcf036", "name": "PS Apache02" }, "className": "cmdb_ci_web_server" }, { "values": { "sys_id": "3a307c930a0a0bb400353965d0b8861f", "name": "PS ORA01" }, "className": "cmdb_ci_database" } ] } } ## Anwendungsservice: GET /now/cmdb/csdm/app_service/find_service {#ariaid-title3} Gibt grundlegende Informationen zu einem angegebenen Anwendungsservice und dem zugehörigen Geschäftskontext zurück. Hinweis: Dieser Endpunkt ist veraltet, verwenden Sie stattdessen [SG Services -- POST -- /sg_services/app_service/find](https://www.servicenow.com/docs/QKsKqdKcHo6d98hPnlrdag#sg_svcs-POST-find "Sucht die Details eines bestimmten Anwendungsservice und seiner vorgelagerten Beziehungen."). ### URL-Format Standard-URL: /api/now/cmdb/csdm/app_service/find_service ### Unterstützte Anforderungsparameter {#appservice-GET-find_service__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 7. Pfadparameter] {#appservice-GET-find_service__entry__6} | Name | Beschreibung | |-|-| | name | Erforderlich, wenn number nicht übergeben wird. Name des Services, für den Informationen zurückgegeben werden sollen. Befindet sich in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\]. Datentyp: Zeichenfolge | | Nummer | Erforderlich, wenn name nicht übergeben wird. Eindeutige Nummer, die den Anwendungsservice identifiziert, für den Informationen zurückgegeben werden sollen. Befindet sich in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\]. Datentyp: Zeichenfolge | [Tabelle : 8. Abfrageparameter] {#appservice-GET-find_service__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 9. Anforderungstextparameter (XML oder JSON)] ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#appservice-GET-find_service__entry__16}{#appservice-GET-find_service__accept-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | [Tabelle : 10. Anforderungskopfzeilen] {#appservice-GET-find_service__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 11. Antwortkopfzeilen] ### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#appservice-GET-find_service__table_wwn_rhd_ct__entry__2}{#appservice-GET-find_service__entry-200-status-code}{#appservice-GET-find_service__entry-400-status-code}{#appservice-GET-find_service__entry-401-appservice}{#appservice-GET-find_service__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert Die Anmeldeinformationen des Anwenders sind falsch oder er verfügt nicht über die Rolle „app_service_admin". | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 12. Statuscodes] {#appservice-GET-find_service__table_wwn_rhd_ct} ### Parameter des Antworttexts (JSON oder XML) {#appservice-GET-find_service__entry__34}{#appservice-GET-find_service__entry-error-appservice}{#appservice-GET-find_service__entry-error-details-appservice}{#appservice-GET-find_service__entry-error-message-appservice} | Name | Beschreibung | |-|-| | Fehler | Beschreibt einen aufgetretenen Fehler. Datentyp: Objekt "error": { "details": "String", "message": "String" } | | Fehler.Details | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, in der der Fehler beschrieben wird. Datentyp: Zeichenfolge | | -Services | Array von Objekten, wobei jedes Objekt Details zu Services enthält, die dem angegebenen Anwendungsservice zugeordnet sind. Datentyp: Array "services": [ { "environment": "String", "name": "String", "number": "String", "relationships": {Object}, "sys_id": "String", "version": "String" } ] | | Services.Environment | Umgebung, in der der Anwendungsservice bereitgestellt wird, z. B. „Produktion" oder „Testlabor 2". Dies kann ein beliebiger Wert sein, der für den Implementierer sinnvoll ist. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: null | | services.name | Erforderlich. Name des Anwendungsservice. Muss ein eindeutiger Name aus allen anderen Anwendungsservices sein. Datentyp: Zeichenfolge Maximale Länge: 255 | | service.number | Eindeutige Nummer, die den Anwendungsservice identifiziert. Dieser Wert wird anfänglich vom Endpunkt generiert. Datentyp: Zeichenfolge | | Services.Beziehungen | Servicetypen, die dem Anwendungsservice zugeordnet sind. Datentyp: Objekt "relationships": { "business_app": [Array], "business_service_offering": [Array], "technical_service_offering": [Array] } | | „services.relationships.business_app" | Liste der sys_ids der Geschäftsanwendungen, die sich auf den Anwendungsservice beziehen. Datentyp: Array | | services.relationships.technical_service_offering | Liste der sys_ids der Business-Service-Angebote im Zusammenhang mit dem Anwendungsservice. Datentyp: Array | | „services.relationships.business_service_offering" | Liste der sys_ids der technischen Serviceangebote im Zusammenhang mit dem Anwendungsservice. Datentyp: Array | | service.sys_id | Sys_id des Anwendungsservice. Datentyp: Zeichenfolge | | services.version | Versionsnummer des Anwendungsservice. Datentyp: Zeichenfolge Maximale Länge: 40 Format: anwenderdefinierbar Standard: null | [ ] ### Beispiel für eine cURL-Anforderung curl -X GET \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/find_service?name=Email_East&number=SNSVC0001018 \ -H 'Accept: application/json' \ -u 'username':'password' { "result": { "services": [ { "name": "Email_East", "number": "SNSVC0001018", "sys_id": "f809cb60db94101037740f95ca96190f", "environment": "Production", "version": "1.1.1", "relationships": { "business_app": [ "658c7620db54101037740f95ca9619f2" ], "technical_service_offering": [], "business_service_offering": [ "069c7e20db54101037740f95ca9619bf" ] } } ] } } ## Anwendungsservice -- POST /now/cmdb/app_service/create {#ariaid-title4} Erstellt einen Anwendungsservice oder aktualisiert einen vorhandenen Anwendungsservice. ### URL-Format Standard-URL: /api/now/cmdb/app_service/create ### Unterstützte Anforderungsparameter {#createService-POST-api-now-cmdb-app__entry__2} | Parameter | Beschreibung | |-|-| | Keine | | [Tabelle : 13. Parameter] ### Kopfzeilen Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#createService-POST-api-now-cmdb-app__entry__6}{#createService-POST-api-now-cmdb-app__accept-RESTAPI}{#createService-POST-api-now-cmdb-app__content_type-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | | Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 14. Anforderungskopfzeilen] {#createService-POST-api-now-cmdb-app__entry__12} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 15. Antwortkopfzeilen] ### Statuscodes Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#createService-POST-api-now-cmdb-app__table_wwn_rhd_ct__entry__2}{#createService-POST-api-now-cmdb-app__entry-200-status-code}{#createService-POST-api-now-cmdb-app__entry-400-status-code}{#createService-POST-api-now-cmdb-app__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | [Tabelle : 16. Statuscodes] {#createService-POST-api-now-cmdb-app__table_wwn_rhd_ct} ### Anforderungstext Die API akzeptiert diese JSON-Elemente im Anforderungstext. Darüber hinaus können Sie ein beliebiges Feld aus der Tabelle „Zugeordneter Anwendungsservice" \[cmdb_ci_service_discovered\] hinzufügen, um Daten an den Anwendungsservice-Datensatz zu übergeben. Um beispielsweise dem Feld „Kommentare" Inhalt hinzuzufügen, fügen Sie `"comments": "Passing data to the Comments field"` zur JSON-Anforderung hinzu. {#createService-POST-api-now-cmdb-app__table_rm1_yjd_kv__entry__2} | Elemente | Beschreibung | |-|-| | Name | Name des Anwendungsservice, den Sie erstellen oder aktualisieren möchten. | | service_relations | Informationen über CIs und die Hierarchie, die sie bilden. Alle CIs bilden Paare aus einem übergeordneten CI und einem untergeordneten CI. Das oberste CI, als Einstiegspunkt eines Anwendungsservice bezeichnet, verfügt nicht über ein übergeordnetes CI. | | übergeordnet | Sys_id des CI, dessen ausgehende Verbindung dieses CI mit dem CI auf der niedrigeren Ebene in der Kartenhierarchie verbindet. | | child | Sys_id des CI, dessen eingehende Verbindung dieses CI mit dem CI auf einer höheren Ebene in der Kartenhierarchie verbindet. | [Tabelle : 17. Im Anforderungstext akzeptierte Elemente] {#createService-POST-api-now-cmdb-app__table_rm1_yjd_kv} ### Antworttext Die API gibt diese JSON-Elemente im Antworttext zurück. {#createService-POST-api-now-cmdb-app__table_mc1_pr1_tx__entry__2} | Elemente | Beschreibung | |-|-| | URL | URL der REST-API der Standardtabelle zum Anzeigen der sys_id eines Anwendungsservice-Datensatzes. Dieses Element wird nur angezeigt, wenn der Endpunkt erfolgreich ist. Datentyp: Zeichenfolge | | getContentUrl | REST-API-Pfad zum Abrufen des Anwendungsservice-Inhalts. Dieses Element wird nur angezeigt, wenn der Endpunkt erfolgreich ist. Datentyp: Zeichenfolge | | Info | Anzahl der CIs, die dem Anwendungsservice hinzugefügt wurden. Dieses Element wird nur angezeigt, wenn der Endpunkt erfolgreich ist. Datentyp: Zeichenfolge | | Fehler | Fehlermeldungsdetails. Dieses Element wird nur angezeigt, wenn der Endpunkt fehlschlägt. Datentyp: Objekt | | Nachricht | Fehlermeldung, die die Art des Fehlers beschreibt. Dieses Element wird nur angezeigt, wenn der Endpunkt fehlschlägt. Datentyp: Zeichenfolge | | status | Gibt „Fehler" an, wenn die REST-API fehlschlägt. Dieses Element wird nur angezeigt, wenn der Endpunkt fehlschlägt. Datentyp: Zeichenfolge | [Tabelle : 18. Im Antwort-Haupttext zurückgegebene Elemente] {#createService-POST-api-now-cmdb-app__table_mc1_pr1_tx} ### Beispiel für eine cURL-Anforderung curl "http:///api/now/cmdb/app_service/create" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"name\": \"myTestAppService\", \"comments\": \"Passing data to the Comments field\", \"service_relations\": [ { \"parent\": \"\", \"child\": \"3a70f789c0a8ce010091b0ea635b982a\" },{ \"parent\": \"3a70f789c0a8ce010091b0ea635b982a\", \"child\": \"b4fd7c8437201000deeabfc8bcbe5dc1\" },{ \"parent\": \"b4fd7c8437201000deeabfc8bcbe5dc1\", \"child\": \"53fdbc8437201000deeabfc8bcbe5d10\" } ] }" \ --user 'admin':'admin' { "result": { "url": "/api/now/table/cmdb_ci_service_discovered/b1cff89fc9e19300964fcbb1ac3059a5", "getContentUrl": "/api/now/cmdb/app_service/b1cff89fc9e19300964fcbb1ac3059a5/getContent", "info": "3 CIs added to service" } } ## Anwendungsservice -- POST /now/cmdb/csdm/app_service/register_service {#ariaid-title5} Erstellt einen Anwendungsservice-Datensatz-Stub in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\] und füllt ihn mit den übergebenen Informationen. Vor dem Speichern des Datensatzes werden die übergebenen Parameter und die Eindeutigkeit des Anwendungsservicenamens validiert. Es erstellt auch vorgelagerte Beziehungen, die dem Service Geschäftskontext bieten, indem die angegebenen Geschäftsanwendungen, Business-Service-Angebote und technischen Serviceangebote der Serviceanwendung zugeordnet werden. Es werden keine nachgelagerten Beziehungen zur Infrastruktur erstellt. Um nachgelagerte Beziehungen zu definieren, müssen Sie den Endpunkt „Anwendungsservice - PUT /now/cmdb/csdm/app_service/{service_sys_id}/populate_service" aufrufen. Hinweis: Dieser Endpunkt ist veraltet, verwenden Sie stattdessen [SG Services -- POST -- /sg_services/app_service/register](https://www.servicenow.com/docs/QKsKqdKcHo6d98hPnlrdag#sg_svcs-POST-register "Erstellt einen Anwendungsservice, Tags und erstellt vorgelagerte Beziehungen wie Geschäftsanwendungen, Business-Service-Angebote und andere Anwendungsservices."). ### URL-Format Standard-URL: /api/now/cmdb/csdm/app_service/register_service ### Unterstützte Anforderungsparameter {#appservice-POST-register_service__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 19. Pfadparameter] {#appservice-POST-register_service__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 20. Abfrageparameter] {#appservice-POST-register_service__entry__10}{#appservice-POST-register_service__entry-basic_details-environment-appservice}{#appservice-POST-register_service__entry-basic_details-name-appservice}{#appservice-POST-register_service__entry-basic_details-version-appservice}{#appservice-POST-register_service__entry-relationships-bus_app-appservice}{#appservice-POST-register_service__entry-relationships-bus_srv_off-appservice}{#appservice-POST-register_service__entry-relationships-tech_srv_off-appservice} | Name | Beschreibung | |-|-| | grundlegende_details | Erforderlich. Details des Services, der dem angegebenen Anwendungsservice zugeordnet ist. Datentyp: Objekt "basic_details": { "environment": "String", "name": "String", "version": "String" } | | grundlegende_details.umgebung | Umgebung, in der der Anwendungsservice bereitgestellt wird, z. B. „Produktion" oder „Testlabor 2". Dies kann ein beliebiger Wert sein, der für den Implementierer sinnvoll ist. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: null | | grundlegende_details.name | Erforderlich. Name des Anwendungsservice. Muss ein eindeutiger Name aus allen anderen Anwendungsservices sein. Datentyp: Zeichenfolge Maximale Länge: 255 | | grundlegende_details.version | Versionsnummer des Anwendungsservice. Datentyp: Zeichenfolge Maximale Länge: 40 Format: anwenderdefinierbar Standard: null | | Beziehungen | Vorgelagerte (übergeordnete) Servicetypen, die dem Anwendungsservice zugeordnet werden sollen. Diese Beziehungen werden in der Tabelle „CI-Beziehungen" \[cmdb_rel_ci\] gespeichert. Datentyp: Objekt "relationships": { "business_app": [Array], "business_service_offering": [Array], "technical_service_offering": [Array] } | | beziehungen.business_app | Liste der sys_ids der Geschäftsanwendungen, die sich auf den Anwendungsservice beziehen sollen. Datentyp: Array | | beziehungen.business_service_offering | Liste der sys_ids der Business-Service-Angebote, die sich auf den Anwendungsservice beziehen sollen. Datentyp: Array | | beziehungen.technical_service_offering | Liste der sys_ids der technischen Serviceangebote, die sich auf den Anwendungsservice beziehen sollen. Datentyp: Array | [Tabelle : 21. Anforderungstextparameter] ### Header Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#appservice-POST-register_service__table_hxm_cks_mlb__entry__2}{#appservice-POST-register_service__accept-JSON-only-entry-RESTAPI}{#appservice-POST-register_service__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 22. Anforderungskopfzeilen] {#appservice-POST-register_service__table_hxm_cks_mlb} {#appservice-POST-register_service__entry__34} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 23. Antwortkopfzeilen] ### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#appservice-POST-register_service__table_wwn_rhd_ct__entry__2}{#appservice-POST-register_service__entry-400-status-code}{#appservice-POST-register_service__entry-401-appservice}{#appservice-POST-register_service__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 201 | Erfolgreich. Der Anwendungsservice wurde erfolgreich registriert. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert Die Anmeldeinformationen des Anwenders sind falsch oder er verfügt nicht über die Rolle „app_service_admin". | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 24. Statuscodes] {#appservice-POST-register_service__table_wwn_rhd_ct} ### Parameter des Antworttexts (JSON oder XML) {#appservice-POST-register_service__entry__48}{#appservice-POST-register_service__entry-error-appservice}{#appservice-POST-register_service__entry-error-details-appservice}{#appservice-POST-register_service__entry-error-message-appservice} | Name | Beschreibung | |-|-| | Fehler | Beschreibt einen aufgetretenen Fehler. Datentyp: Objekt "error": { "details": "String", "message": "String" } | | Fehler.Details | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, in der der Fehler beschrieben wird. Datentyp: Zeichenfolge | | Nummer | Eindeutige Nummer, die den Anwendungsservice identifiziert. Diese Zahl wird vom Endpunkt generiert. | | service_sys_id | Sys_id des registrierten Anwendungsservice. | [ ] ### Beispiel für eine cURL-Anforderung curl -X POST \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/register_service \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' -d '{ "basic_details": { "environment": "Test Lab 2", "name": "Test Lab 2", "version": "1.1.1" }, "relationships": { "business_app":["f07c7620db54101037740f95ca96199a"], "business_service_offering":["069c7e20db54101037740f95ca9619bf"] } }' { "result": { "service_sys_id": "80f21bbadbd410103d3a93c3e296199a", "number": "SNSVC0001018 } } ## Anwendungsservice: PUT /now/cmdb/csdm/app_service/{service_sys_id}/populate_service {#ariaid-title6} Füllt den angegebenen Anwendungsservice mit einem angegebenen Satz nachgelagerter Konfigurationselemente (Configuration Items, CI) auf. Bevor Sie diesen Endpunkt aufrufen, müssen Sie den Endpunkt [POST /now/cmdb/csdm/app_service/register_service aufrufen](https://www.servicenow.com/docs/bCCOdOMC2qEPHqSYkyEw8Q#appservice-POST-register_service "Erstellt einen Anwendungsservice-Datensatz-Stub in der Tabelle „Anwendungsservice“ [cmdb_ci_service_auto] und füllt ihn mit den übergebenen Informationen."), um den Anwendungsservice zu erstellen. Hinweis: Dieser Endpunkt ist veraltet, verwenden Sie stattdessen [SG Services -- POST -- /sg_services/app_service/populate](https://www.servicenow.com/docs/QKsKqdKcHo6d98hPnlrdag#sg_svcs-POST-populate "Füllt einen Anwendungsservice mit einer Serviceauffüllungsmethode auf."). ### URL-Format Standard-URL: /api/now/cmdb/csdm/app_service/{service_sys_id}/populate_service ### Unterstützte Anforderungsparameter {#appservice-PUT-populate_service__entry__2} | Name | Beschreibung | |-|-| | service_sys_id | Sys_id des Anwendungsservice, der mit den angegebenen CIs gefüllt werden soll. Befindet sich in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\]. Datentyp: Zeichenfolge | [Tabelle : 25. Pfadparameter] {#appservice-PUT-populate_service__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 26. Abfrageparameter] {#appservice-PUT-populate_service__entry__10} | Name | Beschreibung | |-|-| | „population_method" | Dem angegebenen Anwendungsservice zuzuordnende CIs. Die Elemente im Objekt populate_method hängen von der Art der ausgefüllten Informationen ab. durch den Parameter type definiert. Datentyp: Objekt Für type = cmdb_group_based { "population_method": { "group_id": "String", "type": "String" } } Für type = Discovery Hinweis: Um diesen Typ zu verwenden, müssen Sie das Plugin „Service Mapping" (com.snc.service-mapping) aktivieren. { "population_method": { "attributes": [Array], "entry_point_id": "String", "type":"String" } } Für type = tag_list Hinweis: Um diesen Typ zu verwenden, müssen Sie das Plugin „Service Mapping" (com.snc.service-mapping) aktivieren. { "population_method": { "tags":[Array], "type":"String" } } | | „population_method.attributes" | Liste der Attribute, die dem CI zugeordnet werden sollen, z. B. Host, Port, Name und URL. Weitere Informationen zu Einstiegspunkten finden Sie unter [Einstiegspunktattribute](https://www.servicenow.com/docs/access?context=r_EntryPointsforBizSvcDef&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). Hinweis: Sie müssen alle erforderlichen Attribute übergeben. Datentyp: Array { "attributes": { "name":"String", "value":"String" } } | | population_method.attributes.name | Name des Attributs, z. B. Host, Port, Name und URL. Datentyp: Zeichenfolge | | „population_method.attributes.value" | Attributwert. Datentyp: Zeichenfolge | | „population_method.entry_point" | Erforderlich, wenn population_method.type = Discovery. Einstiegspunkt in den Anwendungsservice. Weitere Informationen zu Einstiegspunkten finden Sie unter [Einstiegspunktattribute](https://www.servicenow.com/docs/access?context=r_EntryPointsforBizSvcDef&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US) und [Einstiegspunkttypen für Service-Mapping erstellen](https://www.servicenow.com/docs/access?context=t_CreateEntryPoint&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). Datentyp: Zeichenfolge | | „population_method.group_id" | Erforderlich, wenn population_method.type = cmdb_group_based. Sys_id der Gruppe, die dem CI zugeordnet werden soll. Befindet sich in der Tabelle „CMDB-Gruppe" \[cmdb_group\]. Datentyp: Zeichenfolge | | „population_method.tags" | Liste der Tags, die dem CI zugeordnet werden sollen. Diese Informationen befinden sich in der Tabelle „Schlüsselwerte" \[cmdb_key_value\]. Datentyp: Array { "tags": { "tag": "String", "value": "String" } } | | „population_method.tags.tag" | Name des Tags. Datentyp: Zeichenfolge | | „population_method.tags.value" | Tag-Wert. Datentyp: Zeichenfolge | | „population_method.type" | Erforderlich. Auszufüllender CI-Typ. Gültige Werte: * cmdb_group_based * Erkennung von * tag_list {#appservice-PUT-populate_service__ul_j42_5jm_tlb} Datentyp: Zeichenfolge | [Tabelle : 27. Anforderungstextparameter (XML oder JSON)] ### Header Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#appservice-PUT-populate_service__table_h3m_gh2_mlb__entry__2}{#appservice-PUT-populate_service__accept-JSON-only-entry-RESTAPI}{#appservice-PUT-populate_service__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 28. Anforderungskopfzeilen] {#appservice-PUT-populate_service__table_h3m_gh2_mlb} {#appservice-PUT-populate_service__entry__38} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 29. Antwortkopfzeilen] ### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#appservice-PUT-populate_service__entry__42}{#appservice-PUT-populate_service__entry-200-status-code}{#appservice-PUT-populate_service__entry-401-appservice}{#appservice-PUT-populate_service__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 401 | Nicht autorisiert Die Anmeldeinformationen des Anwenders sind falsch oder er verfügt nicht über die Rolle „app_service_admin". | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. | [Tabelle : 30. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#appservice-PUT-populate_service__entry__50}{#appservice-PUT-populate_service__entry-error-appservice}{#appservice-PUT-populate_service__entry-error-details-appservice}{#appservice-PUT-populate_service__entry-error-message-appservice} | Name | Beschreibung | |-|-| | Fehler | Beschreibt einen aufgetretenen Fehler. Datentyp: Objekt "error": { "details": "String", "message": "String" } | | Fehler.Details | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, in der der Fehler beschrieben wird. Datentyp: Zeichenfolge | [ ] ### Beispiel für eine cURL-Anforderung Das folgende Codebeispiel zeigt, wie ein Anwendungsservice gefüllt wird, wenn der CI-Typ cmdb_group_based lautet. curl -X PUT \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/f809cb60db94101037740f95ca96190f/populate_service \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "population_method": { "type":"cmdb_group_based", "group_id": "e809cf60db94101037640f95ca961932" } }' { "result": {} } Das folgende Codebeispiel zeigt, wie ein Discovery-Anwendungsservice gefüllt wird. curl -X PUT \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/f809cb60db94101037740f95ca96190f/populate_service \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "population_method": { "type":"discovery", "entry_point_id":"cmdb_ci_endpoint_ad_forest", "attributes": [ { "name":"host", "value":"test1.com" }, { "name":"port", "value":"500" }, { "name":"protocol", "value":"ssh" } ] } }' { "result": {} } ## Anwendungsservice: PUT /now/cmdb/csdm/app_service/{service_sys_id}/service_details {#ariaid-title7} Aktualisiert den angegebenen Anwendungsservice mit den übergebenen Basisinformationen. Außerdem wird die Eindeutigkeit des Anwendungsservice validiert, indem die übergebenen Informationen mit den Regeln der Identification and Reconciliation Engine (IRE) verglichen werden, die in der Anwendungsserviceklasse definiert sind. Hinweis: Dieser Endpunkt ist veraltet, verwenden Sie stattdessen [SG Services -- POST -- /sg_services/app_service/update](https://www.servicenow.com/docs/QKsKqdKcHo6d98hPnlrdag#sg_svcs-POST-update "Aktualisiert einen vorhandenen bereitgestellten Anwendungsservice und erstellt Tags für den angegebenen Anwendungsservice."). ### URL-Format Standard-URL: /api/now/cmdb/csdm/app_service/{service_sys_id}/service_details ### Unterstützte Anforderungsparameter {#appservice-PUT-service_details__entry__2} | Name | Beschreibung | |-|-| | service_sys_id | Sys_id des zu aktualisierenden Anwendungsservice. Befindet sich in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\]. Datentyp: Zeichenfolge | [Tabelle : 31. Pfadparameter] {#appservice-PUT-service_details__entry__6} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 32. Abfrageparameter] {#appservice-PUT-service_details__entry__10}{#appservice-PUT-service_details__entry-basic_details-appservice}{#appservice-PUT-service_details__entry-basic_details-environment-appservice}{#appservice-PUT-service_details__entry-basic_details-name-appservice}{#appservice-PUT-service_details__entry-relationships-appservice}{#appservice-PUT-service_details__entry-relationships-bus_app-appservice}{#appservice-PUT-service_details__entry-relationships-bus_srv_off-appservice}{#appservice-PUT-service_details__entry-relationships-tech_srv_off-appservice} | Name | Beschreibung | |-|-| | grundlegende_details | Details des Services, der dem angegebenen Anwendungsservice zugeordnet ist. Datentyp: Objekt "basic_details": { "environment": "String", "name": "String" } | | grundlegende_details.umgebung | Umgebung, in der der Anwendungsservice bereitgestellt wird, z. B. „Produktion" oder „Testlabor 2". Dies kann ein beliebiger Wert sein, der für den Implementierer sinnvoll ist. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: null | | grundlegende_details.name | Erforderlich. Name des Anwendungsservice. Muss ein eindeutiger Name aus allen anderen Anwendungsservices sein. Datentyp: Zeichenfolge Maximale Länge: 255 | | Beziehungen | Servicetypen, die dem Anwendungsservice zugeordnet werden sollen. In der Tabelle „CI-Beziehungen" \[cmdb_rel_ci\]. Datentyp: Objekt "relationships": { "business_app": [Array], "business_service_offering": [Array], "technical_service_offering": [Array] } | | beziehungen.business_app | Liste der sys_ids der Geschäftsanwendungen, die sich auf den Anwendungsservice beziehen sollen. Datentyp: Array | | beziehungen.business_service_offering | Liste der sys_ids der Business-Service-Angebote, die sich auf den Anwendungsservice beziehen sollen. Datentyp: Array | | beziehungen.technical_service_offering | Liste der sys_ids der technischen Serviceangebote, die sich auf den Anwendungsservice beziehen sollen. Datentyp: Array | [Tabelle : 33. Anforderungstextparameter (XML oder JSON)] ### Header Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können."). {#appservice-PUT-service_details__entry__26}{#appservice-PUT-service_details__accept-JSON-only-entry-RESTAPI}{#appservice-PUT-service_details__content_type-JSON-only-entry-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. | | Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. | [Tabelle : 34. Anforderungskopfzeilen] {#appservice-PUT-service_details__entry__32} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 35. Antwortkopfzeilen] ### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API. {#appservice-PUT-service_details__entry__36}{#appservice-PUT-service_details__entry-200-status-code}{#appservice-PUT-service_details__entry-401-appservice} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 401 | Nicht autorisiert Die Anmeldeinformationen des Anwenders sind falsch oder er verfügt nicht über die Rolle „app_service_admin". | [Tabelle : 36. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#appservice-PUT-service_details__entry__42}{#appservice-PUT-service_details__entry-error-appservice}{#appservice-PUT-service_details__entry-error-details-appservice}{#appservice-PUT-service_details__entry-error-message-appservice} | Name | Beschreibung | |-|-| | Fehler | Beschreibt einen aufgetretenen Fehler. Datentyp: Objekt "error": { "details": "String", "message": "String" } | | Fehler.Details | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, in der der Fehler beschrieben wird. Datentyp: Zeichenfolge | [ ] ### Beispiel für eine cURL-Anforderung curl -X PUT \ https://instance.servicenow.com/api/now/cmdb/csdm/app_service/f809cb60db94101037740f95ca96190f/service_details \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password' \ -d '{ "basic_details": { "environment": "Test Lab 2" }, "relationships": { "business_app" :["f07c7620db54101037740f95ca96199a"] } }' { "result": {} }