CdmApplicationsApi

CdmApplicationsApi – /sn_cdm/applications/deployables löschen

Löscht ein angegebenes bereitstellbares Configuration Data Management (CDM).

Der Aufrufer dieses Endpunkts muss über die CDM-Administratorrolle verfügen.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables

Standard-URL: /api/sn_cdm/applications/deployables

Unterstützte Anforderungsparameter

Tabelle : 1. Pfadparameter
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 : 2. Abfrageparameter
Name	Beschreibung
appName	Erforderlich. Name der CDM-Anwendung, der das bereitstellbare Element zugeordnet ist. Befindet sich in der Tabelle „Bereitstellbares CDM“ [sn_cdm_deployable]. Datentyp: Zeichenfolge
Name	Name des zu löschenden bereitstellbaren Elements. Befindet sich in der Tabelle „Bereitstellbares CDM“ [sn_cdm_deployable]. Datentyp: Zeichenfolge

Tabelle : 3. 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 : 4. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur 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 HTTP-Antwortcodesder REST-API.

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.

Parameter des Antwort-Haupttexts


Name	Beschreibung
Keine

cURL-Anforderung

Das folgende Codebeispiel zeigt, wie ein bereitstellbares Element entfernt wird.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables?appName=testApp&name=Dep-1" \ 
--request DELETE \ 
--header "Accept:application/json" \ 
--user 'username':'password1'

Bei einer erfolgreichen Löschung des bereitstellbaren Elements wird keine andere Antwort als der HTTP-Statuscode zurückgegeben.

None - results defined by the HTTP status code

CdmApplicationsApi – DELETE /sn_cdm/applications/shared_components

Entfernt die Verwendungsreferenz der gemeinsam genutzten Komponente aus einer angegebenen Configuration Data Management (CDM)-Anwendung.

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

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/shared_components

Standard-URL: /api/sn_cdm/applications/shared_components

Unterstützte Anforderungsparameter

Tabelle : 7. Pfadparameter
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 : 8. Abfrageparameter
Name	Beschreibung
appName	Erforderlich. Name der Anwendung, aus der die angegebene Zuordnung der gemeinsam genutzten Komponente entfernt werden soll. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Für die angegebene Anwendung muss das Typfeld auf „shared_library“ festgelegt sein. Datentyp: Zeichenfolge
changesetNumber	Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10“. Befindet sich in der Tabelle „CDMChangeset“ [sn_cdm_changeset]. Datentyp: Zeichenfolge
sharedComponentName	Erforderlich. Eindeutiger Name der gemeinsam genutzten Komponente, die aus der angegebenen Anwendung entfernt werden soll. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente“ [sn_cdm_shared_component]. Datentyp: Zeichenfolge

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 oder application/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 HTTP-Antwortcodesder REST-API.

Tabelle : 12. 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
Ergebnis	Leer. Der HTTP-Statuscode gibt das Ergebnis des Aufrufs an.
Fehler	Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt `"error": { "detail": "String", "message": "String" }`
Fehler.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 gemeinsam genutzte Komponente „paymentService-V1.1“ aus der Anwendung „App1“ gelöscht wird.

curl "https://instance-name.service-now.com/api/sn_cdm/applications/shared_components?appName=App1&sharedComponentName=paymentService-V1.1&changesetNumber=Chset-25" \ 
--request DELETE \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Antwort:

""

CdmApplicationsApi – GET /sn_cdm/applications/deployables/exports/{export_id}/content

Gibt den Inhalt zurück, der einer angegebenen Konfigurationsdaten-Exportanforderung zugeordnet ist.

Rufen Sie diesen Endpunkt nur auf, wenn Sie eine vollständige Antwort vom CdmApplicationsApi – GET /sn_cdm/applications/deployables/exports/{export_id}/status -Endpunkt erhalten haben. Wenn Sie diesen Endpunkt aufrufen, bevor der Export abgeschlossen ist, wird ein Statusfehler 400 zurückgegeben.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables/exports/{export_id}/content

Standard-URL: /api/sn_cdm/applications/deployables/exports/{export_id}/content

Unterstützte Anforderungsparameter

Tabelle : 13. Pfadparameter
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
export_id	Eindeutiger Bezeichner für die Exportanforderung, deren Konfigurationsdaten zurückgegeben werden sollen. Dieser Wert wird vom Endpunkt CdmApplicationsApi – POST /sn_cdm/applications/deployables/exports zurückgegeben.

Tabelle : 14. Abfrageparameter
Name	Beschreibung
Keine

Tabelle : 15. 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 : 16. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur 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 HTTP-Antwortcodesder REST-API.

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.

Antworttextparameter (JSON oder XML)


Name	Beschreibung
Fehler	Beschreibung der beim Export aufgetretenen Fehler. Datentyp: Zeichenfolge
export_id	ID der Exportanforderung Identisch mit dem, der an den Endpunkt übergeben wurde. Datentyp: Zeichenfolge
exporter_result	Inhalt des angegebenen Konfigurationsdatenexports. Datentyp: JSON-Objekt: Wenn die Anforderung darin bestand, Daten im JSON-Format zu exportieren. Zeichenfolge: Wenn die Anforderung darin bestand, Daten in einem anderen Format zu exportieren.
request_id	ID der Exportanforderung Identisch mit dem, der an den Endpunkt übergeben wurde. Datentyp: Zeichenfolge
Status	Aktueller Status des angegebenen Exports. Wert aus der Statusspalte in der Tabelle „CDM-Anforderungswarteschlange“ [sn_cdm_request_queue]. Mögliche Werte: abgeschlossen Fehler in_progress neu Bereit Datentyp: Zeichenfolge

cURL-Anforderung

Im folgenden Beispiel werden die Konfigurationsdaten einer Exportanforderung mit der ID 3ab14a7d53b1301096edddeeff7b12f angefordert.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/exports/3ab14a7d53b1301096edddeeff7b12f/content" \ 
--request GET \ 
--header "Accept:application/json" \
--user 'username':'password'

Im Folgenden sind die möglichen Rückgabeergebnisse aufgeführt.

// Successful completion of the export request
{ 
  "result": { 
    "export_id": "3ab14a7d53b1301096edddeeff7b12f" 
    "exporter_result": "DEP1.COMP.cdi_1=cdi-1-value" 
  } 
}

// Response when an incorrect export_id is passed. Note: Status code is 200.
{ 
  "result": { 
    "request_id": "3ab14a7d53b1301096edddeeff7b12e", 
    "state": "error", 
    "errors": "Invalid requestId '3ab14a7d53b1301096edddeeff7b12fe'", 
    "export_id": "3ab14a7d53b1301096edddeeff7b12e" 
  } 
}

CdmApplicationsApi – GET /sn_cdm/applications/deployables/exports/{export_id}/status

Gibt den aktuellen Status der angegebenen Exportanforderung für Konfigurationsdaten zurück.

Verwenden Sie den Endpunkt CdmApplicationsApi – POST /sn_cdm/applications/deployables/exports, um eine Exportanforderung zu erstellen.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables/exports/{export_id}/status

Standard-URL: /api/sn_cdm/applications/deployables/exports/{export_id}/status

Unterstützte Anforderungsparameter

Tabelle : 19. Pfadparameter
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
export_id	Sys_id der Exportanforderung, deren Status zurückgegeben werden soll. Dieser Wert wird vom Endpunkt CdmApplicationsApi – POST /sn_cdm/applications/deployables/exports zurückgegeben.

Tabelle : 20. Abfrageparameter
Name	Beschreibung
Keine

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ützt nur 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 HTTP-Antwortcodesder REST-API.

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.

Antworttextparameter (JSON oder XML)


Name	Beschreibung
Fehler	Beschreibung der beim Export aufgetretenen Fehler. Datentyp: Zeichenfolge
export_id	ID der Exportanforderung Identisch mit dem, der an den Endpunkt übergeben wurde. Datentyp: Zeichenfolge
exporter_result	Details zum zugeordneten Fehler. Datentyp: Objekt
exporter_result.errors	Beschreibung der beim Export aufgetretenen Fehler. Datentyp: Array
exporter_result.execution_id	Eindeutiger Bezeichner für den Exporter-Ausführungsdatensatz. Befindet sich in der Tabelle „sn_cdm_exporter_execution“. Datentyp: Zeichenfolge
exporter_result.state	Aktueller Status des angegebenen Exports. Befindet sich in der Tabelle „sn_cdm_exporter_execution“. Mögliche Werte: Abschließen Fehler in_progress neu Datentyp: Zeichenfolge
request_id	ID der Exportanforderung Identisch mit dem, der an den Endpunkt übergeben wurde. Datentyp: Zeichenfolge
Status	Aktueller Status des angegebenen Exports. Wert aus der Statusspalte in der Tabelle „CDM-Anforderungswarteschlange“ [sn_cdm_request_queue]. Mögliche Werte: abgeschlossen Fehler in_progress neu Bereit Datentyp: Zeichenfolge

cURL-Anforderung

Im folgenden Beispiel wird der Status eines Exports mit der ID 3ab14a7d53b1301096edddeeff7b12f angefordert.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/exports/3ab14a7d53b1301096edddeeff7b12f/status" \ 
--request GET \ 
--header "Accept:application/json" \
--user 'username':'password'

Im Folgenden sind die möglichen Rückgabeergebnisse aufgeführt.

// Successful completion of the export request
{ 
  "result": { 
    "state": "completed", 
    "export_id": "3ab14a7d53b1301096edddeeff7b12f0" 
  } 
}

// Response when an incorrect export_id is passed. Note: Status code is 200.
{ 
  "result": { 
    "request_id": "3ac8e1b05311301096edddeeff7b123c", 
    "state": "error", 
    "errors": "Invalid requestId '3ac8e1b05311301096edddeeff7b123c'", 
    "export_id": "3ac8e1b05311301096edddeeff7b123c" 
  } 
} 

// Response when the export encounters an error. The exporter_result array contains the error information. Note: Status code is 200.
{ 
  "result": { 
    "state": "completed", 
    "export_id": "24536c3353f9301096edddeeff7b12b1", 
    "exporter_result": { 
      "execution_id": "81536c3353f9301096edddeeff7b129e", 
      "state": "failure", 
      "errors": [ 
        "Snapshot 'SNA-001-published-non_compliant' has not passed validation. All snapshots of deployable '/ApplicationA/deployables/DEP3' are required to pass validation" 
      ] 
    } 
  } 
}

CdmApplicationsApi – GET /sn_cdm/applications/shared_components

Gibt die Liste der gemeinsam genutzten Komponenten zurück, die von einer angegebenen Anwendung verwendet werden. Sie können auch angeben, dass nur die gemeinsam genutzten Komponenten zurückgegeben werden sollen, für die eine neue Version verfügbar ist.

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

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/shared_components

Standard-URL: /api/sn_cdm/applications/shared_components

Unterstützte Anforderungsparameter

Tabelle : 25. Pfadparameter
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 : 26. Abfrageparameter
Name	Beschreibung
appName	Erforderlich. Name der Anwendung, deren Liste der gemeinsam genutzten Komponenten zurückgegeben werden soll. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Das Typfeld der Anwendung muss auf shared_library festgelegt werden. Datentyp: Zeichenfolge
withUpdatesOnly	Kennzeichnung, die angibt, ob nur gemeinsam genutzte Komponenten zurückgegeben werden sollen, für die eine neue aktualisierte Version verfügbar ist. Gültige Werte: true: Gibt nur gemeinsam genutzte Komponenten zurück, für die eine neue aktualisierte Version verfügbar ist. false: Gibt alle gemeinsam genutzten Komponenten zurück, die von der angegebenen Anwendung verwendet werden. Standardwert: false

Tabelle : 27. 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 : 28. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/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 HTTP-Antwortcodesder REST-API.

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
currentVersion	Aktuelle Version der CDM-Anwendung. Datentyp: Ganzzahl
currentVersionName	Name der derzeit verwendeten Version der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge
Beschreibung	Beschreibung der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge
Fehler	Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt `"error": { "detail": "String", "message": "String" }`
Fehler.Detail	Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge
Name	Eindeutiger Name der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge
sharedLibraryName	Name der gemeinsamen Bibliothek, zu der die gemeinsam genutzte Komponente gehört. Datentyp: Zeichenfolge
status	Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge
updateVersionName	Name der Version der gemeinsam genutzten Komponente, die für die Aktualisierung verfügbar ist. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird, um die gemeinsam genutzten Komponenten abzurufen, für die eine neue Version von „App1“ verwendet wird.

curl "https://instance-name.service-now.com/api/sn_cdm/applications/shared_components?updatesOnly=true&appName=App1" \ 
--request GET \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Antwort:

{ 
  "result": [
    {
      "name": "Component_Name",
      "description": "”,
      "sharedLibraryName": "Shared Library",
      "currentVersion": "2",
      "currentVersionName": "Component_A-v2.shc",
      "updateVersionName": "Component_A-v3.shc"
    } 
  ]
}

CdmApplicationsApi – GET /sn_cdm/applications/shared_libraries/components/applications

Gibt eine Zuordnung der gemeinsam genutzten Komponenten und der Anwendungen zurück, die sie verwenden und sich innerhalb einer angegebenen Bibliothek befinden.

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

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/shared_libraries/components/applications

Standard-URL: /api/sn_cdm/applications/shared_libraries/components/applications

Unterstützte Anforderungsparameter

Tabelle : 31. Pfadparameter
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 : 32. Abfrageparameter
Name	Beschreibung
sharedComponentName	Erforderlich. Name der gemeinsam genutzten Komponente, die in die Zuordnung aufgenommen werden soll. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente“ [sn_cdm_shared_component]. Datentyp: Zeichenfolge
sharedLibraryName	Erforderlich. Name der gemeinsamen Bibliothek, die in die Zuordnung aufgenommen werden soll. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Für die angegebene Anwendung muss das Typfeld auf „shared_library“ festgelegt sein. Datentyp: Zeichenfolge

Tabelle : 33. 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 : 34. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json

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 HTTP-Antwortcodesder REST-API.

Tabelle : 36. 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
Beschreibung	Beschreibung der Anwendung, die die gemeinsam genutzte Komponente verwendet Datentyp: Zeichenfolge
Fehler	Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt `"error": { "detail": "String", "message": "String" }`
Fehler.Detail	Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge
managed_by_group	Kommagetrennte Liste von sys_ids der Gruppen, die die Anwendung verwalten können. Datentyp: Zeichenfolge
Name	Eindeutiger Name der Anwendung, die die Komponente verwendet. Datentyp: Zeichenfolge
status	Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge
sys_id	Sys_id der Anwendung, die die gemeinsam genutzte Komponente verwendet. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird, um die Zuordnung abzurufen, die die Anwendungen in der gemeinsamen Bibliothek „OracleG-Bibliothek-10“ anzeigt, die die gemeinsam genutzte Komponente „paymentService-V1.1“ verwenden.

curl "https://instance-name.service-now.com/api/sn_cdm/applications/shared_libraries/components/applications?sharedLibraryName=OracleG-Library-10&sharedComponentName=paymentService-V1.1" \ 
--request GET \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Antwort:

{
  "result": {
    "component_name": [
      { 
        "name": "App Name",
        "description": "desc",
        "managed_by_group": null,
        "sys_id": "4e7808bb1b371110636e0fe0604bcb08"
      }, 
      {
        "name": "Config App",
        "description": "desc",
        "managed_by_group": null,
        "sys_id": "55a75cfb1b771110636e0fe0604bcb5c"
      },
      {
        "name": "Database App",
        "description": "desc",
        "managed_by_group": null,
        "sys_id": "2eb7503f1b771110636e0fe0604bcb06"
      }
    ]
  } 
}

CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id}

Gibt den aktuellen Status der angegebenen Anforderung zum Hochladen von Konfigurationsdaten zurück.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/upload-status/{upload_id}

Standard-URL: /api/sn_cdm/applications/upload-status/{upload_id}

Unterstützte Anforderungsparameter

Tabelle : 37. Pfadparameter
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
hochgeladene ID	Sys_id der Upload-Anforderung, deren Status zurückgegeben werden soll. Dieser Wert wird von den verschiedenen CdmApplications-Upload-Anforderungsendpunkten zurückgegeben.

Tabelle : 38. Abfrageparameter
Name	Beschreibung
Keine

Tabelle : 39. 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 : 40. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur 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 HTTP-Antwortcodesder REST-API.

Tabelle : 42. 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.

Antworttextparameter (JSON oder XML)


Name	Beschreibung
Fehler	Beschreibung der Fehler, die beim Upload 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", "snapshot_description": "String", "snapshot_name": "String", "state": "String", "sys_created_by": "String", "sys_id": "String", "title": "String" }`
Ausgabe.auto_validieren	Gibt an, ob die Validierung nach dem Commit aufgerufen werden soll. Datentyp: Zeichenfolge
Ausgabe.cdm_application	Name der Anwendung, unter der der Upload durchgeführt wurde. Datentyp: Zeichenfolge
Ausgabe.committed_at	Datum und Uhrzeit, zu der der hochgeladene Inhalt bestätigt wurde. Datentyp: Zeichenfolge
Ausgabe.committed_by	Sys_id des Datensatzes der Entität, die den Commit ausgeführt hat. Datentyp: Zeichenfolge
Ausgabe.Beschreibung	Derzeit nicht verwendet. Datentyp: Zeichenfolge
Ausgabe.last_conflict_detection_time	Datum und Uhrzeit des Aufrufs der Konflikterkennung. Datentyp: Zeichenfolge
Ausgabe.Nummer	Eindeutige Nummer des Changesets. Datentyp: Zeichenfolge
Ausgabe.veröffentlichen_option	Veröffentlichungsoption für die zugeordneten konfigurierten Snapshots. Gültige Werte: veröffentlichen_none: Keine Snapshots veröffentlichen. veröffentlichen_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Snapshots veröffentlichen oder Veröffentlichung aufheben. Datentyp: Zeichenfolge Standard: veröffentlichen_none Hinweis: Diese Option ist nur verfügbar, wenn der Wert für den Parameter autoCommit „ true“ ist.
Ausgabe.snapshot_description	Beschreibung des zugeordneten Snapshots. Datentyp: Zeichenfolge
Ausgabe.snapshot_name	Name des zugeordneten Snapshots. Datentyp: Zeichenfolge
Ausgabe.Status	Status des Upload-Inhalts. Mögliche Werte: blockiert checking_for_conflict commit_failed commit_in_progress committet offen 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: NICHT_VERARBEITET VERARBEITET Datentyp: Zeichenfolge
Status	Aktueller Status der Upload-Anforderung. Mögliche Werte: abgeschlossen Fehler in_progress neu Bereit
type	Typ der Upload-Anforderung. Mögliche Werte: Commit export „upload_and_commit“ Datentyp: Zeichenfolge
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt die Anforderung des Status für einen Upload mit der ID 5560a6895326301096edddeeff7b1230.

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

Im Folgenden sind die möglichen Rückgabeergebnisse aufgeführt.

// Successful completion of the upload request
{ 
  "result": { 
    "type": "upload_and_commit", 
    "state": "completed", 
    "output": { 
      "sys_id": "be681dc95362301096edddeeff7b12ba", 
      "number": "Chset-102", 
      "title": "admin2021-09-10 08:09:07", 
      "description": null, 
      "committed_at": "2021-09-10 20:23:37", 
      "committed_by": "6816f79cc0a8016401c5a33be04be441", 
      "sys_created_by": "admin", 
      "state": "committed", 
      "publish_option": "publish_none", 
      "auto_validate": false, 
      "snapshot_name": null, 
      "snapshot_description": null, 
      "cdm_application": "Demo_App1631126164773", 
      "last_conflict_detection_time": "1631305417894" 
    }, 
    "processing_state": "PROCESSED", 
    "upload_id": "5560a6895326301096edddeeff7b1230"
  } 
}

// Response when an incorrect upload_id is passed. Note: Status code is 200.
{ 
  "result": { 
    "state": "error", 
    "errors": "Invalid requestId '5560a6895326301096edddeeff7b1240'", 
    "upload_id": "5560a6895326301096edddeeff7b1240" 
  } 
} 

// Response when the upload encounters an error. The exporter_result array contains the error information. Note: Status code is 200.
{ 
  "result": { 
    "type": "upload_and_commit", 
    "state": "error", 
    "output": "Error encountered during execution of request.\nError: Node 'dbSettings' of type 'sg_cdm_node_component' cannot create child 'dbSettings' of type 'sg_cdm_node_folder'", 
    "processing_state": "PROCESSED", 
    "upload_id": "272f8a415326301096edddeeff7b1232" 
  } 
}

CdmApplicationsApi – POST /sn_cdm/applications/deployables

Erstellt ein neues bereitstellbares Element und verbindet es automatisch mit einer angegebenen Configuration Data Management (CDM)-Anwendung.

Sie können ein bereitstellbares Element für einen von drei Umgebungstypen erstellen: Entwicklung, Test oder Produktion.

Um auf diesen Endpunkt zuzugreifen, muss der Aufrufer über die CDM-Administratorrolle verfügen.

Wenn Sie mehrere bereitstellbare Elemente erstellen müssen, verwenden Sie den Endpunkt CdmApplicationsApi – POST /sn_cdm/applications/deployables/create.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables

Standard-URL: /api/sn_cdm/applications/deployables

Unterstützte Anforderungsparameter

Tabelle : 43. Pfadparameter
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 : 44. Abfrageparameter
Name	Beschreibung
appName	Erforderlich. Name einer vorhandenen, aktiven CDM-Anwendung, die dem bereitstellbaren Element zugeordnet werden soll. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
envType	Erforderlich. Umgebungstyp für das bereitstellbare Element Gültige Werte (Groß-/Kleinschreibung beachten): Entwicklung Produktion Test Hinweis: Der bereitstellbare Umgebungstyp kann nach der Erstellung nicht geändert werden. Datentyp: Zeichenfolge
Name	Erforderlich. Name des bereitstellbaren CDM. Darf nicht mehr als 255 Zeichen enthalten. Standardmäßig zulässige Zeichen sind 0-9, AZ, az, _,-,., %, $, Leerzeichen, :, #. Datentyp: Zeichenfolge Maximale Länge: 255 Zeichen Zulässige Zeichen: 0-9, AZ, az, _, -, ., %, $, Leerzeichen, : und #
returnFields	Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt

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ützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützt nur 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 HTTP-Antwortcodesder REST-API.

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
cdi_count	Anzahl der Konfigurationsdatenelemente (CDIs), die in der zugeordneten CDM-Anwendung enthalten sind. Datentyp: Ganzzahl
cdi_usage	Prozentsatz der vom bereitstellbaren Element verwendeten CDIs. Datentyp: Ganzzahl
cdm_app	CDM-Anwendungsobjekt, das dem bereitstellbaren Element zugeordnet ist. Datentyp: Objekt `"cdm_app": { "link": "String", "value": "String" }`
cdm_app.link	Rufen Sie auf, um mithilfe der REST- Tabellen -API auf den CDM-Anwendungsdatensatz zuzugreifen. Datentyp: Zeichenfolge
cdm_app.value	Sys_id des zugeordneten CDM-Anwendungsdatensatzes. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
cdm_ci	Anwendungsserviceobjekt, das dem bereitstellbaren Element zugeordnet ist. Datentyp: Objekt `"cdm_ci": { "link": "String", "value": "String" }`
cdm_ci.link	Rufen Sie auf, um mithilfe der REST- Tabellen -API auf den Anwendungsservice-Datensatz zuzugreifen. Datentyp: Zeichenfolge
cdm_ci.value	Sys_id des zugeordneten Anwendungsservice-Datensatzes. Befindet sich in der Tabelle „Konfigurationselement“ [cmdb_ci]. Datentyp: Zeichenfolge
Beschreibung	Beschreibung des generierten bereitstellbaren CDM. Datentyp: Zeichenfolge
umgebungstyp	Umgebungstyp des bereitstellbaren Elements Mögliche Werte: Entwicklung Produktion Test Datentyp: Zeichenfolge
Fehler	Wird nur zurückgegeben, wenn während der Verarbeitung ein Fehler aufgetreten ist. Datentyp: Objekt `"error": { "detail": "String", "message": "String" }`
Fehler.Detail	Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge
Name	Name des bereitstellbaren CDM. Datentyp: Zeichenfolge
Knoten	Details zum bereitstellbaren Knoten. Datentyp: Objekt `"node": { "link": "String", "value": "String" }`
node.link	Rufen Sie auf, um mithilfe der REST- Tabellen -API auf den Datensatz des bereitstellbaren Knotens zuzugreifen. Datentyp: Zeichenfolge
node.value	Sys_id des Datensatzes des bereitstellbaren Knotens. Befindet sich in der Tabelle „Bereitstellbares CDM“ [sn_cdm_deployable]. Datentyp: Zeichenfolge
snapshot_version_counter	Anzahl der für das bereitstellbare Element erstellten Snapshots. Datentyp: Ganzzahl
Status	Aktueller Status des bereitstellbaren Elements. Mögliche Werte: aktiv gelöscht Datentyp: Zeichenfolge
sys_created_by	Benutzername des Benutzers, der das bereitstellbare CDM erstellt hat. Beispiel: able.tuter. Datentyp: Zeichenfolge
sys_created_on	Datum und Uhrzeit der Erstellung des bereitstellbaren CDM-Elements. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge
sys_id	Sys_id des erstellten bereitstellbaren Elements. Befindet sich in der Tabelle „Bereitstellbares CDM“ [sn_cdm_deployable]. Datentyp: Zeichenfolge
sys_updated_by	Benutzername des Benutzers, der das bereitstellbare CDM zuletzt aktualisiert hat. Beispiel: able.tuter. Datentyp: Zeichenfolge
sys_updated_on	Datum und Uhrzeit der letzten Aktualisierung des bereitstellbaren CDM. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge

cURL-Anforderung .

Das folgende Codebeispiel zeigt, wie ein bereitstellbares Element erstellt und einer CDM-Anwendung zugeordnet wird.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables?name=Dep-1&returnFields=name%2Csys_id%2Cstate&appName=testApp&envType=Test" \ 
--request POST \ 
--header "Accept:application/json" \ 
--user 'username':'password1'

Ergebnisse zurückgeben:

{ 
  "result": [ 
    { 
      "cmdb_ci": { 
        "value": "f5b9e00b53901110a1d3ddeeff7b12b8", 
        "link": "http://192.168.0.233:8080/api/now/table/cmdb_ci_service_auto/f5b9e00b53901110a1d3ddeeff7b12b8" 
      }, 
      "cdi_count": "0", 
      "snapshot_version_counter": "0", 
      "description": null, 
      "sys_updated_on": "2022-06-29 12:53:57", 
      "environment_type": "Test", 
      "node": { 
        "value": "7db9e00b53901110a1d3ddeeff7b12b6", 
        "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_node/7db9e00b53901110a1d3ddeeff7b12b6" 
      }, 
      "sys_id": "39b9e00b53901110a1d3ddeeff7b12b7", 
      "sys_updated_by": "admin", 
      "cdm_app": { 
        "value": "62b517a953b70110a1d3ddeeff7b128c", 
        "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
      }, 
      "sys_created_on": "2022-06-29 12:53:57", 
      "cdi_usage": "0", 
      "name": "Dep-2", 
      "state": "active", 
      "sys_created_by": "admin" 
    } 
  ] 
}

CdmApplicationsApi – POST /sn_cdm/applications/deployables/create

Erstellt ein oder mehrere neue bereitstellbare Elemente.

Sie können eine von zwei Arten von bereitstellbaren Elementen erstellen:

Bereitstellbare Elemente, die manuell mit einem Anwendungsmodell (CI-Service) verbunden werden müssen
Bereitstellbare Elemente, die automatisch mit neuen, dynamisch erstellten Anwendungsmodellen (CI-Services) verbunden werden.

Sie können ein bereitstellbares Element für einen von drei Umgebungstypen erstellen: Entwicklung, Test oder Produktion. Beim Erstellen mehrerer bereitstellbarer Elemente folgen die automatisch generierten Namen der bereitstellbaren Elemente dem Muster: DeployableType_Number, wobei Number eine laufende Sequenznummer ist, die auf der Erstellung eines neuen bereitstellbaren Elements basiert. Wenn Sie beispielsweise drei bereitstellbare Elemente vom Typ Test in einem Endpunktaufruf erstellen, erhalten sie die Namen Test_1, Test_2 und Test_3. Wenn Sie dann den Endpunkt erneut aufrufen und ein anderes bereitstellbares Testelement erstellen, lautet der automatisch generierte Name Test_4. Diese Nummern werden nie wiederverwendet, auch wenn ein bereitstellbares Element gelöscht wird.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables/create

Standard-URL: /api/sn_cdm/applications/deployables/create

Unterstützte Anforderungsparameter

Tabelle : 49. Pfadparameter
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 : 50. Abfrageparameter
Name	Beschreibung
appSysId	Erforderlich. Sys_id einer aktiven CDM-Anwendung, die den bereitstellbaren Elementen zugeordnet werden soll. Datentyp: Zeichenfolge
autoConnect	Erforderlich. Kennzeichnung, die bestimmt, ob die neu erstellten bereitstellbaren Elemente automatisch mit dynamisch generierten Anwendungsmodellen verbunden werden sollen. Gültige Werte: true: Verbinden Sie die neu erstellten bereitstellbaren Elemente mit dynamisch generierten Anwendungsmodellen. false: Erstellen Sie einfach die bereitstellbaren Elemente. Diese bereitstellbaren Elemente müssen mithilfe der Benutzeroberfläche manuell Anwendungsmodellen zugeordnet werden. Datentyp: Boolesch
envType	Erforderlich. Umgebungstyp für das bereitstellbare Element Gültige Werte (Groß-/Kleinschreibung beachten): Entwicklung Produktion Test Hinweis: Der bereitstellbare Umgebungstyp kann nach der Erstellung nicht geändert werden. Datentyp: Zeichenfolge
quantity	Erforderlich. Anzahl der zu erstellenden bereitstellbaren Elemente. Datentyp: Zahl

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ützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützt nur 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 HTTP-Antwortcodesder REST-API.

Tabelle : 54. Statuscodes
Statuscode	Beschreibung
200	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
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" }`
Fehler.Detail	Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge
Ergebnis	Sys_ids der erstellten bereitstellbaren Elemente. Datentyp: Array
status	Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt, wie Sie ein einzelnes bereitstellbares Element erstellen und es einer vorhandenen CDM-Anwendung zuordnen.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/create?envType=Production&appSysId=5e118055b712011054c1e5a6ce11a9d4&quantity=5&autoConnect=true" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password'

Das Folgende zeigt die möglichen Antworten auf diesen Aufruf, sowohl als Erfolg als auch als Fehler.

// Successful completion of the upload request
{
  "result": [
    "8ba43a3db7d6011054c1e5a6ce11a9a4",
    "93a47a3db7d6011054c1e5a6ce11a90d",
    "dba47a3db7d6011054c1e5a6ce11a91d",
    "6fa47a3db7d6011054c1e5a6ce11a921",
    "efa47a3db7d6011054c1e5a6ce11a925"
  ]
} 

// Error response
{
  "error": {
    "message": "Error: CDM Application with SysID 5e118055b712011054c1e5a6ce11a9d1 was not found. (sys_script_include.8cf0fbf453626010a1d3ddeeff7b12fe.script; line 211)",
    "detail": ""
  },
  "status": "failure"
}

CdmApplicationsApi – POST /sn_cdm/applications/deployables/exports

Sendet eine Anforderung zum Exportieren des aktuellen Snapshots für eine angegebene Anwendung und ein oder mehrere bereitstellbare Elemente in die Tabelle „CDM-Exporteur-Cache“ [sn_cdm_exporter_cache].

Dieser Endpunkt gibt einen eindeutigen Bezeichner für die Anforderung zurück, den Sie dann zum Aufrufen des Endpunkts CdmApplicationsApi – GET /sn_cdm/applications/deployables/exports/{export_id}/status verwenden, um den Status des Exports abzurufen. Sobald der Export abgeschlossen ist, können Sie den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/deployables/exports/{export_id}/content verwenden, um die Konfigurationsdaten der zugehörigen Anwendung abzurufen.

Ein Snapshot ist das vollständige Datenmodell eines bereitstellbaren Elements zum Zeitpunkt der Übermittlung einer Konfigurationsänderung. Dies umfasst alle enthaltenen Komponenten, Sammlungen und Variablen sowie bereitstellbare spezifische Variablen und Überschreibungen. Weitere Informationen zu bereitstellbaren Elementen finden Sie unter Bereitstellbare Elemente erstellen und aktualisieren.

Hinweis:

Snapshots dürfen 10.000 Konfigurationsdatenelemente (CDIs) pro bereitstellbarem Element oder 100.000 CDIs pro Anwendung nicht überschreiten.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables/exports

Standard-URL: /api/sn_cdm/applications/deployables/exports

Unterstützte Anforderungsparameter

Tabelle : 55. Pfadparameter
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 : 56. Abfrageparameter
Name	Beschreibung
zusätzlicheBereitstellbare Elemente	Nicht primäre bereitstellbare Elemente zum Exportieren von. Datentyp: Array von Objekten `"additionalDeployables": [ { "app_name": "String", "deployable_name": "String" } ]` Beispiel: `[{'app_name':'TestApp', "deployable_name:'DEP-1'}]` Standard: Leeres Array – []
AdditionalDeployables.app_name	Erforderlich, wenn das Array additionalDeployables angegeben ist. Name der Anwendung, die dem bereitstellbaren Element zugeordnet ist, dessen Konfigurationsdaten Sie exportieren möchten. Datentyp: Zeichenfolge
AdditionalDeployables.deployable_name	Erforderlich, wenn das Array additionalDeployables angegeben ist. Name des nicht primären bereitstellbaren Elements, dessen Konfigurationsdaten Sie exportieren möchten. Datentyp: Zeichenfolge
appName	Erforderlich. Name der Anwendung, deren Konfigurationsdaten Sie exportieren möchten. Datentyp: Zeichenfolge
args	Ein JSON-Objekt, das Schlüssel-Wert-Paare für benutzerdefinierte Argumenteenthält. Datentyp: Objekt
dataFormat	Ausgabeformat der exportierten Daten. Gültige Werte (Groß-/Kleinschreibung beachten): ini json Eigenschaften unformatiert (Daten werden im Zeichenfolgenformat zurückgegeben) XML YAML Datentyp: Zeichenfolge Standard: json
bereitstellbarerName	Erforderlich. Name des bereitstellbaren Elements, dessen Konfigurationsdaten Sie exportieren möchten. Datentyp: Zeichenfolge
exporterName	Erforderlich. Name des Exporters, der zum Exportieren der Snapshot-Daten verwendet werden soll. Exporter sind für den Implementierer benutzerdefiniert. Weitere Informationen zum Erstellen eines benutzerdefinierten Exporters finden Sie unter Benutzerdefinierten Exporter erstellen. Datentyp: Zeichenfolge
einschränkenExport	Kennzeichnung, die angibt, ob der Endpunkt Snapshots beim Exportieren der Daten validiert. Gültige Werte: true: Snapshots validieren. false: Snapshots nicht validieren. Datentyp: Boolesch Standardwert: false
snapshotName	Name des zu exportierenden Snapshots. Dies kann nur einer der Snapshot-Namen sein, die dem bereitstellbaren Element zugeordnet sind, wie in deployableName oder additionalDeployables.deployable_nameangegeben. Standard: Der Endpunkt exportiert den zuletzt veröffentlichten Snapshot. Wenn kein veröffentlichter Snapshot vorhanden ist, gibt das System den Fehler „Fehler beim Finden des neuesten veröffentlichten Snapshots für bereitstellbares Element „{0}““ aus.

Tabelle : 57. 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 : 58. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützt nur application/json.

Tabelle : 59. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 60. Statuscodes
Statuscode	Beschreibung
200	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
400	Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. Mögliche Fehlermeldungen: Fehler: Erforderlicher Parameter „appName“ fehlt Fehler: Anwender verfügt nicht über die erforderliche Berechtigung zum Erstellen der Exportanforderung Fehler: Ungültiger boolescher Wert (<xyz> ).
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	Details zum aufgetretenen Fehler. `"error": { "detail": "String", "message": "String" }` Datentyp: Array
Fehler.Detail	Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge
export_id	Eindeutiger Bezeichner der Exportanforderung. Verwenden Sie diese ID beim Aufruf des Endpunkts CdmApplicationsApi – GET /sn_cdm/applications/deployables/exports/{export_id}/status, um den aktuellen Status der Exportanforderung zu überprüfen. Datentyp: Zeichenfolge
status	Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge

cURL-Anforderung

Im folgenden Beispiel wird der Export der Konfigurationsdaten für Folgendes angefordert: Anwendungsname = TestAppA, Name des bereitstellbaren Elements = DEP, mit dem Exporter = exporter-1-primary_deployable.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/exports?appName=TestAppA&args=%7B%22arg_A_required%22%20%3A%20%22value%20A%22%7D&exporterName=exporter-1-primary_deployable&deployableName=DEP1" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password'

Gibt den eindeutigen Bezeichner der Exportanforderung zurück.

{ 
  "result": {
    "export_id": "64b5f79f5379301096edddeeff7b12eb" 
  } 
}

CdmApplicationsApi – POST /sn_cdm/applications/shared_components

Ordnet die angegebene gemeinsam genutzte Komponente der Anwendung innerhalb eines angegebenen Changesets zu.

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

Hinweis:

Der angegebenen gemeinsam genutzten Komponente muss eine veröffentlichte Version (Snapshot) zugeordnet sein.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/shared_components

Standard-URL: /api/sn_cdm/applications/shared_components

Unterstützte Anforderungsparameter

Tabelle : 61. Pfadparameter
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 : 62. Abfrageparameter
Name	Beschreibung
appName	Erforderlich. Name der Anwendung, die der gemeinsam genutzten Komponente zugeordnet werden soll. Datentyp: Zeichenfolge
changesetNumber	Erforderlich. Eindeutiger Bezeichner des Changesets, das der Komponente zugeordnet ist. Datentyp: Zeichenfolge
returnFields	Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt
sharedComponentName	Erforderlich. Name der gemeinsam genutzten Komponente, die der angegebenen Anwendung zugeordnet werden soll. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente“ [sn_cdm_shared_component]. Datentyp: Zeichenfolge
sharedLibraryName	Erforderlich. Name der gemeinsamen Bibliothek, unter der die Komponente erstellt werden soll. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. In der gemeinsamen Bibliothek müssen die folgenden Felder wie folgt definiert sein: Status = aktiv verfügbar = true Typ = shared_library Datentyp: Zeichenfolge

Tabelle : 63. 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 : 64. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json

Tabelle : 65. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 66. Statuscodes
Statuscode	Beschreibung
200	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
400	Ungültige Anforderung. Das übergebene Changeset ist nicht vorhanden.
500	Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

Parameter des Antwort-Haupttexts

Die Antwortfelder hängen davon ab, welche Felder im Parameter returnFields in der Anforderung angegeben wurden. Im Folgenden werden einige der wichtigeren Felder beschrieben.


Name	Beschreibung
changeset_id	Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt `"changeset_id": { "link": "String", "value": "String" }`
changeset_id.link	Ruft die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge
changeset_id.value	Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge
Beschreibung	Beschreibung des CDM-Knotens. Datentyp: Zeichenfolge
Fehler	Wird nur zurückgegeben, wenn während der Verarbeitung ein Fehler aufgetreten ist. Datentyp: Objekt `"error": { "detail": "String", "message": "String" }`
Fehler.Detail	Details zum aufgetretenen Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Meldung, die eine Übersicht über den Fehler bietet. Datentyp: Zeichenfolge
linked_to	ID des Hauptknotens, der der gemeinsam genutzten Komponente zugeordnet ist. Datentyp: Zeichenfolge
linked_to_version	Details des dem Knoten zugeordneten CDM-Snapshot-Datensatzes. Datentyp: Objekt `"linked_to_version": { "link": "String", "value": "String" }`
linked_to_version.link	Ruft die Syntax zum Abfragen dieses Versionsdatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge
linked_to_version.value	Sys_id des Versionsdatensatzes. Datentyp: Zeichenfolge
Haupt	Kennzeichnung, die angibt, ob der zugeordnete Snapshot veröffentlicht wurde. Gültige Werte: true: Snapshot wurde veröffentlicht. false: Snapshot wurde nicht veröffentlicht.
main_id	Eindeutige ID des neu erstellten Hauptknotens. Datentyp: Zeichenfolge
main_id_encoded	Codierte ID des neu erstellten Hauptknotens. Datentyp: Zeichenfolge
Name	Name des CDM-Knotens. Datentyp: Zeichenfolge
Knoten	Sys_id des gemeinsam genutzten Komponentenknotens. Datentyp: Zeichenfolge
node_path	Pfad zum neuen verknüpften Knoten, der beim Hinzufügen der gemeinsam genutzten Komponente erstellt wurde. Datentyp: Zeichenfolge
status	Status des Knotens. Mögliche Werte: Neu Datentyp: Zeichenfolge
sys_created_by	Benutzername des Benutzers, der den CDM-Knoten erstellt. Beispiel: able.tuter. Datentyp: Zeichenfolge
sys_created_on	Datum und Uhrzeit der Erstellung des CDM-Knotens. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge
sys_id	Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten“ [sn_cdm_node]. Datentyp: Zeichenfolge
sys_updated_by	Benutzername des Benutzers, der den CDM-Knoten zuletzt aktualisiert hat. Beispiel: able.tuter. Datentyp: Zeichenfolge
sys_updated_on	Datum und Uhrzeit der letzten Aktualisierung des CDM-Knotens. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge
type	Knotentyp Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt, wie dieser Endpunkt aufgerufen wird, um die Anwendung „App1“ der gemeinsam genutzten Komponente „paymentService-V1.1“ unter der gemeinsam genutzten Bibliothek „OracleG-Bibliothek-10“ innerhalb des Changesets „Chset-20“ zuzuordnen.

curl "https://instance.servicenow.com/api/sn_cdm/applications/shared_components?appName=App1&changesetNumber=Chset-20&sharedLibraryName=OracleG-Library-10&sharedComponentName=paymentService-V1.1" \ 
--request POST \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Antwort:

{ 
  "result": { 
    "changeset_id": { 
      "value": "74b7ff6fc33711100c257e2cc840dd6b", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/74b7ff6fc33711100c257e2cc840dd6b" 
    }, 
    "node_path": "!,0!,1!/D", 
    "description": null, 
    "sys_updated_on": "2022-12-22 17:07:29", 
    "type": "sn_cdm_node_linked_shared_component", 
    "sys_class_name": "sn_cdm_node", 
    "sys_id": "ff8b37ebc3b711100c257e2cc840ddba", 
    "sys_updated_by": "admin", 
    "previous_version": null, 
    "sys_created_on": "2022-12-22 17:07:29", 
    "value": null, 
    "effective_from": null, 
    "linked_to": "210", 
    "sys_created_by": "admin", 
    "restricted_to": null, 
    "linked_to_version": { 
      "value": "581fc3e9c3b311100c257e2cc840dd17", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_snapshot/581fc3e9c3b311100c257e2cc840dd17" 
    }, 
    "level": "2", 
    "conflict_type": null, 
    "main_id": "483",
    "effective_to": null,
    "secure_value": null, 
    "node_classifier": "/application/components", 
    "main_id_encoded": "/D",
    "name": "LIB2_C",
    "position": null,
    "reason_for_conflict": null,
    "system_folder": false,
    "status": "new",
    "conflict": false
  } 
}

CdmApplicationsApi – POST /sn_cdm/applications/uploads/components

Sendet eine Anforderung zum Hochladen der übergebenen Konfigurationsdaten für eine bestimmte Komponente im Systemkomponentenordner für die angegebene Anwendung.

Dieser Endpunkt gibt die ID der Upload-Anforderung zurück. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen.

Hinweis:

Die maximale Standardgröße für Upload-Inhalte beträgt 2 MB. Sie können diesen Standard ändern, indem Sie die Eigenschaft sn_cdm.max_allowed_upload_file_size aktualisieren.

Die folgende Abbildung zeigt ein Beispiel dafür, wo die Komponentenkonfigurationsdaten in Bezug auf die ServiceNow DevOps Config -UI hochgeladen werden. Angenommen, die Komponente ist dbComponent und die Anwendung ist paymentSvc.

Beispielkonfiguration des Inhaltsorts in der Benutzeroberfläche

Hinweis:

Diese Upload-Methode kann nicht zum Ändern von Knoten verwendet werden. Verwenden Sie die alternative Methode CdmApplicationsApi – POST sn_cdm/applications/uploads/components/file, um Knoten zu ändern.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/uploads/components

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

Unterstützte Anforderungsparameter

Tabelle : 67. Pfadparameter
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 : 68. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload 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: true: Vorhandene Knoten automatisch löschen. false: Vorhandene Knoten nicht automatisch löschen. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
dataFormat	Erforderlich. Format der Konfigurationsdaten. Gültige Werte: CSV ini json Eigenschaften unformatiert XML YAML Datentyp: Zeichenfolge
dataFormatAttribute	Wird nur unterstützt, wenn der Parameter dataFormat auf `csv`festgelegt ist. Attribute, die das CSV-Datenformat definieren. Weitere Informationen finden Sie unter . Datentyp: Objekt `"dataFormatAttributes" { "containsHeader": Boolean, "delimeter": "String" "headers": [Array], "securedHeaders": [Array] }`
dataFormatAttribute.containsHeaders	Kennzeichnung, die angibt, ob die Daten eine Headerzeile enthalten. Gültige Werte: true: Daten enthalten eine Kopfzeile. Die erste Zeile in den Daten wird als Header-Zeile betrachtet. false: Daten enthalten keine Headerzeile. Sie müssen die Header-Informationen im Parameter dataFormatAttributes.headers übergeben. Datentyp: Boolesch Standardwert: false
dataFormatAttributes.delimeter	Zeichen, das zum Begrenzen von Feldern in den Daten verwendet werden soll. Datentyp: Zeichenfolge Standard: Komma ","
dataFormatAttributes.headers	Erforderlich, wenn Parameter dataFormatAttributes.containsHeaders auf „ `false`“ festgelegt ist. Felder in den Daten, aus denen sich der Header zusammensetzt. Diese Kopfzeilen werden in die Schlüsselnamen der CDIs im JSON-Format konvertiert. Die Anzahl der Kopfzeilen muss mit der Anzahl der Datensatzfelder übereinstimmen. Datentyp: Array Standard: Leeres Array
dataFormatAttributes.secureHeaders	Felder in den Daten, die sichere Felder sind und in den nach CDMhochgeladenen Daten verschlüsselt werden müssen. Der Name der gesicherten Header muss mit dem Namen der Header im Header-Attribut oder in der Datendatei übereinstimmen. Diese Felder werden in einer Spalte vom Typ Passwort (2-fach verschlüsselt) gespeichert. Hinweis: Sie können Felder nur mit diesem Attribut sichern. Sie können die Sicherung der gesicherten Felder nicht aufheben. Datentyp: Array Standard: Leeres Array
deleteRedundantOverrides	Kennzeichnung, die angibt, ob eine Überschreibung erstellt werden soll, wenn redundante Werte vorhanden sind. Gültige Werte: true: Wenn redundante Werte vorhanden sind, wird keine Überschreibung erstellt. false: Wenn redundante Werte vorhanden sind, wird mit einer Überschreibung fortgefahren. Standardwert: true
fileName	Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .txt/.scv/.jar. Der Wert fileName 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
IdentifierKeys	Liste der Namen, die angeben, welcher Schlüssel in einem untergeordneten Array-Element zum Identifizieren desselben Knotens verwendet werden soll. Zum Beispiel, wenn Sie Folgendes hochladen: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` im folgenden vorhandenen Modell: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` und Sie identifierKeys auf `name`festlegen, wird die folgende Ausgabe erzeugt: `[ {"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
ignoreAttribute	Kennzeichnung, die angibt, ob das angegebene Datenformat Attribute unterstützt (derzeit nur XML). Gültige Werte: true: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten während des Uploads übersprungen. false: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten in den Upload einbezogen. Datentyp: Boolesch Standardwert: false
namePath	Pfad des Zielknotens, unter den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge
sharedLibraryName	Erforderlich. Name der gemeinsamen Bibliothek, in der sich die zu löschende Komponente befindet. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge

Tabelle : 69. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Dies können beliebige Daten in dem Format sein, das durch den Parameter dataFormat der Abfrageparameter definiert ist.

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 : 70. Anforderungskopfzeilen.
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützte Typen: text/plain und application/x-www-form-urlencoded. Standard: text/plain

Tabelle : 71. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 72. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt eine Upload-Anforderung für die Anwendung Demo_App1631126164773.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/components?namePath=%2FSettings%2FdbSettings&dataFormat=json&appName=Demo_App1631126164773&changesetNumber=Chset-8&autoCommit=false&publishOption=publish_none&autoValidate=false&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 für diese Anforderung.

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

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi – POST sn_cdm/applications/uploads/components/file

Lädt Dateien als Teil des Configuration Data Model (CDM) in den Komponentenordner hoch.

Verwenden Sie diese Methode, um in einen Komponentendateiknoten hochzuladen.

URL-Format

Versionierte URL: POST /api/sn_cdm/{api_version}/applications/uploads/components/file

Standard-URL: POST /api/sn_cdm/applications/uploads/components/file

Unterstützte Anforderungsparameter

Tabelle : 73. Pfadparameter
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 : 74. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload nicht bestätigt. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
fileName	Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .txt/.scv/.jar. Der Wert fileName 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 den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge
veröffentlichenOption	Veröffentlichungsoption für die zugeordneten konfigurierten Snapshots. Gültige Werte: veröffentlichen_none: Keine Snapshots veröffentlichen. veröffentlichen_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Snapshots veröffentlichen oder Veröffentlichung aufheben. Datentyp: Zeichenfolge Standard: veröffentlichen_none Hinweis: Diese Option ist nur verfügbar, wenn der Wert für den Parameter autoCommit „ true“ ist.

Tabelle : 75. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Standardmäßig ist die Dateigröße für Uploads auf 5 MB beschränkt. Informationen zum Anpassen der Größen und des Typs der Upload-Datei finden Sie unter Now Support Artikel. Datentyp: Zeichenfolge/Stream

Header

Tabelle : 76. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json
Content-Type	Datentyp der hochzuladenden Datei. Unterstützte Typen: application/zip, text/plain, application/json. Standard: application/json

Tabelle : 77. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 78. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt, wie ein Inhalt in eine Textdatei hochgeladen wird.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/components/file?autoValidate=true&appName=testApp&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 für 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"
}

CdmApplicationsApi – POST /sn_cdm/applications/uploads/components/vars

Sendet eine Anforderung zum Hochladen der übergebenen Konfigurationsdaten im Ordner „vars“ im Ordner „Systemkomponenten“ für die angegebene Anwendung.

Die folgende Abbildung zeigt ein Beispiel dafür, wo die vars-Konfigurationsdaten der Komponente in Bezug auf die ServiceNow DevOps Config Workspace-UI hochgeladen werden. Angenommen, die Anwendung ist „paymentSvc“.

Laden Sie das vars-Verzeichnis hoch

Hinweis:

Die maximale Standardgröße für Upload-Inhalte beträgt 2 MB. Sie können diesen Standard ändern, indem Sie die Eigenschaft sn_cdm.max_allowed_upload_file_size aktualisieren.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/uploads/components/vars

Standard-URL: /api/sn_cdm/applications/uploads/components/vars

Unterstützte Anforderungsparameter

Tabelle : 79. Pfadparameter
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 : 80. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload 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: true: Vorhandene Knoten automatisch löschen. false: Vorhandene Knoten nicht automatisch löschen. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
dataFormat	Erforderlich. Format der Konfigurationsdaten. Gültige Werte: ini json Eigenschaften unformatiert XML YAML Datentyp: Zeichenfolge
deleteRedundantOverrides	Kennzeichnung, die angibt, ob eine Überschreibung erstellt werden soll, wenn redundante Werte vorhanden sind. Gültige Werte: true: Wenn redundante Werte vorhanden sind, wird keine Überschreibung erstellt. false: Wenn redundante Werte vorhanden sind, wird mit einer Überschreibung fortgefahren. Standardwert: true
fileName	Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .txt/.scv/.jar. Der Wert fileName 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
IdentifierKeys	Liste der Namen, die angeben, welcher Schlüssel in einem untergeordneten Array-Element zum Identifizieren desselben Knotens verwendet werden soll. Zum Beispiel, wenn Sie Folgendes hochladen: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` im folgenden vorhandenen Modell: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` und Sie identifierKeys auf `name`festlegen, wird die folgende Ausgabe erzeugt: `[ {"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
ignoreAttribute	Kennzeichnung, die angibt, ob das angegebene Datenformat Attribute unterstützt (derzeit nur XML). Gültige Werte: true: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten während des Uploads übersprungen. false: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten in den Upload einbezogen. Datentyp: Boolesch Standardwert: false
namePath	Pfad des Zielknotens, unter den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge
sharedLibraryName	Erforderlich. Name der gemeinsamen Bibliothek, in der sich die zu löschende Komponente befindet. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge

Tabelle : 81. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Dies können beliebige Daten in dem Format sein, das durch den Parameter dataFormat der Abfrageparameter definiert ist.

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 : 82. Anforderungskopfzeilen.
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützte Typen: text/plain und application/x-www-form-urlencoded. Standard: text/plain

Tabelle : 83. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 84. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt eine vars-Upload-Anforderung für die Anwendung Demo_App1631126164773.

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

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

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

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi – POST /sn_cdm/applications/uploads/collections

Sendet eine Anforderung zum Hochladen der übergebenen Konfigurationsdaten für eine bestimmte Sammlung im Systemsammlungsordner für die angegebene Anwendung.

Dieser Endpunkt gibt die ID der Upload-Anforderung zurück. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen.

Hinweis:

Die maximale Standardgröße für Upload-Inhalte beträgt 2 MB. Sie können diesen Standard ändern, indem Sie die Eigenschaft sn_cdm.max_allowed_upload_file_size aktualisieren.

Die folgende Abbildung zeigt ein Beispiel dafür, wo die Konfigurationsdaten in Bezug auf die ServiceNow DevOps Config Workspace-UI hochgeladen werden. Angenommen, die Sammlung ist db0Release1.0 und die Anwendung ist paymentSvc.

Upload-Ordner für Sammlungen

Hinweis:

Diese Upload-Methode kann nicht zum Ändern von Knoten verwendet werden. Verwenden Sie die alternative Methode CdmApplicationsApi – POST /sn_cdm/applications/uploads/collections/file, um Knoten zu ändern.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/uploads/collections

Standard-URL: /api/sn_cdm/applications/uploads/collections

Unterstützte Anforderungsparameter

Tabelle : 85. Pfadparameter
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 : 86. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload 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: true: Vorhandene Knoten automatisch löschen. false: Vorhandene Knoten nicht automatisch löschen. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
collectionName	Erforderlich. Name der Sammlung, unter der die hochgeladene Nutzlast gespeichert werden soll. Hinweis: Wenn der angegebene namePath in dieser Sammlung nicht vorhanden ist, erstellt das System automatisch die Komponente(n) in dieser Sammlung und lädt dann den Konfigurationsinhalt hoch. Wenn Sie beispielsweise die Sammlung `collA`mit dem Pfad `„compA/comp/compC“`hochladen möchten, werden die Daten unter `/collA/collections/compa/compB/compC hochgeladen`. Wenn `comA` vorhanden ist, aber nicht `comB` und `comC`, erstellt der Endpunkt diese Komponenten und lädt die Daten unter `comC hoch`. Datentyp: Zeichenfolge
dataFormat	Erforderlich. Format der Konfigurationsdaten. Gültige Werte: CSV ini json Eigenschaften unformatiert XML YAML Datentyp: Zeichenfolge
dataFormatAttribute	Wird nur unterstützt, wenn der Parameter dataFormat auf `csv`festgelegt ist. Attribute, die das CSV-Datenformat definieren. Weitere Informationen finden Sie unter . Datentyp: Objekt `"dataFormatAttributes" { "containsHeader": Boolean, "delimeter": "String" "headers": [Array], "securedHeaders": [Array] }`
dataFormatAttribute.containsHeaders	Kennzeichnung, die angibt, ob die Daten eine Headerzeile enthalten. Gültige Werte: true: Daten enthalten eine Kopfzeile. Die erste Zeile in den Daten wird als Header-Zeile betrachtet. false: Daten enthalten keine Headerzeile. Sie müssen die Header-Informationen im Parameter dataFormatAttributes.headers übergeben. Datentyp: Boolesch Standardwert: false
dataFormatAttributes.delimeter	Zeichen, das zum Begrenzen von Feldern in den Daten verwendet werden soll. Datentyp: Zeichenfolge Standard: Komma ","
dataFormatAttributes.headers	Erforderlich, wenn Parameter dataFormatAttributes.containsHeaders auf „ `false`“ festgelegt ist. Felder in den Daten, aus denen sich der Header zusammensetzt. Diese Kopfzeilen werden in die Schlüsselnamen der CDIs im JSON-Format konvertiert. Die Anzahl der Kopfzeilen muss mit der Anzahl der Datensatzfelder übereinstimmen. Datentyp: Array Standard: Leeres Array
dataFormatAttributes.secureHeaders	Felder in den Daten, die sichere Felder sind und in den nach CDMhochgeladenen Daten verschlüsselt werden müssen. Der Name der gesicherten Header muss mit dem Namen der Header im Header-Attribut oder in der Datendatei übereinstimmen. Diese Felder werden in einer Spalte vom Typ Passwort (2-fach verschlüsselt) gespeichert. Hinweis: Sie können Felder nur mit diesem Attribut sichern. Sie können die Sicherung der gesicherten Felder nicht aufheben. Datentyp: Array Standard: Leeres Array
deleteRedundantOverrides	Kennzeichnung, die angibt, ob eine Überschreibung erstellt werden soll, wenn redundante Werte vorhanden sind. Gültige Werte: true: Wenn redundante Werte vorhanden sind, wird keine Überschreibung erstellt. false: Wenn redundante Werte vorhanden sind, wird mit einer Überschreibung fortgefahren. Standardwert: true
ignoreAttribute	Kennzeichnung, die angibt, ob das angegebene Datenformat Attribute unterstützt (derzeit nur XML). Gültige Werte: true: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten während des Uploads übersprungen. false: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten in den Upload einbezogen. Datentyp: Boolesch Standardwert: false
namePath	Pfad des Zielknotens, unter den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge

Tabelle : 87. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Dies können beliebige Daten in dem Format sein, das durch den Parameter dataFormat der Abfrageparameter definiert ist.

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 : 88. Anforderungskopfzeilen.
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützte Typen: text/plain und application/x-www-form-urlencoded. Standard: text/plain

Tabelle : 89. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 90. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Dieses Beispiel zeigt, wie das JSON-formatierte dbSettings Konfigurationsdatum in den Sammlungsordner für die Anwendung Demo_App1631126164773 hochgeladen wird.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/collections?dataFormat=json&autoValidate=false&changesetNumber=Chset-102&appName=Demo_App1631126164773&autoDelete=true&namePath=%2FSettings%2FdbSettings&collectionName=release-1.0&autoCommit=false&publishOption=publish_none" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "{ 
  \"dbSettings\": { 
    \"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'

Das Folgende zeigt die möglichen Antworten auf diesen Aufruf, sowohl als Erfolg als auch als Fehler.

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

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi – POST /sn_cdm/applications/uploads/collections/file

Lädt eine Datei in den Sammlungsordner im Configuration Data Model (CDM) hoch.

URL-Format

Versionierte URL: POST /api/sn_cdm/{api_version}/applications/uploads/collections/file

Standard-URL: POST /api/sn_cdm/applications/uploads/collections/file

Unterstützte Anforderungsparameter

Tabelle : 91. Pfadparameter
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 : 92. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload nicht bestätigt. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
collectionName	Erforderlich. Name der Sammlung, unter der die hochgeladene Nutzlast gespeichert werden soll. Hinweis: Wenn der angegebene `namePath` in dieser Sammlung nicht vorhanden ist, erstellt das System automatisch die Komponente(n) in dieser Sammlung und lädt dann den Konfigurationsinhalt hoch. Wenn Sie beispielsweise die Sammlung `collA`mit dem Pfad `„compA/comp/compC“`hochladen möchten, werden die Daten unter `/collA/collections/compa/compB/compC hochgeladen`. Wenn `comA` vorhanden ist, aber nicht `comB` und `comC`, erstellt der Endpunkt diese Komponenten und lädt die Daten unter `comC hoch`. Datentyp: Zeichenfolge
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
fileName	Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .txt/.scv/.jar. Der Wert fileName 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 den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge
veröffentlichenOption	Veröffentlichungsoption für die zugeordneten konfigurierten Snapshots. Gültige Werte: veröffentlichen_none: Keine Snapshots veröffentlichen. veröffentlichen_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Snapshots veröffentlichen oder Veröffentlichung aufheben. Datentyp: Zeichenfolge Standard: veröffentlichen_none Hinweis: Diese Option ist nur verfügbar, wenn der Wert für den Parameter autoCommit „ true“ ist.

Tabelle : 93. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Standardmäßig ist die Dateigröße für Uploads auf 5 MB beschränkt. Informationen zum Anpassen der Größen und des Typs der Upload-Datei finden Sie unter Now Support Artikel. Datentyp: Zeichenfolge/Stream

Header

Tabelle : 94. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json
Content-Type	Inhaltstyp der hochzuladenden Datei. Beispiele: application/zip, text/plain, application/json.

Tabelle : 95. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 96. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Mit dem folgenden Aufruf wird eine Nur-Text-Datei in den CDM-Sammlungsordner hochgeladen.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/collections/file?autoValidate=true&collectionName=collA&appName=testApp&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"
}

CdmApplicationsApi – POST /sn_cdm/applications/uploads/deployables

Sendet eine Anforderung zum Hochladen des Konfigurationsinhalts für ein bestimmtes bereitstellbares Element im Systemordner für bereitstellbare Elemente einer angegebenen Anwendung.

Dieser Endpunkt gibt die ID der Upload-Anforderung zurück. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen.

Hinweis:

Die maximale Standardgröße für Upload-Inhalte beträgt 2 MB. Sie können diesen Standard ändern, indem Sie die Eigenschaft sn_cdm.max_allowed_upload_file_size aktualisieren.

Die folgende Abbildung zeigt ein Beispiel dafür, wo die bereitstellbaren Konfigurationsdaten in Bezug auf die ServiceNow DevOps Config -UI hochgeladen werden. Angenommen, das bereitstellbare Element ist Development_1 und die Anwendung ist paymentSvc.

Speicherort der Konfigurationsdaten für bereitstellbare Elemente in der Benutzeroberfläche

Hinweis:

Diese Upload-Methode kann nicht zum Ändern von Knoten verwendet werden. Verwenden Sie die alternative Methode CdmApplicationsApi – POST /sn_cdm/applications/uploads/deployables/file, um Knoten zu ändern.

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/uploads/deployables

Standard-URL: /api/sn_cdm/applications/uploads/deployables

Unterstützte Anforderungsparameter

Tabelle : 97. Pfadparameter
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 : 98. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload 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: true: Vorhandene Knoten automatisch löschen. false: Vorhandene Knoten nicht automatisch löschen. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
dataFormat	Erforderlich. Format der Konfigurationsdaten. Gültige Werte: CSV ini json Eigenschaften unformatiert XML YAML Datentyp: Zeichenfolge
dataFormatAttribute	Wird nur unterstützt, wenn der Parameter dataFormat auf `csv`festgelegt ist. Attribute, die das CSV-Datenformat definieren. Weitere Informationen finden Sie unter . Datentyp: Objekt `"dataFormatAttributes" { "containsHeader": Boolean, "delimeter": "String" "headers": [Array], "securedHeaders": [Array] }`
dataFormatAttribute.containsHeaders	Kennzeichnung, die angibt, ob die Daten eine Headerzeile enthalten. Gültige Werte: true: Daten enthalten eine Kopfzeile. Die erste Zeile in den Daten wird als Header-Zeile betrachtet. false: Daten enthalten keine Headerzeile. Sie müssen die Header-Informationen im Parameter dataFormatAttributes.headers übergeben. Datentyp: Boolesch Standardwert: false
dataFormatAttributes.delimeter	Zeichen, das zum Begrenzen von Feldern in den Daten verwendet werden soll. Datentyp: Zeichenfolge Standard: Komma ","
dataFormatAttributes.headers	Erforderlich, wenn Parameter dataFormatAttributes.containsHeaders auf „ `false`“ festgelegt ist. Felder in den Daten, aus denen sich der Header zusammensetzt. Diese Kopfzeilen werden in die Schlüsselnamen der CDIs im JSON-Format konvertiert. Die Anzahl der Kopfzeilen muss mit der Anzahl der Datensatzfelder übereinstimmen. Datentyp: Array Standard: Leeres Array
dataFormatAttributes.secureHeaders	Felder in den Daten, die sichere Felder sind und in den nach CDMhochgeladenen Daten verschlüsselt werden müssen. Der Name der gesicherten Header muss mit dem Namen der Header im Header-Attribut oder in der Datendatei übereinstimmen. Diese Felder werden in einer Spalte vom Typ Passwort (2-fach verschlüsselt) gespeichert. Hinweis: Sie können Felder nur mit diesem Attribut sichern. Sie können die Sicherung der gesicherten Felder nicht aufheben. Datentyp: Array Standard: Leeres Array
deleteRedundantOverrides	Kennzeichnung, die angibt, ob eine Überschreibung erstellt werden soll, wenn redundante Werte vorhanden sind. Gültige Werte: true: Wenn redundante Werte vorhanden sind, wird keine Überschreibung erstellt. false: Wenn redundante Werte vorhanden sind, wird mit einer Überschreibung fortgefahren. Standardwert: true
bereitstellbarerName	Erforderlich. Name des bereitstellbaren Elements, unter dem die hochgeladene Nutzlast gespeichert werden soll. Hinweis: Wenn der angegebene namePath unter diesem bereitstellbaren Element nicht vorhanden ist, erstellt das System automatisch die Komponente(n) unter diesem bereitstellbaren Element und lädt dann den Konfigurationsinhalt hoch.
IdentifierKeys	Liste der Namen, die angeben, welcher Schlüssel in einem untergeordneten Array-Element zum Identifizieren desselben Knotens verwendet werden soll. Zum Beispiel, wenn Sie Folgendes hochladen: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` im folgenden vorhandenen Modell: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` und Sie identifierKeys auf `name`festlegen, wird die folgende Ausgabe erzeugt: `[ {"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
ignoreAttribute	Kennzeichnung, die angibt, ob das angegebene Datenformat Attribute unterstützt (derzeit nur XML). Gültige Werte: true: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten während des Uploads übersprungen. false: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten in den Upload einbezogen. Datentyp: Boolesch Standardwert: false
namePath	Pfad des Zielknotens, unter den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge
veröffentlichenOption	Veröffentlichungsoption für die zugeordneten konfigurierten Snapshots. Gültige Werte: veröffentlichen_none: Keine Snapshots veröffentlichen. veröffentlichen_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Snapshots veröffentlichen oder Veröffentlichung aufheben. Datentyp: Zeichenfolge Standard: veröffentlichen_none Hinweis: Diese Option ist nur verfügbar, wenn der Wert für den Parameter autoCommit „ true“ ist.

Tabelle : 99. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Dies können beliebige Daten in dem Format sein, das durch den Parameter dataFormat der Abfrageparameter definiert ist.

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 : 100. Anforderungskopfzeilen.
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützt nur application/json.
Content-Type	Datenformat des Anforderungstexts. Unterstützte Typen: text/plain und application/x-www-form-urlencoded. Standard: text/plain

Tabelle : 101. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 102. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt eine Upload-Anforderung für die Anwendung Demo_App1631126164773.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/deployables?deployableName=TST-1&autoValidate=false&dataFormat=json&autoDelete=false&changesetNumber=Chset-102&appName=Demo_App1631126164773&publishOption=publish_none&autoCommit=true&namePath=%2FSettings%2FdbSettings" \ 
--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 für diese Anforderung.

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

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi – POST /sn_cdm/applications/uploads/deployables/file

Lädt Dateien in den Ordner „Bereitstellbare Elemente“ im Configuration Data Model (CDM) hoch.

URL-Format

Versionierte URL: POST /api/sn_cdm/{api_version}/applications/uploads/deployables/file

Standard-URL: POST /api/sn_cdm/applications/uploads/deployables/file

Unterstützte Anforderungsparameter

Tabelle : 103. Pfadparameter
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 : 104. Abfrageparameter
Name	Beschreibung
appName	Name der Anwendung, die den Konfigurationsdaten zugeordnet werden soll. Diese Anwendung muss sich im Status „Aktiv“ befinden. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. Datentyp: Zeichenfolge
autoCommit	Kennzeichnung, die angibt, ob das im Parameter changesetNumber identifizierte Changeset nach dem Upload an das Datenmodell übergeben wird. Gültige Werte: true: Changeset wird nach dem Upload committet. „false“: Changeset wird nach dem Upload nicht bestätigt. Datentyp: Boolesch Standardwert: false
autoValidieren	Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden. Gültige Werte: true: Validiert die Snapshots. false: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn der Parameter autoCommit den Wert `true`hat. Datentyp: Boolesch Standardwert: false
changesetNumber	Zeichenfolge, die das mit der Anwendung verknüpfte Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen“ befinden. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil der CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} -Ergebnisse zurückgegeben.
bereitstellbarerName	Erforderlich. Name des bereitstellbaren CDM, für den die Richtlinie zugeordnet werden soll. Befindet sich in der Tabelle „Bereitstellbares CDM“ [sn_cdm_deployable]. Datentyp: Zeichenfolge
fileName	Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .txt/.scv/.jar. Der Wert fileName 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 den die Konfigurationsdaten hochgeladen werden sollen Dieser Pfad ist relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. So definieren Sie beispielsweise den Namenspfad für den Knoten `testApp/deployables/Development1/cdi1`: Backslash-Format: testApp/deployables/Development1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich („/“) enthält, können Sie dieses Format nicht verwenden. Back-End-Namenspfad mit Ersetzungszeichen: testAppdeployablesDevelopment1cdi1 Array: ['testApp','bereitstellbare Elemente','Entwicklung1','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. Datentyp: Zeichenfolge
veröffentlichenOption	Veröffentlichungsoption für die zugeordneten konfigurierten Snapshots. Gültige Werte: veröffentlichen_none: Keine Snapshots veröffentlichen. veröffentlichen_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter Snapshots veröffentlichen oder Veröffentlichung aufheben. Datentyp: Zeichenfolge Standard: veröffentlichen_none Hinweis: Diese Option ist nur verfügbar, wenn der Wert für den Parameter autoCommit „ true“ ist.

Tabelle : 105. Anforderungstextparameter (XML oder JSON)
Name	Beschreibung
Variablen-Upload-Daten	Hochzuladende Konfigurationsdaten. Standardmäßig ist die Dateigröße für Uploads auf 5 MB beschränkt. Informationen zum Anpassen der Größen und des Typs der Upload-Datei finden Sie unter Now Support Artikel. Datentyp: Zeichenfolge/Stream

Header

Tabelle : 106. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json
Content-Type	Datentyp der hochzuladenden Datei. Unterstützte Typen: application/zip, text/plain, application/json. Standard: application/json

Tabelle : 107. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 108. 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.

Antworttextparameter (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" }`
Fehler.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
hochgeladene ID	Sys_id der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt CdmApplicationsApi – GET /sn_cdm/applications/upload-status/{upload_id} aufzurufen und den Status des Uploads abzurufen. Datentyp: Zeichenfolge

cURL-Anforderung

Die folgende Anforderung lädt eine Nur-Text-Datei in den Ordner „Bereitstellbare Elemente“ der CDM-Anwendung.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/deployables/file?autoValidate=true&deployableName=depA&appName=testApp&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"
}

CdmApplicationsApi – PUT /sn_cdm/applications/deployables

Aktualisiert die angegebene gemeinsam genutzte Komponente in einer Anwendung innerhalb eines angegebenen Changesets.

Ermöglicht eine Aktualisierung der folgenden Felder:

Name
Beschreibung
Anwendungsservice\Dynamische CI-Gruppe
Bereitstellbarer Bezeichner

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

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/deployables

Standard-URL: /api/sn_cdm/applications/deployables

Unterstützte Anforderungsparameter

Tabelle : 109. Pfadparameter
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 : 110. Abfrageparameter
Name	Beschreibung
appName	Erforderlich. Name der CDM-Anwendung. Datentyp: Zeichenfolge
Name	Erforderlich. Name des bereitstellbaren CDM. Datentyp: Zeichenfolge
neueBeschreibung	Optional. Eine Beschreibung für das bereitstellbare CDM. Datentyp: Zeichenfolge
neueServiceId	Optional. ID des gewünschten Anwendungsservice/der dynamischen CI-Gruppe. Geben Sie in der cURL-Anforderung `„“` an, um das bereitstellbare Element vom Service zu trennen.
newIdentifier	Optional. Bezeichner des bereitstellbaren Elements. Datentyp: Auswahl (Entwicklung/Test/Produktion
neuerName	Optional. Der neue Name des bereitstellbaren Elements. Datentyp: Zeichenfolge
returnFields	Optional. Kommagetrennte Liste von Feldern, die als Teil der Antwort zurückgegeben werden sollen.

Tabelle : 111. 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 : 112. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json

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-Antwortcodesder REST-API.

Tabelle : 113. Statuscodes
Statuscode	Beschreibung
200	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
400	Ungültige 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.

Antworttextparameter (JSON oder XML)


Name	Beschreibung
sys_id	CDM – Bereitstellbare sys_Id.
Name	Name des bereitstellbaren CDM.
Knoten	Bereitstellbares Knotenobjekt. `{'Wert': '<sysId> ', 'link': 'http://localhost:8081/api/now/table/*'}`
Beschreibung	CDM – Beschreibung des bereitstellbaren Elements
Kennung	Ein Bezeichner für das bereitstellbare Element.
cmdb_ci	Das App-Serviceobjekt, das mit einem bereitstellbaren Element verbunden ist. `{'Wert': '<sysId> ', 'link': 'http://localhost:8081/api/now/table/*'}`
cmdb_app	Das CDM-Anwendungsobjekt. `{'Wert': '<sysId> ', 'link': 'http://localhost:8081/api/now/table/*'}`
snapshot_version_counter	Anzahl der für ein bereitstellbares Element erstellten Snapshots.
cdi_count	Die Anzahl der in diesem bereitstellbaren CDM enthaltenen CDIs.
cdi_usage	Prozentsatz der CDI-Nutzung
umgebungstyp	Der Umgebungstyp. Mögliche Werte: Entwicklung Produktion testen
Status	Status „Aktiv“ oder „Gelöscht“. . Mögliche Werte: aktiv gelöscht
sys_created_by	CDM – Bereitstellbares Element erstellt von<username> .
sys_created_on	CDM – Zeitstempel der bereitstellbaren Erstellung im Format<yyyy-MM-dd hh:mm:ss> .
sys_updated_by	CDM – Bereitstellbares Element aktualisiert von<username> .
sys_updated_on	Bereitstellbares CDM, aktualisiert nach Zeitstempel im Format<yyyy-MM-dd hh:mm:ss> .

cURL-Anforderung

curl "http://localhost:8080/api/sn_cdm/applications/deployables?appName=testApp&name=Dep-1" \ 
--request PUT\ 
--header "Accept:application/json" \ 
--user 'cdm_admin':'password1!'

Ausgabe:

{ 
  "result": { 
    "identifier": "identiy1", 
    "cmdb_ci": { 
      "value": "f5b9e00b53901110a1d3ddeeff7b12b8", 
      "link": "http://192.168.0.233:8080/api/now/table/cmdb_ci_service_auto/f5b9e00b53901110a1d3ddeeff7b12b8" 
    }, 
    "cdi_count": "3", 
    "snapshot_version_counter": "1", 
    "description": "cdcds", 
    "sys_updated_on": "2022-07-27 13:40:13", 
    "environment_type": "Test", 
    "node": { 
      "value": "30c00d4053015110a1d3ddeeff7b12bf", 
      "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_node/30c00d4053015110a1d3ddeeff7b12bf" 
    }, 
    "sys_id": "39b9e00b53901110a1d3ddeeff7b12b7", 
    "sys_updated_by": "admin", 
    "cdm_app": { 
      "value": "62b517a953b70110a1d3ddeeff7b128c", 
      "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
    }, 
    "sys_created_on": "2022-06-29 12:53:57", 
    "cdi_usage": "0.03", 
    "name": "Dep-2", 
    "state": "active", 
    "sys_created_by": "admin" 
  } 
}

CdmApplicationsApi – PUT /sn_cdm/applications/shared_components

Aktualisiert die angegebene gemeinsam genutzte Komponente in einer Anwendung innerhalb eines angegebenen Changesets.

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

URL-Format

Versionierte URL: /api/sn_cdm/{api_version}/applications/shared_components

Standard-URL: /api/sn_cdm/applications/shared_components

Unterstützte Anforderungsparameter

Tabelle : 114. Pfadparameter
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 : 115. Abfrageparameter
Name	Beschreibung
changesetNumber	Erforderlich. Eindeutiger Bezeichner des Changesets, das der Komponente zugeordnet ist. Datentyp: Zeichenfolge
returnFields	Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Datensatzspaltennamen wie sys_id, sys_updated_by oder state. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt
sharedComponentName	Erforderlich. Name der gemeinsam genutzten Komponente, die der angegebenen Anwendung zugeordnet ist. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente“ [sn_cdm_shared_component]. Datentyp: Zeichenfolge
sharedLibraryName	Erforderlich. Name der gemeinsamen Bibliothek, unter der sich die Komponente befindet. Befindet sich in der CDM-Anwendungstabelle [sn_cdm_application]. In der gemeinsamen Bibliothek müssen die folgenden Felder wie folgt definiert sein: Status = aktiv verfügbar = true Typ = shared_library Datentyp: Zeichenfolge
version	Erforderlich. Versionsname, der der gemeinsam genutzten Komponente zugeordnet ist. Befindet sich in der Tabelle „CDM-Snapshot“ [sn_cdm_snapshot]. Datentyp: Zeichenfolge

Tabelle : 116. 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 : 117. Anforderungskopfzeilen
Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json

Tabelle : 118. 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 HTTP-Antwortcodesder REST-API.

Tabelle : 119. Statuscodes
Statuscode	Beschreibung
200	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
400	Ungültige Anforderung. Das übergebene Changeset ist nicht vorhanden.
500	Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler.

Parameter des Antwort-Haupttexts

Die Antwortfelder hängen davon ab, welche Felder im Parameter returnFields in der Anforderung angegeben wurden. Im Folgenden werden einige der wichtigeren Felder beschrieben.


Name	Beschreibung
changeset_id	Details des Changeset-Datensatzes, der dem Knoten zugeordnet ist. Datentyp: Objekt `"changeset_id": { "link": "String", "value": "String" }`
changeset_id.link	Ruft die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge
changeset_id.value	Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz“ [sn_cdm_changeset]. Datentyp: Zeichenfolge
Beschreibung	Beschreibung des CDM-Knotens. Datentyp: Zeichenfolge
Fehler	Wird nur zurückgegeben, wenn während der Verarbeitung ein Fehler aufgetreten ist. Datentyp: Objekt `"error": { "detail": "String", "message": "String" }`
Fehler.Detail	Details zum aufgetretenen Fehler. Datentyp: Zeichenfolge
Fehler.Nachricht	Meldung, die eine Übersicht über den Fehler bietet. Datentyp: Zeichenfolge
linked_to	ID des Hauptknotens, der der gemeinsam genutzten Komponente zugeordnet ist. Datentyp: Zeichenfolge
linked_to_version	Details des dem Knoten zugeordneten CDM-Snapshot-Datensatzes. Datentyp: Objekt `"linked_to_version": { "link": "String", "value": "String" }`
linked_to_version.link	Ruft die Syntax zum Abfragen dieses Versionsdatensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge
linked_to_version.value	Sys_id des Versionsdatensatzes. Datentyp: Zeichenfolge
Haupt	Kennzeichnung, die angibt, ob der zugeordnete Snapshot veröffentlicht wurde. Gültige Werte: true: Snapshot wurde veröffentlicht. false: Snapshot wurde nicht veröffentlicht.
main_id	Eindeutige ID des neu erstellten Hauptknotens. Datentyp: Zeichenfolge
main_id_encoded	Codierte ID des neu erstellten Hauptknotens. Datentyp: Zeichenfolge
Name	Name des CDM-Knotens. Datentyp: Zeichenfolge
Knoten	Sys_id des gemeinsam genutzten Komponentenknotens. Datentyp: Zeichenfolge
node_path	Pfad zum neuen verknüpften Knoten, der beim Hinzufügen der gemeinsam genutzten Komponente erstellt wurde. Datentyp: Zeichenfolge
status	Status des Knotens. Mögliche Werte: Neu Datentyp: Zeichenfolge
sys_created_by	Benutzername des Benutzers, der den CDM-Knoten erstellt. Beispiel: able.tuter. Datentyp: Zeichenfolge
sys_created_on	Datum und Uhrzeit der Erstellung des CDM-Knotens. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge
sys_id	Sys_id des Knotens. Befindet sich in der Tabelle „CDM-Knoten“ [sn_cdm_node]. Datentyp: Zeichenfolge
sys_updated_by	Benutzername des Benutzers, der den CDM-Knoten zuletzt aktualisiert hat. Beispiel: able.tuter. Datentyp: Zeichenfolge
sys_updated_on	Datum und Uhrzeit der letzten Aktualisierung des CDM-Knotens. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge
type	Knotentyp Datentyp: Zeichenfolge

cURL-Anforderung

Das folgende Beispiel zeigt, wie dieser Endpunkt aufgerufen wird, um die Anwendung „App1“ mit der gemeinsam genutzten Komponente „paymentService-V1.1“ unter der gemeinsamen Bibliothek „OracleG-Bibliothek-10“ innerhalb des Changesets „Chset-20“ zu aktualisieren.

"https://instance-name.service-now.com/api/sn_cdm/applications/shared_components?sharedComponentName=paymentService-V1.1&sharedLibraryName=OracleG-Library-10&changesetNumber=Chset-20&versionName=sComp3-v2.shc&appName=App1" \ 
--request PUT \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Antwort:

"result": {
  "changeset_id": {
    "value": "7343d0f71b771110636e0fe0604bcb0b",
    "link": "https://instance-name.service-now.com/api/now/table/sn_cdm_changeset/7343d0f71b771110636e0fe0604bcb0b"
  },
  "node_path": "!2!3!&`",
  "description": null,
  "sys_updated_on": "2022-12-22 18:52:38",
  "type": "sn_cdm_node_linked_shared_component",
  "sys_class_name": "sn_cdm_node",
  "sys_id": "339314b71b771110636e0fe0604bcba3",
  "sys_updated_by": ”admin",
  "previous_version": {
    "value": "a9ce80bf1b371110636e0fe0604bcb10",
    "link": "https://instance-name.service-now.com/api/now/table/sn_cdm_node/a9ce80bf1b371110636e0fe0604bcb10" 
  },
  "sys_created_on": "2022-12-22 18:52:38",
  "value": null,
  "effective_from": null,
  "linked_to": "146", 
  "sys_created_by": ”admin",
  "restricted_to": null,
  "linked_to_version": {
    "value": "54115c371b771110636e0fe0604bcb77",
    "link": "https://instance-name.service-now.com/api/now/table/sn_cdm_snapshot/54115c371b771110636e0fe0604bcb77"
  },
  "level": "2",
  "conflict_type": null,
  "main_id": "166",
  "effective_to": null,
  "secure_value": null,
  "node_classifier": "/application/components",
  "main_id_encoded": "&`",
  "name": "Component_A",
  "position": null,
  "reason_for_conflict": null,
  "system_folder": false,
  "status": "updated",
  "conflict": false
}