--- 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 --- # Change-Verwaltungs-API # Change-Verwaltungs-API {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 160 Minuten Lesedauer Die Change-Management- API stellt Endpunkte bereit, die die Integration von Drittanbieteranwendungen in den Prozess ServiceNow Change-Management ermöglichen. Durch die Integration Ihrer Anwendung in den ServiceNow-Change-Management-Prozess, verfügen alle Change Requests, unabhängig davon, wo sie initiiert werden, über eine einzige wahrheitsgemäße Version und bieten eine einzige Auditquelle. Verwenden Sie diese REST API, um Ihren Change-Management-Prozess mit externen Anwendungen und bei der Entwicklung von ServiceNow clientseitigen Anwendungen zu integrieren. Mit dieser REST API können Integratoren: * Initiieren Sie eine Standard-Change-Anforderung aus einer veröffentlichten Vorlage für eine Standard-Change-Anforderung. * Erstellen Sie eine Change-Anforderung vom Typ Notfall oder Normal. * Aktualisieren Sie alle Felder, die in der Change-Anforderungstabelle für eine Change-Anforderung vorhanden sind. * Aktualisieren Sie alle Felder, die in der Change-Aufgabentabelle und den Arbeitsaufgaben von der Erstellung bis zum Abschluss/Abbruch vorhanden sind. * Rufen Sie einen bestimmten Change-Anforderung, eine Standardvorlage, eine Change-Anforderungsaufgabe oder ein Change-Modell ab. * Rufen Sie mehrere Change-Anforderungen, Standardvorlagen und Change-Anforderungsaufgaben mithilfe von Paginierung ab. * Führen Sie eine Risikobewertung durch. * Betroffene Services neu laden. * Generieren und verarbeiten Sie alle zugehörigen Genehmigungsaktivitäten, die einer Change-Anforderung zugeordnet sind. * Erkennen Sie potenzielle Planungskonflikte und Zeiträume, in denen keine Konflikte auftreten. * Löschen Sie Change-Anforderungen, Change-Anforderungsaufgaben und Konfliktüberprüfungsprozesse. * Erstellen Sie einen Change-Anforderungs-Datensatz basierend auf einem Change-Modell-Datensatz. * Ruft eine Liste der verfügbaren Status für die angegebene Change-Anforderung ab, einschließlich des aktuellen Status. {#change-management-api__ul_rmh_xmm_dhb} Die Change-Management- API unterstützt ITIL-Typen und Change-Modelle mit Workflow-Studio und Workflow. Change-Modelle liefern zweckmäßige Changes. Typen und Modelle definieren Übergangskriterien, die erfüllt werden müssen, bevor die Change-Anforderung in den nächsten Status übergehen kann. Sie können diese Kriterien mithilfe von Status, Workflows, Tools und Geschäftsregeln definieren. * Herkömmliche ITIL-Typen: Standard, Notfall und Normal. * Status des Change-Modells: Neu, Geplant, Implementieren, Überprüfen und Geschlossen. {#change-management-api__ul_lxs_wzs_qpb} Sie können zusätzliche Change-Modelle in Ihrer Instanz ServiceNow konfigurieren und dann Change-Anforderungen basierend auf diesen Change-Modellen erstellen, indem Sie Endpunkte in dieser API verwenden. Verwenden Sie die Endpunkte [Change-Management -- GET /sn_chg_rest/change/model/{sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-model-sys_id "Ruft das Change-Modell ab, das durch die angegebene sys_id identifiziert wurde.") und [Change-Management -- GET /sn_chg_rest/change/model](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-model "Ruft ein oder mehrere Change-Modelle basierend auf den angegebenen Kriterien ab."), um die verfügbaren Change-Modelle in einer -Instanz abzurufen. Verwenden Sie dann [Change Management -- POST /sn_chg_rest/change](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-POST-change-sys_id "Erstellt einen Change-Anforderungsdatensatz basierend auf der Change-Anforderung. Das Erstellen mehrerer Change-Anforderungen innerhalb eines einzigen Aufrufs wird nicht unterstützt."), um eine Change-Anforderung basierend auf einem angegebenen Change-Modell zu erstellen. Informationen zur Konfiguration von Change-Modellen finden Sie unter [Change-Management konfigurieren](https://www.servicenow.com/docs/access?context=configure-change-management&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Die folgenden Rollen sind für den Zugriff auf die Change-Management- Endpunkte erforderlich: * LÖSCHEN: change_manager oder admin * GET: change_manager, itil, sn_change_read oder admin * PATCH/POST: change_manager, itil oder admin {#change-management-api__ul_wwd_k45_rnb} Zusätzlich dazu können Administratoren Change-Eigenschaften zum Konfigurieren des Change-Verwaltungs-Verhaltens verwenden. Eine Liste dieser Eigenschaften und eine Beschreibung der verfügbaren Funktionen finden Sie unter [Eigenschaften des Change-Managements](https://www.servicenow.com/docs/access?context=r_ChangeManagementProperties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). ## Change-Management -- DELETE /sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} {#ariaid-title2} Löscht die Change Request-Aufgabe, die von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-DELETE-c_id-task-t_id__section_odv_43n_ylb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task/{task_sys_id} Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} ### Unterstützte Anforderungsparameter {#change-DELETE-c_id-task-t_id__entry__2}{#change-DELETE-c_id-task-t_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung, der die Aufgabe zugeordnet ist. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Überprüft, dass die Aufgabe tatsächlich dem angegebenen Change Request zugeordnet ist. Datentyp: Zeichenfolge | | task_sys_id | Sys_id der zu löschenden Change-Anforderungsaufgabe. Befindet sich in der Tabelle „Change-Aufgaben" \[change_task\]. Datentyp: Zeichenfolge | [Tabelle : 1. Pfadparameter] {#change-DELETE-c_id-task-t_id__entry__10} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 2. Abfrageparameter] {#change-DELETE-c_id-task-t_id__entry__14} | 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."). {#change-DELETE-c_id-task-t_id__entry__18}{#change-DELETE-c_id-task-t_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 4. Anforderungskopfzeilen] {#change-DELETE-c_id-task-t_id__entry__22} | 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. {#change-DELETE-c_id-task-t_id__entry__26}{#change-DELETE-c_id-task-t_id__entry-200-status-code}{#change-DELETE-c_id-task-t_id__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. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 6. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-DELETE-c_id-task-t_id__entry__38} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für die identifizierte Change Request-Aufgabe vor dem Löschen. Datentyp: Objekt | | übergeordnet | Informationen für die Change-Anforderung, der diese Aufgabe zugeordnet wurde. Datentyp: Objekt parent: { display_value: "String", value: "String" } | | parent.display_value | Sys_id der übergeordneten Aufgabe, die in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | parent.value | Sys_id der übergeordneten Aufgabe. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die gelöschte Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire both nodes", display_value: "Retire both nodes" } } ] } ## Change-Management -- DELETE /sn_chg_rest/change/{sys_id} {#ariaid-title3} Löscht die Change-Anforderung, die der angegebenen sys_id zugeordnet ist. ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id} Standard-URL: /api/sn_chg_rest/change/{sys_id} ### Unterstützte Anforderungsparameter {#change-DELETE-change-sys_id__entry__2}{#change-DELETE-change-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id des zu löschenden Change-Anforderungsdatensatzes. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 7. Pfadparameter] {#change-DELETE-change-sys_id__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 8. Abfrageparameter] {#change-DELETE-change-sys_id__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."). {#change-DELETE-change-sys_id__entry__16}{#change-DELETE-change-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 10. Anforderungskopfzeilen] {#change-DELETE-change-sys_id__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. {#change-DELETE-change-sys_id__entry__24}{#change-DELETE-change-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 12. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-DELETE-change-sys_id__entry__36} | Name | Beschreibung | |-|-| | Ergebnis | Change-Anforderungsdatensatz, der gelöscht wurde. Jedes Element in diesem Objekt entspricht einem Feld im Datensatz der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Objekt | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { "result": { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Reboot the server at 6 am", "value": "Reboot the server at 6 am" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "b0dbda5347c12200e0ef563dbb9a718f", "value": "b0dbda5347c12200e0ef563dbb9a718f" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } } ## Change-Management -- DELETE /sn_chg_rest/change/{sys_id}/conflict {#ariaid-title4} Bricht den laufenden Konflikt-Überprüfungsprozess für den angegebenen Change Request ab (sys_id). ### URL-Format {#change-DELETE-conflict__section_x3q_tnn_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/conflict Standard-URL: /api/sn_chg_rest/change/{sys_id}/conflict ### Unterstützte Anforderungsparameter {#change-DELETE-conflict__entry__2}{#change-DELETE-conflict__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id des Change-Anforderungsdatensatzes, für den die laufende Konfliktüberprüfung abgebrochen werden soll. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 13. Pfadparameter] {#change-DELETE-conflict__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 14. Abfrageparameter] {#change-DELETE-conflict__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 15. 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."). {#change-DELETE-conflict__entry__16} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 16. Anforderungskopfzeilen] {#change-DELETE-conflict__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 17. 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. {#change-DELETE-conflict__entry__24}{#change-DELETE-conflict__entry-200-status-code}{#change-DELETE-conflict__entry-401-status-code}{#change-DELETE-conflict__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Fehlerhafte Anforderung. Abbruch fehlgeschlagen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 18. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-DELETE-conflict__entry__36} | Name | Beschreibung | |-|-| | Keine | | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request DELETE \ --user "username":"password" None ## Change-Management -- DELETE /sn_chg_rest/change/emergency/{sys_id} {#ariaid-title5} Löscht den Notfall-Change Request, der von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-DELETE-emergency__section_d4x_m3t_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/emergency/{sys_id} Standard-URL: /api/sn_chg_rest/change/emergency/{sys_id} ### Unterstützte Anforderungsparameter {#change-DELETE-emergency__entry__2}{#change-DELETE-emergency__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der zu löschenden Notfall-Change-Anforderung. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. | [Tabelle : 19. Pfadparameter] {#change-DELETE-emergency__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 20. Abfrageparameter] {#change-DELETE-emergency__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 21. 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."). {#change-DELETE-emergency__entry__16}{#change-DELETE-emergency__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 22. Anforderungskopfzeilen] {#change-DELETE-emergency__entry__20} | 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. {#change-DELETE-emergency__entry__24}{#change-DELETE-emergency__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 24. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-DELETE-emergency__entry__36} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in der Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „Notfall". Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "b0dbda5347c12200e0ef563dbb9a718f", display_value: "b0dbda5347c12200e0ef563dbb9a718f" }, state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" }, }, ] } ## Change-Management -- DELETE /sn_chg_rest/change/normal/{sys_id} {#ariaid-title6} Löscht den normalen Change Request, der von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-DELETE-normal__section_pkx_xns_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/normal/{sys_id} Standard-URL: /api/sn_chg_rest/change/normal/{sys_id} ### Unterstützte Anforderungsparameter {#change-DELETE-normal__entry__2}{#change-DELETE-normal__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der normalen Change-Anforderung zum Löschen in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 25. Pfadparameter] {#change-DELETE-normal__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 26. Abfrageparameter] {#change-DELETE-normal__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 27. 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."). {#change-DELETE-normal__entry__16}{#change-DELETE-normal__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 28. Anforderungskopfzeilen] {#change-DELETE-normal__entry__20} | 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. {#change-DELETE-normal__entry__24}{#change-DELETE-normal__entry-200-status-code}{#change-DELETE-normal__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. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 30. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-DELETE-normal__entry__36} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in der Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in der Anwenderoberfläche angezeigt werden soll. Wert ist immer „Normal". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „normal". Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" }, }, ] } ## Change-Management -- DELETE /sn_chg_rest/change/standard/{sys_id} {#ariaid-title7} Löscht den Standard-Change Request, der von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-DELETE-standard__section_tdv_s3l_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/standard/{sys_id} Standard-URL: /api/sn_chg_rest/change/standard/{sys_id} ### Unterstützte Anforderungsparameter {#change-DELETE-standard__entry__2}{#change-DELETE-standard__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der zu löschenden Standard-Change-Anforderung. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 31. Pfadparameter] {#change-DELETE-standard__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 32. Abfrageparameter] {#change-DELETE-standard__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 33. 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."). {#change-DELETE-standard__entry__16}{#change-DELETE-standard__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 34. Anforderungskopfzeilen] {#change-DELETE-standard__entry__20} | 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. {#change-DELETE-standard__table_wwn_rhd_ct__entry__2}{#change-DELETE-standard__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 36. Statuscodes] {#change-DELETE-standard__table_wwn_rhd_ct} ### Parameter des Antworttexts (JSON oder XML) {#change-DELETE-standard__entry__34} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für den identifizierten Change Request. | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in der Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Eindeutiger Identifier des Change Requests. | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "1c87925347c12200e0ef563dbb9a7177", state: { value: "-5", display_value: "New" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, ] } ## Change-Management: GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule {#ariaid-title8} Ermöglicht das Abrufen verfügbarer Zeitfenster nach Konfigurationselement-ID und Dauer, mit der Option zum Einschließen der geplanten Startzeit. Erforderliche Rolle: sn_change_writer. Hinweis: Beim Ausführen dieses Endpunkts werden die verfügbaren Start- und Endzeiten nicht aufgelistet. Verwenden Sie den Link in der Eigenschaft des Antworttextes worker.link, um die Zeitplandaten abzurufen. Siehe auch: * [/sn_chg_rest/change/{change_sys_id}/schedule abrufen](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-change-sys_id-sched "Aktiviert das Abrufen der verfügbaren Zeitfenster für eine Change-Anforderung.") * [PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-PATCH-c_id-sched-first "Aktualisiert die geplanten Start- und Endzeiten einer Change-Anforderung anhand des ersten gefundenen verfügbaren Zeitfensters.") {#change-GET-c_id-schedule__ul_orx_mts_npb} ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/ci/{cmdb_ci_sys_id}/schedule Standard-URL: /api/sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule ### Unterstützte Anforderungsparameter {#change-GET-c_id-schedule__entry__2}{#change-GET-c_id-schedule__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | cmdb_ci_sys_id | Sys_id eines Datensatzes in der Tabelle „Konfigurationselemente" \[cmdb_ci\]. Für diesen Endpunkt ist keine Change-Anforderung erforderlich. | [Tabelle : 37. Pfadparameter] {#change-GET-c_id-schedule__table_fd4_yhf_jpb__entry__2} | Name | Beschreibung | |-|-| | Dauer_in_Sekunden | Dauer des Change in Sekunden, d. h. wie viel Zeit zum Abschließen der Change-Anforderungsaufgabe erforderlich ist. Datentyp: Ganzzahl | | planned_start_time | Optional. Datum und Uhrzeit für den Start der Implementierung der Change-Anforderung in UTC. Rufen Sie das verfügbare Zeitfenster ab, das um oder später als diese Zeit beginnt. Wenn nicht angegeben, verwendet das System die aktuelle Uhrzeit als Startzeit. Zeitformat: jjjj-mm-tt hh:mm:ss Datentyp: Zeichenfolge | [Tabelle : 38. Abfrageparameter] {#change-GET-c_id-schedule__table_fd4_yhf_jpb} {#change-GET-c_id-schedule__entry__14} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 39. 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."). {#change-GET-c_id-schedule__entry__18}{#change-GET-c_id-schedule__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 40. Anforderungskopfzeilen] {#change-GET-c_id-schedule__entry__22} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 41. 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. {#change-GET-c_id-schedule__entry__26} | Statuscode | Beschreibung | |-|-| | 202 | Das System hat die Anforderung akzeptiert. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. Mögliche Probleme: * cmdb_ci mit der angegebenen sys_id nicht gefunden. Der Datensatz ist entweder nicht vorhanden, oder der Anwender hat keinen Lesezugriff darauf. * Der Abfrageparameterwert „duration_in_seconds" wurde nicht angegeben. * Ungültiger Abfrageparameterwert für „duration_in_seconds" oder „planned_start_time" angegeben. {#change-GET-c_id-schedule__ul_rpf_3sk_npb} | [Tabelle : 42. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-c_id-schedule__section_p33_ccf_jpb} {#change-GET-c_id-schedule__table_is2_n4s_jpb__entry__2}{#change-GET-c_id-schedule__row-result-error-cmdb}{#change-GET-c_id-schedule__row-result-error_detail-cmdb}{#change-GET-c_id-schedule__row-result-error_message-cmdb} | Name | Beschreibung | |-|-| | Fehler | Informationen zu Fehlern, die bei der Verarbeitung der Endpunktanforderung aufgetreten sind. Datentyp: Objekt "error": { "detail": "String", "message": "String", "status": "String" } | | Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, die den Fehler identifiziert. Datentyp: Zeichenfolge | | Nachrichten | Nachrichteninformationen. Datentyp: Objekt "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | nachrichten.fehlermeldungen | Bei der Verarbeitung der Anforderung sind Fehlermeldungen aufgetreten. Datentyp: Array | | nachrichten.infoNachrichten | Informationsnachrichten, die bei der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Array | | nachrichten.warnmeldungen | Bei der Verarbeitung der Anforderung sind Warnmeldungen aufgetreten. Datentyp: Array | | Anforderung | Ursprüngliche Endpunktanforderung. Datentyp: Zeichenfolge | | Staat | Informationen zum aktuellen Status des Mitarbeiters. Datentyp: Objekt state: { display_value: "String", value: Number } | | state.display_value | Anzeigewert des Status des Mitarbeiters. Diese Werte stehen in direktem Zusammenhang mit dem Parameter state.value. Mögliche Werte: * Abgeschlossen * Fehler * In Bearbeitung * Warten {#change-GET-c_id-schedule__ul_ehh_nxy_jhb} Datentyp: Zeichenfolge | | Status.Wert | Numerischer Wert des Status des Mitarbeiters. Mögliche Werte: * 1 * 2 * 3 * 4 {#change-GET-c_id-schedule__ul_zw1_fxy_jhb} Datentyp: Zahl | | type | Gibt den Typ der Anforderung an. Gültiger Wert: Zeitplan Datentyp: Zeichenfolge | | Mitarbeiter | Informationen zum zugeordneten Mitarbeiter. Datentyp: Objekt "worker": { "link": "String", "sysId": "String" } | | worker.link | Link zum Abrufen von Zeitfensterdaten. Verwenden Sie die sys_id in [GET /sn_chg_rest/change/worker/{sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-worker "Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab."), um Ergebnisse anzuzeigen. Datentyp: Zeichenfolge | | worker.sysId | Sys_id des Workers, der dem Change Request zugeordnet ist. Datentyp: Zeichenfolge | | status | wird nur angezeigt, wenn ein Fehler auftritt. Status der Endpunktverarbeitung. Möglicher Wert: Fehler Datentyp: Zeichenfolge | [ ] {#change-GET-c_id-schedule__table_is2_n4s_jpb} ### Rufen Sie verfügbare Zeitfenster ab {#change-GET-c_id-schedule__cmapi-sched-get-ci} Verwenden Sie den in worker.link angegebenen Wert, um Details zu Zeitplanfenstern abzurufen. Der Wert weist das folgende Format auf: https://instance.service-now.com/api/sn_chg_rest/change/worker/\ Verwenden Sie worker_sys_id in [GET /sn_chg_rest/change/worker/{sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-worker "Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab."), um Ergebnisse anzuzeigen. Der Antworttext enthält den Status und liefert Ergebnisse, wenn die Verarbeitung abgeschlossen ist. Die Ergebnisse des Mitarbeiter-Antworttextkörperparameters variieren je nach Verfügbarkeit des Zeitfensters. * Wenn das angegebene Zeitfenster für die Change-Anforderung innerhalb des geplanten Zeitfensters verfügbar ist, listet die Worker-API die verfügbaren Zeitfenster in der Eigenschaft payload.spans auf. Die Eigenschaft payload.spans wird ansonsten nicht in den Ergebnissen aufgeführt. * Wenn für die Dauer der Change-Anforderung innerhalb des definierten Zeitfensters für die Planung keine Zeitfenster verfügbar sind, gibt messages.infoMessages Folgendes an: `D` Hinweis: Der Standardwert für das Zeitfenster für die Planung von Change-Anforderungen beträgt 90 Tage. Um diesen Wert zu ändern, ändern Sie die Eigenschaft change.conflict.next_available.schedule_window. Weitere Informationen finden Sie unter [Konfliktanalyseeigenschaften konfigurieren](https://www.servicenow.com/docs/access?context=configure-conflict-properties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).{#change-GET-c_id-schedule__cmapi-wkr-no-slots-90-li} {#change-GET-c_id-schedule__cmapi-wkr-no-slots-90-li} Das folgende Beispiel für GET /sn_chg_rest/change/worker/{sys_id} zeigt die Ausgabe, die mit der im Detail worker.link angegebenen ID bereitgestellt wird. In den Ergebnissen werden die offenen Zeitspannen aufgelistet, die für die Aufgabendauer verfügbar sind. { "result": { "worker": { "sysId": "d7d1f2b4a444b010f87712198fe9caae", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/d7d1f2b4a444b010f87712198fe9caae" }, "request": "{\"cmdb_ci_sys_id\":\"82967cdd0ad3370236092104ce988d76\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] }, "payload": { "spans": [ { "start": { "value": "2021-05-15 08:00:00", "display_value": "2021-05-15 01:00:00" }, "end": { "value": "2021-05-15 11:00:00", "display_value": "2021-05-15 04:00:00" } }, { "start": { "value": "2021-05-22 08:00:00", "display_value": "2021-05-22 01:00:00" }, "end": { "value": "2021-05-22 11:00:00", "display_value": "2021-05-22 04:00:00" } }, ... ] } } } ### cURL-Anforderung curl "https://instance.service-now.com/api/sn_chg_rest/change/ci//schedule?duration_in_seconds=10800" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Die Ergebnisse enthalten worker.link-Details, die Sie verwenden können, um die angegebene sys_id im Endpunkt GET /sn_chg_rest/change/worker/ auszuführen. { "result": { "worker": { "sysId": "1049419c1b4c3010f58a6572604bcb7a", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/1049419c1b4c3010f58a6572604bcb7a" }, "request": "{\"cmdb_ci_sys_id\":\"\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change Management -- GET /sn_chg_rest/change {#ariaid-title9} Ruft eine oder mehrere Change-Anforderungen basierend auf den angegebenen Kriterien ab. ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change Standard-URL: /api/sn_chg_rest/change ### Unterstützte Anforderungsparameter {#change-GET-change__entry__2}{#change-GET-change__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 43. Pfadparameter] {#change-GET-change__entry__6}{#change-GET-change__sysparm_offset-ph-RESTAPI}{#change-GET-change__sysparm-query-RESTAPI} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | Bestellen | Feld, nach dem die zurückgesendeten Change Requests sortiert werden sollen. Datentyp: Zeichenfolge Standard: Name | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-change__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-change__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-change__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-change__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller normalen Change Request-Datensatzfelder verwendet wird. Diese Suche nutzt die Funktionalität der Volltextsuchplattform ServiceNow. Weitere Informationen zu den Suchfunktionen für ServiceNow finden Sie unter [Suchverwaltung](https://www.servicenow.com/docs/access?context=search-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Standard: IR_AND_OR_QUERY | [Tabelle : 44. Abfrageparameter] {#change-GET-change__entry__18} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 45. 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."). {#change-GET-change__entry__22}{#change-GET-change__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 46. Anforderungskopfzeilen] {#change-GET-change__entry__26} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 47. 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. {#change-GET-change__entry__30}{#change-GET-change__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 48. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-change__entry__38}{#change-GET-change__action_status-entry-chg_req}{#change-GET-change__active-entry-chg_req}{#change-GET-change__activity_due-entry-chg_req}{#change-GET-change__add_assignee_list-entry-chg_req}{#change-GET-change__approval-entry-chg_req}{#change-GET-change__approval_history-entry-chg_req}{#change-GET-change__approval_set-entry-chg_req}{#change-GET-change__assigned_to-entry-chg_req}{#change-GET-change__assign_group-entry-chg_req}{#change-GET-change__backout_plan-entry-chg_req}{#change-GET-change__business_dur-entry-chg_req}{#change-GET-change__business_service-entry-chg_req}{#change-GET-change__cab_date-entry-chg_req}{#change-GET-change__cab_delegate-entry-chg_req}{#change-GET-change__cab_rec-entry-chg_req}{#change-GET-change__cab_req-entry-chg_req}{#change-GET-change__cal_dur-entry-chg_req}{#change-GET-change__category-entry-chg_req}{#change-GET-change__change_plan-entry-chg_req}{#change-GET-change__chg_model-entry-chg_req}{#change-GET-change__closed_at-entry-chg_req}{#change-GET-change__closed_by-entry-chg_req}{#change-GET-change__close_code-entry-chg_req}{#change-GET-change__close_notes-entry-chg_req}{#change-GET-change__cmdb_ci-entry-chg_req}{#change-GET-change__comments-entry-chg_req}{#change-GET-change__comments_work_notes-entry-chg_req}{#change-GET-change__company-entry-chg_req}{#change-GET-change__conflict_last_run-entry-chg_req}{#change-GET-change__conflict_status-entry-chg_req}{#change-GET-change__contact_type-entry-chg_req}{#change-GET-change__contract-entry-chg_req}{#change-GET-change__corr_display-entry-chg_req}{#change-GET-change__corr_id-entry-chg_req}{#change-GET-change__delivery_plan-entry-chg_req}{#change-GET-change__delivery_task-entry-chg_req}{#change-GET-change__description-entry-chg_req}{#change-GET-change__end_date-entry-chg_req}{#change-GET-change__escalation-entry-chg_req}{#change-GET-change__expected_start-entry-chg_req}{#change-GET-change__follow_up-entry-chg_req}{#change-GET-change__group_list-entry-chg_req}{#change-GET-change__impact-entry-chg_req}{#change-GET-change__imp_plan-entry-chg_req}{#change-GET-change__justification-entry-chg_req}{#change-GET-change__knowledge-entry-chg_req}{#change-GET-change__location-entry-chg_req}{#change-GET-change__made_sla-entry-chg_req}{#change-GET-change__needs_attention-entry-chg_req}{#change-GET-change__number-entry-chg_req}{#change-GET-change__on_hold-entry-chg_req}{#change-GET-change__on_hold_reason-entry-chg_req}{#change-GET-change__on_hold_task-entry-chg_req}{#change-GET-change__opened_at-entry-chg_req}{#change-GET-change__opened_by-entry-chg_req}{#change-GET-change__order-entry-chg_req}{#change-GET-change__outside_maint_sched-entry-chg_req}{#change-GET-change__parent-entry-chg_req}{#change-GET-change__phase-entry-chg_req}{#change-GET-change__phase_state-entry-chg_req}{#change-GET-change__priority-entry-chg_req}{#change-GET-change__prod_system-entry-chg_req}{#change-GET-change__reason-entry-chg_req}{#change-GET-change__reassign_count-entry-chg_req}{#change-GET-change__rejection_goto-entry-chg_req}{#change-GET-change__requested_by-entry-chg_req}{#change-GET-change__requested_by_date-entry-chg_req}{#change-GET-change__review_comments-entry-chg_req}{#change-GET-change__review_date-entry-chg_req}{#change-GET-change__review_status-entry-chg_req}{#change-GET-change__risk-entry-chg_req}{#change-GET-change__risk_impact_analysis-entry-chg_req}{#change-GET-change__route_reason-entry-chg_req}{#change-GET-change__scope-entry-chg_req}{#change-GET-change__sevice_offering-entry-chg_req}{#change-GET-change__short_desc-entry-chg_req}{#change-GET-change__skills-entry-chg_req}{#change-GET-change__sla_due-entry-chg_req}{#change-GET-change__start_date-entry-chg_req}{#change-GET-change__state-entry-chg_req}{#change-GET-change__std_chg_prodversion-entry-chg_req}{#change-GET-change__sys_class_name-entry-chg_req}{#change-GET-change__sys_create_by-entry-chg_req}{#change-GET-change__sys_created_on-entry-chg_req}{#change-GET-change__sys_domain-entry-chg_req}{#change-GET-change__sys_domain_path-entry-chg_req}{#change-GET-change__sys_id-entry-chg_req}{#change-GET-change__sys_mod_count-entry-chg_req}{#change-GET-change__sys_updated_by-entry-chg_req}{#change-GET-change__sys_updated_on-entry-chg_req}{#change-GET-change__task_eff_number-entry-chg_req}{#change-GET-change__task_for-entry-chg_req}{#change-GET-change__test_plan-entry-chg_req}{#change-GET-change__time_worked-entry-chg_req}{#change-GET-change__type-entry-chg_req}{#change-GET-change__unauthorized-entry-chg_req}{#change-GET-change__universal_request-entry-chg_req}{#change-GET-change__upon_approval-entry-chg_req}{#change-GET-change__upon_reject-entry-chg_req}{#change-GET-change__urgency-entry-chg_req}{#change-GET-change__user_input-entry-chg_req}{#change-GET-change__variables-entry-chg_req}{#change-GET-change__watch_list-entry-chg_req}{#change-GET-change__wf_activity-entry-chg_req}{#change-GET-change__work_end-entry-chg_req}{#change-GET-change__work_notes-entry-chg_req}{#change-GET-change__work_notes_list-entry-chg_req}{#change-GET-change__work_start-entry-chg_req} | Elemente | Beschreibung | |-|-| | Ergebnis | Liste mit einem oder mehreren Change-Anforderungsdatensatz-Objekten. Jedes Objekt beschreibt eine Change-Anforderung. Jedes Element im Change-Anforderungsobjekt entspricht einem Feld in dem zugehörigen Datensatz in der Tabelle „Change-Anforderung" \[change_request\]. Alle -Elemente enthalten Name-Wert-Paare vom Typ „ Wert " und „display_value". Datumsfelder enthalten auch Name-Wert-Paare vom Typ display_value_internal. Datentyp: Array | | action_status | Aktueller Aktionsstatus der zugeordneten Change-Anforderung. Mögliche Werte: * 1: Intern blockiert * 2: Vom Kunden blockiert * 3: Intern und vom Kunden blockiert * 4: Handlungsbedarf {#change-GET-change__ul_nhd_tc3_2hb} Datentyp: Zahl | | aktiv | Kennzeichnung, die anzeigt, ob die Change-Anforderung aktiv ist. Mögliche Werte: * „wahr": Change-Anforderung ist aktiv * „falsch": Change-Anforderung ist nicht aktiv {#change-GET-change__ul_dqy_5jb_2hb} Datentyp: Boolesch Standardwert: true | | activity_due | Datum und Uhrzeit, zu der der zugehörige Fall abgeschlossen werden soll. Datentyp: Zeichenfolge | | Zusätzliche_Beauftragte_Liste | Liste der sys_ids zusätzlicher Personen, die für die Bearbeitung der Change-Anforderung zugewiesen sind. Datentyp: Array | | Genehmigung | Typ des erforderlichen Genehmigungsprozesses. Datentyp: Zeichenfolge Standard: nicht angefordert | | approval_history | Neuester Journaleintrag im Genehmigungsverlauf. Datentyp: Zeichenfolge | | approval_set | Datum und Uhrzeit, zu der die zugeordnete Aktion genehmigt wurde. Datentyp: Zeichenfolge | | assigned_to | Sys_id des Benutzers, der dem Change Request zugewiesen ist. Datentyp: Zeichenfolge | | assignment_group | Sys_id der Gruppe, die der Change-Anforderung zugewiesen ist. Datentyp: Zeichenfolge | | „backout_plan" | Beschreibung des Plans, der ausgeführt werden soll, wenn der Change rückgängig gemacht werden muss. Datentyp: Zeichenfolge | | business_duration | Dauer in geplanten Arbeitsstunden, Arbeitstagen und Arbeitswochen, die für die Durchführung des Change benötigt wurden. Datentyp: Zeichenfolge | | business_service | Sys_id des Business-Service, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Service" \[cmdb_ci_service\]. Datentyp: Zeichenfolge | | CAB_Date | Datum der Sitzung des Change Advisory Board (CAB). Datentyp: Zeichenfolge | | CAB_Delegate | Sys_id des Benutzers, der den CAB-Manager während eines CAB-Meetings vertreten kann. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | CAB_Recommendation | Beschreibung der CAB-Empfehlungen für die Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | CAB_REquired | Kennzeichnung, die angibt, ob das CAB erforderlich ist. Mögliche Werte: * „wahr": Change Advisory Board ist erforderlich. * „falsch": Das Change Advisory Board ist nicht erforderlich. {#change-GET-change__ul_jbv_tb4_tnb} Datentyp: Boolesch Standardwert: false | | calendar_duration | Derzeit nicht verwendet von Change-Management. Datentyp: Zeichenfolge | | category | Kategorie des Change, zum Beispiel Hardware, Netzwerk oder Software. Datentyp: Zeichenfolge Standard: Andere | | change_plan | Aktivitäten und Rollen zum Verwalten und Steuern der Change-Anforderung. Datentyp: Zeichenfolge | | chg_model | Sys_id des Change-Modells, auf dem die zugehörige Change-Anforderung basiert. Befindet sich in der Tabelle „Change-Modell" \[chg_model\]. Das Change-Modell definiert den Status-Flow, die Übergänge und die Prozessaktivitäten, die für die Change-Anforderung abgeschlossen werden müssen. Datentyp: Zeichenfolge | | closed_at | Zeitpunkt (Datum und Uhrzeit), zu dem die zugeordnete Change-Anforderung geschlossen wurde. Datentyp: Zeichenfolge | | closed_by | Sys_id der Person, die die Change-Anforderung geschlossen hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | close_code | Code, der der Change-Anforderung beim Schließen zugewiesen wurde. Beispiel: Erfolgreich, Erfolgreich mit Problemen und Nicht erfolgreich. Datentyp: Zeichenfolge | | close_notes | Notizen, die die Person beim Schließen der Change-Anforderung eingegeben hat. Datentyp: Zeichenfolge | | cmdb_ci | Sys_id des Konfigurationselements, das der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Configuration Item" \[cmdb_ci\]. Datentyp: Zeichenfolge | | comments | Liste der kundengerichteten Arbeitsnotizen, die im zugehörigen Change Request eingegeben wurden. Datentyp: Array | | comments_and_work_notes | Liste der internen und kundenorientierten Arbeitsnotizen, die für die zugehörige Change-Anforderung eingegeben wurden. Datentyp: Array Maximale Länge: 4.000 | | Unternehmen | Sys_id des Unternehmens, das dem Change Request zugeordnet ist. Befindet sich in der Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge | | konflikt_last_run | Datum und Uhrzeit der letzten Ausführung des Konflikterkennungsskripts für die Change-Anforderung. Datentyp: Zeichenfolge | | Konfliktstatus | Aktueller Konfliktstatus, wie vom Konflikterkennungsskript erkannt, z. B. Konflikt und Nicht ausgeführt. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Nicht ausgeführt | | „contact_type" | Methode, mit der die Change-Anforderung ursprünglich angefordert wurde. Mögliche Werte: * Chat * E-Mail * Telefon * Social * Web Datentyp: Zeichenfolge | | contract | Sys_id des Vertrags, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Vertrag" \[ast_contract\]. Datentyp: Zeichenfolge | | „correlation_display" | Anwenderfreundlicher Name für correlation_id. Datentyp: Zeichenfolge Maximale Länge: 100 | | correlation_id | Globally Unique ID (GUID) eines übereinstimmenden Change-Anforderungsdatensatzes in einem Drittparteisystem. Datentyp: Zeichenfolge Maximale Länge: 100 | | Delivery_plan | Wird nicht mehr verwendet. Sys_id des Bereitstellungsplans, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Ausführungsplan" \[sc_cat_item_delivery_plan\]. Datentyp: Zeichenfolge | | Delivery_task | Wird nicht mehr verwendet. Sys_id der Bereitstellungsaufgabe, die der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Ausführungsplan Aufgabe" \[sc_cat_item_delivery_task\]. Datentyp: Zeichenfolge | | Beschreibung | Detaillierte Beschreibung der Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | due_date | Fälligkeitsdatum der Aufgabe. Wird nicht vom Change-Anforderungsprozess verwendet. Datentyp: Zeichenfolge | | end_date | Zeitpunkt (Datum und Uhrzeit), zu dem die Change-Anforderung abgeschlossen werden soll. Datentyp: Zeichenfolge | | Eskalation | Aktuelle Eskalationsebene. Mögliche Werte: * 0: Normal * 1: Mittel * 2: Hoch * 3: Überfällig {#change-GET-change__ul_kkn_123_2hb} Datentyp: Zahl (Ganzzahl) Standard: 0 | | expected_start | Datum und Uhrzeit des Starts der Aufgabe. Wird nicht vom Change-Anforderungsprozess verwendet. Datentyp: Zeichenfolge | | Follow_up | Zeitpunkt (Datum und Uhrzeit), zu dem ein Anwender bei der Person, die den Change Request angefordert hat, nachgefragt hat. Datentyp: Zeichenfolge | | group_list | Liste der sys_ids und Namen der Gruppen, die dem Change Request zugeordnet sind. Datentyp: Array Maximale Länge: 4.000 | | impact | Die Change-Anforderung hat Auswirkungen auf den Kunden. Mögliche Werte: * 1: Hoch * 2: Mittel * 3: Niedrig {#change-GET-change__ul_j2x_j23_2hb} Datentyp: Zahl (Ganzzahl) Standard: 3 | | Implementation_plan | Sequenzielle Schritte, die ausgeführt werden müssen, um diesen Change zu implementieren. Sie enthält auch alle Abhängigkeiten zwischen Schritten und Details zu Beauftragten für jeden Schritt. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | Begründung | Vorteile der Implementierung dieses Change und die Auswirkungen, wenn dieser Change nicht implementiert wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | Wissen | Kennzeichnung, die angibt, ob Knowledge Base-Artikel ()KB) vorhanden sind, die der Change-Anforderung zugeordnet sind. Mögliche Werte: * true: Zugehörige KB-Artikel * „falsch": Keine zugeordneten KB-Artikel {#change-GET-change__ul_ehz_hp1_wnb} Datentyp: Boolesch | | location | Sys_id und Name des Standorts des in der Change-Anforderung referenzierten Geräts. Befindet sich in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | gemacht_sla | Wird nicht mehr verwendet. Kennzeichnung, die angibt, ob die Change-Anforderung in Übereinstimmung mit der zugehörigen Servicelevel-Vereinbarung implementiert wurde. Datentyp: Boolesch | | benötigt_attention | Kennzeichnung, die angibt, ob für die Change-Anforderung Handlungsbedarf besteht. Mögliche Werte: * wahr: Change-Anforderung erfordert zusätzliche Aufmerksamkeit. * false: Die Change-Anforderung erfordert keine zusätzliche Aufmerksamkeit. {#change-GET-change__ul_zzn_gnc_2hb} Datentyp: Boolesch Standardwert: false | | Nummer | Change-Nummer, die der Change-Anforderung vom System zugewiesen wurde, z. B. CHG0040007. Datentyp: Zeichenfolge | | on_hold | Kennzeichnung, die angibt, ob sich die Change-Anforderung derzeit im Status „Warten" befindet. Mögliche Werte: * true: Warten * false: Nicht angehalten {#change-GET-change__ul_xjn_nv1_wnb} Datentyp: Boolesch Standardwert: false | | on_hold_reason | Wenn der Parameter on_hold auf „wahr" festgelegt ist, Beschreibung des Grunds, warum die Change-Anforderung zurückgehalten wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | on_hold_task | Wenn der Parameter on_hold auf „wahr" festgelegt ist, Liste der sys_ids der Aufgaben, die abgeschlossen werden müssen, bevor die Warteschleife freigegeben wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | opened_at | Datum und Uhrzeit der Erstellung des Change-Release. Datentyp: Zeichenfolge | | opened_by | Sys_id und Name des Benutzers, der das Change-Release erstellt hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | Bestellen | Nicht verwendet von Change-Management. Optionales numerisches Feld zum Sortieren von Datensätzen, z. B. beim Abrufen aus einer Datenbank. Datentyp: Zahl (Ganzzahl) | | „outside_maintenance_schedule" | Kennzeichnung, die angibt, ob für die Change-Anforderung Wartungen durch ein externes Unternehmen geplant wurden. Mögliche Werte: * true: Außerhalb der Wartung geplant * „falsch": Keine externe Wartung geplant Datentyp: Boolesch Standardwert: false | | übergeordnet | Sys_id und Name der übergeordneten Aufgabe für diese Change-Anforderung, falls vorhanden. Befindet sich in der Aufgabentabelle \[task\]. Datentyp: Zeichenfolge | | phase | Aktuelle Phase der Change-Anforderung. Dadurch wird genauer definiert, was der Change bewirkt. Mögliche Werte: * akzeptieren * Build * Planen * angefordert Datentyp: Zeichenfolge | | Phase_state | Change_phase-Datensätze, die für einen Change erstellt werden sollen. Sie hängen von der Kategorie ab, sodass jede Art von Change unterschiedliche change_phase-Datensätze haben kann. Die change_phase-Datensätze bieten die Möglichkeit, den Genehmigungsprozess zu steuern, da jede change_phase einen Zeitplan und eine Gruppe von Genehmigern haben kann. Mögliche Werte: * Abschließen * angehalten * offen * abgelehnt * angefordert * In Bearbeitung {#change-GET-change__ul_rng_ly1_wnb} Datentyp: Zeichenfolge | | Priorität | Priorität der Change-Anforderung. Mögliche Werte: * 1: Kritisch * 2: Hoch * 3: Mittel * 4: Niedrig Datentyp: Zahl (Ganzzahl) Standard: 4 | | Production_system | Kennzeichnung, die angibt, ob die Change-Anforderung für eine ServiceNow -Instanz in einer Produktionsumgebung gilt. Mögliche Werte: * true: Produktionsumgebung * false: Nicht-Produktionsumgebung Datentyp: Boolesch | | Grund | Beschreibung, warum die Change-Anforderung initiiert wurde. Mögliche Werte: * Geschäftsanforderungen * Hardware-Upgrade * Gesetzgebung * Standortänderung * Netzwerkanforderungen * Neues oder entferntes CI * Sonstige * Problem gelöst * Produkt oder Service geändert * Software-Upgrade * Anwender angefordert Datentyp: Zeichenfolge Maximale Länge: 40 | | reassignment_count | Anzahl der Neuzuweisungen der Change-Anforderung an einen neuen Besitzer. Datentyp: Zahl (Ganzzahl) Standard: 0 | | Ablehnung_goto | Sys_id der Aufgabe, die ausgeführt werden soll, wenn die Change-Anforderung abgelehnt wird. Befindet sich in der Aufgabe \[Tabelle\]. Datentyp: Zeichenfolge | | Requested_by | Sys_id des Anwenders, der den Change angefordert hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | Requested_by_date | Datum und Uhrzeit, zu der die Implementierung des Change angefordert wird. Datentyp: Zeichenfolge | | review_comments | Kommentare, die bei der Überprüfung der Change-Anforderung eingegeben wurden. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | review_date | Datum, an dem die Change-Anforderung geprüft wurde. Datentyp: Zeichenfolge | | review_status | Aktueller Status der Überprüfung der angeforderten Change-Anforderung. Datentyp: Zeichenfolge | | Risiko | Risikostufe, die der Change-Anforderung zugeordnet ist. Gültige Werte: * 1: Hoch * 2: Mittel * 3: Niedrig {#change-GET-change__ul_ejt_tn4_wnb} Datentyp: Zahl Standard: 3 | | risk_impact_anasys | Beschreibung des Risikos und Analyse der Implementierung der Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | Route_Reason | Derzeit nicht verwendet von Change-Management. Grund, aus dem die Change-Anforderung übertragen wurde. Mögliche Werte: * 1: Übertragung mit Lösung * 9: Übertragung ohne Lösungen {#change-GET-change__ul_yvl_cxq_znb} Datentyp: Zahl | | scope | Größe der Change-Anforderung. Mögliche Werte: * 1: Massiv * 2: Groß * 3: Mittel * 4: Klein * 5: Winzig {#change-GET-change__ul_b3j_3xq_znb} Datentyp: Zahl Standard: 3 | | Service.Offering | Sys_id des Serviceangebots, das der Change-Anforderung zugeordnet ist. Serviceangebote definieren die Serviceebene eindeutig in Bezug auf Verfügbarkeit, Umfang, Preisgestaltung und Verpackungsoptionen. Befindet sich in der Tabelle „Angebot" \[service_offering\]. Datentyp: Zeichenfolge | | short_description | Beschreibung der Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 40 | | Kompetenzen | Liste der sys_ids aller Kompetenzen, die zur Implementierung der Change-Anforderung erforderlich sind. Befindet sich in der Kompetenztabelle \[cmn_skill\]. Datentyp: Array | | sla_due | Wird nicht mehr verwendet. Datum und Uhrzeit, zu der die Change-Anforderung basierend auf der zugehörigen Servicelevel-Vereinbarung abgeschlossen werden muss. Datentyp: Zeichenfolge | | sn_esign_document | Sys_id eines E-signierten Dokuments, das an die Change-Anforderung angehängt ist. Befindet sich in der Tabelle „Anhang" \[sys_attachment\]. Datentyp: Zeichenfolge | | sn_esign_esignature_configuration | Sys_id der E-Signatur-Signaturvorlage, die für das zugeordnete Dokument verwendet wird. Befindet sich in der Tabelle „E-Signatur-Vorlage" \[sn_esign_configuration\]. Datentyp: Zeichenfolge | | start_date | Zeitpunkt (Datum und Uhrzeit), zu dem die Implementierung der Change-Anforderung beginnen soll. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Change Requests. Mögliche Werte sind im Change-Modell definiert. Datentyp: Zahl (Ganzzahl) Standard: 1 | | std_change_producer_version | Sys_id des Datensatzerstellers und Change-Vorschlags, der der Change-Anforderung zugeordnet ist. Enthält auch die Anzahl und den Prozentsatz erfolgreicher und nicht erfolgreicher Change-Anforderungen, die aus dem Vorschlag erstellt wurden. Befindet sich in der Tabelle „Standard-Change-Vorlagenversion" \[std_change_producer_version\]. Datentyp: Zeichenfolge | | sys_class_name | Name der Tabelle, in der sich die Change-Anforderung befindet. Datentyp: Zeichenfolge | | sys_created_by | Name des Benutzers, der die Change-Anforderung ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des zugeordneten Change-Anforderungsdatensatzes. Datentyp: Zeichenfolge | | sys_domain | Bei Verwendung von Domänen in der Instanz der Name der Domäne, der der Change-Modul-Datensatz zugeordnet ist. Datentyp: Zeichenfolge | | sys_domain_path | Bei Verwendung von Domänen in der Instanz der Domänenpfad, in dem sich der zugehörige Change-Modul-Datensatz befindet. Datentyp: Zeichenfolge | | sys_id | Eindeutiger Bezeichner des zugeordneten Change-Anforderungsdatensatzes. Datentyp: Zeichenfolge | | sys_mod_count | Anzahl der Updates für den Fall seit der ursprünglichen Erstellung. Datentyp: Zahl (Ganzzahl) | | sys_updated_by | Person, die den Fall zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Falls. Datentyp: Zeichenfolge | | task_effektive_Nummer | Universal-Anforderungs-Nummer Datentyp: Zeichenfolge Maximale Länge: 40 | | task_for | Nicht verwendet von Change-Management. Sys_id des Anwenders, für den die Aufgabe erstellt wurde. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | test_plan | Beschreibung des zugeordneten Testplans für den Change. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | time_worked | Gesamtarbeitszeit für die Change-Anforderung. Datentyp: Zeichenfolge | | type | Change-Anforderungstyp. Mögliche Werte: * Notfall * normal * Standard Datentyp: Zeichenfolge Maximale Länge: 40 | | nicht autorisiert | Kennzeichnung, die angibt, ob die Change-Anforderung nicht autorisiert ist Mögliche Werte: * true: Nicht autorisiert * false: Autorisiert {#change-GET-change__ul_gd3_q1p_wnb} Datentyp: Boolesch | | universal_request | Sys_id der übergeordneten Universal-Anforderung, zu der diese Change-Anforderung gehört. Befindet sich in der Aufgabentabelle \[task\]. Datentyp: Zeichenfolge | | on_approval | Aktion, die ausgeführt werden soll, wenn die Change-Anforderung genehmigt wird. Mögliche Werte: * do_nomething * fortfahren Datentyp: Zeichenfolge Maximale Länge: 40 Standard: fortsetzen | | on_reject | Aktion, die ausgeführt wird, wenn die Change-Anforderung abgelehnt wird. Mögliche Werte: * abbrechen * goto {#change-GET-change__ul_mnw_cg3_2hb} Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Abbrechen | | urgency | Dringlichkeit der Change-Anforderung. Mögliche Werte: * 1: Hoch * 2: Mittel * 3: Niedrig {#change-GET-change__ul_td4_3g3_2hb} Datentyp: Zahl (Ganzzahl) Standard: 3 | | Anwender_Eingabe | Zusätzliche Anwendereingabe. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | variables | Name-Wert-Paare von Variablen, die der Change-Anforderung zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 | | „watch_list" | Liste der sys_ids der Benutzer, die Benachrichtigungen zu dieser Change-Anforderung erhalten, wenn zusätzliche Kommentare hinzugefügt werden oder wenn der Status einer Change-Anforderung in Gelöst oder Geschlossen geändert wird. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Array | | wf_activity | Sys_id des Workflow-Aktivitätsdatensatzes, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Workflow-Aktivität" \[wf_activity\]. Datentyp: Zeichenfolge | | work_end | Datum und Uhrzeit des Endes der Arbeit am Change Request. Datentyp: Zeichenfolge | | work_notes | Informationen darüber, wie die Change-Anforderung gelöst werden kann, oder welche Schritte zur Lösung des Change Requests unternommen wurden. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | work_notes_list | Liste der sys_ids der internen Benutzer, die Benachrichtigungen über diese Change-Anforderung erhalten, wenn Arbeitsnotizen hinzugefügt werden. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Array | | work_start | Datum und Uhrzeit des Beginns der Arbeit an der Change-Anforderung. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Der Kürze halber enthalten die Ergebnisse nur einen einzigen Change-Anforderungsdatensatz. { "result": [ { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Clear BGP sessions on a Cisco router", "value": "Clear BGP sessions on a Cisco router" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "1766f1de47410200e90d87e8dee490f6", "value": "1766f1de47410200e90d87e8dee490f6" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } ] } ## Change-Management -- GET /sn_chg_rest/change/{change_sys_id}/nextstates {#ariaid-title10} Ruft eine Liste der verfügbaren Status für die angegebene Change-Anforderung ab, einschließlich des aktuellen Status. Falls verfügbar, wird auch angegeben, wie der Übergang in den nächsten Status basierend auf der Version des implementierten Change-Managements erfolgt. Wenn die Changes vom Change-Modell gesteuert werden, gibt der Endpunkt Bedingungen zurück, die erfüllt sind oder nicht. Sie liefert auch Informationen darüber, ob alle Bedingungen für einen bestimmten Übergang erfüllt sind. Diese Informationen sind für typgesteuerte und veraltete Change-Anforderungen nicht verfügbar. ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/nextstates Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/nextstates ### Unterstützte Anforderungsparameter {#change-GET-chg_sys_id-nextstates__entry__2}{#change-GET-chg_sys_id-nextstates__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 49. Pfadparameter] {#change-GET-chg_sys_id-nextstates__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 50. Abfrageparameter] {#change-GET-chg_sys_id-nextstates__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 51. 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."). {#change-GET-chg_sys_id-nextstates__entry__16}{#change-GET-chg_sys_id-nextstates__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 52. Anforderungskopfzeilen] {#change-GET-chg_sys_id-nextstates__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 53. 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. {#change-GET-chg_sys_id-nextstates__entry__24}{#change-GET-chg_sys_id-nextstates__entry-200-status-code}{#change-GET-chg_sys_id-nextstates__entry-404-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. | [Tabelle : 54. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-chg_sys_id-nextstates__entry__30} | Name | Beschreibung | |-|-| | available_states | Werte für die Status, die für die angegebene Change-Anforderung verfügbar sind, einschließlich des aktuellen Status. Datentyp: Array | | state_label | Schlüssel-Wert-Paare, die Bezeichnungen den verfügbaren Status zuordnen. Datentyp: Objekt | | state_transitions | Informationen darüber, was für den Übergang in den jeweiligen verfügbaren Status erforderlich ist. Jedes eindeutige verfügbare „Bis Status" befindet sich in einem eigenen Array , wobei jeder andere Satz von Bedingungen für den Status „Zu Status" in einem eigenen Objekt liegt. Datentyp: Array "state_transitions": [ { "automatic_transition": Boolean, "conditions": [Array], "display_value": "String", "from_state": "String", "sys_id": "String", "to_state": "String", "transition_available": Boolean } ] | | state_transitions.automatic_transition | Kennzeichnung, die angibt, ob der automatische Übergang in diesen Status erfolgen soll. Gültige Werte: * true: Die Change-Anforderung geht automatisch in diesen Status über. * „falsch": Die Change-Anforderung wechselt nicht automatisch in diesen Status. {#change-GET-chg_sys_id-nextstates__ul_w1g_3zl_jtb} Datentyp: Boolesch | | state_transitions.conditions | Liste der Bedingungen, die dem -Statuszugeordnet sind. Datentyp: Array von Objekten "conditions": [ { "condition": {Object}, "passed": Boolean } ] | | state_transitions.conditions.condition | Werte einer bestimmten Bedingung. Datentyp: Objekt "condition": { "description": "String", "name": "String", "sys_id": "String" } | | state_transitions.conditions.condition.description | Beschreibung der Bedingung Datentyp: Zeichenfolge | | state_transitions.conditions.condition.name | Name der Bedingung Datentyp: Zeichenfolge | | state_transitions.conditions.conditions.sys_id | Sys_id der Bedingung. Datentyp: Zeichenfolge | | state_transitions.conditions.bestanden | Kennzeichnung, die angibt, ob die Change-Anforderung die zugeordnete Bedingung erfüllt hat. Gültige Werte: * true: Die Bedingung wurde erfüllt. * „falsch": Die Bedingung wurde nicht erfüllt. {#change-GET-chg_sys_id-nextstates__ul_x2m_ccm_jtb} | | state_transitions.display_value | Angezeigte Beschreibung des Status. Datentyp: Zeichenfolge | | state_transitions.from_state | Wert des Status, von dem die Change-Anforderung übergeht. Datentyp: Zeichenfolge | | state_transitions.sys_id | Sys_id des Übergangsstatus. Datentyp: Zeichenfolge | | state_transitions.to_state | Wert des Status, in den die Change-Anforderung übergeht. Datentyp: Zeichenfolge | | state_transitions.transition_available | Kennzeichnung, die angibt, ob die Change-Anforderung von ihrem aktuellen Status in diesen Status übergehen kann. Gültige Werte: * true: Kann in diesen Status übergehen. * „falsch": Ein Übergang in diesen Status ist nicht möglich. | [ ] ### cURL-Anforderung Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f"/nextstates \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Ergebnisse zurückgeben: { "result": { "available_states": [ "0", "4", "-1" ], // State values "state_transitions": [ [ { "sys_id": "7a0d2ccdc343101035ae3f52c1d3ae2e", // sttrm_state_transition sys id "display_value": "Implement to Review", "from_state": "-1", "to_state": "0", "transition_available": false, // If true, can move to this state "automatic_transition": true, // If true, automatically moves to this state "conditions": [ { "passed": false, // If true, change request met this condition "condition": { "name": "No active Change Tasks", "description": null, "sys_id": "3c1d2ccdc343101035ae3f52c1d3aea4" } } ] }, { "sys_id": "db401481c343101035ae3f52c1d3aedd", "display_value": "Implement to Review", "from_state": "-1", "to_state": "0", "transition_available": true, "automatic_transition": false, "conditions": [ { "passed": true, "condition": { "name": "Not On hold", "description": null, "sys_id": "2132deb6c303101035ae3f52c1d3ae8c" } } ] } ], [ { "sys_id": "5327c551c343101035ae3f52c1d3aeec", "display_value": "Implement to Canceled", "from_state": "-1", "to_state": "4", "transition_available": true, "automatic_transition": false, "conditions": [] } ] ], "state_label": { // state value to label pairs "0": "Review", "4": "Canceled", "-1": "Implement" } } } ## Change-Management: GET /sn_chg_rest/change/{change_sys_id}/schedule {#ariaid-title11} Aktiviert das Abrufen der verfügbaren Zeitfenster für eine Change-Anforderung. Erforderliche Rolle: sn_change_writer. Hinweis: Beim Ausführen dieses Endpunkts werden die verfügbaren Start- und Endzeiten nicht aufgelistet. Verwenden Sie den Link in der Eigenschaft des Antworttextes worker.link, um die Zeitplandaten abzurufen. Siehe auch: * [GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-c_id-schedule "Ermöglicht das Abrufen verfügbarer Zeitfenster nach Konfigurationselement-ID und Dauer, mit der Option zum Einschließen der geplanten Startzeit.") * [PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-PATCH-c_id-sched-first "Aktualisiert die geplanten Start- und Endzeiten einer Change-Anforderung anhand des ersten gefundenen verfügbaren Zeitfensters.") {#change-GET-change-sys_id-sched__ul_orx_mts_npb} ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/schedule Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/schedule ### Unterstützte Anforderungsparameter {#change-GET-change-sys_id-sched__entry__2}{#change-GET-change-sys_id-sched__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung, für die das nächste verfügbare Zeitfenster gesucht werden soll. Befindet sich in der Tabelle \[change_request\]. Die ausgewählte Change-Anforderung muss ein Konfigurationselement (cmdb_ci) mit geplanten Start- und geplanten Endzeiten aufweisen. | [Tabelle : 55. Pfadparameter] {#change-GET-change-sys_id-sched__table_fd4_yhf_jpb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 56. Abfrageparameter] {#change-GET-change-sys_id-sched__table_fd4_yhf_jpb} {#change-GET-change-sys_id-sched__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 57. 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."). {#change-GET-change-sys_id-sched__entry__16}{#change-GET-change-sys_id-sched__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 58. Anforderungskopfzeilen] {#change-GET-change-sys_id-sched__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 59. 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. {#change-GET-change-sys_id-sched__entry__24} | Statuscode | Beschreibung | |-|-| | 202 | Das System hat die Anforderung akzeptiert. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. Mögliche Probleme: * Bei der angegebenen Change-Anforderung fehlen die geplanten Start- und Endzeiten. * Der angegebenen Change-Anforderung ist kein Configuration Item (cmdb_ci) zugeordnet. * Der Benutzer hat keinen Lesezugriff auf die Felder der Change-Anforderung. {#change-GET-change-sys_id-sched__ul_nng_24r_spb} | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. Mögliche Probleme: * Das System kann die Change-Anforderung nicht basierend auf den bereitgestellten Informationen finden. * Anwender hat keinen Lesezugriff auf den Datensatz. {#change-GET-change-sys_id-sched__ul_ery_g1j_rpb} | [Tabelle : 60. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-change-sys_id-sched__section_p33_ccf_jpb} {#change-GET-change-sys_id-sched__table_is2_n4s_jpb__entry__2}{#change-GET-change-sys_id-sched__row-result-error-cmdb}{#change-GET-change-sys_id-sched__row-result-error_detail-cmdb}{#change-GET-change-sys_id-sched__row-result-error_message-cmdb} | Name | Beschreibung | |-|-| | Fehler | Informationen zu Fehlern, die bei der Verarbeitung der Endpunktanforderung aufgetreten sind. Datentyp: Objekt "error": { "detail": "String", "message": "String", "status": "String" } | | Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, die den Fehler identifiziert. Datentyp: Zeichenfolge | | Nachrichten | Nachrichteninformationen. Datentyp: Objekt "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | nachrichten.fehlermeldungen | Bei der Verarbeitung der Anforderung sind Fehlermeldungen aufgetreten. Datentyp: Array | | nachrichten.infoNachrichten | Informationsnachrichten, die bei der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Array | | nachrichten.warnmeldungen | Bei der Verarbeitung der Anforderung sind Warnmeldungen aufgetreten. Datentyp: Array | | Anforderung | Ursprüngliche Endpunktanforderung. Datentyp: Zeichenfolge | | Staat | Informationen zum aktuellen Status des Mitarbeiters. Datentyp: Objekt state: { display_value: "String", value: Number } | | state.display_value | Anzeigewert des Status des Mitarbeiters. Diese Werte stehen in direktem Zusammenhang mit dem Parameter state.value. Mögliche Werte: * Abgeschlossen * Fehler * In Bearbeitung * Warten {#change-GET-change-sys_id-sched__ul_ehh_nxy_jhb} Datentyp: Zeichenfolge | | Status.Wert | Numerischer Wert des Status des Mitarbeiters. Mögliche Werte: * 1 * 2 * 3 * 4 {#change-GET-change-sys_id-sched__ul_zw1_fxy_jhb} Datentyp: Zahl | | type | Gibt den Typ der Anforderung an. Gültiger Wert: Zeitplan Datentyp: Zeichenfolge | | Mitarbeiter | Informationen zum zugeordneten Mitarbeiter. Datentyp: Objekt "worker": { "link": "String", "sysId": "String" } | | worker.link | Link zum Abrufen von Zeitfensterdaten. Verwenden Sie die sys_id in [GET /sn_chg_rest/change/worker/{sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-worker "Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab."), um Ergebnisse anzuzeigen. Datentyp: Zeichenfolge | | worker.sysId | Sys_id des Workers, der dem Change Request zugeordnet ist. Datentyp: Zeichenfolge | | status | wird nur angezeigt, wenn ein Fehler auftritt. Status der Endpunktverarbeitung. Möglicher Wert: Fehler Datentyp: Zeichenfolge | [ ] {#change-GET-change-sys_id-sched__table_is2_n4s_jpb} ### Rufen Sie verfügbare Zeitfenster ab {#change-GET-change-sys_id-sched__cmapi-sched-get-change} Verwenden Sie den in worker.link angegebenen Wert, um Details zu Zeitplanfenstern abzurufen. Der Wert weist das folgende Format auf: https://instance.service-now.com/api/sn_chg_rest/change/worker/\ Verwenden Sie worker_sys_id in [GET /sn_chg_rest/change/worker/{worker_sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-worker "Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab."), um Ergebnisse anzuzeigen. Der Antworttext enthält den Status und liefert Ergebnisse, wenn die Verarbeitung abgeschlossen ist. Die Ergebnisse des Mitarbeiter-Antworttextkörperparameters variieren je nach Verfügbarkeit des Zeitfensters. * Wenn das angegebene Zeitfenster für die Change-Anforderung innerhalb des geplanten Zeitfensters verfügbar ist, listet die Worker-API die verfügbaren Zeitfenster in der Eigenschaft payload.spans auf. Die Eigenschaft payload.spans wird ansonsten nicht in den Ergebnissen aufgeführt. * Wenn für die Dauer der Change-Anforderung innerhalb des definierten Zeitfensters für die Planung keine Zeitfenster verfügbar sind, gibt messages.infoMessages Folgendes an: `D` Hinweis: Der Standardwert für das Zeitfenster für die Planung von Change-Anforderungen beträgt 90 Tage. Um diesen Wert zu ändern, ändern Sie die Eigenschaft change.conflict.next_available.schedule_window. Weitere Informationen finden Sie unter [Konfliktanalyseeigenschaften konfigurieren](https://www.servicenow.com/docs/access?context=configure-conflict-properties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).{#change-GET-change-sys_id-sched__cmapi-wkr-no-slots-90-li} {#change-GET-change-sys_id-sched__cmapi-wkr-no-slots-90-li} Das folgende Beispiel für GET /sn_chg_rest/change/worker/{sys_id} zeigt die Ausgabe, die mit der im Detail worker.link angegebenen ID bereitgestellt wird. In den Ergebnissen werden die offenen Zeitspannen aufgelistet, die für die Aufgabendauer verfügbar sind. { "result": { "worker": { "sysId": "9b3f62e0a4c87010f87712198fe9cad1", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] }, "payload": { "spans": [ { "start": { "value": "2021-05-08 08:00:00", "display_value": "2021-05-08 01:00:00" }, "end": { "value": "2021-05-08 11:00:00", "display_value": "2021-05-08 04:00:00" } }, { "start": { "value": "2021-05-15 08:00:00", "display_value": "2021-05-15 01:00:00" }, "end": { "value": "2021-05-15 11:00:00", "display_value": "2021-05-15 04:00:00" } }, ... ] } } } ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/change/{change_sys_id}/schedule" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Die Ergebnisse enthalten worker.link-Details, die Sie verwenden können, um die angegebene sys_id im Endpunkt GET /sn_chg_rest/change/worker/ auszuführen. { "result": { "worker": { "sysId": "9b3f62e0a4c87010f87712198fe9cad1", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change-Management: GET /sn_chg_rest/change/{change_sys_id}/task {#ariaid-title12} Ruft eine oder mehrere einem angegebenen Change Request zugeordnete Aufgaben ab, basierend auf den angegebenen Kriterien. ### URL-Format {#change-GET-c_id-task__section_jjh_pvm_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/task ### Unterstützte Anforderungsparameter {#change-GET-c_id-task__entry__2}{#change-GET-c_id-task__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung, deren Aufgaben abgerufen werden sollen. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 61. Pfadparameter] {#change-GET-c_id-task__table_tnj_bxm_ylb__entry__2}{#change-GET-c_id-task__sysparm_offset-ph-RESTAPI} | Name | Beschreibung | |-|-| | Schlüssel-Wert-Paare | Felder, die beim Erstellen des Requests zu modifizieren sind. Der Schlüssel ist der Feldname in der Vorlage und der Wert die Informationen, die in das Feld eingefügt werden sollen. Felder, die nicht geändert werden können und bei der Übergabe ignoriert werden: * Business-Regeln * Schreibgeschützte Felder wie in ACLs definiert * Felder, die nicht vorhanden sind {#change-GET-c_id-task__ul_uh4_dxm_ylb} Datentyp: Zeichenfolge | | Bestellen | Feld, nach dem die zurückgesendeten Change Requests sortiert werden sollen. Standard: Zahl Datentyp: Zeichenfolge | | sysparm_limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren. Datentyp: Zahl Standard: 500 | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-c_id-task__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-c_id-task__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-c_id-task__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-c_id-task__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller Change-Aufgaben-Datensatzfelder verwendet wird. Diese Suche nutzt die Funktion der Volltextsuchplattform ServiceNow und ist standardmäßig auf `IR_AND_OR_QUERY eingestellt`. Datentyp: Zeichenfolge | [Tabelle : 62. Abfrageparameter] {#change-GET-c_id-task__table_tnj_bxm_ylb} {#change-GET-c_id-task__entry__22} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 63. 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."). {#change-GET-c_id-task__entry__26}{#change-GET-c_id-task__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 64. Anforderungskopfzeilen] {#change-GET-c_id-task__entry__30} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 65. 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. {#change-GET-c_id-task__entry__34}{#change-GET-c_id-task__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 66. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-c_id-task__entry__46} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für die identifizierte Change Request-Aufgabe vor dem Löschen. Datentyp: Objekt | | übergeordnet | Informationen für den Change Request, der der Aufgabe zugeordnet ist. Datentyp: Objekt parent: { display_value: "String", value: "String" } | | parent.display_value | Change-Anforderungsinformationen zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | parent.value | Sys_id der Change-Anforderung, die der Aufgabe zugeordnet ist. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderungsaufgabe. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderungsaufgabe zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderungsaufgabe. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire node", display_value: "Retire node" } }, { // next record found }, ... // and so on ] } ## Change-Management -- GET /sn_chg_rest/change/{sys_id} {#ariaid-title13} Ruft die Change-Anforderung ab, die durch die angegebene sys_id identifiziert wurde. ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id} Standard-URL: /api/sn_chg_rest/change/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-change-sys_id__entry__2}{#change-GET-change-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id des Change-Anforderungsdatensatzes, der aus der Tabelle „Change-Anforderung" \[change_request\] abgerufen werden soll. Datentyp: Zeichenfolge | [Tabelle : 67. Pfadparameter] {#change-GET-change-sys_id__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 68. Abfrageparameter] {#change-GET-change-sys_id__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 69. 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."). {#change-GET-change-sys_id__entry__16}{#change-GET-change-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 70. Anforderungskopfzeilen] {#change-GET-change-sys_id__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 71. 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. {#change-GET-change-sys_id__entry__24}{#change-GET-change-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 72. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-change-sys_id__entry__36}{#change-GET-change-sys_id__action_status-entry-chg_req}{#change-GET-change-sys_id__active-entry-chg_req}{#change-GET-change-sys_id__activity_due-entry-chg_req}{#change-GET-change-sys_id__add_assignee_list-entry-chg_req}{#change-GET-change-sys_id__approval-entry-chg_req}{#change-GET-change-sys_id__approval_history-entry-chg_req}{#change-GET-change-sys_id__approval_set-entry-chg_req}{#change-GET-change-sys_id__assigned_to-entry-chg_req}{#change-GET-change-sys_id__assign_group-entry-chg_req}{#change-GET-change-sys_id__backout_plan-entry-chg_req}{#change-GET-change-sys_id__business_dur-entry-chg_req}{#change-GET-change-sys_id__business_service-entry-chg_req}{#change-GET-change-sys_id__cab_date-entry-chg_req}{#change-GET-change-sys_id__cab_delegate-entry-chg_req}{#change-GET-change-sys_id__cab_rec-entry-chg_req}{#change-GET-change-sys_id__cab_req-entry-chg_req}{#change-GET-change-sys_id__cal_dur-entry-chg_req}{#change-GET-change-sys_id__category-entry-chg_req}{#change-GET-change-sys_id__change_plan-entry-chg_req}{#change-GET-change-sys_id__chg_model-entry-chg_req}{#change-GET-change-sys_id__closed_at-entry-chg_req}{#change-GET-change-sys_id__closed_by-entry-chg_req}{#change-GET-change-sys_id__close_code-entry-chg_req}{#change-GET-change-sys_id__close_notes-entry-chg_req}{#change-GET-change-sys_id__cmdb_ci-entry-chg_req}{#change-GET-change-sys_id__comments-entry-chg_req}{#change-GET-change-sys_id__comments_work_notes-entry-chg_req}{#change-GET-change-sys_id__company-entry-chg_req}{#change-GET-change-sys_id__conflict_last_run-entry-chg_req}{#change-GET-change-sys_id__conflict_status-entry-chg_req}{#change-GET-change-sys_id__contact_type-entry-chg_req}{#change-GET-change-sys_id__contract-entry-chg_req}{#change-GET-change-sys_id__corr_display-entry-chg_req}{#change-GET-change-sys_id__corr_id-entry-chg_req}{#change-GET-change-sys_id__delivery_plan-entry-chg_req}{#change-GET-change-sys_id__delivery_task-entry-chg_req}{#change-GET-change-sys_id__description-entry-chg_req}{#change-GET-change-sys_id__end_date-entry-chg_req}{#change-GET-change-sys_id__escalation-entry-chg_req}{#change-GET-change-sys_id__expected_start-entry-chg_req}{#change-GET-change-sys_id__follow_up-entry-chg_req}{#change-GET-change-sys_id__group_list-entry-chg_req}{#change-GET-change-sys_id__impact-entry-chg_req}{#change-GET-change-sys_id__imp_plan-entry-chg_req}{#change-GET-change-sys_id__justification-entry-chg_req}{#change-GET-change-sys_id__knowledge-entry-chg_req}{#change-GET-change-sys_id__location-entry-chg_req}{#change-GET-change-sys_id__made_sla-entry-chg_req}{#change-GET-change-sys_id__needs_attention-entry-chg_req}{#change-GET-change-sys_id__number-entry-chg_req}{#change-GET-change-sys_id__on_hold-entry-chg_req}{#change-GET-change-sys_id__on_hold_reason-entry-chg_req}{#change-GET-change-sys_id__on_hold_task-entry-chg_req}{#change-GET-change-sys_id__opened_at-entry-chg_req}{#change-GET-change-sys_id__opened_by-entry-chg_req}{#change-GET-change-sys_id__order-entry-chg_req}{#change-GET-change-sys_id__outside_maint_sched-entry-chg_req}{#change-GET-change-sys_id__parent-entry-chg_req}{#change-GET-change-sys_id__phase-entry-chg_req}{#change-GET-change-sys_id__phase_state-entry-chg_req}{#change-GET-change-sys_id__priority-entry-chg_req}{#change-GET-change-sys_id__prod_system-entry-chg_req}{#change-GET-change-sys_id__reason-entry-chg_req}{#change-GET-change-sys_id__reassign_count-entry-chg_req}{#change-GET-change-sys_id__rejection_goto-entry-chg_req}{#change-GET-change-sys_id__requested_by-entry-chg_req}{#change-GET-change-sys_id__requested_by_date-entry-chg_req}{#change-GET-change-sys_id__review_comments-entry-chg_req}{#change-GET-change-sys_id__review_date-entry-chg_req}{#change-GET-change-sys_id__review_status-entry-chg_req}{#change-GET-change-sys_id__risk-entry-chg_req}{#change-GET-change-sys_id__risk_impact_analysis-entry-chg_req}{#change-GET-change-sys_id__route_reason-entry-chg_req}{#change-GET-change-sys_id__scope-entry-chg_req}{#change-GET-change-sys_id__sevice_offering-entry-chg_req}{#change-GET-change-sys_id__short_desc-entry-chg_req}{#change-GET-change-sys_id__skills-entry-chg_req}{#change-GET-change-sys_id__sla_due-entry-chg_req}{#change-GET-change-sys_id__start_date-entry-chg_req}{#change-GET-change-sys_id__state-entry-chg_req}{#change-GET-change-sys_id__std_chg_prodversion-entry-chg_req}{#change-GET-change-sys_id__sys_class_name-entry-chg_req}{#change-GET-change-sys_id__sys_create_by-entry-chg_req}{#change-GET-change-sys_id__sys_created_on-entry-chg_req}{#change-GET-change-sys_id__sys_domain-entry-chg_req}{#change-GET-change-sys_id__sys_domain_path-entry-chg_req}{#change-GET-change-sys_id__sys_id-entry-chg_req}{#change-GET-change-sys_id__sys_mod_count-entry-chg_req}{#change-GET-change-sys_id__sys_updated_by-entry-chg_req}{#change-GET-change-sys_id__sys_updated_on-entry-chg_req}{#change-GET-change-sys_id__task_eff_number-entry-chg_req}{#change-GET-change-sys_id__task_for-entry-chg_req}{#change-GET-change-sys_id__test_plan-entry-chg_req}{#change-GET-change-sys_id__time_worked-entry-chg_req}{#change-GET-change-sys_id__type-entry-chg_req}{#change-GET-change-sys_id__unauthorized-entry-chg_req}{#change-GET-change-sys_id__universal_request-entry-chg_req}{#change-GET-change-sys_id__upon_approval-entry-chg_req}{#change-GET-change-sys_id__upon_reject-entry-chg_req}{#change-GET-change-sys_id__urgency-entry-chg_req}{#change-GET-change-sys_id__user_input-entry-chg_req}{#change-GET-change-sys_id__variables-entry-chg_req}{#change-GET-change-sys_id__watch_list-entry-chg_req}{#change-GET-change-sys_id__wf_activity-entry-chg_req}{#change-GET-change-sys_id__work_end-entry-chg_req}{#change-GET-change-sys_id__work_notes-entry-chg_req}{#change-GET-change-sys_id__work_notes_list-entry-chg_req}{#change-GET-change-sys_id__work_start-entry-chg_req} | Elemente | Beschreibung | |-|-| | Ergebnis | Liste mit einem oder mehreren Change-Anforderungsdatensatz-Objekten. Jedes Objekt beschreibt eine Change-Anforderung. Jedes Element im Change-Anforderungsobjekt entspricht einem Feld in dem zugehörigen Datensatz in der Tabelle „Change-Anforderung" \[change_request\]. Alle -Elemente enthalten Name-Wert-Paare vom Typ „ Wert " und „display_value". Datumsfelder enthalten auch Name-Wert-Paare vom Typ display_value_internal. Datentyp: Array | | action_status | Aktueller Aktionsstatus der zugeordneten Change-Anforderung. Mögliche Werte: * 1: Intern blockiert * 2: Vom Kunden blockiert * 3: Intern und vom Kunden blockiert * 4: Handlungsbedarf {#change-GET-change-sys_id__ul_nhd_tc3_2hb} Datentyp: Zahl | | aktiv | Kennzeichnung, die anzeigt, ob die Change-Anforderung aktiv ist. Mögliche Werte: * „wahr": Change-Anforderung ist aktiv * „falsch": Change-Anforderung ist nicht aktiv {#change-GET-change-sys_id__ul_dqy_5jb_2hb} Datentyp: Boolesch Standardwert: true | | activity_due | Datum und Uhrzeit, zu der der zugehörige Fall abgeschlossen werden soll. Datentyp: Zeichenfolge | | Zusätzliche_Beauftragte_Liste | Liste der sys_ids zusätzlicher Personen, die für die Bearbeitung der Change-Anforderung zugewiesen sind. Datentyp: Array | | Genehmigung | Typ des erforderlichen Genehmigungsprozesses. Datentyp: Zeichenfolge Standard: nicht angefordert | | approval_history | Neuester Journaleintrag im Genehmigungsverlauf. Datentyp: Zeichenfolge | | approval_set | Datum und Uhrzeit, zu der die zugeordnete Aktion genehmigt wurde. Datentyp: Zeichenfolge | | assigned_to | Sys_id des Benutzers, der dem Change Request zugewiesen ist. Datentyp: Zeichenfolge | | assignment_group | Sys_id der Gruppe, die der Change-Anforderung zugewiesen ist. Datentyp: Zeichenfolge | | „backout_plan" | Beschreibung des Plans, der ausgeführt werden soll, wenn der Change rückgängig gemacht werden muss. Datentyp: Zeichenfolge | | business_duration | Dauer in geplanten Arbeitsstunden, Arbeitstagen und Arbeitswochen, die für die Durchführung des Change benötigt wurden. Datentyp: Zeichenfolge | | business_service | Sys_id des Business-Service, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Service" \[cmdb_ci_service\]. Datentyp: Zeichenfolge | | CAB_Date | Datum der Sitzung des Change Advisory Board (CAB). Datentyp: Zeichenfolge | | CAB_Delegate | Sys_id des Benutzers, der den CAB-Manager während eines CAB-Meetings vertreten kann. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | CAB_Recommendation | Beschreibung der CAB-Empfehlungen für die Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | CAB_REquired | Kennzeichnung, die angibt, ob das CAB erforderlich ist. Mögliche Werte: * „wahr": Change Advisory Board ist erforderlich. * „falsch": Das Change Advisory Board ist nicht erforderlich. {#change-GET-change-sys_id__ul_jbv_tb4_tnb} Datentyp: Boolesch Standardwert: false | | calendar_duration | Derzeit nicht verwendet von Change-Management. Datentyp: Zeichenfolge | | category | Kategorie des Change, zum Beispiel Hardware, Netzwerk oder Software. Datentyp: Zeichenfolge Standard: Andere | | change_plan | Aktivitäten und Rollen zum Verwalten und Steuern der Change-Anforderung. Datentyp: Zeichenfolge | | chg_model | Sys_id des Change-Modells, auf dem die zugehörige Change-Anforderung basiert. Befindet sich in der Tabelle „Change-Modell" \[chg_model\]. Das Change-Modell definiert den Status-Flow, die Übergänge und die Prozessaktivitäten, die für die Change-Anforderung abgeschlossen werden müssen. Datentyp: Zeichenfolge | | closed_at | Zeitpunkt (Datum und Uhrzeit), zu dem die zugeordnete Change-Anforderung geschlossen wurde. Datentyp: Zeichenfolge | | closed_by | Sys_id der Person, die die Change-Anforderung geschlossen hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | close_code | Code, der der Change-Anforderung beim Schließen zugewiesen wurde. Beispiel: Erfolgreich, Erfolgreich mit Problemen und Nicht erfolgreich. Datentyp: Zeichenfolge | | close_notes | Notizen, die die Person beim Schließen der Change-Anforderung eingegeben hat. Datentyp: Zeichenfolge | | cmdb_ci | Sys_id des Konfigurationselements, das der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Configuration Item" \[cmdb_ci\]. Datentyp: Zeichenfolge | | comments | Liste der kundengerichteten Arbeitsnotizen, die im zugehörigen Change Request eingegeben wurden. Datentyp: Array | | comments_and_work_notes | Liste der internen und kundenorientierten Arbeitsnotizen, die für die zugehörige Change-Anforderung eingegeben wurden. Datentyp: Array Maximale Länge: 4.000 | | Unternehmen | Sys_id des Unternehmens, das dem Change Request zugeordnet ist. Befindet sich in der Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge | | konflikt_last_run | Datum und Uhrzeit der letzten Ausführung des Konflikterkennungsskripts für die Change-Anforderung. Datentyp: Zeichenfolge | | Konfliktstatus | Aktueller Konfliktstatus, wie vom Konflikterkennungsskript erkannt, z. B. Konflikt und Nicht ausgeführt. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Nicht ausgeführt | | „contact_type" | Methode, mit der die Change-Anforderung ursprünglich angefordert wurde. Mögliche Werte: * Chat * E-Mail * Telefon * Social * Web Datentyp: Zeichenfolge | | contract | Sys_id des Vertrags, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Vertrag" \[ast_contract\]. Datentyp: Zeichenfolge | | „correlation_display" | Anwenderfreundlicher Name für correlation_id. Datentyp: Zeichenfolge Maximale Länge: 100 | | correlation_id | Globally Unique ID (GUID) eines übereinstimmenden Change-Anforderungsdatensatzes in einem Drittparteisystem. Datentyp: Zeichenfolge Maximale Länge: 100 | | Delivery_plan | Wird nicht mehr verwendet. Sys_id des Bereitstellungsplans, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Ausführungsplan" \[sc_cat_item_delivery_plan\]. Datentyp: Zeichenfolge | | Delivery_task | Wird nicht mehr verwendet. Sys_id der Bereitstellungsaufgabe, die der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Ausführungsplan Aufgabe" \[sc_cat_item_delivery_task\]. Datentyp: Zeichenfolge | | Beschreibung | Detaillierte Beschreibung der Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | due_date | Fälligkeitsdatum der Aufgabe. Wird nicht vom Change-Anforderungsprozess verwendet. Datentyp: Zeichenfolge | | end_date | Zeitpunkt (Datum und Uhrzeit), zu dem die Change-Anforderung abgeschlossen werden soll. Datentyp: Zeichenfolge | | Eskalation | Aktuelle Eskalationsebene. Mögliche Werte: * 0: Normal * 1: Mittel * 2: Hoch * 3: Überfällig {#change-GET-change-sys_id__ul_kkn_123_2hb} Datentyp: Zahl (Ganzzahl) Standard: 0 | | expected_start | Datum und Uhrzeit des Starts der Aufgabe. Wird nicht vom Change-Anforderungsprozess verwendet. Datentyp: Zeichenfolge | | Follow_up | Zeitpunkt (Datum und Uhrzeit), zu dem ein Anwender bei der Person, die den Change Request angefordert hat, nachgefragt hat. Datentyp: Zeichenfolge | | group_list | Liste der sys_ids und Namen der Gruppen, die dem Change Request zugeordnet sind. Datentyp: Array Maximale Länge: 4.000 | | impact | Die Change-Anforderung hat Auswirkungen auf den Kunden. Mögliche Werte: * 1: Hoch * 2: Mittel * 3: Niedrig {#change-GET-change-sys_id__ul_j2x_j23_2hb} Datentyp: Zahl (Ganzzahl) Standard: 3 | | Implementation_plan | Sequenzielle Schritte, die ausgeführt werden müssen, um diesen Change zu implementieren. Sie enthält auch alle Abhängigkeiten zwischen Schritten und Details zu Beauftragten für jeden Schritt. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | Begründung | Vorteile der Implementierung dieses Change und die Auswirkungen, wenn dieser Change nicht implementiert wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | Wissen | Kennzeichnung, die angibt, ob Knowledge Base-Artikel ()KB) vorhanden sind, die der Change-Anforderung zugeordnet sind. Mögliche Werte: * true: Zugehörige KB-Artikel * „falsch": Keine zugeordneten KB-Artikel {#change-GET-change-sys_id__ul_ehz_hp1_wnb} Datentyp: Boolesch | | location | Sys_id und Name des Standorts des in der Change-Anforderung referenzierten Geräts. Befindet sich in der Standorttabelle \[cmn_location\]. Datentyp: Zeichenfolge | | gemacht_sla | Wird nicht mehr verwendet. Kennzeichnung, die angibt, ob die Change-Anforderung in Übereinstimmung mit der zugehörigen Servicelevel-Vereinbarung implementiert wurde. Datentyp: Boolesch | | benötigt_attention | Kennzeichnung, die angibt, ob für die Change-Anforderung Handlungsbedarf besteht. Mögliche Werte: * wahr: Change-Anforderung erfordert zusätzliche Aufmerksamkeit. * false: Die Change-Anforderung erfordert keine zusätzliche Aufmerksamkeit. {#change-GET-change-sys_id__ul_zzn_gnc_2hb} Datentyp: Boolesch Standardwert: false | | Nummer | Change-Nummer, die der Change-Anforderung vom System zugewiesen wurde, z. B. CHG0040007. Datentyp: Zeichenfolge | | on_hold | Kennzeichnung, die angibt, ob sich die Change-Anforderung derzeit im Status „Warten" befindet. Mögliche Werte: * true: Warten * false: Nicht angehalten {#change-GET-change-sys_id__ul_xjn_nv1_wnb} Datentyp: Boolesch Standardwert: false | | on_hold_reason | Wenn der Parameter on_hold auf „wahr" festgelegt ist, Beschreibung des Grunds, warum die Change-Anforderung zurückgehalten wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | on_hold_task | Wenn der Parameter on_hold auf „wahr" festgelegt ist, Liste der sys_ids der Aufgaben, die abgeschlossen werden müssen, bevor die Warteschleife freigegeben wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | opened_at | Datum und Uhrzeit der Erstellung des Change-Release. Datentyp: Zeichenfolge | | opened_by | Sys_id und Name des Benutzers, der das Change-Release erstellt hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | Bestellen | Nicht verwendet von Change-Management. Optionales numerisches Feld zum Sortieren von Datensätzen, z. B. beim Abrufen aus einer Datenbank. Datentyp: Zahl (Ganzzahl) | | „outside_maintenance_schedule" | Kennzeichnung, die angibt, ob für die Change-Anforderung Wartungen durch ein externes Unternehmen geplant wurden. Mögliche Werte: * true: Außerhalb der Wartung geplant * „falsch": Keine externe Wartung geplant Datentyp: Boolesch Standardwert: false | | übergeordnet | Sys_id und Name der übergeordneten Aufgabe für diese Change-Anforderung, falls vorhanden. Befindet sich in der Aufgabentabelle \[task\]. Datentyp: Zeichenfolge | | phase | Aktuelle Phase der Change-Anforderung. Dadurch wird genauer definiert, was der Change bewirkt. Mögliche Werte: * akzeptieren * Build * Planen * angefordert Datentyp: Zeichenfolge | | Phase_state | Change_phase-Datensätze, die für einen Change erstellt werden sollen. Sie hängen von der Kategorie ab, sodass jede Art von Change unterschiedliche change_phase-Datensätze haben kann. Die change_phase-Datensätze bieten die Möglichkeit, den Genehmigungsprozess zu steuern, da jede change_phase einen Zeitplan und eine Gruppe von Genehmigern haben kann. Mögliche Werte: * Abschließen * angehalten * offen * abgelehnt * angefordert * In Bearbeitung {#change-GET-change-sys_id__ul_rng_ly1_wnb} Datentyp: Zeichenfolge | | Priorität | Priorität der Change-Anforderung. Mögliche Werte: * 1: Kritisch * 2: Hoch * 3: Mittel * 4: Niedrig Datentyp: Zahl (Ganzzahl) Standard: 4 | | Production_system | Kennzeichnung, die angibt, ob die Change-Anforderung für eine ServiceNow -Instanz in einer Produktionsumgebung gilt. Mögliche Werte: * true: Produktionsumgebung * false: Nicht-Produktionsumgebung Datentyp: Boolesch | | Grund | Beschreibung, warum die Change-Anforderung initiiert wurde. Mögliche Werte: * Geschäftsanforderungen * Hardware-Upgrade * Gesetzgebung * Standortänderung * Netzwerkanforderungen * Neues oder entferntes CI * Sonstige * Problem gelöst * Produkt oder Service geändert * Software-Upgrade * Anwender angefordert Datentyp: Zeichenfolge Maximale Länge: 40 | | reassignment_count | Anzahl der Neuzuweisungen der Change-Anforderung an einen neuen Besitzer. Datentyp: Zahl (Ganzzahl) Standard: 0 | | Ablehnung_goto | Sys_id der Aufgabe, die ausgeführt werden soll, wenn die Change-Anforderung abgelehnt wird. Befindet sich in der Aufgabe \[Tabelle\]. Datentyp: Zeichenfolge | | Requested_by | Sys_id des Anwenders, der den Change angefordert hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | Requested_by_date | Datum und Uhrzeit, zu der die Implementierung des Change angefordert wird. Datentyp: Zeichenfolge | | review_comments | Kommentare, die bei der Überprüfung der Change-Anforderung eingegeben wurden. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | review_date | Datum, an dem die Change-Anforderung geprüft wurde. Datentyp: Zeichenfolge | | review_status | Aktueller Status der Überprüfung der angeforderten Change-Anforderung. Datentyp: Zeichenfolge | | Risiko | Risikostufe, die der Change-Anforderung zugeordnet ist. Gültige Werte: * 1: Hoch * 2: Mittel * 3: Niedrig {#change-GET-change-sys_id__ul_ejt_tn4_wnb} Datentyp: Zahl Standard: 3 | | risk_impact_anasys | Beschreibung des Risikos und Analyse der Implementierung der Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | Route_Reason | Derzeit nicht verwendet von Change-Management. Grund, aus dem die Change-Anforderung übertragen wurde. Mögliche Werte: * 1: Übertragung mit Lösung * 9: Übertragung ohne Lösungen {#change-GET-change-sys_id__ul_yvl_cxq_znb} Datentyp: Zahl | | scope | Größe der Change-Anforderung. Mögliche Werte: * 1: Massiv * 2: Groß * 3: Mittel * 4: Klein * 5: Winzig {#change-GET-change-sys_id__ul_b3j_3xq_znb} Datentyp: Zahl Standard: 3 | | Service.Offering | Sys_id des Serviceangebots, das der Change-Anforderung zugeordnet ist. Serviceangebote definieren die Serviceebene eindeutig in Bezug auf Verfügbarkeit, Umfang, Preisgestaltung und Verpackungsoptionen. Befindet sich in der Tabelle „Angebot" \[service_offering\]. Datentyp: Zeichenfolge | | short_description | Beschreibung der Change-Anforderung. Datentyp: Zeichenfolge Maximale Länge: 40 | | Kompetenzen | Liste der sys_ids aller Kompetenzen, die zur Implementierung der Change-Anforderung erforderlich sind. Befindet sich in der Kompetenztabelle \[cmn_skill\]. Datentyp: Array | | sla_due | Wird nicht mehr verwendet. Datum und Uhrzeit, zu der die Change-Anforderung basierend auf der zugehörigen Servicelevel-Vereinbarung abgeschlossen werden muss. Datentyp: Zeichenfolge | | sn_esign_document | Sys_id eines E-signierten Dokuments, das an die Change-Anforderung angehängt ist. Befindet sich in der Tabelle „Anhang" \[sys_attachment\]. Datentyp: Zeichenfolge | | sn_esign_esignature_configuration | Sys_id der E-Signatur-Signaturvorlage, die für das zugeordnete Dokument verwendet wird. Befindet sich in der Tabelle „E-Signatur-Vorlage" \[sn_esign_configuration\]. Datentyp: Zeichenfolge | | start_date | Zeitpunkt (Datum und Uhrzeit), zu dem die Implementierung der Change-Anforderung beginnen soll. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Change Requests. Mögliche Werte sind im Change-Modell definiert. Datentyp: Zahl (Ganzzahl) Standard: 1 | | std_change_producer_version | Sys_id des Datensatzerstellers und Change-Vorschlags, der der Change-Anforderung zugeordnet ist. Enthält auch die Anzahl und den Prozentsatz erfolgreicher und nicht erfolgreicher Change-Anforderungen, die aus dem Vorschlag erstellt wurden. Befindet sich in der Tabelle „Standard-Change-Vorlagenversion" \[std_change_producer_version\]. Datentyp: Zeichenfolge | | sys_class_name | Name der Tabelle, in der sich die Change-Anforderung befindet. Datentyp: Zeichenfolge | | sys_created_by | Name des Benutzers, der die Change-Anforderung ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des zugeordneten Change-Anforderungsdatensatzes. Datentyp: Zeichenfolge | | sys_domain | Bei Verwendung von Domänen in der Instanz der Name der Domäne, der der Change-Modul-Datensatz zugeordnet ist. Datentyp: Zeichenfolge | | sys_domain_path | Bei Verwendung von Domänen in der Instanz der Domänenpfad, in dem sich der zugehörige Change-Modul-Datensatz befindet. Datentyp: Zeichenfolge | | sys_id | Eindeutiger Bezeichner des zugeordneten Change-Anforderungsdatensatzes. Datentyp: Zeichenfolge | | sys_mod_count | Anzahl der Updates für den Fall seit der ursprünglichen Erstellung. Datentyp: Zahl (Ganzzahl) | | sys_updated_by | Person, die den Fall zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Falls. Datentyp: Zeichenfolge | | task_effektive_Nummer | Universal-Anforderungs-Nummer Datentyp: Zeichenfolge Maximale Länge: 40 | | task_for | Nicht verwendet von Change-Management. Sys_id des Anwenders, für den die Aufgabe erstellt wurde. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge | | test_plan | Beschreibung des zugeordneten Testplans für den Change. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | time_worked | Gesamtarbeitszeit für die Change-Anforderung. Datentyp: Zeichenfolge | | type | Change-Anforderungstyp. Mögliche Werte: * Notfall * normal * Standard Datentyp: Zeichenfolge Maximale Länge: 40 | | nicht autorisiert | Kennzeichnung, die angibt, ob die Change-Anforderung nicht autorisiert ist Mögliche Werte: * true: Nicht autorisiert * false: Autorisiert {#change-GET-change-sys_id__ul_gd3_q1p_wnb} Datentyp: Boolesch | | universal_request | Sys_id der übergeordneten Universal-Anforderung, zu der diese Change-Anforderung gehört. Befindet sich in der Aufgabentabelle \[task\]. Datentyp: Zeichenfolge | | on_approval | Aktion, die ausgeführt werden soll, wenn die Change-Anforderung genehmigt wird. Mögliche Werte: * do_nomething * fortfahren Datentyp: Zeichenfolge Maximale Länge: 40 Standard: fortsetzen | | on_reject | Aktion, die ausgeführt wird, wenn die Change-Anforderung abgelehnt wird. Mögliche Werte: * abbrechen * goto {#change-GET-change-sys_id__ul_mnw_cg3_2hb} Datentyp: Zeichenfolge Maximale Länge: 40 Standard: Abbrechen | | urgency | Dringlichkeit der Change-Anforderung. Mögliche Werte: * 1: Hoch * 2: Mittel * 3: Niedrig {#change-GET-change-sys_id__ul_td4_3g3_2hb} Datentyp: Zahl (Ganzzahl) Standard: 3 | | Anwender_Eingabe | Zusätzliche Anwendereingabe. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | variables | Name-Wert-Paare von Variablen, die der Change-Anforderung zugeordnet sind. Datentyp: Zeichenfolge Maximale Länge: 40 | | „watch_list" | Liste der sys_ids der Benutzer, die Benachrichtigungen zu dieser Change-Anforderung erhalten, wenn zusätzliche Kommentare hinzugefügt werden oder wenn der Status einer Change-Anforderung in Gelöst oder Geschlossen geändert wird. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Array | | wf_activity | Sys_id des Workflow-Aktivitätsdatensatzes, der der Change-Anforderung zugeordnet ist. Befindet sich in der Tabelle „Workflow-Aktivität" \[wf_activity\]. Datentyp: Zeichenfolge | | work_end | Datum und Uhrzeit des Endes der Arbeit am Change Request. Datentyp: Zeichenfolge | | work_notes | Informationen darüber, wie die Change-Anforderung gelöst werden kann, oder welche Schritte zur Lösung des Change Requests unternommen wurden. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | work_notes_list | Liste der sys_ids der internen Benutzer, die Benachrichtigungen über diese Change-Anforderung erhalten, wenn Arbeitsnotizen hinzugefügt werden. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Array | | work_start | Datum und Uhrzeit des Beginns der Arbeit an der Change-Anforderung. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Clear BGP sessions on a Cisco router", "value": "Clear BGP sessions on a Cisco router" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "1766f1de47410200e90d87e8dee490f6", "value": "1766f1de47410200e90d87e8dee490f6" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } } ## Change-Management -- GET /sn_chg_rest/change/{sys_id}/ci {#ariaid-title14} Ruft mehrere Configuration Items (CIs) ab, die einer angegebenen Change-Anforderung zugeordnet sind, basierend auf dem angegebenen Zuordnungstyp. ### URL-Format {#change-GET-ci__section_sb3_m5n_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/ci Standard-URL: /api/sn_chg_rest/change/{sys_id}/ci ### Unterstützte Anforderungsparameter {#change-GET-ci__entry__2}{#change-GET-ci__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung, für die die zugeordneten CMDB-CIs zurückgegeben werden sollen. Datentyp: Zeichenfolge | [Tabelle : 73. Pfadparameter] {#change-GET-ci__entry__8}{#change-GET-ci__sysparm_offset-ph-RESTAPI} | Name | Beschreibung | |-|-| | „association_type" | Erforderlich. Typ der Zuordnung zwischen dem CMDB-CI und der Change-Anforderung. Gültige Werte: * Betroffene: CIs, die von der Change-Anforderung betroffen sind * impacted: Services, die von der Change-Anforderung betroffen sind * Jobangebot: Betroffene Serviceangebote {#change-GET-ci__ul_bp5_2sm_dhb} Datentyp: Zeichenfolge | | Name-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | sysparm_limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren. Datentyp: Zahl Standard: 500 | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-ci__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-ci__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-ci__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-ci__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | [Tabelle : 74. Abfrageparameter] {#change-GET-ci__entry__20} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 75. 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."). {#change-GET-ci__entry__24}{#change-GET-ci__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 76. Anforderungskopfzeilen] {#change-GET-ci__entry__28} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 77. 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. {#change-GET-ci__entry__32}{#change-GET-ci__entry-200-status-code}{#change-GET-ci__entry-401-status-code}{#change-GET-ci__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. Die Fehlerantwort enthält relevante Nachrichten, die bei der Behebung des Problems helfen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 78. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-ci__entry__42} | Name | Beschreibung | |-|-| | ci_item\|cmdb_ci_service | Je nach Zuordnungstyp entweder die Variable „ci_item" oder die Variable „cmdb_ci_service". Datentyp: Array ci_item|cmdb_ci_service : { display_value: "String", value: "String" } | | ci_item\|cmdb_ci_service.value | Sys_id von ci_item oder cmdb_ci_service. Datentyp: Zeichenfolge | | ci_item\|cmdb_ci_service.display_value | Anzeigewert von „ci_item" oder „cmdb_ci_service". Datentyp: Zeichenfolge | | sys_id | sys_id-Informationen der Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | \ | Alle gültigen Felder im Datensatz „ci_item" oder „cmdb_ci_service" Tabelle basierend auf dem Zuordnungstyp. Datentyp: Objekt | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci?association_type=affected" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' { result: [ { sys_id: { value: "92b8544047810200e90d87e8dee490b0", display_value: "92b8544047810200e90d87e8dee490b0" }, ci_item|cmdb_ci_service : { value: "3a27d4370a0a0bb4006316812bf45439", display_value: "PS Apache01" }, ..., // all valid fields in record, table based on association type }, { // next record found }, ... // and so on ] } ## Change-Management -- GET /sn_chg_rest/change/{sys_id}/conflict {#ariaid-title15} Ruft den Status des aktuell laufenden Change Request-Konflikt-Überprüfungsprozesses oder die Ergebnisse des letzten abgeschlossenen Konflikt-Überprüfungsprozesses für den angegebenen Change Request ab. ### URL-Format {#change-GET-conflict__section_dhd_zln_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/conflict Standard-URL: /api/sn_chg_rest/change/{sys_id}/conflict ### Unterstützte Anforderungsparameter {#change-GET-conflict__entry__2}{#change-GET-conflict__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung, für die der Status des laufenden/abgeschlossenen Konfliktüberprüfungsprozesses zurückgegeben werden soll. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 79. Pfadparameter] {#change-GET-conflict__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 80. Abfrageparameter] {#change-GET-conflict__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 81. 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."). {#change-GET-conflict__entry__16}{#change-GET-conflict__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 82. Anforderungskopfzeilen] {#change-GET-conflict__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 83. 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. {#change-GET-conflict__entry__24}{#change-GET-conflict__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Aktueller Status des Konflikt-Überprüfungsprozesses; einschließlich Konflikte, wenn welche entdeckt werden. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 84. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-conflict__entry__36} | Name | Beschreibung | |-|-| | Konflikte | Liste der gefundenen Konflikte für den Change Request. Ein leeres Objekt gibt an, dass keine Konflikte erkannt wurden. Datentyp: Array | | job_status | Status des aktuellen Konflikt-Überprüfungsjobs. Datentyp: Zeichenfolge | | last_run | Datum und Uhrzeit des Beginns des letzten Konflikt-Überprüfungsprozesses. Datentyp: Zeichenfolge | | record_count | Anzahl der geprüften Datensätze. Datentyp: Zeichenfolge | | status | Ergebnis des Konflikt-Überprüfungsprozesses, wie zum Beispiel „Konflikt" oder „Nicht ausgeführt". Hinweis: Auch wenn die Change-Anforderung keine Konflikte aufweist, wird dieses Feld auf „Konflikt" gesetzt. Das Objekt conflicts ist jedoch leer. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Erfolgreiche Antwort -- keine Konflikte { result: { status: "Conflict", last_run": "2018-08-30 12:58:05", record_count: "1", job_status: "2", conflicts: [] } } ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Erfolgreiche Antwort -- mit Konflikten { result: { status: "Conflict", last_run": "2018-08-30 12:58:05", record_count: "1", job_status: "2", conflicts: [ { change: { display_value: "CHG0030001", value: "afbffb24b758230096c3e4f6ee11a972" }, type: { display_value: "Not In Maintenance Window", value: "not_in_maintenance_window" } ..., // all valid fields in record, example below } ] } } ## Change Management -- GET /sn_chg_rest/change/emergency {#ariaid-title16} Ruft einen oder mehrere Notfall-Change Requests basierend auf den angegebenen Kriterien ab. ### URL-Format {#change-GET-emergency__section_hdm_cxs_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/emergency Standard-URL: /api/sn_chg_rest/change/emergency ### Unterstützte Anforderungsparameter {#change-GET-emergency__entry__2}{#change-GET-emergency__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 85. Pfadparameter] {#change-GET-emergency__entry__6}{#change-GET-emergency__sysparm_offset-ph-RESTAPI} | Name | Beschreibung | |-|-| | Bestellen | Feld, nach dem die zurückgesendeten Change Requests sortiert werden sollen. Standard: Zahl Datentyp: Zeichenfolge Standard: Nummer | | sysparm_limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren. Datentyp: Zahl Standard: 500 | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-emergency__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-emergency__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-emergency__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-emergency__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | Schlüssel-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller Notfall-Change Request-Datensatzfelder verwendet wird. Diese Suche nutzt die Funktion der Volltextsuchplattform ServiceNow und ist standardmäßig auf `IR_AND_OR_QUERY eingestellt`. Datentyp: Zeichenfolge | [Tabelle : 86. Abfrageparameter] {#change-GET-emergency__table_dht_wnc_4mb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 87. Anforderungstextparameter (XML oder JSON)] {#change-GET-emergency__table_dht_wnc_4mb} ### 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."). {#change-GET-emergency__entry__24}{#change-GET-emergency__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 88. Anforderungskopfzeilen] {#change-GET-emergency__entry__28} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 89. 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. {#change-GET-emergency__entry__32}{#change-GET-emergency__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 90. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-emergency__entry__40} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status der Change-Anforderung. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „Notfall". Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" }, }, { // next record found }, ... // and so on ] } ## Change-Management -- GET /sn_chg_rest/change/emergency/{sys_id} {#ariaid-title17} Ruft den Notfall-Change Request ab, der von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-GET-emergency-sys_id__section_ovg_gbt_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/emergency/{sys_id} Standard-URL: /api/sn_chg_rest/change/emergency/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-emergency-sys_id__entry__2}{#change-GET-emergency-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Notfall-Change-Anforderung, die aus der Tabelle „Change-Anforderung" \[change_request\] abgerufen werden soll. Datentyp: Zeichenfolge | [Tabelle : 91. Pfadparameter] {#change-GET-emergency-sys_id__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 92. Abfrageparameter] {#change-GET-emergency-sys_id__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 93. 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."). {#change-GET-emergency-sys_id__entry__16}{#change-GET-emergency-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 94. Anforderungskopfzeilen] {#change-GET-emergency-sys_id__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 95. 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. {#change-GET-emergency-sys_id__entry__24}{#change-GET-emergency-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 96. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-emergency-sys_id__entry__36} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status der Change-Anforderung. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „Notfall". Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "b0dbda5347c12200e0ef563dbb9a718f", display_value: "b0dbda5347c12200e0ef563dbb9a718f" }, state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" }, }, ] } ## Change-Management -- GET /sn_chg_rest/change/model {#ariaid-title18} Ruft ein oder mehrere Change-Modelle basierend auf den angegebenen Kriterien ab. Verwenden Sie diesen Endpunkt, um ein Change-Modell zu finden, das am besten zu der Change-Anforderung passt, die Sie erstellen möchten. Weitere Informationen finden Sie unter [Change-Modelle](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/model Standard-URL: /api/sn_chg_rest/change/model ### Unterstützte Anforderungsparameter {#change-GET-model__entry__2}{#change-GET-model__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 97. Pfadparameter] {#change-GET-model__entry__6}{#change-GET-model__sysparm_offset-ph-RESTAPI}{#change-GET-model__sysparm-query-RESTAPI} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | Bestellen | Feld, nach dem die zurückgegebenen Change-Modelle sortiert werden sollen. Datentyp: Zeichenfolge Standard: Name | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-model__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-model__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-model__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-model__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller Datensatzfelder des Change-Modells verwendet wird. Diese Suche nutzt die Funktionalität der Volltextsuchplattform ServiceNow. Weitere Informationen zu den Suchfunktionen für ServiceNow finden Sie unter [Suchverwaltung](https://www.servicenow.com/docs/access?context=search-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Datentyp: Zeichenfolge Standard: IR_AND_OR_QUERY | [Tabelle : 98. Abfrageparameter] {#change-GET-model__entry__18} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 99. 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."). {#change-GET-model__entry__22}{#change-GET-model__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 100. Anforderungskopfzeilen] {#change-GET-model__entry__26} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 101. 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. {#change-GET-model__entry__30}{#change-GET-model__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 102. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-model__entry__38} | Name | Beschreibung | |-|-| | Ergebnis | Liste mit mindestens einem Datensatzobjekt des Change-Modells. Jedes Objekt beschreibt ein Change-Modell. Jedes Element im Change-Modell-Objekt entspricht einem Feld in dem zugehörigen Datensatz in der Tabelle „Change-Modell" \[chg_model\]. Alle -Elemente enthalten Name-Wert-Paare vom Typ „ Wert " und „display_value". Einige enthalten display_value_internal Name/Wert-Paare. Datentyp: Array | | result.active | Kennzeichnung, die angibt, ob der zugeordnete Datensatz des Change-Modells aktiv und innerhalb der Instanz verfügbar ist. Gültige Werte: * „wahr": Das Change-Modell ist aktiv. * „falsch": Das Change-Modell ist nicht aktiv. {#change-GET-model__ul_lg3_kls_vnb} Datentyp: Boolesch Standardwert: true | | result.available_in_ui | Kennzeichnung, die angibt, ob der zugeordnete Datensatz des Change-Modells innerhalb der Anwenderoberfläche verfügbar ist. Gültige Werte: * wahr: Das Change-Modell ist in der -Anwenderoberfläche verfügbar. * „falsch": Das Change-Modell ist in der Anwenderoberfläche nicht verfügbar. {#change-GET-model__ul_srf_mls_vnb} Datentyp: Boolesch Standardwert: true | | Ergebnis.Farbe | Farbe des zugeordneten Change-Modells auf der Zielseite der Change-Anforderung. Datentyp: Zeichenfolge Standard: #cbcbcb | | result.default_change_model | Kennzeichnung, die angibt, ob der zugeordnete Datensatz des Change-Modells das Standard-Change-Modell ist. Gültige Werte: * true: Standard * false: Nicht der Standard {#change-GET-model__ul_bnb_vls_vnb} Datentyp: Boolesch Standardwert: false | | result.description | Kurze Beschreibung des Zwecks des Change-Modells. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | result.name | Name des Change-Modells. Datentyp: Zeichenfolge Maximale Länge: 200 | | result.record_preset | Name-Wert-Paare der Felder, die automatisch mit den zugehörigen Werten ausgefüllt werden sollen, wenn ein neuer Change-Anforderungsdatensatz erstellt wird. Werte werden durch Einfügesymbole getrennt. Beispiel: `"type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automatisiert: Change^EQ" ` Datentyp: Zeichenfolge | | result.state_field | Auswahllistenfeld, aus dem Auswahlmöglichkeiten gesammelt werden sollen, basierend auf dem in table_nameangegebenen . Bei Change-Modellen ist dies immer auf „Status" festgelegt. Datentyp: Zeichenfolge | | result.sys_class_name | Ändern Sie den Modultabellennamen. Change-Modell/chg_model Datentyp: Zeichenfolge | | result.sys_created_by | Name des Benutzers, der den Datensatz des zugehörigen Change-Moduls ursprünglich erstellt hat. Datentyp: Zeichenfolge | | result.sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des Change-Modul-Datensatzes. Datentyp: Zeichenfolge | | result.sys_domain | Bei Verwendung von Domänen in der Instanz der Name der Domäne, der der Change-Modul-Datensatz zugeordnet ist. Datentyp: Zeichenfolge | | result.sys_domain_path | Bei Verwendung von Domänen in der Instanz der Domänenpfad, in dem sich der zugehörige Change-Modul-Datensatz befindet. Datentyp: Zeichenfolge | | result.sys_id | Eindeutiger Bezeichner des zugeordneten Datensatzes des Change-Modells. Datentyp: Zeichenfolge | | result.sys_mod_count | Anzahl der Male, mit denen der zugeordnete Datensatz des Change-Modells geändert wurde. Datentyp: Zahl | | result.sys_name | Name des Change-Modells. Immer derselbe wie der Parameter name. Datentyp: Zeichenfolge | | result.sys_tags | System-Tags, die dem Change-Modell-Datensatz zugeordnet sind. Datentyp: Zeichenfolge | | result.sys_updated_by | Name des Benutzers, der den zugehörigen Datensatz des Change-Modells zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | result.sys_updated_on | Zeitpunkt (Datum und Uhrzeit), zu dem der Datensatz des zugehörigen Change-Modells zuletzt aktualisiert wurde. Datentyp: Zeichenfolge | | result.table_name | Tabelle, die das Auswahllistenfeld definiert, aus dem Auswahlmöglichkeiten gesammelt werden sollen. Für Change-Modelle ist dies immer auf „change_request" festgelegt. Datentyp: Zeichenfolge Maximale Länge: 80 | [ ] ### cURL-Anforderung Dieses Beispiel zeigt eine Anforderung zum Abrufen aller Datensätze des Change-Modells. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model \ --request GET \ --header "Accept:application/json" \ --user "username":"password" Der Kürze halber zeigt diese Antwort nur ein einziges Change-Modell-Objekt. { "result": [ { "record_preset": { "display_value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ", "value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ" }, "color": { "display_value": "#488df4", "value": "#488df4" }, "default_change_model": { "display_value": "false", "value": false }, "sys_mod_count": { "display_value": "6", "value": 6.0 }, "description": { "display_value": "This model is intended to capture a record of an automated change. There are no approvals associated with this change model.\r\n", "value": "This model is intended to capture a record of an automated change. There are no approvals associated with this change model.\r\n" }, "active": { "display_value": "true", "value": true }, "sys_updated_on": { "display_value": "2020-10-02 06:24:24", "value": "2020-10-02 13:24:24", "display_value_internal": "2020-10-02 06:24:24" }, "sys_tags": { "display_value": "", "value": "" }, "table_name": { "display_value": "change_request", "value": "change_request" }, "sys_class_name": { "display_value": "Change Model", "value": "chg_model" }, "sys_id": { "display_value": "7840d2515323101034d1ddeeff7b12a6", "value": "7840d2515323101034d1ddeeff7b12a6" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "available_in_ui": { "display_value": "false", "value": false }, "state_field": { "display_value": "state", "value": "state" }, "sys_created_on": { "display_value": "2020-09-28 07:33:25", "value": "2020-09-28 14:33:25", "display_value_internal": "2020-09-28 07:33:25" }, "name": { "display_value": "Change Registration", "value": "Change Registration" }, "sys_name": { "display_value": "Change Registration", "value": "Change Registration" }, "sys_created_by": { "display_value": "admin", "value": "admin" } } ] } ## Change-Management -- GET /sn_chg_rest/change/model/{sys_id} {#ariaid-title19} Ruft das Change-Modell ab, das durch die angegebene sys_id identifiziert wurde. Anschließend können Sie mit diesem Change-Modell die gewünschte Change-Anforderung erstellen. Weitere Informationen zu Change-Modellen finden Sie unter [Change-Modelle](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). ### URL-Format {#change-GET-model-sys_id__section_et4_vbs_4nb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/model/{sys_id} Standard-URL: /api/sn_chg_rest/change/model/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-model-sys_id__entry__2}{#change-GET-model-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id des Change-Modell-Datensatzes, der aus der Tabelle „Change-Modell" \[chg_model\] abgerufen werden soll. Datentyp: Zeichenfolge | [Tabelle : 103. Pfadparameter] {#change-GET-model-sys_id__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 104. Abfrageparameter] {#change-GET-model-sys_id__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 105. 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."). {#change-GET-model-sys_id__entry__16}{#change-GET-model-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 106. Anforderungskopfzeilen] {#change-GET-model-sys_id__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 107. 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. {#change-GET-model-sys_id__entry__24}{#change-GET-model-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 108. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-model-sys_id__entry__36} | Name | Beschreibung | |-|-| | Ergebnis | Datensatzobjekt des angeforderten Change-Modells. Jedes Element in diesem Objekt entspricht einem Feld im Datensatz in der Tabelle „Change-Modell" \[chg_model\]. Alle -Elemente enthalten Name-Wert-Paare vom Typ value und display_value. Einige enthalten Name/Wert-Paare display_value_internal. Datentyp: Objekt | | result.active | Kennzeichnung, die angibt, ob der zugeordnete Datensatz des Change-Modells aktiv und innerhalb der Instanz verfügbar ist. Gültige Werte: * „wahr": Das Change-Modell ist aktiv. * „falsch": Das Change-Modell ist nicht aktiv. {#change-GET-model-sys_id__ul_lg3_kls_vnb} Datentyp: Boolesch Standardwert: true | | result.available_in_ui | Kennzeichnung, die angibt, ob der zugeordnete Datensatz des Change-Modells innerhalb der Anwenderoberfläche verfügbar ist. Gültige Werte: * wahr: Das Change-Modell ist in der -Anwenderoberfläche verfügbar. * „falsch": Das Change-Modell ist in der Anwenderoberfläche nicht verfügbar. {#change-GET-model-sys_id__ul_srf_mls_vnb} Datentyp: Boolesch Standardwert: true | | Ergebnis.Farbe | Farbe des zugeordneten Change-Modells auf der Zielseite der Change-Anforderung. Datentyp: Zeichenfolge Standard: #cbcbcb | | result.default_change_model | Kennzeichnung, die angibt, ob der zugeordnete Datensatz des Change-Modells das Standard-Change-Modell ist. Gültige Werte: * true: Standard * false: Nicht der Standard {#change-GET-model-sys_id__ul_bnb_vls_vnb} Datentyp: Boolesch Standardwert: false | | result.description | Kurze Beschreibung des Zwecks des Change-Modells. Datentyp: Zeichenfolge Maximale Länge: 4.000 | | result.name | Name des Change-Modells. Datentyp: Zeichenfolge Maximale Länge: 200 | | result.record_preset | Name-Wert-Paare der Felder, die automatisch mit den zugehörigen Werten ausgefüllt werden sollen, wenn ein neuer Change-Anforderungsdatensatz erstellt wird. Werte werden durch Einfügesymbole getrennt. Beispiel: `"type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automatisiert: Change^EQ" ` Datentyp: Zeichenfolge | | result.state_field | Auswahllistenfeld, aus dem Auswahlmöglichkeiten gesammelt werden sollen, basierend auf dem in table_nameangegebenen . Bei Change-Modellen ist dies immer auf „Status" festgelegt. Datentyp: Zeichenfolge | | result.sys_class_name | Ändern Sie den Modultabellennamen. Change-Modell/chg_model Datentyp: Zeichenfolge | | result.sys_created_by | Name des Benutzers, der den Datensatz des zugehörigen Change-Moduls ursprünglich erstellt hat. Datentyp: Zeichenfolge | | result.sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des Change-Modul-Datensatzes. Datentyp: Zeichenfolge | | result.sys_domain | Bei Verwendung von Domänen in der Instanz der Name der Domäne, der der Change-Modul-Datensatz zugeordnet ist. Datentyp: Zeichenfolge | | result.sys_domain_path | Bei Verwendung von Domänen in der Instanz der Domänenpfad, in dem sich der zugehörige Change-Modul-Datensatz befindet. Datentyp: Zeichenfolge | | result.sys_id | Eindeutiger Bezeichner des zugeordneten Datensatzes des Change-Modells. Datentyp: Zeichenfolge | | result.sys_mod_count | Anzahl der Male, mit denen der zugeordnete Datensatz des Change-Modells geändert wurde. Datentyp: Zahl | | result.sys_name | Name des Change-Modells. Immer derselbe wie der Parameter name. Datentyp: Zeichenfolge | | result.sys_tags | System-Tags, die dem Change-Modell-Datensatz zugeordnet sind. Datentyp: Zeichenfolge | | result.sys_updated_by | Name des Benutzers, der den zugehörigen Datensatz des Change-Modells zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | result.sys_updated_on | Zeitpunkt (Datum und Uhrzeit), zu dem der Datensatz des zugehörigen Change-Modells zuletzt aktualisiert wurde. Datentyp: Zeichenfolge | | result.table_name | Tabelle, die das Auswahllistenfeld definiert, aus dem Auswahlmöglichkeiten gesammelt werden sollen. Für Change-Modelle ist dies immer auf „change_request" festgelegt. Datentyp: Zeichenfolge Maximale Länge: 80 | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model/c0efda5347c12200e0ef563dbb9a81e3" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "record_preset": { "display_value": "type=emergency^EQ", "value": "type=emergency^EQ" }, "color": { "display_value": "#ea3423", "value": "#ea3423" }, "default_change_model": { "display_value": "false", "value": false }, "sys_mod_count": { "display_value": "2", "value": 2.0 }, "description": { "display_value": "ITIL Mode 1 Emergency Change", "value": "ITIL Mode 1 Emergency Change" }, "active": { "display_value": "true", "value": true }, "sys_updated_on": { "display_value": "2020-09-28 08:53:12", "value": "2020-09-28 15:53:12", "display_value_internal": "2020-09-28 08:53:12" }, "sys_tags": { "display_value": "", "value": "" }, "table_name": { "display_value": "change_request", "value": "change_request" }, "sys_class_name": { "display_value": "Change Model", "value": "chg_model" }, "sys_id": { "display_value": "c0efda5347c12200e0ef563dbb9a81e3", "value": "c0efda5347c12200e0ef563dbb9a81e3" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "available_in_ui": { "display_value": "true", "value": true }, "state_field": { "display_value": "state", "value": "state" }, "sys_created_on": { "display_value": "2020-09-04 09:16:03", "value": "2020-09-04 16:16:03", "display_value_internal": "2020-09-04 09:16:03" }, "name": { "display_value": "Emergency", "value": "Emergency" }, "sys_name": { "display_value": "Emergency", "value": "Emergency" }, "sys_created_by": { "display_value": "admin", "value": "admin" } } } ## Change-Management -- GET /sn_chg_rest/change/normal {#ariaid-title20} Ruft eine oder mehrere normale Change-Anforderungen basierend auf den angegebenen Kriterien ab. ### URL-Format {#change-GET-normal__section_vpf_mlr_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/normal Standard-URL: /api/sn_chg_rest/change/normal ### Unterstützte Anforderungsparameter {#change-GET-normal__entry__2}{#change-GET-normal__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 109. Pfadparameter] {#change-GET-normal__entry__6}{#change-GET-normal__sysparm_offset-ph-RESTAPI} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | Bestellen | Feld, nach dem die zurückgesendeten Change Requests sortiert werden sollen. Standard: Zahl Datentyp: Zeichenfolge | | sysparm_limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren. Datentyp: Zahl Standard: 500 | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-normal__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-normal__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-normal__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-normal__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller normalen Change Request-Datensatzfelder verwendet wird. Diese Suche verwendet Volltextsuche-Funktionalität der ServiceNow-Plattform und verwendet standardmäßig `IR_AND_OR_QUERY`. Datentyp: Zeichenfolge | [Tabelle : 110. Abfrageparameter] {#change-GET-normal__entry__20} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 111. 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."). {#change-GET-normal__entry__24}{#change-GET-normal__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 112. Anforderungskopfzeilen] {#change-GET-normal__entry__28} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 113. 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. {#change-GET-normal__entry__32}{#change-GET-normal__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 114. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-normal__entry__40} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Normal". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „normal". Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, { // next record found }, ... // and so on ] } ## Change-Management -- GET /sn_chg_rest/change/normal/{sys_id} {#ariaid-title21} Ruft den normalen Change Request ab, der von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-GET-normal-sys_id__section_q1h_nnr_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/normal/{sys_id} Standard-URL: /api/sn_chg_rest/change/normal/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-normal-sys_id__entry__2}{#change-GET-normal-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der normalen Change-Anforderung, die aus der Tabelle „Change-Anforderung" \[change_request\] abgerufen werden soll. Datentyp: Zeichenfolge | [Tabelle : 115. Pfadparameter] {#change-GET-normal-sys_id__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 116. Abfrageparameter] {#change-GET-normal-sys_id__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 117. 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."). {#change-GET-normal-sys_id__entry__16}{#change-GET-normal-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 118. Anforderungskopfzeilen] {#change-GET-normal-sys_id__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 119. 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. {#change-GET-normal-sys_id__entry__24}{#change-GET-normal-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 120. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-normal-sys_id__entry__36} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Normal". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „normal". Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, ] } ## Change-Management -- GET /sn_chg_rest/change/standard {#ariaid-title22} Ruft einen oder mehrere Standard-Change Requests basierend auf den angegebenen Kriterien ab. ### URL-Format {#change-GET-standard__section_q3c_ppv_wlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/standard Standard-URL: /api/sn_chg_rest/change/standard ### Unterstützte Anforderungsparameter {#change-GET-standard__entry__2}{#change-GET-standard__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 121. Pfadparameter] {#change-GET-standard__entry__6}{#change-GET-standard__sysparm_offset-ph-RESTAPI} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | Bestellen | Feld, nach dem die zurückgesendeten Change Requests sortiert werden sollen. Standard: Zahl Datentyp: Zeichenfolge | | sysparm_limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren. Datentyp: Zeichenfolge Standard: 500 | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-standard__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-standard__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-standard__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-standard__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller Standard-Change Request-Datensatzfelder verwendet wird. Diese Suche nutzt die Funktion der Volltextsuchplattform ServiceNow und ist standardmäßig auf `IR_AND_OR_QUERY eingestellt`. Datentyp: Zeichenfolge | [Tabelle : 122. Abfrageparameter] {#change-GET-standard__entry__20} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 123. 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."). {#change-GET-standard__entry__24}{#change-GET-standard__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 124. Anforderungskopfzeilen] {#change-GET-standard__entry__28} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 125. 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. {#change-GET-standard__entry__32}{#change-GET-standard__entry-200-status-code}{#change-GET-standard__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 126. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-standard__entry__40} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für den identifizierten Change Request. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Standard". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „Standard". Datentyp: Zeichenfolge | [ ] ### Beispiel für eine cURL-Anforderung curl "https://instance.service-now.com/api/sn_chg_rest/v1/change/standard?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, type: { value: "standard", display_value: "Standard" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, { // next record found }, ... // and so on ] } ## Change-Management -- GET /sn_chg_rest/change/standard/{sys_id} {#ariaid-title23} Ruft den Standard-Change Request ab, der von der angegebenen sys_id identifiziert wird. ### URL-Format {#change-GET-standard-sys_id__section_hgk_h1k_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/standard/{sys_id} Standard-URL: /api/sn_chg_rest/change/standard/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-standard-sys_id__section_bgs_31k_xlb} {#change-GET-standard-sys_id__table_cgs_31k_xlb__entry__2}{#change-GET-standard-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Standard-Change-Anforderung, die aus der Tabelle „Change-Anforderung" \[change_request\] abgerufen werden soll. Datentyp: Zeichenfolge | [Tabelle : 127. Pfadparameter] {#change-GET-standard-sys_id__table_cgs_31k_xlb} {#change-GET-standard-sys_id__table_yvb_r1k_xlb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 128. Abfrageparameter] {#change-GET-standard-sys_id__table_yvb_r1k_xlb} {#change-GET-standard-sys_id__table_uvn_xfw_nmb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 129. Anforderungstextparameter (XML oder JSON)] {#change-GET-standard-sys_id__table_uvn_xfw_nmb} ### Kopfzeilen {#change-GET-standard-sys_id__section_tbj_gbk_xlb} 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."). {#change-GET-standard-sys_id__table_ubj_gbk_xlb__entry__2}{#change-GET-standard-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 130. Anforderungskopfzeilen] {#change-GET-standard-sys_id__table_ubj_gbk_xlb} {#change-GET-standard-sys_id__table_vbj_gbk_xlb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 131. Antwortkopfzeilen] {#change-GET-standard-sys_id__table_vbj_gbk_xlb} ### Statuscodes {#change-GET-standard-sys_id__section_kp1_mbk_xlb} 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. {#change-GET-standard-sys_id__table_wwn_rhd_ct__entry__2}{#change-GET-standard-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 132. Statuscodes] {#change-GET-standard-sys_id__table_wwn_rhd_ct} ### Parameter des Antworttexts (JSON oder XML) {#change-GET-standard-sys_id__table_mc1_pr1_tx__entry__2} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für den identifizierten Change Request. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | [ ] {#change-GET-standard-sys_id__table_mc1_pr1_tx} ### cURL-Anforderung curl "https://https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, ] } ## Change Management -- GET /sn_chg_rest/change/standard/template {#ariaid-title24} Ruft eine oder mehrere Standard-Change-Vorlagen basierend auf den angegebenen Kriterien ab. ### URL-Format {#change-GET-standard-temp__section_on3_mnl_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/standard/template Standard-URL: /api/sn_chg_rest/change/standard/template ### Unterstützte Anforderungsparameter {#change-GET-standard-temp__entry__2}{#change-GET-standard-temp__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 133. Pfadparameter] {#change-GET-standard-temp__table_gdg_b4l_xlb__entry__2}{#change-GET-standard-temp__sysparm_offset-ph-RESTAPI} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare zum Filtern des Ergebnissatzes. Der Name ist das Feld, in dem der angegebene Wert gefiltert wird. Dieser Parameter und sysparm_query schließen sich gegenseitig aus. Beispielweise können Sie anstelle der Verwendung von `&sysparm_query=active=true` die aufrufende Anweisung mithilfe von `&active=true` vereinfachen. Sie können auch den Anzeigewert verwenden, wenn das Feld ein Auswahl- oder ein Referenztypfeld ist, z. B. `&state=closed` anstatt `&state=7`. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie sie jeweils mit einem kaufmännischen Und-Zeichen, z. B. `&active=true&assigned_to=john.smith`. Datentyp: Zeichenfolge | | Bestellen | Feld, nach dem die zurückgegebenen Standard-Change-Vorlagen sortiert werden sollen. Datentyp: Zeichenfolge Standard: Zahl | | sysparm_limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter sysparm_offset, um den Datensatzabruf zu paginieren. Datentyp: Zahl Standard: 500 | | sysparm_offset | Startdatensatzindex, für den der Datensatz abgerufen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Wenn zum Beispiel dieser Endpunkt zum ersten Mal aufgerufen wird, ist sysparm_offset auf „0" eingestellt. Verwenden Sie `sysparm_offset=sysparm_offset+sysparm_limit` zum einfachen Durchblättern aller verfügbaren Datensätze, bis das Ende aller Datensätze erreicht ist.{#change-GET-standard-temp__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl im Parameter sysparm_offset. Datentyp: Zahl Standard: 0 | | sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US), die zum Filtern des Ergebnissatzes verwendet wird. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `sysparm_query=`. * \: Name der Tabellenspalte, nach der gefiltert werden soll. * \: Unterstützt die folgenden Werte: * =: Stimmt genau überein mit \. * !=: Stimmt nicht überein mit \. * \^: Logisches UND, mehrfache Abfrageanweisungen. * \^OR: Logisches ODER, mehrfache Abfrageanweisungen. * LIKE: \ enthält die angegebene Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * STARTSWITH: \ beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. * ENDSWITH: \ endet mit der angegebenen Zeichenfolge. Funktioniert nur für \-Felder, deren Datentyp „string" (Zeichenfolge) ist. {#change-GET-standard-temp__ul_bgf_5vz_mlb} \: Wert, mit dem abgeglichen werden soll. {#change-GET-standard-temp__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, beispielsweise sysparm_query=\\\\[\\\\\]. Beispiel: `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Verwenden Sie die Klauseln `ORDERBY` und `ORDERBYDESC` in sysparm_query, um Antworten anhand bestimmter Felder zu sortieren. Syntax: * `ORDERBY` * `ORDERBYDESC` {#change-GET-standard-temp__ul_sq4_rc1_nlb} Beispiel: `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` Diese Abfrage filtert alle aktiven Datensätze und sortiert die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Es werden dann nur Zeilen unter Verwendung des gültigen Teils der Abfrage zurückgegeben. Sie können dieses Verhalten mithilfe der Eigenschaft glide.invalid_query.returns_no_rows steuern. Legen Sie diese Eigenschaft auf „true" fest, um bei einer ungültigen Abfrage keine Zeilen zurückzugeben. Hinweis: Diese Eigenschaft glide.invalid_query.returns_no_rows steuert das Verhalten aller Abfragen in der Instanz, beispielsweise in Listen, Skripts (GlideRecord.query()) und Webservice-APIs. Datentyp: Zeichenfolge | | textSearch | Zeichenfolge, die zum Durchsuchen aller Standard-Change Request-Datensatzfelder verwendet wird. Diese Suche verwendet Volltextsuche-Funktionalität der ServiceNow-Plattform und verwendet standardmäßig `IR_AND_OR_QUERY`. Datentyp: Zeichenfolge | [Tabelle : 134. Abfrageparameter] {#change-GET-standard-temp__table_gdg_b4l_xlb} {#change-GET-standard-temp__entry__20} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 135. 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."). {#change-GET-standard-temp__entry__24}{#change-GET-standard-temp__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 136. Anforderungskopfzeilen] {#change-GET-standard-temp__entry__28} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 137. 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. {#change-GET-standard-temp__table_wwn_rhd_ct__entry__2}{#change-GET-standard-temp__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 138. Statuscodes] {#change-GET-standard-temp__table_wwn_rhd_ct} ### Parameter des Antworttexts (JSON oder XML) {#change-GET-standard-temp__entry__40} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder mit ihren zugehörigen Werten für die identifizierte Standard-Change-Vorlage. Datentyp: Objekt | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | Vorlage | Informationen zur Standard-Change-Vorlage. Datentyp: Objekt template: { display_value: "String", value: "String" } | | template.display_value | Vorlageninformationen, die in der Anwenderoberfläche angezeigt werden sollen. Datentyp: Zeichenfolge | | template.value | sys_id der Vorlage Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "92b8544047810200e90d87e8dee490b0", display_value: "92b8544047810200e90d87e8dee490b0" }, template : { value: "1c8e02ec47410200e90d87e8dee49057", display_value: "Add network switch to datacenter cabinet" }, ..., // all valid fields in record, example below short_description: { value: "Standard change template to add network switch to cabinet", display_value: "Standard change template to add network switch to cabinet" }, }, { // next record found }, ... // and so on ] } ## Change-Management -- GET /sn_chg_rest/change/standard/template/{sys_id} {#ariaid-title25} Ruft die Standard-Change-Vorlage ab, die durch die angegebene sys_id identifiziert wird. ### URL-Format {#change-GET-standard-temp-sys_id__section_cvs_jbm_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/standard/template/{sys_id} Standard-URL: /api/sn_chg_rest/change/standard/template/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-standard-temp-sys_id__entry__2}{#change-GET-standard-temp-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Standard-Change-Vorlage, die aus der Tabelle \[std_change_record_producer\] abgerufen werden soll. Datentyp: Zeichenfolge | [Tabelle : 139. Pfadparameter] {#change-GET-standard-temp-sys_id__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 140. Abfrageparameter] {#change-GET-standard-temp-sys_id__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 141. 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."). {#change-GET-standard-temp-sys_id__entry__16}{#change-GET-standard-temp-sys_id__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 142. Anforderungskopfzeilen] {#change-GET-standard-temp-sys_id__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 143. 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. {#change-GET-standard-temp-sys_id__entry__24}{#change-GET-standard-temp-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 144. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-standard-temp-sys_id__entry__36} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder mit ihren zugehörigen Werten für die identifizierte Standard-Change-Vorlage. Datentyp: Objekt | | sys_id | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | Vorlage | Informationen zur Standard-Change-Vorlage. Datentyp: Objekt template: { display_value: "String", value: "String" } | | template.display_value | Vorlageninformationen, die in einer Anwenderoberfläche angezeigt werden sollen. Datentyp: Zeichenfolge | | template.value | sys_id der Vorlage Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template/92b8544047810200e90d87e8dee490b0" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "92b8544047810200e90d87e8dee490b0", template : { value: "1c8e02ec47410200e90d87e8dee49057", display_value: "Add network switch to datacenter cabinet" }, ..., // all valid fields in record, example below short_description: { value: "Standard change template to add network switch to cabinet", display_value: "Standard change template to add network switch to cabinet" }, }, ] } ## Change-Management -- GET /sn_chg_rest/change/worker/{sys_id} {#ariaid-title26} Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab. ### URL-Format {#change-GET-worker__section_vz2_g34_ylb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/worker/{sys_id} Standard-URL: /api/sn_chg_rest/{change/worker/{sys_id} ### Unterstützte Anforderungsparameter {#change-GET-worker__entry__2}{#change-GET-worker__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id des asynchronen Change-Management-Workers. Befindet sich in der Tabelle „Change-Management-Worker" \[chg_mgt_worker\]. Datentyp: Zeichenfolge | [Tabelle : 145. Pfadparameter] {#change-GET-worker__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 146. Abfrageparameter] {#change-GET-worker__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 147. 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."). {#change-GET-worker__entry__16}{#change-GET-worker__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 148. Anforderungskopfzeilen] {#change-GET-worker__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 149. 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. {#change-GET-worker__entry__24}{#change-GET-worker__entry-200-status-code}{#change-GET-worker__entry-401-status-code}{#change-GET-worker__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 150. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-GET-worker__table_is2_n4s_jpb__entry__2}{#change-GET-worker__cmapi-worker-resp-messages-err-ph}{#change-GET-worker__cmapi-worker-resp-messages-info-ph}{#change-GET-worker__cmapi-worker-resp-messages-warn-ph} | Name | Beschreibung | |-|-| | Nachrichten | Nachrichteninformationen. Datentyp: Objekt "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | nachrichten.fehlermeldungen | Bei der Verarbeitung der Anforderung sind Fehlermeldungen aufgetreten. Beispiel: ``` Ungültige CMDB_CI-sys_id angegeben ``` Datentyp: Array | | nachrichten.infoNachrichten | Informationsnachrichten, die bei der Verarbeitung der Anforderung aufgetreten sind. Beispiel: ``` CMDB_CI-sys_id ist bereits angegebener zugeordnet. ``` Datentyp: Array | | nachrichten.warnmeldungen | Bei der Verarbeitung der Anforderung sind Warnmeldungen aufgetreten. Beispiel: ``` Ungültige CMDB_CI-sys_id angegeben. ``` Datentyp: Array | | Nutzlast | Eindeutige Nutzlast, die bei Verwendung einer Worker-sys_id aus dem erfolgreichen Antworttext eines Zeitplanungsendpunkts bereitgestellt wird. * [/ci/{cmdb_ci_sys_id}/schedule abrufen](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-c_id-schedule "Ermöglicht das Abrufen verfügbarer Zeitfenster nach Konfigurationselement-ID und Dauer, mit der Option zum Einschließen der geplanten Startzeit.") * [/sn_chg_rest/change/{change_sys_id}/schedule abrufen](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-change-sys_id-sched "Aktiviert das Abrufen der verfügbaren Zeitfenster für eine Change-Anforderung.") {#change-GET-worker__ul_orx_mts_npb} "payload": { "spans": [Array] } Datentyp: Objekt | | payload.spans | Wenn eine Zeitspanne innerhalb der im Zeitplanendpunkt angegebenen Dauer verfügbar ist, listet die Worker-API die verfügbaren Zeitspannen auf. "payload": { "spans": [ { "start": {Object}, "end": {Object} } ] } Datentyp: Array | | payload.spans.start | "start": { "value": "String", "display_value": "String" } Datentyp: Objekt | | Nutzlast.Bereiche.Start.Wert | Zeitpunkt (Datum und Uhrzeit), zu dem die Implementierung der Change-Anforderung beginnen soll. Datentyp: Zeichenfolge | | payload.spans.start.anzeigewert | Zeigt den Wert der Startzeit der Change-Anforderung an. Zeitformat: jjjj-mm-tt hh:mm:ss Datentyp: Zeichenfolge | | payload.spans.ende | "end": { "value": "String", "display_value": "String" } Datentyp: Objekt | | Nutzlast.Bereiche.Endwert | Datum und Uhrzeit, zu der die Change-Anforderung abgeschlossen sein soll. Zeitformat: jjjj-mm-tt hh:mm:ss Datentyp: Zeichenfolge | | payload.spans.end.display_value | Zeigt den Wert der Bearbeitungszeit einer Change-Anforderung an. Datentyp: Zeichenfolge | | Anforderung | Ursprüngliche Endpunktanforderung. Datentyp: Zeichenfolge | | Staat | Informationen zum aktuellen Status des Mitarbeiters. Datentyp: Objekt state: { display_value: "String", value: Number } | | state.display_value | Anzeigewert des Status des Mitarbeiters. Diese Werte stehen in direktem Zusammenhang mit dem Parameter state.value. Mögliche Werte: * Abgeschlossen * Fehler * In Bearbeitung * Warten {#change-GET-worker__ul_ehh_nxy_jhb} Datentyp: Zeichenfolge | | Status.Wert | Numerischer Wert des Status des Mitarbeiters. Mögliche Werte: * 1 * 2 * 3 * 4 {#change-GET-worker__ul_zw1_fxy_jhb} Datentyp: Zahl | | type | Typ der Zuordnung zwischen dem CMDB-CI und der Change-Anforderung. Datentyp: Zeichenfolge | | Mitarbeiter | Informationen zum zugeordneten Mitarbeiter. Datentyp: Objekt "worker": { "link": "String", "sysId": "String" } | | worker.link | URL zum Abrufen des Status des zugeordneten Mitarbeiters und anderer relevanter Mitarbeiterinformationen. Datentyp: Zeichenfolge | | worker.sysId | Sys_id des Workers, der dem Change Request zugeordnet ist. Datentyp: Zeichenfolge | | \ | Andere prozessspezifische Parameter, z. B. ignored_cmdb_ci_sys_ids. | [ ] {#change-GET-worker__table_is2_n4s_jpb} ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/worker/0644cd02dbec330084f07ffdbf9619c1" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "worker": { "sysId": "0644cd02dbec330084f07ffdbf9619c1", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/0644cd02dbec330084f07ffdbf9619c1" }, "request": "{\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "impacted", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change-Management -- PATCH /sn_chg_rest/change/{sys_id} {#ariaid-title27} Aktualisiert die Change-Anforderung, die von der angegebenen sys_id identifiziert wird, mit den Schlüssel-Wert-Paaren im Anforderungstext oder in der URL.
### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id} Standard-URL: /api/sn_chg_rest/change/{sys_id} ### Unterstützte Anforderungsparameter {#change-PATCH-change-sys_id__entry__2}{#change-PATCH-change-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der zu ändernden Change-Anforderung. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 151. Pfadparameter] {#change-PATCH-change-sys_id__entry__8}{#change-PATCH-change-sys_id__encrypted_fields-chgmng-entry} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare, die die zu aktualisierenden Felder darstellen. Anforderungstextparameter überschreiben URL-Parameter. Erforderliche Parameter müssen jedoch in der URL angegeben werden. Datentyp: Zeichenfolge | | Verschlüsselte_Felder | Liste der durch Kommas getrennten Felder, die verschlüsselt werden sollen. Diese Felder werden verschlüsselt, bevor sie im zugehörigen Datensatz gespeichert werden. Wenn angegeben, ruft der Endpunkt die GlideRecord-Methode „ setDisplayValue() " anstelle der Methode „setValue() " auf. Aus diesem Grund können Sie diesen Parameter auch verwenden, um Anzeigewerte für unverschlüsselte Felder wie Referenz- oder Auswahlfelder zu übergeben, anstatt sys_ids oder Werte zu übergeben. Datentyp: Zeichenfolge | [Tabelle : 152. Abfrageparameter] {#change-PATCH-change-sys_id__entry__14}{#change-PATCH-change-sys_id__d2783e964} | Name | Beschreibung | |-|-| | Daten | Name-Wert-Paare, die für die Felder stehen, die im zugeordneten Change Request aktualisiert werden sollen. Um zum Beispiel die Datei „Kurzbeschreibung" zu aktualisieren, geben Sie ein Name-Wert-Paar ein, das ähnlich ist wie das Folgende: `--data "{\"short_description\": \"my short desc\" }" \`. Datentyp: Zeichenfolge | | Verschlüsselte_Felder | Liste der durch Kommas getrennten Felder, die verschlüsselt werden sollen. Diese Felder werden verschlüsselt, bevor sie im zugehörigen Datensatz gespeichert werden. Wenn angegeben, ruft der Endpunkt die GlideRecord-Methode „ setDisplayValue() " anstelle der Methode „setValue() " auf. Aus diesem Grund können Sie diesen Parameter auch verwenden, um Anzeigewerte für unverschlüsselte Felder wie Referenz- oder Auswahlfelder zu übergeben, anstatt sys_ids oder Werte zu übergeben. Datentyp: Zeichenfolge | [Tabelle : 153. 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."). {#change-PATCH-change-sys_id__entry__20}{#change-PATCH-change-sys_id__accept-RESTAPI}{#change-PATCH-change-sys_id__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 : 154. Anforderungskopfzeilen] {#change-PATCH-change-sys_id__entry__26} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 155. 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. {#change-PATCH-change-sys_id__entry__30}{#change-PATCH-change-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 156. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-change-sys_id__entry__42} | Name | Beschreibung | |-|-| | Ergebnis | Change-Anforderungsdatensatz aktualisiert. Jedes Element in diesem Objekt entspricht einem Feld im Datensatz in der Tabelle „Change-Anforderung" \[change_request\]. Alle -Elemente enthalten Name-Wert-Paare vom Typ value und display_value. Einige enthalten Name/Wert-Paare display_value_internal. Datentyp: Objekt | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request PATCH \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"short_desription\": \"Reboot the server at 6 am\" }" \ --user "username":"password" { "result": { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Reboot the server at 6 am", "value": "Reboot the server at 6 am" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "b0dbda5347c12200e0ef563dbb9a718f", "value": "b0dbda5347c12200e0ef563dbb9a718f" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } } ### cURL-Anforderung {#change-PATCH-change-sys_id__example_t5g_p5c_5xb} Das folgende Beispiel zeigt, wie verschlüsselte Felder im Anforderungstext übergeben werden. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"encrypted_fields\":\"short_description,description\", \"short_description\":\"my short desc\", \"description\":\"my desc\" }" \ --user "username":"password" ### cURL-Anforderung {#change-PATCH-change-sys_id__example_a4f_z5c_5xb} Das folgende Beispiel zeigt, wie verschlüsselte Felder als Abfrageparameter übergeben werden. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{}" \ --user "username":"password" ## Change Management -- PATCH /sn_chg_rest/change/{sys_id}/approvals {#ariaid-title28} Ermöglicht dem aktuellen Benutzer, einen Genehmigungsdatensatz für Change-Anforderungen für den angegebenen Change-Anforderung zu genehmigen oder abzulehnen. ### URL-Format {#change-PATCH-approvals__section_ord_srn_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/approvals Standard-URL: /api/sn_chg_rest/change/{sys_id}/approvals ### Unterstützte Anforderungsparameter {#change-PATCH-approvals__entry__2}{#change-PATCH-approvals__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung, für die die Genehmigung/Ablehnung gilt. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 157. Pfadparameter] {#change-PATCH-approvals__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 158. Abfrageparameter] {#change-PATCH-approvals__entry__12} | Name | Beschreibung | |-|-| | comments | Erforderlich, wenn state`abgelehnt`wird. Grund, aus dem der Change abgelehnt wurde. Datentyp: Zeichenfolge | | Staat | Erforderlich. Genehmigungsstatus. Beispiel: `--data "{\"state\": \"approved\"}" ` Gültige Werte: * Genehmigt * abgelehnt {#change-PATCH-approvals__ul_zcf_tpz_tkb} Datentyp: Zeichenfolge | [Tabelle : 159. 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."). {#change-PATCH-approvals__entry__18}{#change-PATCH-approvals__accept-RESTAPI}{#change-PATCH-approvals__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 : 160. Anforderungskopfzeilen] {#change-PATCH-approvals__entry__24} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 161. 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. {#change-PATCH-approvals__entry__28}{#change-PATCH-approvals__entry-200-status-code}{#change-PATCH-approvals__entry-401-status-code}{#change-PATCH-approvals__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 400 | Fehlerhafte Anforderung. Zeigt einen fehlerhaften Anforderungstyp an, wie zum Beispiel, dass der Benutzer nicht über die Befugnis zum Genehmigen oder Ablehnen des Change Requests verfügt. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 162. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-approvals__entry__38} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Aktueller Status des Change Requests. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id der genehmigten/abgelehnten Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Mögliche Werte: * Notfall * Normal * Standard {#change-PATCH-approvals__ul_czn_btz_tkb} Datentyp: Zeichenfolge | | type.value | Interner Typwert. Mögliche Werte: * Notfall * normal * Standard {#change-PATCH-approvals__ul_upd_cn5_wlb} Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/approvals" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"state\": \"approved\"}" \ --user "username":"password" { result: [ { sys_id: "0f4ac6c4b750230096c3e4f6ee11a9fe", state: { value: "-2", display_value: "Scheduled" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, single parameter example below short_description: { value: "Remove server", display_value: "Remove server" } } ] } ## Change Management -- PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available {#ariaid-title29} Aktualisiert die geplanten Start- und Endzeiten einer Change-Anforderung anhand des ersten gefundenen verfügbaren Zeitfensters. Erforderliche Rolle: sn_change_writer. Hinweis: Verwenden Sie den Link in der Eigenschaft des Antworttextes worker.link, um den Zeitplanstatus anzuzeigen. Siehe auch: * [GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-c_id-schedule "Ermöglicht das Abrufen verfügbarer Zeitfenster nach Konfigurationselement-ID und Dauer, mit der Option zum Einschließen der geplanten Startzeit.") * [/sn_chg_rest/change/{change_sys_id}/schedule abrufen](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-change-sys_id-sched "Aktiviert das Abrufen der verfügbaren Zeitfenster für eine Change-Anforderung.") {#change-PATCH-c_id-sched-first__ul_orx_mts_npb} ### URL-Format URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/schedule/first_available Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/schedule/first_available ### Unterstützte Anforderungsparameter {#change-PATCH-c_id-sched-first__entry__2}{#change-PATCH-c_id-sched-first__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung, die mit dem nächsten verfügbaren Zeitfenster aktualisiert werden soll. Befindet sich in der Tabelle „Change-Anforderungen" \[change_request\]. Die ausgewählte Change-Anforderung muss ein Configuration Item (cmdb_ci) aufweisen. | [Tabelle : 163. Pfadparameter] {#change-PATCH-c_id-sched-first__table_fd4_yhf_jpb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 164. Abfrageparameter] {#change-PATCH-c_id-sched-first__table_fd4_yhf_jpb} {#change-PATCH-c_id-sched-first__entry__12} | Name | Beschreibung | |-|-| | Dauer_in_Sekunden | Dauer des Change in Sekunden, d. h. wie viel Zeit zum Abschließen der Change-Anforderungsaufgabe erforderlich ist. Datentyp: Ganzzahl | | planned_start_time | Optional. Datum und Uhrzeit für den Start der Implementierung der Change-Anforderung in UTC. Rufen Sie das verfügbare Zeitfenster ab, das um oder später als diese Zeit beginnt. Wenn nicht angegeben, verwendet das System die aktuelle Uhrzeit als Startzeit. Zeitformat: jjjj-mm-tt hh:mm:ss Datentyp: Zeichenfolge | [Tabelle : 165. 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."). {#change-PATCH-c_id-sched-first__entry__18}{#change-PATCH-c_id-sched-first__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 166. Anforderungskopfzeilen] {#change-PATCH-c_id-sched-first__entry__22} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 167. 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. {#change-PATCH-c_id-sched-first__entry__26} | Statuscode | Beschreibung | |-|-| | 202 | Das System hat die Anforderung akzeptiert. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. Mögliche Probleme: * Der Wert des Textparameters „duration_in_seconds" ist ungültig oder wurde nicht angegeben.{#change-PATCH-c_id-sched-first__change-schedule-400-duration} {#change-PATCH-c_id-sched-first__change-schedule-400-duration} * Ungültiger Wert für Textkörperparameter „planned_start_time" angegeben.{#change-PATCH-c_id-sched-first__change-schedule-400-invalid-parm} {#change-PATCH-c_id-sched-first__change-schedule-400-invalid-parm} * Der angegebenen Change-Anforderung ist kein Configuration Item (cmdb_ci) zugeordnet. * Der Benutzer hat keinen Lesezugriff auf die Felder der Change-Anforderung. {#change-PATCH-c_id-sched-first__ul_rpf_3sk_npb} | | 403 | Unzulässig. Der Benutzer hat keinen Schreibzugriff auf die geplanten Start- und Enddatumswerte der Change-Anforderung. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. Mögliche Probleme: * Das System kann die Change-Anforderung nicht basierend auf den bereitgestellten Informationen finden. * Anwender hat keinen Lesezugriff auf den Datensatz. {#change-PATCH-c_id-sched-first__ul_ery_g1j_rpb} | [Tabelle : 168. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-c_id-sched-first__section_p33_ccf_jpb} {#change-PATCH-c_id-sched-first__table_is2_n4s_jpb__entry__2}{#change-PATCH-c_id-sched-first__row-result-error-cmdb}{#change-PATCH-c_id-sched-first__row-result-error_detail-cmdb}{#change-PATCH-c_id-sched-first__row-result-error_message-cmdb} | Name | Beschreibung | |-|-| | Fehler | Informationen zu Fehlern, die bei der Verarbeitung der Endpunktanforderung aufgetreten sind. Datentyp: Objekt "error": { "detail": "String", "message": "String", "status": "String" } | | Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge | | Fehlernachricht | Meldung, die den Fehler identifiziert. Datentyp: Zeichenfolge | | Nachrichten | Nachrichteninformationen. Datentyp: Objekt "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | nachrichten.fehlermeldungen | Bei der Verarbeitung der Anforderung sind Fehlermeldungen aufgetreten. Datentyp: Array | | nachrichten.infoNachrichten | Informationsnachrichten, die bei der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Array | | nachrichten.warnmeldungen | Bei der Verarbeitung der Anforderung sind Warnmeldungen aufgetreten. Datentyp: Array | | Anforderung | Ursprüngliche Endpunktanforderung. Datentyp: Zeichenfolge | | Staat | Informationen zum aktuellen Status des Mitarbeiters. Datentyp: Objekt state: { display_value: "String", value: Number } | | state.display_value | Anzeigewert des Status des Mitarbeiters. Diese Werte stehen in direktem Zusammenhang mit dem Parameter state.value. Mögliche Werte: * Abgeschlossen * Fehler * In Bearbeitung * Warten {#change-PATCH-c_id-sched-first__ul_ehh_nxy_jhb} Datentyp: Zeichenfolge | | Status.Wert | Numerischer Wert des Status des Mitarbeiters. Mögliche Werte: * 1 * 2 * 3 * 4 {#change-PATCH-c_id-sched-first__ul_zw1_fxy_jhb} Datentyp: Zahl | | type | Gibt den Typ der Anforderung an. Gültiger Wert: Zeitplan Datentyp: Zeichenfolge | | Mitarbeiter | Informationen zum zugeordneten Mitarbeiter. Datentyp: Objekt "worker": { "link": "String", "sysId": "String" } | | worker.link | Link zum Abrufen des Zeitplanstatus von Change-Anforderungen. Verwenden Sie die sys_id in [GET /sn_chg_rest/change/worker/{sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-worker "Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab."), um Ergebnisse anzuzeigen. Datentyp: Zeichenfolge | | worker.sysId | Sys_id des Workers, der dem Change Request zugeordnet ist. Datentyp: Zeichenfolge | | status | wird nur angezeigt, wenn ein Fehler auftritt. Status der Endpunktverarbeitung. Möglicher Wert: Fehler Datentyp: Zeichenfolge | [ ] {#change-PATCH-c_id-sched-first__table_is2_n4s_jpb} ### Ruft den Zeitplanstatus der Change-Anforderung ab {#change-PATCH-c_id-sched-first__cmapi-sched-get-change-status} Verwenden Sie den in worker.link angegebenen Wert, um zu bestimmen, ob der Change-Datensatz erfolgreich für das erste verfügbare Zeitfenster geplant wurde. Der Wert weist das folgende Format auf: https://instance.service-now.com/api/sn_chg_rest/change/worker/\ Verwenden Sie die worker.link-Details, um die bereitgestellte sys_id in [GET /sn_chg_rest/change/worker/{sys_id} auszuführen](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-worker "Ruft den aktuellen Status, Informationen und Fehler für den angegebenen asynchronen Worker ab.") und die Ergebnisse anzuzeigen. Der Antworttext enthält den Status und liefert Ergebnisse, wenn die Verarbeitung abgeschlossen ist. Wenn ein verfügbares Zeitfenster gefunden wird, aktualisiert das System den Change Request mit dem ersten verfügbaren Zeitfenster. Wenn der Status abgeschlossen ist, zeigt messages.infoMessages an, dass das erste verfügbare Zeitfenster festgelegt wurde. Einer der folgenden Werte für die Zeitplanungsantwort für messages.infoMessages wird im Antworttext bereitgestellt: * `Change wurde aktualisiert` -- Angeforderter Change wurde für das Zeitfenster aktualisiert. * `Keine Slots für gefunden` \ Tage ab jetzt : Keine Zeitfenster für die Dauer der Change-Anforderung innerhalb der im Zeitplanfenster definierten Anzahl von Tagen verfügbar. Hinweis: Der Standardwert für das Zeitfenster für die Planung von Change-Anforderungen beträgt 90 Tage. Um diesen Wert zu ändern, ändern Sie die Eigenschaft change.conflict.next_available.schedule_window. Weitere Informationen finden Sie unter [Konfliktanalyseeigenschaften konfigurieren](https://www.servicenow.com/docs/access?context=configure-conflict-properties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). {#change-PATCH-c_id-sched-first__ul_kb2_rhy_npb} Das folgende Beispiel für GET /sn_chg_rest/change/worker/{sys_id} zeigt die Ausgabe, die mit der im Detail worker.link angegebenen ID bereitgestellt wird. Die Ergebnisse zeigen, dass die Verarbeitung abgeschlossen ist und die Change-Anforderung mit dem ersten verfügbaren Zeitfenster aktualisiert wurde. { "result": { "worker": { "sysId": "355c62e0a4c87010f87712198fe9cacf", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [ "Change has been updated" ] } } } ### cURL-Anforderung curl "https://instance.service-now.com/api/sn_chg_rest/change/87ae5e900a0a2c3e263e8304e727c646/schedule/first_available" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{\"duration_in_seconds\":\"10800\"}" \ --user "username":"password" Die Ergebnisse enthalten worker.link-Details, die Sie verwenden können, um die angegebene sys_id im Endpunkt GET /sn_chg_rest/change/worker/ auszuführen. { "result": { "worker": { "sysId": "355c62e0a4c87010f87712198fe9cacf", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change-Management -- PATCH /sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} {#ariaid-title30} Aktualisiert die Change Request-Aufgabe, die von der angegebenen sys_id identifiziert wurde, mit den Schlüssel-Wert-Paaren im Anforderungstext oder der URL. ### URL-Format {#change-PATCH-c_id-task-t_id__section_lv1_rzm_ylb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task/{task_sys_id} Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} ### Unterstützte Anforderungsparameter {#change-PATCH-c_id-task-t_id__entry__2}{#change-PATCH-c_id-task-t_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung, der die Aufgabe zugeordnet ist. Überprüft, ob die angegebene Aufgabe dem angegebenen Change Request zugeordnet ist. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | | task_sys_id | Sys_id der zu ändernden Aufgabe. Befindet sich in der Tabelle „Change-Aufgabe" \[change_task\]. Datentyp: Zeichenfolge | [Tabelle : 169. Pfadparameter] {#change-PATCH-c_id-task-t_id__entry__10} | Name | Beschreibung | |-|-| | Schlüssel-Wert-Paare | Name-Wert-Paare, die die zu aktualisierenden Felder darstellen. Anforderungstextparameter überschreiben URL-Parameter. Erforderliche Parameter müssen jedoch in der URL angegeben werden. Datentyp: Zeichenfolge | [Tabelle : 170. Abfrageparameter] {#change-PATCH-c_id-task-t_id__entry__14} | Name | Beschreibung | |-|-| | Daten | Name-Wert-Paare, die für die Felder stehen, die im zugeordneten Change Request aktualisiert werden sollen. Um zum Beispiel die Datei „Kurzbeschreibung" zu aktualisieren, geben Sie ein Name-Wert-Paar ein, das ähnlich ist wie das Folgende: `--data "{\"short_description\": \"my short desc\" }" \`. Datentyp: Zeichenfolge | [Tabelle : 171. 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."). {#change-PATCH-c_id-task-t_id__entry__18}{#change-PATCH-c_id-task-t_id__accept-RESTAPI}{#change-PATCH-c_id-task-t_id__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 : 172. Anforderungskopfzeilen] {#change-PATCH-c_id-task-t_id__entry__24} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 173. 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. {#change-PATCH-c_id-task-t_id__entry__28}{#change-PATCH-c_id-task-t_id__entry-200-status-code}{#change-PATCH-c_id-task-t_id__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. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 174. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-c_id-task-t_id__entry__40} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für die identifizierte Change Request-Aufgabe vor dem Löschen. Datentyp: Objekt | | sys_id | Sys_id-Informationen für die Change-Anforderungsaufgabe. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderungsaufgabe zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderungsaufgabe. Datentyp: Zeichenfolge | | übergeordnet | Eindeutige Identifier-Informationen für die Change-Anforderung, die dieser Aufgabe zugeordnet ist. Datentyp: Objekt parent: { display_value: "String", value: "String" } | | parent.display_value | Aufgabeninformationen, die in einer Anwenderoberfläche angezeigt werden sollen. Datentyp: Zeichenfolge | | parent.value | Sys_id der übergeordneten Aufgabe. Datentyp: Zeichenfolge | | __meta.ignoredFields | Schlüssel-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change Request angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden oder die Felder schreibgeschützt sind. Datentyp: Array | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5?short_description=Retire both nodes" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type: application/json" \ --data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \ --user "username":"password" { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire both nodes", display_value: "Retire both nodes" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change-Management -- PATCH /sn_chg_rest/change/emergency/{sys_id} {#ariaid-title31} Aktualisiert den Notfall-Change Request, der von der angegebenen sys_id identifiziert wurde, mit den Schlüssel-Wert-Paaren im Anforderungstext oder der URL. ### URL-Format {#change-PATCH-emergency__section_xvk_cgt_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/emergency/{sys_id} Standard-URL: /api/sn_chg_rest/change/emergency/{sys_id} ### Unterstützte Anforderungsparameter {#change-PATCH-emergency__entry__2}{#change-PATCH-emergency__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der zu ändernden Change-Anforderung. Befindet sich in der Tabelle \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 175. Pfadparameter] {#change-PATCH-emergency__entry__8} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare, die die zu aktualisierenden Felder darstellen. Anforderungstextparameter überschreiben URL-Parameter. Erforderliche Parameter müssen jedoch in der URL angegeben werden. Datentyp: Zeichenfolge | [Tabelle : 176. Abfrageparameter] {#change-PATCH-emergency__entry__12} | Name | Beschreibung | |-|-| | Daten | Name-Wert-Paare, die für die Felder stehen, die im zugeordneten Change Request aktualisiert werden sollen. Um zum Beispiel die Datei „Kurzbeschreibung" zu aktualisieren, geben Sie ein Name-Wert-Paar ein, das ähnlich ist wie das Folgende: `--data "{\"short_description\": \"my short desc\" }" \`. Datentyp: Zeichenfolge | [Tabelle : 177. 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."). {#change-PATCH-emergency__entry__16}{#change-PATCH-emergency__accept-RESTAPI}{#change-PATCH-emergency__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 : 178. Anforderungskopfzeilen] {#change-PATCH-emergency__entry__22} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 179. 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. {#change-PATCH-emergency__entry__26}{#change-PATCH-emergency__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 180. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-emergency__entry__38} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Zeichenfolge | | Staat | Aktueller Status des Change Requests. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | __meta.ignoredFields | Name-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change-Anforderung angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden sind oder die Felder schreibgeschützt sind. Datentyp: Array | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \ --request PATCH \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"no_such_field\": \"this will be ignored\", }" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", }, state: { value: "-4", display_value: "Assess" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change-Management -- PATCH /sn_chg_rest/change/normal/{sys_id} {#ariaid-title32} Aktualisiert den normalen Change Request, der von der angegebenen sys_id identifiziert wurde, mit den Parametern im Anforderungstext oder der URL. ### URL-Format {#change-PATCH-normal__section_ksd_x2s_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/normal/{sys_id} Standard-URL: /api/sn_chg_rest/change/normal/{sys_id} ### Unterstützte Anforderungsparameter {#change-PATCH-normal__entry__2}{#change-PATCH-normal__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der zu ändernden Change-Anforderung. Befindet sich in der Tabelle \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 181. Pfadparameter] {#change-PATCH-normal__entry__8} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare, die die zu aktualisierenden Felder darstellen. Anforderungstextparameter überschreiben URL-Parameter. Erforderliche Parameter müssen jedoch in der URL angegeben werden. Datentyp: Zeichenfolge | [Tabelle : 182. Abfrageparameter] {#change-PATCH-normal__entry__12} | Name | Beschreibung | |-|-| | Daten | Name-Wert-Paare, die für die Felder stehen, die im zugeordneten Change Request aktualisiert werden sollen. Um zum Beispiel die Datei „Kurzbeschreibung" zu aktualisieren, geben Sie ein Name-Wert-Paar ein, das ähnlich ist wie das Folgende: `--data "{\"short_description\": \"my short desc\" }" \`. Datentyp: Zeichenfolge | [Tabelle : 183. 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."). {#change-PATCH-normal__entry__16}{#change-PATCH-normal__accept-RESTAPI}{#change-PATCH-normal__content_type-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | | Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 184. Anforderungskopfzeilen] {#change-PATCH-normal__entry__22} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 185. 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. {#change-PATCH-normal__entry__26}{#change-PATCH-normal__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 186. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-normal__entry__38} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Aktueller Status des Change Requests. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Normal". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „normal". Datentyp: Zeichenfolge | | __meta.ignoredFields | Name-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change-Anforderung angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden sind oder die Felder schreibgeschützt sind. Datentyp: Array | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f?state=assess" \ --request PATCH \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-4", display_value: "Assess" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change-Management -- PATCH /sn_chg_rest/change/standard/{sys_id} {#ariaid-title33} Aktualisiert den Standard-Change Request, der von der angegebenen sys_id identifiziert wurde, mit den Parametern im Anforderungstext oder der URL. ### URL-Format {#change-PATCH-standard__section_dz5_j5k_xlb} URL mit Versionsangabe: /api/sn_chg_rest/{api_version}/change/standard/{sys_id} Standard-URL: /api/sn_chg_rest/change/standard/{sys_id} ### Unterstützte Anforderungsparameter {#change-PATCH-standard__entry__2}{#change-PATCH-standard__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der zu ändernden Change-Anforderung. Befindet sich in der Tabelle \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 187. Pfadparameter] {#change-PATCH-standard__entry__8} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare, die die zu aktualisierenden Felder darstellen. Anforderungstextparameter überschreiben URL-Parameter. Erforderliche Parameter müssen jedoch in der URL angegeben werden. Datentyp: Zeichenfolge | [Tabelle : 188. Abfrageparameter] {#change-PATCH-standard__entry__12} | Name | Beschreibung | |-|-| | Daten | Name-Wert-Paare, die für die Felder stehen, die im zugeordneten Change Request aktualisiert werden sollen. Um zum Beispiel die Datei „Kurzbeschreibung" zu aktualisieren, geben Sie ein Name-Wert-Paar ein, das ähnlich ist wie das Folgende: `--data "{\"short_description\": \"my short desc\" }" \`. Datentyp: Zeichenfolge | [Tabelle : 189. 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."). {#change-PATCH-standard__entry__16}{#change-PATCH-standard__accept-RESTAPI}{#change-PATCH-standard__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 : 190. Anforderungskopfzeilen] {#change-PATCH-standard__entry__22} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 191. Antwortkopfzeilen] ### Statuscodes {#change-PATCH-standard__section_vzh_nvk_xlb} 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. {#change-PATCH-standard__table_wwn_rhd_ct__entry__2}{#change-PATCH-standard__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 192. Statuscodes] {#change-PATCH-standard__table_wwn_rhd_ct} ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-standard__entry__38} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Alle Felder (Schlüssel) mit ihren zugehörigen Werten für den identifizierten Change Request. Datentyp: Objekt | | Staat | Status der Change-Anforderung. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177?description=Reboot my email server" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{\"short_description\": \"my short desc\" }" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, ..., // all valid fields in record, example below short_description: { value: "Reboot my email server", display_value: "Reboot my email server" }, } ] } ## Change Management -- PATCH /sn_chg_rest/change/standard/{sys_id}/risk {#ariaid-title34} Berechnet das Risiko und die Auswirkungen des angegebenen Standard-Change auf der Grundlage einer Bewertung der Risikobedingungen. Wenn das Plugin Change Risk Assessment installiert ist, berechnet es auch das kumulativ höchste Risiko, sobald die Risikobewertung abgeschlossen ist. ### URL-Format {#change-PATCH-standard-risk__section_k5j_sgl_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/risk Standard-URL: /api/sn_chg_rest/change/{sys_id}/risk ### Unterstützte Anforderungsparameter {#change-PATCH-standard-risk__entry__2}{#change-PATCH-standard-risk__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id des auszuwertenden Standard-Change. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 193. Pfadparameter] {#change-PATCH-standard-risk__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 194. Abfrageparameter] {#change-PATCH-standard-risk__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 195. 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."). {#change-PATCH-standard-risk__entry__16}{#change-PATCH-standard-risk__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 196. Anforderungskopfzeilen] {#change-PATCH-standard-risk__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 197. 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. {#change-PATCH-standard-risk__entry__24}{#change-PATCH-standard-risk__entry-401-status-code}{#change-PATCH-standard-risk__entry-404-status-code}{#change-PATCH-standard-risk__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Risikobewertung erfolgreich abgeschlossen. | | 400 | Risikobewertung fehlgeschlagen Details zu der Art des Fehlers sind in den Fehlerdaten enthalten. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 198. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-PATCH-standard-risk__entry__36} | Name | Beschreibung | |-|-| | impact | Auswirkungen im Zusammenhang mit dem angegebenen Standard-Change. Datentyp: Objekt impact: { display_value: "String", value: "String" } | | „impact.display_value" | Auswirkungsinformationen, die in einer Anwenderoberfläche angezeigt werden sollen. Datentyp: Zeichenfolge | | Auswirkung.Wert | Wert der internen Auswirkung. Datentyp: Zeichenfolge | | Name-Wert-Paare | Alle gültigen Felder innerhalb des standardmäßigen Change Record. Datentyp: Objekt | | Risiko | Berechnetes Risiko für den angegebenen Standard-Change. Datentyp: Objekt risk: { display_value: "String", value: "String" } | | risk.display_value | Risikoinformationen, die in einer Anwenderoberfläche angezeigt werden sollen. Datentyp: Zeichenfolge | | risiko.wert | Interner Risikowert. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen für die Standard-Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderung. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/1c87925347c12200e0ef563dbb9a7177/risk" \ --request PATCH \ --header "Accept:application/json" \ --user "username":"password" { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, risk: { value: "4", display_value: "Low" }, impact: { value: "3", display_value: "3 - Low" } ..., // all valid fields in record } ## Change Management -- POST /sn_chg_rest/change {#ariaid-title35} Erstellt einen Change-Anforderungsdatensatz basierend auf der Change-Anforderung. Das Erstellen mehrerer Change-Anforderungen innerhalb eines einzigen Aufrufs wird nicht unterstützt. Sie können die Liste der verfügbaren Change-Modelle mit den Endpunkten [Change-Management -- GET /sn_chg_rest/change/model](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-model "Ruft ein oder mehrere Change-Modelle basierend auf den angegebenen Kriterien ab.") oder [Change-Management -- GET /sn_chg_rest/change/model/{sys_id}](https://www.servicenow.com/docs/jZq5xzfiDs40JpouU9zAaQ#change-GET-model-sys_id "Ruft das Change-Modell ab, das durch die angegebene sys_id identifiziert wurde.") abrufen. Legen Sie beim Erstellen einer Change-Anforderung das Change-Modell (chg_model) oder typefest. Wenn chg_modelund type festgelegt sind, ist der Typ einfach eine Kategorisierung des Change. Wenn Sie nicht mindestens einen dieser Werte angeben, wird eine Standardeinstellung verwendet, die sich je nach Release ändern kann. Es wird dringend empfohlen, mindestens einen dieser Werte festzulegen. Werte können entweder als Abfrageparameter oder als Anforderungstextparameter festgelegt werden. ### URL-Format URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change Standard-URL: /api/sn_chg_rest/change ### Unterstützte Anforderungsparameter {#change-POST-change-sys_id__entry__2}{#change-POST-change-sys_id__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 199. Pfadparameter] {#change-POST-change-sys_id__entry__6}{#change-POST-change-sys_id__encrypted_fields-chgmng-entry} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare, die die zu aktualisierenden Felder darstellen. Anforderungstextparameter überschreiben URL-Parameter. Erforderliche Parameter müssen jedoch in der URL angegeben werden. Die gleichen Werte können stattdessen als Anforderungstextparameter festgelegt werden. Hinweis: Legen Sie beim Erstellen einer Change-Anforderung das Change-Modell (chg_model) oder typefest. Wenn chg_modelund type festgelegt sind, ist der Typ einfach eine Kategorisierung des Change. Wenn Sie nicht mindestens einen dieser Werte angeben, wird eine Standardeinstellung verwendet, die sich je nach Release ändern kann. Es wird dringend empfohlen, mindestens einen dieser Werte festzulegen. Datentyp: Zeichenfolge | | chg_model | Name eines Change-Modells, das in der Tabelle „Change-Modell" \[chg_model\] aufgeführt ist. Wird im folgenden Format bereitgestellt: `chg_model=Normal`. Weitere Informationen finden Sie unter [Change-Modelle](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Hinweis: Wenn Sie weder das Change-Modell (chg_model) noch den Wert type angeben, ergibt sich eine Standardeinstellung, die bis zum Release geändert werden kann. Es wird dringend empfohlen, mindestens einen dieser Werte festzulegen. Datentyp: Zeichenfolge | | Verschlüsselte_Felder | Liste der durch Kommas getrennten Felder, die verschlüsselt werden sollen. Diese Felder werden verschlüsselt, bevor sie im zugehörigen Datensatz gespeichert werden. Wenn angegeben, ruft der Endpunkt die GlideRecord-Methode „ setDisplayValue() " anstelle der Methode „setValue() " auf. Aus diesem Grund können Sie diesen Parameter auch verwenden, um Anzeigewerte für unverschlüsselte Felder wie Referenz- oder Auswahlfelder zu übergeben, anstatt sys_ids oder Werte zu übergeben. Datentyp: Zeichenfolge | | type | aufgeführt ist. Wenn auch chg_model ausgefüllt ist, wird dieses Feld nur zur Change-Kategorisierung verwendet. Wird im folgenden Format bereitgestellt: `type=Normal`. Weitere Informationen finden [Sie unter Neuen Change-Anforderungstyp hinzufügen](https://www.servicenow.com/docs/access?context=t_AddNewChangeType&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Hinweis: Wenn Sie weder das Change-Modell (chg_model) noch den Wert type angeben, ergibt sich eine Standardeinstellung, die bis zum Release geändert werden kann. Es wird dringend empfohlen, mindestens einen dieser Werte festzulegen. Datentyp: Zeichenfolge | [Tabelle : 200. Abfrageparameter] {#change-POST-change-sys_id__entry__16} | Name | Beschreibung | |-|-| | Objekt | Name-Wert-Paare, die für die Felder stehen, die im zugeordneten Change Request aktualisiert werden sollen. Um zum Beispiel die Datei „Kurzbeschreibung" zu aktualisieren, geben Sie ein Name-Wert-Paar ein, das ähnlich ist wie das Folgende: `--data "{\"short_description\": \"my short desc\" }" \`. Dieselben Eigenschaften können stattdessen als Abfrageparameter festgelegt werden. Datentyp: Zeichenfolge | | Object.chg_model | Name eines Change-Modells, das in der Tabelle „Change-Modell" \[chg_model\] aufgeführt ist. Wird als Name-Wert-Paar im folgenden Format bereitgestellt: `{"chg_model" : "Cloud Infrastructure"}` Weitere Informationen finden Sie unter [Change-Modelle](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Hinweis: Wenn Sie weder das Change-Modell (chg_model) noch den Wert type angeben, ergibt sich eine Standardeinstellung, die bis zum Release geändert werden kann. Es wird dringend empfohlen, mindestens einen dieser Werte festzulegen. Datentyp: Zeichenfolge | | Object.encrypted_fields | Liste der durch Kommas getrennten Felder, die verschlüsselt werden sollen. Diese Felder werden verschlüsselt, bevor sie im zugehörigen Datensatz gespeichert werden. Wenn angegeben, ruft der Endpunkt die GlideRecord-Methode „ setDisplayValue() " anstelle der Methode „setValue() " auf. Aus diesem Grund können Sie diesen Parameter auch verwenden, um Anzeigewerte für unverschlüsselte Felder wie Referenz- oder Auswahlfelder zu übergeben, anstatt sys_ids oder Werte zu übergeben. Datentyp: Zeichenfolge | | Objekt.Typ | aufgeführt ist. Wenn auch chg_model ausgefüllt ist, wird dieses Feld nur zur Change-Kategorisierung verwendet. Wird als Name-Wert-Paar im folgenden Format bereitgestellt: `{"type" : "emergency"}` Weitere Informationen finden [Sie unter Neuen Change-Anforderungstyp hinzufügen](https://www.servicenow.com/docs/access?context=t_AddNewChangeType&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Hinweis: Wenn Sie weder das Change-Modell (chg_model) noch den Wert type angeben, ergibt sich eine Standardeinstellung, die bis zum Release geändert werden kann. Es wird dringend empfohlen, mindestens einen dieser Werte festzulegen. Datentyp: Zeichenfolge | [Tabelle : 201. Parameter des Anforderungstexts (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."). {#change-POST-change-sys_id__entry__26}{#change-POST-change-sys_id__accept-RESTAPI}{#change-POST-change-sys_id__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 : 202. Anforderungskopfzeilen] {#change-POST-change-sys_id__entry__32} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 203. 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. {#change-POST-change-sys_id__entry__36}{#change-POST-change-sys_id__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 204. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-change-sys_id__entry__48} | Name | Beschreibung | |-|-| | Ergebnis | Neuer Change-Anforderungs-Datensatz. Die Elemente dieses Objekts entsprechen dem Datensatzformat in der Tabelle „Change-Anforderung" \[change_request\]. Alle Werte, die nicht in der Anforderung angegeben sind, werden auf ihre Standardwerte festgelegt oder sind leer/null. Datentyp: Objekt | [ ] ### cURL-Anforderung Das folgende Beispiel zeigt, wie ein Datensatz für eine Change-Anforderung auf Grundlage des Standard-Change-Modells und des Standardtyps erstellt wird. In diesem Beispiel wird die Change-Anforderung vom Modell gesteuert, und das Typfeld wird nur zur Kategorisierung verwendet. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"chg_model\" : \"Standard\", \"description\" : \"Describes the change request.\", \"short_description\" : \"My change request\", \"type\" : \"Standard\" }" \ --user "username":"password" Die Ergebnisse zeigen, dass der Datensatz erfolgreich der Tabelle „Change-Anforderung" \[change_request\] mit dem Wert CHG0030022 hinzugefügt wurde. { "result": "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2022-12-08 17:18:57", "value": "2022-12-09 01:18:57", "display_value_internal": "2022-12-08 17:18:57" }, "type": { "display_value": "Standard", "value": "standard" } "number": { "display_value": "CHG0030022", "value": "CHG0030022" }, "is_bulk": { "display_value": "false", "value": false } "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "New", "value": -5 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "phase": { "display_value": "Requested", "value": "requested" } "impact": { "display_value": "3 - Low", "value": 3 }, "active": { "display_value": "true", "value": true }, "priority": { "display_value": "4 - Low", "value": 4 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "production_system": { "display_value": "false", "value": false }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" } "short_description": { "display_value": "My change request", "value": "My change request" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "reassignment_count": { "display_value": "0", "value": 0 }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "escalation": { "display_value": "Normal", "value": 0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0030022", "value": "CHG0030022" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "sys_created_on": { "display_value": "2022-12-08 17:18:57", "value": "2022-12-09 01:18:57", "display_value_internal": "2022-12-08 17:18:57" }, "sys_domain": { "display_value": "global", "value": "global" }, "chg_model": { "display_value": "Standard", "value": "e55d0bfec343101035ae3f52c1d3ae49" }, "opened_at": { "display_value": "2022-12-08 17:18:57", "value": "2022-12-09 01:18:57", "display_value_internal": "2022-12-08 17:18:57" }, "description": { "display_value": "Describes the change request.", "value": "Describes the change request." }, "sys_id": { "display_value": "2ac52dd77c6b1510f877be3b096e64fe", "value": "2ac52dd77c6b1510f877be3b096e64fe" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3 }, "scope": { "display_value": "Medium", "value": 3 }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "approval": { "display_value": "Not Yet Requested", "value": "not requested" }, } } ### cURL-Anforderung {#change-POST-change-sys_id__example_t5g_p5c_5xb} Das folgende Beispiel zeigt, wie verschlüsselte Felder im Anforderungstext übergeben werden. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"encrypted_fields\":\"short_description,description\", \"short_description\":\"my short desc\", \"description\":\"my desc\" }" \ --user "username":"password" ### cURL-Anforderung {#change-POST-change-sys_id__example_a4f_z5c_5xb} Das folgende Beispiel zeigt, wie verschlüsselte Felder als Abfrageparameter übergeben werden. curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{}" \ --user "username":"password" ## Change Management -- POST /sn_chg_rest/change/{sys_id}/ci {#ariaid-title36} Erstellt die Zuordnung zwischen einer Change-Anforderung und Configuration Management Database (CMDB) Configuration Items (CI). Die Erstellung der Zuordnung erfolgt asynchron. Dies bedeutet, dass sofort eine Antwort bereitgestellt wird und Details für den Mitarbeiter enthalten sind. Der Mitarbeiter führt die eigentliche Arbeit nach der Antwort aus. ### URL-Format {#change-POST-ci__section_gjg_rxn_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/ci Standard-URL: /api/sn_chg_rest/change/{sys_id}/ci ### Unterstützte Anforderungsparameter {#change-POST-ci__entry__2}{#change-POST-ci__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung, die dem CMDB-CI zugeordnet werden soll. Datentyp: Zeichenfolge | [Tabelle : 205. Pfadparameter] {#change-POST-ci__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 206. Abfrageparameter] {#change-POST-ci__entry__12} | Name | Beschreibung | |-|-| | „association_type" | Erforderlich. Typ der Zuordnung zwischen dem CMDB-CI und der Change-Anforderung. Gültige Werte: * Betroffene: CIs, die von der Change-Anforderung betroffen sind * impacted: Services, die von der Change-Anforderung betroffen sind * Jobangebot: Betroffene Serviceangebote {#change-POST-ci__ul_bp5_2sm_dhb} Datentyp: Zeichenfolge | | cmdb_ci_sys_ids | Erforderlich. Liste der CMDB-CI-sys_ids, die der Change-Anforderung zugeordnet werden sollen. Datentyp: Array oder durch Kommas getrennte Zeichenfolge | | refresh_impacted_services | Kennzeichnung, die verwendet wird, wenn „ `association_type=affected` " ist, um betroffene Services basierend auf der Liste der betroffenen CIs auszufüllen. Gültige Werte: * „wahr": Betroffene Services basierend auf der Liste der betroffenen CIs ausfüllen * „falsch": Betroffene Services nicht automatisch ausfüllen {#change-POST-ci__ul_uxb_xvm_dhb} Datentyp: Boolesch Standardwert: false | [Tabelle : 207. 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."). {#change-POST-ci__entry__20}{#change-POST-ci__accept-RESTAPI}{#change-POST-ci__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 : 208. Anforderungskopfzeilen] {#change-POST-ci__entry__26} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 209. 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. {#change-POST-ci__entry__30}{#change-POST-ci__entry-401-status-code}{#change-POST-ci__entry-404-status-code}{#change-POST-ci__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 202 | Akzeptiert. Die Anforderung wurde zur Verarbeitung akzeptiert. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. Die Fehlerantwort enthält relevante Nachrichten, die bei der Behebung des Problems helfen. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 210. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-ci__entry__42} | Name | Beschreibung | |-|-| | Nachrichten | Nachrichteninformationen. Datentyp: Objekt "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | nachrichten.fehlermeldungen | Bei der Verarbeitung der Anforderung sind Fehlermeldungen aufgetreten. Beispiel: ``` Ungültige CMDB_CI-sys_id angegeben ``` Datentyp: Array | | nachrichten.infoNachrichten | Informationsnachrichten, die bei der Verarbeitung der Anforderung aufgetreten sind. Beispiel: ``` CMDB_CI-sys_id ist bereits angegebener zugeordnet. ``` Datentyp: Array | | nachrichten.warnmeldungen | Bei der Verarbeitung der Anforderung sind Warnmeldungen aufgetreten. Beispiel: ``` Ungültige CMDB_CI-sys_id angegeben. ``` Datentyp: Array | | Anforderung | Ursprüngliche Endpunktanforderung. Datentyp: Zeichenfolge | | Staat | Informationen zum aktuellen Status des Mitarbeiters. state: { display_value: "String", value: "String" } | | state.display_value | Anzeigewert des Status des Mitarbeiters. Diese Werte beziehen sich direkt auf das Element state.value. Mögliche Werte: * Abgeschlossen * Fehler * In Bearbeitung * Warten {#change-POST-ci__ul_ehh_nxy_jhb} Datentyp: Zeichenfolge | | Status.Wert | Numerischer Wert des Status des Mitarbeiters. Mögliche Werte: * 1 * 2 * 3 * 4 {#change-POST-ci__ul_zw1_fxy_jhb} Datentyp: Zahl | | type | Typ der Zuordnung zwischen dem CMDB-CI und der Change-Anforderung. Datentyp: Zeichenfolge | | Mitarbeiter | Informationen zum zugeordneten Mitarbeiter. Datentyp: Objekt "worker": { "link": "String", "sysId": "String" } | | worker.link | URL zum Abrufen des Status des zugeordneten Mitarbeiters und anderer relevanter Mitarbeiterinformationen. Datentyp: Zeichenfolge | | worker.sysId | Sys_id des Workers, der dem Change Request zugeordnet ist. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{cmdb_ci_sys_ids:'caf043a3b7fb23000999e4f6ee11a9c0,06f043a3b7fb23000999e4f6ee11a9c1', association_type:'affected'}" \ --user "username":"password" { "result": { "worker": { "sysId": "f490f4c6dbac330084f07ffdbf961952", "link": "instance.service-now.com/api/sn_chg_rest/change/worker/f490f4c6dbac330084f07ffdbf961952" }, "request": "{\"cmdb_ci_sys_ids\":[\"caf043a3b7fb23000999e4f6ee11a9c0\",\"06f043a3b7fb23000999e4f6ee11a9c1\"],\"association_type\":\"affected\",\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "affected", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change-Management -- POST /sn_chg_rest/change/{sys_id}/conflict {#ariaid-title37} Startet einen Change Request-Konflikt-Überprüfungsprozess für den angegebene Change Request (sys_id). ### URL-Format {#change-POST-conflict__section_m3g_gkn_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/conflict Standard-URL: /api/sn_chg_rest/change/{sys_id}/conflict ### Unterstützte Anforderungsparameter {#change-POST-conflict__entry__2}{#change-POST-conflict__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Management-Anforderung, für die der Konfliktüberprüfungsprozess gestartet werden soll. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Weitere Informationen zum Konfliktüberprüfungsprozess finden Sie unter [Konflikterkennung](https://www.servicenow.com/docs/access?context=c_ConflictDetection&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Datentyp: Zeichenfolge | [Tabelle : 211. Pfadparameter] {#change-POST-conflict__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 212. Abfrageparameter] {#change-POST-conflict__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 213. 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."). {#change-POST-conflict__entry__16}{#change-POST-conflict__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 214. Anforderungskopfzeilen] {#change-POST-conflict__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 215. 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. {#change-POST-conflict__entry__24}{#change-POST-conflict__entry-200-status-code}{#change-POST-conflict__entry-401-status-code}{#change-POST-conflict__entry-404-status-code}{#change-POST-conflict__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 400 | Fehlerhafte Anforderung. Die Anforderung konnte aufgrund nicht behebbarer Fehler nicht gestartet werden. Die zurückgegebene Nachricht enthält möglicherweise weitere Details. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 216. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-conflict__entry__36} | Name | Beschreibung | |-|-| | Ergebnis | Sys_id des Prozesses zur Konfliktüberprüfung von Change-Anforderungen. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: "c0b5afe4b710230096c3e4f6ee11a93f" } ## Change-Management -- POST /sn_chg_rest/change/emergency {#ariaid-title38} Erstellt einen Notfall-Change Request basierend auf dem standardmäßigen Notfall-Change Request-Datensatz. Mehrere Notfall-Change Request-Erstellungen innerhalb eines einzelnen Anrufs werden nicht unterstützt. ### URL-Format {#change-POST-emergency__section_evv_brs_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/emergency Standard-URL: /api/sn_chg_rest/change/emergency ### Unterstützte Anforderungsparameter {#change-POST-emergency__entry__2}{#change-POST-emergency__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 217. Pfadparameter] {#change-POST-emergency__entry__6} | Name | Beschreibung | |-|-| | Schlüssel-Wert-Paare | Schlüssel-Wert-Paare von Feldern, die beim Erstellen der Anforderung geändert werden sollen. Der Schlüssel ist der Feldname in der Vorlage und der Wert die Informationen, die in das Feld eingefügt werden sollen. Felder, die nicht geändert werden können und bei der Übergabe ignoriert werden: * Business-Regeln * Schreibgeschützte Felder wie in ACLs definiert * Felder, die nicht vorhanden sind {#change-POST-emergency__ul_zz1_qdz_tkb} Datentyp: Zeichenfolge | [Tabelle : 218. Abfrageparameter] {#change-POST-emergency__entry__10} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 219. 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."). {#change-POST-emergency__entry__14}{#change-POST-emergency__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 220. Anforderungskopfzeilen] {#change-POST-emergency__entry__18} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 221. 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. {#change-POST-emergency__entry__22}{#change-POST-emergency__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 222. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-emergency__entry__32} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare der Felder, die in der Notfall-Change-Anforderung erstellt wurden. Datentyp: Objekt | | Staat | Status des Change Requests vor dem Löschen. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Neu". Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Wert ist immer „-5". Datentyp: Zeichenfolge | | sys_id | Sys_id der neu erstellten Notfall-Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „Notfall". Datentyp: Zeichenfolge | | __meta.ignoredFields | Schlüssel-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change Request angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden oder die Felder schreibgeschützt sind. Datentyp: Array | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?no_such_field=something&description=test&short_description=Reboot server" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management -- POST /sn_chg_rest/change/normal {#ariaid-title39} Erstellt einen normalen Change Request basierend auf dem standardmäßigen normalen Change Request-Datensatz. Mehrere normale Change Request-Erstellungen innerhalb eines einzelnen Anrufs werden nicht unterstützt. ### URL-Format {#change-POST-normal__section_kgy_w3r_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/normal Standard-URL: /api/sn_chg_rest/change/normal ### Unterstützte Anforderungsparameter {#change-POST-normal__entry__2}{#change-POST-normal__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | [Tabelle : 223. Pfadparameter] {#change-POST-normal__entry__6} | Name | Beschreibung | |-|-| | Schlüssel-Wert-Paare | Felder, die beim Erstellen des Requests zu modifizieren sind. Der Schlüssel ist der Feldname in der Vorlage und der Wert die Informationen, die in das Feld eingefügt werden sollen. Felder, die nicht geändert werden können und bei der Übergabe ignoriert werden: * Business-Regeln * Schreibgeschützte Felder wie in ACLs definiert * Felder, die nicht vorhanden sind {#change-POST-normal__ul_sj1_fyy_tkb} Datentyp: Zeichenfolge | [Tabelle : 224. Abfrageparameter] {#change-POST-normal__entry__10} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 225. 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."). {#change-POST-normal__entry__14}{#change-POST-normal__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 226. Anforderungskopfzeilen] {#change-POST-normal__entry__18} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 227. 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. {#change-POST-normal__entry__22}{#change-POST-normal__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 228. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-normal__entry__32} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Werte für alle Felder im zugehörigen Change Request. Datentyp: Objekt | | Staat | Status des neu erstellten Change Requests. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Status, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Neu". Datentyp: Zeichenfolge | | Status.Wert | Interner Statuswert. Wert ist immer „-5". Datentyp: Zeichenfolge | | sys_id | Sys_id der neu erstellten normalen Change-Anforderung. Datentyp: Zeichenfolge | | type | Typ der Change-Anforderung. Datentyp: Objekt type: { display_value: "String", value: "String" } | | type.display_value | Ändern Sie den Typ, der in einer Anwenderoberfläche angezeigt werden soll. Wert ist immer „Normal". Datentyp: Zeichenfolge | | type.value | Interner Typwert. Wert ist immer „normal". Datentyp: Zeichenfolge | | __meta.ignoredFields | Schlüssel-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change Request angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden oder die Felder schreibgeschützt sind. Datentyp: Array | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?no_such_field=something&description=test&short_description=Remove server" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management -- POST /sn_chg_rest/change/{sys_id}/refresh_impacted_services {#ariaid-title40} Füllt die zugehörige Liste der betroffenen Services/Configuration Items (CIs) basierend auf dem primären CI aus. Das primäre CI wird im Formular „Change-Anforderung" und in der zugehörigen Liste der betroffenen CIs angezeigt. Hinweis: Alle Arbeitselemente für diesen Endpunkt werden asynchron ausgeführt. ### URL-Format {#change-POST-refresh_impact_srvcs__section_sh4_2r4_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{sys_id}/refresh_impacted_services Standard-URL: /api/sn_chg_rest/change/{sys_id}/refresh_impacted_services ### Unterstützte Anforderungsparameter {#change-POST-refresh_impact_srvcs__entry__2}{#change-POST-refresh_impact_srvcs__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | sys_id | Sys_id der Change-Anforderung, die zum Aktualisieren der betroffenen Services verwendet werden soll. Datentyp: Zeichenfolge | [Tabelle : 229. Pfadparameter] {#change-POST-refresh_impact_srvcs__entry__8} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 230. Abfrageparameter] {#change-POST-refresh_impact_srvcs__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 231. 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."). {#change-POST-refresh_impact_srvcs__entry__16}{#change-POST-refresh_impact_srvcs__accept-RESTAPI}{#change-POST-refresh_impact_srvcs__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 : 232. Anforderungskopfzeilen] {#change-POST-refresh_impact_srvcs__entry__22} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 233. 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. {#change-POST-refresh_impact_srvcs__entry__26}{#change-POST-refresh_impact_srvcs__entry-200-status-code}{#change-POST-refresh_impact_srvcs__entry-401-status-code}{#change-POST-refresh_impact_srvcs__entry-500-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. | [Tabelle : 234. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-refresh_impact_srvcs__entry__36} | Name | Beschreibung | |-|-| | Nachrichten | Nachrichteninformationen. Datentyp: Objekt "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | nachrichten.fehlermeldungen | Bei der Verarbeitung der Anforderung sind Fehlermeldungen aufgetreten. Beispiel: ``` Ungültige CMDB_CI-sys_id angegeben ``` Datentyp: Array | | nachrichten.infoNachrichten | Informationsnachrichten, die bei der Verarbeitung der Anforderung aufgetreten sind. Beispiel: ``` CMDB_CI-sys_id ist bereits angegebener zugeordnet. ``` Datentyp: Array | | nachrichten.warnmeldungen | Bei der Verarbeitung der Anforderung sind Warnmeldungen aufgetreten. Beispiel: ``` Ungültige CMDB_CI-sys_id angegeben. ``` Datentyp: Array | | Anforderung | Ursprüngliche Endpunktanforderung. Datentyp: Zeichenfolge | | Staat | Informationen zum aktuellen Status des Mitarbeiters. Datentyp: Objekt state: { display_value: "String", value: "String" } | | state.display_value | Anzeigewert des Status des Mitarbeiters. Diese Werte beziehen sich direkt auf das Element state.value. Mögliche Werte: * Abgeschlossen * Fehler * In Bearbeitung * Warten {#change-POST-refresh_impact_srvcs__ul_ehh_nxy_jhb} Datentyp: Zeichenfolge | | Status.Wert | Numerischer Wert des Status des Mitarbeiters. Mögliche Werte: * 1 * 2 * 3 * 4 {#change-POST-refresh_impact_srvcs__ul_zw1_fxy_jhb} Datentyp: Zahl | | type | Typ der Zuordnung zwischen dem CMDB-CI und der Change-Anforderung. Datentyp: Zeichenfolge | | Mitarbeiter | Informationen zum zugeordneten Mitarbeiter. Datentyp: Objekt "worker": { "link": "String", "sysId": "String" } | | worker.link | URL zum Abrufen des Status des zugeordneten Mitarbeiters und anderer relevanter Mitarbeiterinformationen. Datentyp: Zeichenfolge | | worker.sysId | Sys_id des Workers, der dem Change Request zugeordnet ist. Datentyp: Zeichenfolge | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/refresh_impacted_services" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user "username":"password" { result: { worker: { sysId: "aa31c308b75033000999e4f6ee11a9c2", link: "http://instance.service-now.com/api/sn_chg_rest/change/worker/aa31c308b75033000999e4f6ee11a9c2" }, request: "", state: { value: 1, display_value: "Waiting" }, type: "impacted", messages: { errorMessages: [], warningMessages: [], infoMessages: [] } } } ## Change Management -- POST /sn_chg_rest/change/standard/{standard_change_template_id} {#ariaid-title41} Erstellt einen Standard-Change Request basierend auf einer vorhandenen Standard-Change-Vorlage, wie von der übergebenen Vorlagen-sys_id angegeben. Mehrere Standard-Change Request-Erstellungen innerhalb eines einzelnen Aufrufs werden nicht unterstützt. ### URL-Format {#change-POST-standard__section_bqr_fk2_xlb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/standard/{standard_change_template_id} Standard-URL: /api/sn_chg_rest/change/standard/{standard_change_template_id} ### Unterstützte Anforderungsparameter {#change-POST-standard__section_n5l_xk2_xlb} {#change-POST-standard__table_o5l_xk2_xlb__entry__2}{#change-POST-standard__version-RESTAPI} | Parameter | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | standard_change_template_id | Sys_id der Standard-Change-Vorlage, auf der die neue Standard-Change-Vorlage basieren soll. Befindet sich in der Tabelle „Standard-Change-Vorlagen" \[std_change_record_producer\]. Datentyp: Zeichenfolge | [Tabelle : 235. Pfad-Parameter] {#change-POST-standard__table_o5l_xk2_xlb} {#change-POST-standard__table_i2g_hl2_xlb__entry__2} | Parameter | Beschreibung | |-|-| | Name-Wert-Paare | Felder innerhalb der angegebenen Standard-Change-Vorlage, die beim Erstellen des Requests geändert werden sollen. Der Schlüssel ist der Feldname in der Vorlage und der Wert die Informationen, die in das Feld eingefügt werden sollen. Felder, die nicht geändert werden können und bei der Übergabe ignoriert werden: * Beschreibung * Rückfallplan * Testplan * Implementierungsplan * Schreibgeschützte Felder wie in ACLs definiert * Felder, die in der angegebenen Standard-Change-Vorlage nicht vorhanden sind {#change-POST-standard__ul_j2g_hl2_xlb} Datentyp: Zeichenfolge | [Tabelle : 236. Abfrageparameter] {#change-POST-standard__table_i2g_hl2_xlb} {#change-POST-standard__table_g3k_dkf_mmb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 237. Anforderungstextparameter (XML oder JSON)] {#change-POST-standard__table_g3k_dkf_mmb} ### 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."). {#change-POST-standard__table_ajc_wm2_xlb__entry__2}{#change-POST-standard__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 238. Anforderungskopfzeilen] {#change-POST-standard__table_ajc_wm2_xlb} {#change-POST-standard__table_m25_xm2_xlb__entry__2} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 239. Antwortkopfzeilen] {#change-POST-standard__table_m25_xm2_xlb} ### Statuscodes {#change-POST-standard__section_tm2_w4j_xlb} 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."). {#change-POST-standard__table_wwn_rhd_ct__entry__2}{#change-POST-standard__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 240. Statuscodes] {#change-POST-standard__table_wwn_rhd_ct} ### Antwort-Haupttext {#change-POST-standard__section_ikl_bn2_xlb} Die API gibt diese JSON- oder XML-Elemente im Antwort-Haupttext zurück. {#change-POST-standard__table_mc1_pr1_tx__entry__2} | Elemente | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare der Felder, die in der Standard-Change-Anforderung erstellt wurden. Datentyp: Objekt | | sys_id | Sys_id-Informationen der neu erstellten Standard-Change-Anforderung. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Standard-Change-Anforderung zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Standard-Change-Anforderung. Datentyp: Zeichenfolge | | __meta.ignoredFields | Schlüssel-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change Request angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden oder die Felder schreibgeschützt sind. Datentyp: Array | [Tabelle : 241. Im Antwort-Haupttext zurückgegebene Elemente] {#change-POST-standard__table_mc1_pr1_tx} ### Beispiel für eine cURL-Anforderung curl "https://instance.servicenow.com" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management -- POST /sn_chg_rest/change/{change_sys_id}/task {#ariaid-title42} Erstellt eine Change Request-Aufgabe basierend auf der Standard-Change Request-Aufgabe und ordnet diese dem angegebenen Change Request zu. Mehrere Change Request-Aufgaben-Erstellungen innerhalb eines einzelnen Anrufs werden nicht unterstützt. ### URL-Format {#change-POST-task__section_elk_15m_ylb} URL mit Versionsnummer: /api/sn_chg_rest/{api_version}/change/{change_sys_id}/task Standard-URL: /api/sn_chg_rest/change/{change_sys_id}/task ### Unterstützte Anforderungsparameter {#change-POST-task__entry__2}{#change-POST-task__version-RESTAPI} | Name | Beschreibung | |-|-| | api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge | | change_sys_id | Sys_id der Change-Anforderung, der diese Aufgabe zugeordnet werden soll. Befindet sich in der Tabelle „Change-Anforderung" \[change_request\]. Datentyp: Zeichenfolge | [Tabelle : 242. Pfadparameter] {#change-POST-task__entry__8} | Name | Beschreibung | |-|-| | Schlüssel-Wert-Paare | Felder, die beim Erstellen des Requests zu modifizieren sind. Der Schlüssel ist der Feldname in der Vorlage und der Wert die Informationen, die in das Feld eingefügt werden sollen. Felder, die nicht geändert werden können und bei der Übergabe ignoriert werden: * Business-Regeln * Schreibgeschützte Felder wie in ACLs definiert * Felder, die nicht vorhanden sind {#change-POST-task__ul_d5q_zyy_tkb} Datentyp: Zeichenfolge | [Tabelle : 243. Abfrageparameter] {#change-POST-task__entry__12} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 244. 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."). {#change-POST-task__entry__16}{#change-POST-task__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 245. Anforderungskopfzeilen] {#change-POST-task__entry__20} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 246. 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. {#change-POST-task__entry__24}{#change-POST-task__entry-401-status-code} | Statuscode | Beschreibung | |-|-| | 200 | Anforderung erfolgreich abgeschlossen. | | 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. | | 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. | | 404 | Nicht gefunden. Der angegebene Datensatz wurde nicht gefunden. | | 500 | Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten. | [Tabelle : 247. Statuscodes] ### Parameter des Antworttexts (JSON oder XML) {#change-POST-task__entry__36} | Name | Beschreibung | |-|-| | Name-Wert-Paare | Name-Wert-Paare der Felder, die in der Change-Anforderungsaufgabe erstellt wurden. Datentyp: Objekt | | übergeordnet | Informationen für den Change Request, der der Aufgabe zugeordnet ist. Datentyp: Objekt parent: { display_value: "String", value: "String" } | | parent.display_value | Informationen, die in der Anwenderoberfläche für die Change-Anforderung angezeigt werden sollen, die der Aufgabe zugeordnet ist. Datentyp: Zeichenfolge | | parent.value | Sys_id der Change-Anforderung, die der Aufgabe zugeordnet ist. Datentyp: Zeichenfolge | | sys_id | Sys_id-Informationen der neu erstellten Change-Anforderungsaufgabe. Datentyp: Objekt sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | Sys_id der Change-Anforderungsaufgabe zur Anzeige in einer Anwenderoberfläche. Datentyp: Zeichenfolge | | sys_id.wert | Sys_id der Change-Anforderungsaufgabe. Datentyp: Zeichenfolge | | __meta.ignoredFields | Schlüssel-Wert-Paare, die im Aufruf übergeben wurden, aber nicht auf die Change Request angewendet wurden, da sie entweder nicht im Basisdatensatz vorhanden oder die Felder schreibgeschützt sind. Datentyp: Array | [ ] ### cURL-Anforderung curl "https://instance.servicenow.com/api/now/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?short_description=Retire node&no_such_field=test" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire node", display_value: "Retire node" } __meta.ignoredFields": ["no_such_field"] } ] }