CdmSharedLibraryApi

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 25 Minuten Lesedauer

    • Die CdmSharedLibraryApi Stellt Endpunkte bereit, mit denen Sie gemeinsam genutzte Bibliotheken und gemeinsam genutzte Komponenten erstellen und verwalten können. Es verfügt auch über Endpunkte, mit denen Sie die Konfigurationsdaten einer gemeinsam genutzten Komponente hochladen und exportieren können.

    Diese API erfordert Konfigurationsdaten-Management(CDM)-Plugin, das aktiviert werden soll, damit diese APIs in der Instanz verfügbar sind. Darüber hinaus müssen Sie über eine der folgenden Rollen verfügen, um auf diese API zuzugreifen:
    • CDM-Editor-Rolle
    • CDM-Administratorrolle

    Weitere Informationen zu gemeinsam genutzten Bibliotheken und gemeinsam genutzten Komponenten finden Sie unter Komponenten für Anwendungen freigeben – Komponentenbibliotheken .

    CdmSharedLibraryApi: LÖSCHEN SIE /sn_cdm/Shared_Libraries

    Löscht die gemeinsame Bibliothek mit dem angegebenen Namen.

    Für den Zugriff auf diesen Endpunkt ist die CDM-Administratorrolle erforderlich.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries

    Standard-URL: /api/sn_cdm/Shared_Libraries

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    name Erforderlich. Name der zu löschenden gemeinsamen Bibliothek.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Anwendung [sn_cdm_Application]

    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 .

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie die gemeinsame Bibliothek „Javalib“ gelöscht wird.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries?name='javalib'\ 
--request DELETE\ 
--header "Accept:application/json" \ 
--user 'username':'password'

    Antwort:

    ""

    CdmSharedLibraryApi: LÖSCHEN SIE /sn_cdm/Shared_Libraries/components

    Löscht die angegebene gemeinsam genutzte Komponente aus der angegebenen Bibliothek.

    Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor“ erforderlich.

    Hinweis:
    Sie können eine Komponente nur löschen, wenn sie derzeit nicht verwendet wird. Außerdem können Sie eine Komponente nicht löschen, wenn die zugehörige gemeinsame Bibliothek nicht aktiv ist.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/components

    Standard-URL: /api/sn_cdm/Shared_Libraries/components

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    changesetNumber Erforderlich. Nummer des Changesets, das der Komponente zugeordnet ist.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Änderungssatz [sn_cdm_changeset]
    name Erforderlich. Name der gemeinsam genutzten Komponente, die gelöscht werden soll.

    Datentyp: Zeichenfolge

    Tabelle: Gemeinsam genutzte CDM-Komponente [sn_cdm_Shared_component]
    sharedLibraryName Erforderlich. Name der gemeinsamen Bibliothek, in der sich die zu löschende Komponente befindet.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    Tabelle : 9. Anforderungstextparameter
    Name Beschreibung
    Keine

    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 .

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Ungültige Anforderung.
    Mögliche Probleme:
    • Gemeinsame Bibliothek ist nicht vorhanden.
    • Gemeinsame Bibliothek ist nicht aktiv.
    • Gemeinsam genutzte Komponente wird verwendet. Kann nicht gelöscht werden.
    • Der Anwender darf die gemeinsam genutzte Komponente nicht löschen.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie die Komponente „TestComponent“ in der gemeinsamen Bibliothek „Javalib“ gelöscht wird.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components?sharedLibraryName='javalib&changesetNumber='chset-8'&name='TestComponent'\ 
--request DELETE\ 
--header "Accept:application/json" \ 
--user 'username':'password'

    Antwort:

    ""

    CdmSharedLibraryApi – GET /sn_cdm/Shared_Libraries/Upload-Status/{Upload-ID}

    Gibt den aktuellen Status der angegebenen Anforderung zum Hochladen der gemeinsamen Bibliothek zurück.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/Upload-Status/{Upload-ID}

    Standard-URL: /api/sn_cdm/Shared_Libraries/Upload-Status/{Upload-ID}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Upload-ID SYS_ID der Upload-Anforderung, deren Status zurückgegeben werden soll. Dieser Wert wird von verschiedenen Endpunkten der CdmSharedLibrary-Upload-Anforderung zurückgegeben.

    Datentyp: Zeichenfolge
    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 15. Anforderungstextparameter
    Name Beschreibung
    Keine

    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 .

    Tabelle : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 17. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 18. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Fehler Beschreibung der Fehler, die während des Uploads aufgetreten sind.

    Datentyp: Zeichenfolge
    Ausgabe Beschreibung der hochgeladenen Daten oder, wenn während des Uploads ein Fehler aufgetreten ist, eine Fehlermeldung, die den aufgetretenen Fehler beschreibt.

    Datentyp: Array von Zeichenfolge

    "output": {
  "auto_validate": "String",
  "cdm_application": "String",
  "committed_at": "String",
  "committed_by": "String",
  "description": "String",
  "last_conflict_detection_time": "String",
  "number": "String",
  "publish_option": "String",
  "sharedLibraryName": "String",
  "snapshot_description": "String",
  "snapshot_name": "String",
  "state": "String",
  "sys_created_by": "String",
  "sys_id": "String",
  "title": "String"
}
    output.auto_validate Gibt an, ob die Validierung nach dem Commit aufgerufen werden soll.

    Datentyp: Zeichenfolge
    Output.cdm_Application Name der Anwendung, unter der der Upload durchgeführt wurde.

    Datentyp: Zeichenfolge
    output.committed_at Datum und Uhrzeit, zu der der hochgeladene Inhalt bestätigt wurde.

    Datentyp: Zeichenfolge
    output.committed_by SYS_ID des Datensatzes der Entität, die den Commit ausgeführt hat.

    Datentyp: Zeichenfolge
    output.description Derzeit nicht verwendet.

    Datentyp: Zeichenfolge
    Output.Last_conflict_Detection_time Aufruf der Konflikterkennung für Datum und Uhrzeit.

    Datentyp: Zeichenfolge
    Ausgabe.Nummer Eindeutiger Changeset-Identifizierungswert, z. B. Chset-124.

    Datentyp: Zeichenfolge
    Ausgabe.Publish_Option Wert der Veröffentlichungsoption, die im zugehörigen Upload-Aufruf übergeben wurde.

    Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Veröffentlichen Sie einen Snapshot, oder heben Sie die Veröffentlichung auf .

    Datentyp: Zeichenfolge
    Ausgabe.SharedLibraryName Name der gemeinsamen Bibliothek, wie im ursprünglichen Upload-Aufruf übergeben.

    Datentyp: Zeichenfolge
    Ausgabe.Snapshot_description Beschreibung des zugehörigen Snapshots.

    Datentyp: Zeichenfolge
    Ausgabe.Snapshot_Name Name des zugeordneten Snapshots.

    Datentyp: Zeichenfolge
    Ausgabe.Status Status des Uploads.
    Mögliche Werte:
    • ABGESCHLOSSEN: Upload wurde abgeschlossen.
    • EXPIREDERROR: Fehler beim Verarbeiten der Upload-Anforderung. Der Auftrag wurde mehr als 15 Minuten lang ausgeführt und vom System beendet.
    • IN_PROGRESS: Upload wird ausgeführt.
    • NEU: Verarbeitung wurde noch nicht gestartet.
    • BEREIT: Anforderung wurde in die Warteschlange gestellt.

    Datentyp: Zeichenfolge
    Ausgabe.sys_created_by SYS_ID der Entität, die den Datensatz erstellt hat.

    Datentyp: Zeichenfolge
    Ausgabe.sys_ID SYS_ID des Datensatzes, der das Changeset enthält.

    Datentyp: Zeichenfolge
    Ausgabe.Titel Titel des Changesets, das als Teil des Uploads erstellt wurde.

    Datentyp: Zeichenfolge
    Processing_State Aktueller Verarbeitungsstatus der Upload-Anforderung.

    Mögliche Werte: VERARBEITET

    Datentyp: Zeichenfolge
    Status Aktueller Status der Upload-Anforderung.
    Mögliche Werte:
    • abgeschlossen
    • Fehler
    type Typ der Upload-Anforderung.

    Mögliche Werte: Upload_and_commit

    Datentyp: Zeichenfolge
    Upload_ID SYS_ID des Datensatzes, der die hochgeladene Konfigurationsnutzlast enthält.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Dieses Codebeispiel zeigt, wie der Status für die Upload-ID 0d91d9891b2b19109524cae0604bcbe6 angefordert wird.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/upload-status/0d91d9891b2b19109524cae0604bcbe6" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Antwort:

    // Successful response
{
  "result": {
    "type": "upload_and_commit",
    "state": "completed",
    "output": {
      "sys_id": "0002ea107768a1109ac0cf0bbb5a9963",
      "number": "Chset-457",
      "title": "admin8802ea107768a1109ac0cf0bbb5a9962",
      "description": null,
      "committed_at": "",
      "committed_by": null,
      "sys_created_by": "admin",
      "state": "open",
      "publish_option": "publish_none",
      "auto_validate": false,
      "snapshot_name": null,
      "snapshot_description": null,
      "cdm_application": "OracleG-Library-15",
      "last_conflict_detection_time": null
    },
    "processing_state": "PROCESSED",
    "upload_id": "00b226547768a1109ac0cf0bbb5a99f2"
  }
}

// Error response
{
  "result": {
    "type": "upload_and_commit",
    "state": "error",
    "output": "Error: Application with sys_id 87fb1ecb1be3111050fc21b0604bcb95 is in State Deleted. No data can be modified on deleted applications",
    "processing_state": "PROCESSED",
    "upload_id": "fcdfaf7f1b88211050fc21b0604bcb79"
  }
}

    CdmSharedLibraryApi: POST /sn_cdm/Shared_Libraries

    Erstellt eine neue gemeinsame Bibliothek mit dem angegebenen Namen.

    Für den Zugriff auf diesen Endpunkt ist die CDM-Administratorrolle erforderlich.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries

    Standard-URL: /api/sn_cdm/Shared_Libraries

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 19. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 20. Abfrageparameter
    Name Beschreibung
    Beschreibung Beschreibung der gemeinsamen Bibliothek.

    Datentyp: Zeichenfolge

    Standard: Leer
    name Erforderlich. Name der zu erstellenden gemeinsamen Bibliothek. Dieser Name muss für alle CDM-Anwendungen und -Bibliotheken eindeutig sein.

    Datentyp: Zeichenfolge
    returnFields Kommagetrennte Liste von Feldern, die als Teil der Antwort zurückgegeben werden sollen.

    Datentyp: Zeichenfolge

    Standard: Alle nicht-Systemfelder werden zurückgegeben.

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    UserGroupIds Kommagetrennte Liste der sys_IDs der Anwendergruppen, die die zugehörige gemeinsame Bibliothek bearbeiten können. Alle Anwender mit den richtigen Rollen können die gemeinsame Bibliothek anzeigen.

    Datentyp: Zeichenfolge

    Standard: Alle Anwender mit der Rolle „CDM-Editor“ können Daten innerhalb der gemeinsamen Bibliothek bearbeiten.

    Tabelle: Gruppe [sys_user_group]
    Tabelle : 21. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Keine

    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 .

    Tabelle : 22. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 23. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 24. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    <fields> Angeforderte Felder.

    Datentyp: Variable

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie Sie diesen Endpunkt aufrufen, um die gemeinsam genutzte Bibliothek Java11Lib mit allen Anwendergruppen zu erstellen, die auf die Bibliothek zugreifen können.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries?name=Java11Lib&description=The%20new%20java%20library" \ 
--request POST \ 
--header "Accept:application/json" \ 
--user 'userName':'password

    Antwort:

    {
  "result": {
    "sdlc_component": null,
    "cdi_count": "0",
    "available": false,
    "description": "Description of LibraryA",
    "managed_by_group": null,
    "sys_updated_on": "2023-01-18 11:34:43",
    "type": "shared_library",
    "node": {
      "value": "d852b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node/d852b15877a4a1109ac0cf0bbb5a99aa"
    },
    "sys_id": "185235dc77a4a1109ac0cf0bbb5a994e",
    "sys_updated_by": "admin",
    "node_main": {
      "value": "1852b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node_main/1852b15877a4a1109ac0cf0bbb5a99aa"
    },
    "sys_created_on": "2023-01-18 11:34:43",
    "cdi_usage": "0",
    "name": "LibraryA",
    "last_committed_changeset": {
      "value": "9052b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/9052b15877a4a1109ac0cf0bbb5a99aa"
    },
    "state": "active",
    "sys_created_by": "admin"
  }
}

    CdmSharedLibraryApi – POST /sn_cdm/Shared_Libraries/components

    Erstellt die angegebene gemeinsam genutzte Komponente unter der angegebenen Bibliothek.

    Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor“ erforderlich.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/components

    Standard-URL: /api/sn_cdm/Shared_Libraries/components

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 25. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 26. Abfrageparameter
    Name Beschreibung
    changesetNumber Erforderlich.
    Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10“.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Änderungssatz [sn_cdm_changeset]
    Beschreibung Beschreibung der gemeinsam genutzten Komponente.

    Datentyp: Zeichenfolge
    name Erforderlich. Name der gemeinsam genutzten Komponente, die in der gemeinsamen Bibliothek erstellt werden soll. Dieser Name muss eindeutig sein.

    Datentyp: Zeichenfolge
    returnFields Kommagetrennte Liste von Feldern in der Tabelle „CDM-Knoten“ [sn_cdm_node], die als Teil der Antwort zurückgegeben werden sollen.

    Datentyp: Zeichenfolge

    Standard: Alle nicht internen Felder werden zurückgegeben.
    sharedLibraryName Erforderlich. Name der gemeinsamen Bibliothek, unter der die Komponente erstellt werden soll. Diese Bibliothek muss bereits vorhanden sein und sich im Status „aktiv“ befinden.

    Datentyp: Zeichenfolge
    Tabelle : 27. Anforderungstextparameter
    Name Beschreibung
    Keine

    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 .

    Tabelle : 28. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 29. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 30. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    <requested fields> Angeforderte Felder.

    Datentyp: Verschiedene

    Tabelle: CDM-Knoten [sn_cdm_node]
    Fehler Wird nur zurückgegeben, wenn während der Verarbeitung ein Fehler aufgetreten ist.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Details zum aufgetretenen Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Nachricht, die einen Überblick über den Fehler bietet.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Im folgenden Codebeispiel wird die Komponente mit dem Namen „SharedComponent“ in der gemeinsamen Bibliothek „Javalib“ gespeichert.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components/?sharedLibraryName=javalib&changeSetNumber='Chset-9'&name='SharedComponent'\  
--request POST\  
--header "Accept:application/json" \  
--user 'username':'password'

    Antwort:

    {
  "result": {
    "changeset_id": {
      "value": "ca7e6a501b202110636e0fe0604bcb71",
      "link": "https://instance.servicenow.com/api/now/table/sn_cdm_changeset/ca7e6a501b202110636e0fe0604bcb71"
    },
    "node_path": "!2!3!:",
    "description": null,
    "sys_updated_on": "2023-01-18 16:04:52",
    "type": "sn_cdm_node_shared_component",
    "sys_class_name": "sn_cdm_node",
    "sys_id": "6d2072901b602110636e0fe0604bcbec",
    "sys_updated_by": "admin",
    "previous_version": null,
    "sys_created_on": "2023-01-18 16:04:52",
    "value": null,
    "effective_from": null,
    "linked_to": null,
    "sys_created_by": "admin",
    "restricted_to": null,
    "linked_to_version": null,
    "level": "2",
    "conflict_type": null,
    "main_id": "19",
    "effective_to": null,
    "secure_value": null,
    "node_classifier": "/shared_library/shared_components",
    "main_id_encoded": ":",
    "name": "testSharedComponent",
    "position": null,
    "reason_for_conflict": null,
    "system_folder": false,
    "status": "new",
    "conflict": false
  }
}

    CdmSharedLibraryApi – POST /sn_cdm/Shared_Libraries/uploads/components

    Mit können Sie gemeinsam genutzte Bibliotheken und gemeinsam genutzte Komponenten erstellen und verwalten. Dieser Endpunkt erstellt einen Knoten der gemeinsam genutzten Komponente in der Tabelle „CDM-Knoten“ [sn_cdm_node] und einen Datensatz einer gemeinsam genutzten Komponente in der Tabelle „gemeinsam genutzte CDM-Komponente“ [sn_cdm_Shared_component].

    Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor“ erforderlich.

    Hinweis:
    Standardmäßig beträgt die maximale Größe für das Hochladen von Inhalten 2 MB. Sie können diesen Standard ändern, indem Sie die Eigenschaft sn_cdm.max_allowed_upload_file_size aktualisieren.
    Hinweis:
    Diese Upload-Methode kann nicht zum Ändern von Knoten verwendet werden. Verwenden Sie die Alternative CdmSharedLibraryApi – POST /sn_cdm/Shared_Libraries/uploads/components/file Methode zum Ändern von Knoten.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/uploads/components

    Standard-URL: /api/sn_cdm/Shared_Libraries/uploads/components

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 31. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 32. Abfrageparameter
    Name Beschreibung
    Automatisches Commit Kennzeichnung, die angibt, ob das Changeset in identifiziert wurde changesetNumberParameter wird nach dem Hochladen an das Datenmodell übergeben.
    Gültige Werte:
    • Wahr: Changeset wird nach dem Hochladen bestätigt.
    • Falsch: Changeset wird nach dem Hochladen nicht bestätigt.

    Datentyp: Boolesch

    Standardwert: false
    autoDelete Kennzeichnung, die angibt, ob die vorhandenen Knoten, die nicht Teil des Upload-Inhalts sind, nach Abschluss der Verarbeitung gelöscht werden.
    Gültige Werte:
    • Wahr: Vorhandene Knoten automatisch löschen.
    • Falsch: Vorhandene Knoten nicht automatisch löschen.

    Datentyp: Boolesch

    Standardwert: false
    changesetNumber Erforderlich. Zeichenfolge, die das Changeset, das der Anwendung zugeordnet ist, eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Änderungssatz [sn_cdm_changeset]
    Datenformat Erforderlich. Format der Konfigurationsdaten.
    Gültige Werte:
    • CSV
    • ini
    • json
    • Eigenschaften
    • roh
    • XML
    • yaml

    Datentyp: Zeichenfolge
    DeleteRedundantOverrides Kennzeichnung, die angibt, ob eine Überschreibung erstellt werden soll, bei der redundante Werte vorhanden sind.
    Gültige Werte:
    • Wahr: Wenn redundante Werte vorhanden sind, wird keine Überschreibung erstellt.
    • Falsch: Wenn redundante Werte vorhanden sind, wird mit einer Überschreibung fortgefahren.

    Standardwert: wahr
    IdentifierKeys Liste der Namen, die angeben, welcher Schlüssel in einem untergeordneten Array zur Identifizierung desselben Knotens verwendet werden soll.

    Beispiel: Wenn Sie hochladen:

    [
  {"name" : "Allan, "city" : "Paris"}, 
  {"name" : "Karen, "city" : "Sydney"}
]

    Im folgenden vorhandenen Modell:

    [
  {"name" : "Karen, "city" : "Manila"},
  {"name" : "Allan, "city" : "Brussels"}
]

    Und Sie haben festgelegt identifierKeysBis Name , Erzeugt die folgende Ausgabe:

    [
  {"name" : "Karen, "city" : "Sydney"},
  {"name" : "Allan, "city" : "Paris"}
]

    Andernfalls wird die folgende Ausgabe erzeugt:

    [
  {"name" : "Karen, "city" : "Manila"},
  {"name" : "Allan, "city" : "Brussels"},
  {"name" : "Allan, "city" : "Paris"},
  {"name" : "Karen, "city" : "Sydney"}
]

    Datentyp: Array von Zeichenfolgen
    IgnorierAttribute Kennzeichnung, die angibt, ob das angegebene Datenformat Attribute unterstützt (derzeit nur XML).
    Gültige Werte:
    • Wahr: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten während des Uploads übersprungen.
    • Falsch: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten in den Upload aufgenommen.

    Datentyp: Boolesch

    Standardwert: false
    namePath Pfad des Zielknotens, unter dem die Konfigurationsdaten hochgeladen werden sollen. Dieser Pfad bezieht sich auf die Komponenten, die Sammlung oder den bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt).
    Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den Namenspfad für den Knoten zu definieren TestApp/bereitstellbare Elemente/Entwickler1/cdi1 :
    • Umgekehrtes Schrägstrichformat: TestApp/bereitstellbare Elemente/Entwickler1/cdi1
      Hinweis:
      Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden.
    • Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbare​Entwickler1​​cdi1
    • Array: ['TestApp','bereitstellbare Elemente','Development1','cdi1']
    Hinweis:
    Wenn die angegebene Komponente im angegebenen Pfad nicht vorhanden ist, erstellt das System die Komponente automatisch im angegebenen Pfad und lädt die Daten hoch.

    Datentyp: Zeichenfolge
    PublishOption
    Veröffentlichungsoption für die zugehörigen konfigurierten Snapshots.
    Gültige Werte:
    • Publish_New_and_unpublish_Old: Veröffentlichen Sie den neuen Snapshot, der nach dem Commit erstellt wurde, und heben Sie die Veröffentlichung des vorhandenen Snapshots auf.
    • Publish_none: Veröffentlichen Sie keine Snapshots.

    Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Veröffentlichen Sie einen Snapshot, oder heben Sie die Veröffentlichung auf .

    Datentyp: Zeichenfolge

    Standard: Publish_none
    sharedLibraryName Erforderlich. Name der gemeinsamen Bibliothek, die erstellt oder verwaltet werden soll.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    Tabelle : 33. Anforderungstextparameter
    Name Beschreibung
    Variablen-Upload-Daten Hochzuladende Konfigurationsdaten. Dies können beliebige Daten in dem von definierten Format sein dataFormatParameter der Abfrageparameter.

    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 .

    Tabelle : 34. Anforderungskopfzeilen.
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützte Typen: text/plainUnd application/x-www-form-urlencoded.

    Standard: text/plain
    Tabelle : 35. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 36. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Ungültige Anforderung. Die Upload-Anforderung wurde abgelehnt.
    Mögliche Probleme:
    • Die Größe der Konfigurationsnutzlast ist größer als das zulässige Maximum – standardmäßig 2 MB.
    • Erforderliche Parameter fehlen im Aufruf.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    Upload_ID SYS_ID der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt aufzurufen, um den Status des Uploads abzurufen.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Beispiel zeigt, wie die gemeinsame Bibliothek Demo_App1631126164773 hochgeladen wird, wobei die Konfigurationsdaten nur-Text sind.

    curl "http://instance.servicenow.com/api/sn_cdm/sharedlibrary/component/upload?namePath=%2FSettings%2FdbSettings&dataFormat=json&appName=Demo_App1631126164773&changesetNumber=Chset-8&autoCommit=false&publishOption=publish_none&autoDelete=true" \ 
--request POST \  
--header "Accept:application/json" \  
--header "Content-Type:text/plain" \  
--data "{  
  \"dbIPAddress\": \"10.10.10.110\",  
\"dbPort\": \"8080\",  
\"dbConnectionString\": \"admin:admin server1.xyz.com:8080 dbName_payments\",  
\"dbConnectionStringBackup\": \"admin:admin server2.xyz.com dbName_payments_backup\ "}" \  
--user 'username':'password'

    Die folgenden Rückgabeergebnisse zeigen sowohl eine erfolgreiche als auch eine Fehlerantwort auf diese Anforderung.

    // Successful response 
{  
"result": {  
    "upload_id": "ec1f71f45322301096edddeeff7b12b3"  
  }  
}
 
// Error response 

{  
"error": {  
   "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)",  
   "detail": ""  
},  
"status": "failure" 
}

    CdmSharedLibraryApi – POST /sn_cdm/Shared_Libraries/uploads/components/file

    Lädt Dateien als Teil des Konfigurationsdatenmodells (Configuration Data Model, CDM) im Komponentenordner in einer gemeinsamen Bibliothek hoch.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}Shared_Libraries/uploads/components/file

    Standard-URL: /api/sn_cdm/Shared_Libraries/uploads/components/file

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 37. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 38. Abfrageparameter
    Automatisches Commit Kennzeichnung, die angibt, ob das Changeset in identifiziert wurde changesetNumberParameter wird nach dem Hochladen an das Datenmodell übergeben.
    Gültige Werte:
    • Wahr: Changeset wird nach dem Hochladen bestätigt.
    • Falsch: Changeset wird nach dem Hochladen nicht bestätigt.

    Datentyp: Boolesch

    Standardwert: false
    Automatisch validieren Kennzeichnung, die angibt, ob die Snapshots, die beim Commit erstellt wurden, validiert werden.
    Gültige Werte:
    • Wahr: Validieren Sie die Snapshots.
    • Falsch: Snapshots nicht validieren.
    Hinweis:
    Diese Option ist nur verfügbar, wenn autoCommitParameter ist Wahr .

    Datentyp: Boolesch

    Standardwert: false
    changesetNumber Zeichenfolge, die eindeutig identifiziert änderungssatz Der Anwendung zugeordnet, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden.

    Datentyp: Zeichenfolge

    Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil von zurückgegeben CdmApplicationsApi – GET /sn_cdm/Applications/Upload-Status/{Upload_ID} Ergebnisse.

    Tabelle: CDM-Änderungssatz [sn_cdm_changeset]
    fileName Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .Txt/.scv/.jar. Der Dateiname wird beim Herunterladen der Datei angewendet.

    Datentyp: Zeichenfolge
    FileNodeName Name des Dateiknotens. Dieser Dateiname wird beim Exportieren in den Konfigurationsdaten verwendet. Dieser Name erfordert keine Dateierweiterung und wirkt sich auch nicht auf den Download aus.

    Datentyp: Zeichenfolge
    namePath Pfad des Zielknotens, unter dem die Konfigurationsdaten hochgeladen werden sollen. Dieser Pfad bezieht sich auf die Komponenten, die Sammlung oder den bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt).
    Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den Namenspfad für den Knoten zu definieren TestApp/bereitstellbare Elemente/Entwickler1/cdi1 :
    • Umgekehrtes Schrägstrichformat: TestApp/bereitstellbare Elemente/Entwickler1/cdi1
      Hinweis:
      Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden.
    • Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbare​Entwickler1​​cdi1
    • Array: ['TestApp','bereitstellbare Elemente','Development1','cdi1']
    Hinweis:
    Wenn die angegebene Komponente im angegebenen Pfad nicht vorhanden ist, erstellt das System die Komponente automatisch im angegebenen Pfad und lädt die Daten hoch.

    Datentyp: Zeichenfolge
    sharedLibraryName Erforderlich. Name der gemeinsamen Bibliothek, in der sich die zu löschende Komponente befindet.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    Tabelle : 39. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Variablen-Upload-Daten Hochzuladende Konfigurationsdaten. Standardmäßig ist die Dateigröße des Uploads auf 5 MB beschränkt. Informationen zum Anpassen der Größe und des Typs der Upload-Datei finden Sie hier Now Support Artikelan.

    Datentyp: Zeichenfolge/Stream

    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 .

    Tabelle : 40. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json
    Inhaltstyp Inhaltstyp der hochzuladenden Datei. Beispiele: Application/zip, Text/plain, Application/JSON.
    Tabelle : 41. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 42. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Ungültige Anforderung.

    Upload-Anforderung wurde abgelehnt.

    Mögliche Probleme:
    • Die Größe der Konfigurationsnutzlast ist größer als das zulässige Maximum – standardmäßig 2 MB.
    • Erforderliche Parameter fehlen im Aufruf.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge
    Upload_ID SYS_ID der Upload-Anforderung. Verwenden Sie diese ID, um den anzurufen CdmApplicationsApi – GET /sn_cdm/Applications/Upload-Status/{Upload_ID} Endpunkt zum Abrufen des Status des Uploads.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Der folgende Aufruf demonstriert, wie eine nur-Text-Datei in den Komponentenordner in der gemeinsamen Bibliothek hochgeladen wird.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/uploads/components/file?autoValidate=true&sharedLibraryName=sharedLibA &namePath=testComponent%2FfilesFolder&fileName=testFileNodeName.txt&publishOption=publish_valid&changesetNumber=Chset-108&autoCommit=true&fileNodeName=testFile.txt" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "This is sample content that will be uploaded to a plain text file."\ 
--user 'username':'password'

    Die folgenden Rückgabeergebnisse zeigen sowohl eine erfolgreiche als auch eine Fehlerantwort auf diese Anforderung.

    // Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Could not find active application with name: ‘testApp’ of type application", 
    "detail": "" 
  },
  "status": "failure"
}

    CdmSharedLibraryApi – PUT /sn_cdm/Shared_Libraries

    Aktualisiert die Informationen der gemeinsamen Bibliothek. Verwenden Sie diesen Endpunkt, um den Namen, die Beschreibung, den Status einer gemeinsamen Bibliothek und die Anwendergruppen zu aktualisieren, die auf die Bibliothek zugreifen können.

    Für den Zugriff auf diesen Endpunkt ist die CDM-Administratorrolle erforderlich.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries

    Standard-URL: /api/sn_cdm/Shared_Libraries

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 43. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 44. Abfrageparameter
    Name Beschreibung
    name Erforderlich. Name der zu aktualisierenden gemeinsamen Bibliothek.

    Datentyp: Zeichenfolge

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    NewAvailableState Kennzeichnung, die den Status der gemeinsamen Bibliothek angibt.
    Gültige Werte:
    • Wahr: Die gemeinsame Bibliothek ist aktiv.
    • Falsch: Die gemeinsame Bibliothek ist inaktiv. Keine Anwender dürfen auf diese Bibliothek zugreifen.

    Standardwert: wahr
    NeuBeschreibung Aktualisierte Beschreibung der gemeinsamen Bibliothek.

    Datentyp: Zeichenfolge
    NEWNAME Neuer Name der gemeinsamen Bibliothek.

    Datentyp: Zeichenfolge
    NewUserGroupIds Kommagetrennte Liste der sys_IDs der Anwendergruppen, die auf die zugehörige gemeinsame Bibliothek zugreifen können.

    Datentyp: Zeichenfolge

    Tabelle: Gruppe [sys_user_group]
    returnFields Kommagetrennte Liste von Feldern in der Tabelle „CDM-Anwendung“ [sn_cdm_Application], die als Teil der Antwort zurückgegeben werden sollen.

    Datentyp: Zeichenfolge

    Standard: Alle nicht-Systemfelder werden zurückgegeben.
    Tabelle : 45. Anforderungstextparameter
    Name Beschreibung
    Keine

    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 .

    Tabelle : 46. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 47. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 48. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    <fields> Angeforderte Felder.

    Datentyp: Variable

    Tabelle: CDM-Anwendung [sn_cdm_Application]
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie dieser Endpunkt für die gemeinsam genutzte Bibliothek Java11Lib aufgerufen und der Bibliotheksname und die Beschreibung aktualisiert werden.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries?name=' javalib'&newName=’NewLibraryName’&newDescription=’new%20description%20of%20library’\ 
--request PUT\ 
--header "Accept:application/json" \ 
--user 'username':'password'

    Antwort:

    {
  "result": {
    "sdlc_component": null,
    "cdi_count": "0",
    "available": true,
    "description": "Set new description",
    "managed_by_group": null,
    "sys_updated_on": "2023-01-18 11:51:14",
    "type": "shared_library",
    "node": {
      "value": "021635dc77a4a1109ac0cf0bbb5a9952",
      "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node/021635dc77a4a1109ac0cf0bbb5a9952"
    },
    "sys_id": "185235dc77a4a1109ac0cf0bbb5a994e",
    "sys_updated_by": "admin",
    "node_main": {
      "value": "1852b15877a4a1109ac0cf0bbb5a99aa",
      "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node_main/1852b15877a4a1109ac0cf0bbb5a99aa"
    },
    "sys_created_on": "2023-01-18 11:34:43",
    "cdi_usage": "0",
    "name": "LibraryA",
    "last_committed_changeset": {
      "value": "4a1635dc77a4a1109ac0cf0bbb5a9951",
      "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_changeset/4a1635dc77a4a1109ac0cf0bbb5a9951"
    },
    "state": "active",
    "sys_created_by": "admin"
  }
}

    CdmSharedLibraryApi – PUT /sn_cdm/Shared_Libraries/components

    Aktualisiert den Namen und die Beschreibung der angegebenen gemeinsam genutzten Komponente.

    Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor“ erforderlich.

    Hinweis:
    Das Umbenennen ist nur zulässig, wenn eine Komponente nie verwendet wurde, z. B. wenn der Snapshot der Komponente nie importiert wurde. Das Umbenennungsszenario dient hauptsächlich dazu, Tippfehler beim Erstellen neuer Komponenten zu beheben.

    URL-Format

    Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/components

    Standard-URL: /api/sn_cdm/Shared_Libraries/components

    Hinweis:
    Verfügbare Versionen werden in angegeben REST API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 49. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 50. Abfrageparameter
    Name Beschreibung
    changesetNumber Erforderlich. Name des zugeordneten Changesets.

    Datentyp: Zeichenfolge

    Tabelle:CDM-Änderungssatz [sn_cdm_changeset]
    name Erforderlich. Name der gemeinsam genutzten Komponente, die aktualisiert werden soll.

    Datentyp: Zeichenfolge

    Tabelle: Gemeinsam genutzte CDM-Komponente [sn_cdm_Shared_component]
    NEWNAME Erforderlich. Name der gemeinsam genutzten Komponente wurde aktualisiert.

    Datentyp: Zeichenfolge
    NeuBeschreibung Aktualisierte Beschreibung der gemeinsam genutzten Komponente.

    Datentyp: Zeichenfolge

    Standard: Leer
    returnFields Kommagetrennte Liste von Feldern in der Tabelle „gemeinsam genutzte CDM-Komponente“ [sn_cdm_Shared_component], die als Teil der Antwort zurückgegeben werden sollen.

    Datentyp: Zeichenfolge

    Standard: Alle nicht-Systemfelder werden zurückgegeben.
    Tabelle : 51. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    Keine

    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 .

    Tabelle : 52. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts.

    Unterstützte Typen:

    • application/json
    • application/xml
    • text/xml

    Standard: application/json
    Tabelle : 53. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter REST API-HTTP-Antwortcodes .

    Tabelle : 54. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    500 Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    <fields> Angeforderte Felder aus der Tabelle „gemeinsam genutzte CDM-Komponente“ [sn_cdm_Shared_component].

    Datentyp: Variable
    Fehler Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler.

    Datentyp: Objekt

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Zusätzliche Informationen zum Fehler.

    Datentyp: Zeichenfolge
    Fehler.Nachricht Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde.

    Datentyp: Zeichenfolge
    status Fehlerstatus der Anforderung.

    Mögliche Werte: Fehler

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie die Beschreibung der Komponente „SharedComponentTest“ aktualisiert wird.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components/?sharedLibraryName=javalib&changeSetNumber='chset-9'&name='SharedComponentTest'&newDescription='The shared component description'\  
--request POST\  
--header "Accept:application/json" \  
--user 'username':'password

    Antwort:

    {
  "result": {
    "changeset_id": {
      "value": "5c33311077e4a1109ac0cf0bbb5a9902",
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/5c33311077e4a1109ac0cf0bbb5a9902"
    },
    "node_path": "!(1!(2!(3",
    "description": "Changing the description only",
    "sys_updated_on": "2023-01-18 12:09:05",
    "type": "sn_cdm_node_shared_component",
    "sys_class_name": "sn_cdm_node",
    "sys_id": "9953f99077a4a1109ac0cf0bbb5a99ec",
    "sys_updated_by": "admin",
    "previous_version": null,
    "sys_created_on": "2023-01-18 11:39:09",
    "value": null,
    "effective_from": null,
    "linked_to": null,
    "sys_created_by": "admin",
    "restricted_to": null,
    "linked_to_version": null,
    "level": "2",
    "conflict_type": null,
    "main_id": "183",
    "effective_to": null,
    "secure_value": null,
    "node_classifier": "/shared_library/shared_components",
    "main_id_encoded": "(3",
    "name": "sharedComponentName",
    "position": null,
    "reason_for_conflict": null,
    "system_folder": false,
    "status": "new",
    "conflict": false
  }
}