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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CI-Lebenszyklusmanagement-API

# CI-Lebenszyklusmanagement-API {#ariaid-title1}

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

Die CI-Lebenszyklusmanagement Die API stellt Endpunkte bereit, um betriebsstatus von Konfigurationselementen (CI) zu bearbeiten und CI-Aktionen anzuwenden.
Die API-Schnittstellen entsprechen den Einschränkungen und Berechtigungen, die durch nicht zulässige CI-Aktionen, kompatible CI-Aktionen und nicht zulässige Betriebsübergänge angegeben werden. Wenn eine Schnittstelle einen eingeschränkten Vorgang versucht, wird der Vorgang blockiert, ein Fehler wird protokolliert, und gegebenenfalls wird eine Aufgabe erstellt.

## CI-Lebenszyklusmanagement -- LÖSCHT /now/cilifecyclemgmt/actions {#ariaid-title2}

Entfernt eine Konfigurationselement-Aktion (CI) für eine Liste von CIs.

### URL-Format {#cilifecyclemgmt-DELETE-actions__section_fcm_jph_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/actions

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-DELETE-actions__entry__2}{#cilifecyclemgmt-DELETE-actions__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-DELETE-actions__entry__6}{#cilifecyclemgmt-DELETE-actions__requestor-id-query-param-desc-entry}

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der Konfigurationselementaktion. Datentyp: Zeichenfolge |
| Request-ID | Erforderlich. SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\]. Datentyp: Zeichenfolge |
| Sys-IDs | Erforderlich. Kommagetrennte Liste von CI-sys_IDs. Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#cilifecyclemgmt-DELETE-actions__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#cilifecyclemgmt-DELETE-actions__entry__22}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

{#cilifecyclemgmt-DELETE-actions__table_od5_2wf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-DELETE-actions__entry__34}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-DELETE-actions__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob die CI-Aktion erfolgreich entfernt wurde. Mögliche Werte: * Wahr: CI-Aktion wurde entfernt. * Falsch: CI-Aktion wurde nicht entfernt. {#cilifecyclemgmt-DELETE-actions__ul_psg_lsh_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Entfernen Sie eine CI-Aktion aus zwei CIs.

    curl --request DELETE \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/actions?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a&sysIds=00a9a80d3790200044e0bfc8bcbe5d1c,d0fdbc8437201000deeabfc8bcbe5d33' \
    --header 'Accept: application/json' \
    --user "username":"password"

Der Antworttext bestätigt, dass die CI-Aktion aus den CIs entfernt wurde.

    {
      "result": {
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- LÖSCHT /now/cilifecyclemgmt/Operators/{req_ID} {#ariaid-title3}

Hebt die Registrierung eines Operators für nicht-Workflow-Anwender auf.

### URL-Format {#cilifecyclemgmt-DELETE-operators__section_xyw_syh_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/Operators/{req_ID}

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-DELETE-operators__entry__2}{#cilifecyclemgmt-DELETE-operators__version-not_optional-RESTAPI}{#cilifecyclemgmt-DELETE-operators__req-id-data-type-p}

| Parameter | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| req_ID | SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\].{#cilifecyclemgmt-DELETE-operators__req-id-table-p} Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#cilifecyclemgmt-DELETE-operators__entry__8}

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

{#cilifecyclemgmt-DELETE-operators__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#cilifecyclemgmt-DELETE-operators__entry__20}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

{#cilifecyclemgmt-DELETE-operators__table_hsj_2wf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb__entry__2}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-DELETE-operators__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob die Registrierung des Operators erfolgreich aufgehoben wurde. Mögliche Werte: * Wahr: Registrierung des Operators wurde erfolgreich aufgehoben. * Falsch: Registrierung des Operators wurde nicht erfolgreich aufgehoben. {#cilifecyclemgmt-DELETE-operators__ul_mkt_tlk_lmb} Datentyp: Zeichenfolge |
[ ]

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb}  

### Curl-Anforderung

Heben Sie die Registrierung eines Operators anhand der Anwender-ID auf.

    curl --request DELETE \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/operators/3cf1b3cc30121010f877773aa7167c6e" \
    --header "Accept: application/json" \
    --user "username":"password"

Der Antworttext verifiziert, dass die Registrierung des Operators aufgehoben wurde.

    {
      "result": {
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- GET /now/cilifecyclemgmt/actions/{sys_ID} {#ariaid-title4}

Gibt eine Liste aktiver Konfigurationselementaktionen (CI) für das angegebene CI zurück.

### URL-Format {#cilifecyclemgmt-GET-actions__section_m1y_5xm_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/actions/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-actions__entry__2}{#cilifecyclemgmt-GET-actions__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-actions__entry__8}

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

{#cilifecyclemgmt-GET-actions__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-actions__entry__20}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.ciActionsParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

{#cilifecyclemgmt-GET-actions__table_lrs_cwf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-actions__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.ciAktionen | Kommagetrennte Liste aktiver CI-Aktionen für das CI, oder `No_Active_action `Wenn keine gefunden wurden. Datentyp: Zeichenfolge |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-GET-actions__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob die Liste der aktiven CI-Aktionen für alle angegebenen CIs zurückgegeben wurde. Mögliche Werte: * Wahr: Liste der aktiven CI-Aktionen wurde zurückgegeben. * Falsch: Liste der aktiven CI-Aktionen wurde nicht zurückgegeben. {#cilifecyclemgmt-GET-actions__ul_psg_lsh_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/actions/00a9a80d3790200044e0bfc8bcbe5d1c' \
    --header 'Accept: application/json' \
    --user "username":"password"

Der Antworttext zeigt an, dass für das angegebene CI keine CI-Aktionen aktiv sind.

    {
      "result": {
        "ciActions": [
          "no_active_action"
        ],
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- GET /now/cilifecyclemgmt/compatActions {#ariaid-title5}

Bestimmt, ob zwei angegebene Konfigurationselement-Aktionen (CI) kompatibel sind.

### URL-Format {#cilifecyclemgmt-GET-compatAction__section_rgg_g2n_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/compatActions

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-compatAction__entry__2}{#cilifecyclemgmt-GET-compatAction__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-compatAction__entry__6}

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der zu vergleichenden CI-Aktion. Datentyp: Zeichenfolge |
| OtherActionName | Erforderlich. Name der zu vergleichenden CI-Aktion. Datentyp: Zeichenfolge |
[Tabelle : 20. Abfrageparameter]

{#cilifecyclemgmt-GET-compatAction__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 22. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-compatAction__entry__20}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

{#cilifecyclemgmt-GET-compatAction__table_vz1_cwf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-compatAction__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Kennzeichnung, die angibt, ob die beiden angegebenen CI-Aktionen kompatibel sind. Mögliche Werte: * Wahr: CI-Aktionen sind kompatibel. * Falsch: CI-Aktionen sind nicht kompatibel. {#cilifecyclemgmt-GET-compatAction__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Überprüfen Sie die Kompatibilität von CI-Aktionen für das Patchen und die Bereitstellung.

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/compatActions?actionName=Patching&otherActionName=Provisioning' \
    --header 'Accept: application/json' \
    --user "username":"password"

Der Antworttext bestätigt, dass die beiden CI-Aktionen kompatibel sind.

    {
      "result": true
    }

## CI-Lebenszyklusmanagement -- GET /now/cilifecyclemgmt/leases/{sys_ID}/expired {#ariaid-title6}

Bestimmt, ob der Mietvertrag für die anfordernde Person einer auf das angegebene CI angewendeten Konfigurationselementaktion (Configuration Item, CI) abgelaufen ist.

### URL-Format {#cilifecyclemgmt-GET-leases-expired__section_kgl_mjn_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/leases/{sys_ID}/abgelaufen

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-leases-expired__entry__2}{#cilifecyclemgmt-GET-leases-expired__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-leases-expired__entry__8}{#cilifecyclemgmt-GET-leases-expired__requestor-id-query-param-desc-entry}

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der CI-Aktion, die auf das angegebene CI angewendet wird. Datentyp: Zeichenfolge |
| Request-ID | Erforderlich. SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\]. Datentyp: Zeichenfolge |
[Tabelle : 26. Abfrageparameter]

{#cilifecyclemgmt-GET-leases-expired__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 27. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 28. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-leases-expired__entry__22}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

{#cilifecyclemgmt-GET-leases-expired__table_hwr_bwf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-leases-expired__entry__34}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-GET-leases-expired__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob die Miete für die anfordernde Person der angewendeten CI-Aktion abgelaufen ist. Mögliche Werte: * Wahr: Lease der anfordernden Person ist abgelaufen. * Falsch: Lease der anfordernden Person ist nicht abgelaufen. {#cilifecyclemgmt-GET-leases-expired__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/leases/00a9a80d3790200044e0bfc8bcbe5d1c/expired?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a' \
    --header 'Accept: application/json' \
    --user "username":"password"

Der Antworttext zeigt an, dass der Mietvertrag für die anfordernde Person der angewendeten CI-Aktion nicht abgelaufen ist.

    {
      "result": {
        "result": false
      }
    }

## CI-Lebenszyklusmanagement -- GET /now/cilifecyclemgmt/notAllowedAction {#ariaid-title7}

Bestimmt, ob eine angegebene Konfigurationselement-Aktion (CI) für ein CI einer angegebenen Klasse in einem angegebenen Betriebsstatus nicht zulässig ist.

### URL-Format {#cilifecyclemgmt-GET-notAllowedAct__section_wbv_pln_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/notAllowedAction

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-notAllowedAct__entry__2}{#cilifecyclemgmt-GET-notAllowedAct__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__6}

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der zu überprüfenden CI-Aktion. Datentyp: Zeichenfolge |
| ciClass | Erforderlich. CI-Klasse. Datentyp: Zeichenfolge |
| OpsBezeichnung | Erforderlich. Zu überprüfender Betriebsstatus. Datentyp: Zeichenfolge |
[Tabelle : 32. Abfrageparameter]

{#cilifecyclemgmt-GET-notAllowedAct__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 33. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 34. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-notAllowedAct__entry__22}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 36. Statuscodes]

{#cilifecyclemgmt-GET-notAllowedAct__table_qqg_bwf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-notAllowedAct__entry__34}

| Name | Beschreibung |
|-|-|
| Ergebnis | Kennzeichnung, die angibt, ob die CI-Aktion für CIs des angegebenen Typs eingeschränkt (nicht zulässig) ist, wenn sie sich im angegebenen Betriebsstatus befinden. Mögliche Werte: * Wahr: CI-Aktion ist eingeschränkt (nicht zulässig). * Falsch: CI-Aktion ist uneingeschränkt (zulässig). {#cilifecyclemgmt-GET-notAllowedAct__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Überprüfen Sie, ob die CI-Aktion „Patchen" für Computer im DR-Standby-Betriebsstatus eingeschränkt (nicht zulässig) ist.

    curl --request GET \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/notAllowedAction?actionName=Patching&ciClass=cmdb_ci_computer&opsLabel=DR+Standby" \
    --header "Accept: application/json" \
    --user "username":"password"

Der Antworttext bestätigt, dass diese Aktion für die angegebene CI-Klasse eingeschränkt (nicht zulässig) ist, wenn sie sich im angegebenen Betriebsstatus befindet.

    {
      "result": true
    }

## CI-Lebenszyklusmanagement -- GET /now/cilifecyclemgmt/notAllowedOpsTransition {#ariaid-title8}

Bestimmt, ob ein Konfigurationselement (CI) aus einer angegebenen Klasse von einem angegebenen Betriebsstatus in einen zweiten angegebenen Betriebsstatus übergehen kann.

### URL-Format {#cilifecyclemgmt-GET-notAllowedOps__section_dmp_44n_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/notAllowedOpsTransition

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-notAllowedOps__entry__2}{#cilifecyclemgmt-GET-notAllowedOps__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-notAllowedOps__entry__6}

| Name | Beschreibung |
|-|-|
| ciClass | Erforderlich. CI-Klasse, für die Übergangsbeschränkungen überprüft werden sollen. Datentyp: Zeichenfolge |
| OpsBezeichnung | Erforderlich. Bezeichnung des aktuellen CI-Betriebsstatus. Datentyp: Zeichenfolge |
| TransitionOpsBezeichnung | Erforderlich. Bezeichnung des Betriebsstatus, der das Ziel des Übergangs ist. Datentyp: Zeichenfolge |
[Tabelle : 38. Abfrageparameter]

{#cilifecyclemgmt-GET-notAllowedOps__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 39. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 40. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-notAllowedOps__entry__22}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 42. Statuscodes]

{#cilifecyclemgmt-GET-notAllowedOps__table_clt_1wf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-notAllowedOps__entry__34}

| Name | Beschreibung |
|-|-|
| Ergebnis | Kennzeichnung, die angibt, ob der angegebene Betriebsstatusübergang für die angegebene CI-Klasse eingeschränkt (nicht zulässig) ist. Mögliche Werte: * Wahr: Übergang des Betriebsstatus ist eingeschränkt (nicht zulässig). * Falsch: Der Übergang des Betriebsstatus ist uneingeschränkt (zulässig). {#cilifecyclemgmt-GET-notAllowedOps__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Überprüfen Sie, ob der Übergang vom Status „stillgelegt" in den Betriebsstatus „DR-Standby" für Linux-Server-CIs eingeschränkt (nicht zulässig) ist.

    curl --request GET \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/notAllowedOpsTransition?ciClass=cmdb_ci_computer&opsLabel=Retired&transitionOpsLabel=DR+Standby" \
    --header "Accept: application/json" \
    --user "username":"password"

Der Antworttext zeigt an, dass der angegebene Betriebsstatusübergang für diese CI-Klasse uneingeschränkt (zulässig) ist.

    {
      "result": false
    }

## CI-Lebenszyklusmanagement -- RUFT /now/cilifecyclemgmt/requestors/{req_ID}/valid ab {#ariaid-title9}

Bestimmt, ob der angegebene aktive Workflow-Anwender oder der registrierte Anwender eine gültige anfordernde Person ist.

### URL-Format {#cilifecyclemgmt-GET-req-valid__section_gdl_3d4_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/Anforderer/{req_ID}/valid

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-req-valid__entry__2}{#cilifecyclemgmt-GET-req-valid__version-not_optional-RESTAPI}{#cilifecyclemgmt-GET-req-valid__req-id-data-type-p}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| req_ID | SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\].{#cilifecyclemgmt-GET-req-valid__req-id-table-p} Datentyp: Zeichenfolge |
[Tabelle : 43. Pfad-Parameter]

{#cilifecyclemgmt-GET-req-valid__entry__8}

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

{#cilifecyclemgmt-GET-req-valid__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 45. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 46. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-req-valid__entry__20}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 48. Statuscodes]

{#cilifecyclemgmt-GET-req-valid__table_mbj_1wf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-req-valid__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-GET-req-valid__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob der angegebene aktive Workflow-Anwender oder registrierte Anwender eine gültige anfordernde Person ist. Mögliche Werte: * Wahr: Gültige anfordernde Person. * Falsch: Ungültige anfordernde Person. {#cilifecyclemgmt-GET-req-valid__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

    curl --request GET \
    'https://instance.service-now.com/api/now/cilifecyclemgmt/requestors/4cab9b95301a9010f877773aa7167ca9/valid' \
    --header 'Accept: application/json' \
    --user "username":"password"

    {
      "result": {
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- GET /now/cilifecyclemgmt/statuses/{sys_ID} {#ariaid-title10}

Gibt den aktuellen Betriebsstatus für das angegebene Konfigurationselement (CI) zurück.

### URL-Format {#cilifecyclemgmt-GET-statuses__section_bgd_bf4_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/statuses/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-GET-statuses__entry__2}{#cilifecyclemgmt-GET-statuses__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-GET-statuses__entry__8}

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

{#cilifecyclemgmt-GET-statuses__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 51. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 52. Anforderungskopfzeilen.]

{#cilifecyclemgmt-GET-statuses__entry__20}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 54. Statuscodes]

{#cilifecyclemgmt-GET-statuses__table_pdp_yvf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-GET-statuses__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-GET-statuses__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Betriebsstatus | Betriebsstatus für das angegebene CI oder `Unbekannt `Wenn kein Status angegeben ist. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

    curl --request GET 'https://instance.service-now.com/api/now/cilifecyclemgmt/statuses/aac0b1213784200044e0bfc8bcbe5de3' \
    --header 'Accept: application/json' \
    --user "username":"password"

    {
      "result": {
        "operationalState": "Repair in Progress",
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- PATCH /now/cilifecyclemgmt/leases/{sys_ID} {#ariaid-title11}

Erweitert die Leasingablaufzeit der angegebenen Konfigurationselement-Aktion (CI) für den angegebenen Anwender.
Wenn der vorherige Mietvertrag abgelaufen ist, beginnt die neue Mietzeit sofort.

### URL-Format {#cilifecyclemgmt-PATCH-leases__section_c22_hp4_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/leases/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-PATCH-leases__entry__2}{#cilifecyclemgmt-PATCH-leases__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des CI, für das der Mietvertrag verlängert werden soll. Datentyp: Zeichenfolge |
[Tabelle : 55. Pfad-Parameter]

{#cilifecyclemgmt-PATCH-leases__entry__8}{#cilifecyclemgmt-PATCH-leases__requestor-id-query-param-desc-entry}

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der zugeordneten CI-Aktion. Datentyp: Zeichenfolge |
| LeaseTime | Erforderlich. Zeitdauer, für die die Miete für die in angegebene CI-Aktion gültig ist actionName. Datentyp: Zeichenfolge FORMAT: HH:MM:SS |
| Request-ID | Erforderlich. SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\]. Datentyp: Zeichenfolge |
[Tabelle : 56. Abfrageparameter]

{#cilifecyclemgmt-PATCH-leases__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 57. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 58. Anforderungskopfzeilen.]

{#cilifecyclemgmt-PATCH-leases__entry__26}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 60. Statuscodes]

{#cilifecyclemgmt-PATCH-leases__table_rwq_xvf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-PATCH-leases__entry__38}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-PATCH-leases__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob die Mietzeit verlängert wurde. Mögliche Werte: * Wahr: Mietzeit wurde verlängert. * Falsch: Mietzeit wurde nicht verlängert. {#cilifecyclemgmt-PATCH-leases__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Verlängern Sie die Dauer einer Patch-CI-Aktion „anfordernde Person mieten" um 24 Stunden.

    curl --request PATCH 'https://instance.service-now.com/api/now/cilifecyclemgmt/leases/affd3c8437201000deeabfc8bcbe5dc3?actionName=Patching&leaseTime=24:00:00&requestorId=e7c3402d305a9010f877773aa7167c2a' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --user "username":"password"

    {
      "result": {
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/actions {#ariaid-title12}

Fügt einer angegebenen Liste von CIs eine angegebene Konfigurationselement-Aktion (CI) hinzu.

### URL-Format {#cilifecyclemgmt-POST-actions__section_lmz_dv4_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/actions

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-POST-actions__entry__2}{#cilifecyclemgmt-POST-actions__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-POST-actions__entry__6}{#cilifecyclemgmt-POST-actions__requestor-id-query-param-desc-entry}

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der CI-Aktion, die der Liste hinzugefügt werden soll. Datentyp: Zeichenfolge |
| LeaseTime | Zeitdauer, für die die Miete für die angegebene CI-Aktion gültig ist. Datentyp: Zeichenfolge FORMAT: HH:MM:SS |
| OldActionNames | Kommagetrennte Liste der alten CI-Aktionen, in denen sich alle CIs befinden sollen. Datentyp: Zeichenfolge |
| Request-ID | Erforderlich. SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\]. Datentyp: Zeichenfolge |
| Sys-IDs | Erforderlich. Kommagetrennte Liste von CI-sys_IDs, denen die CI-Aktion hinzugefügt werden soll. Datentyp: Zeichenfolge |
[Tabelle : 62. Abfrageparameter]

{#cilifecyclemgmt-POST-actions__entry__18}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 63. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 64. Anforderungskopfzeilen.]

{#cilifecyclemgmt-POST-actions__entry__28}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 66. Statuscodes]

{#cilifecyclemgmt-POST-actions__table_wj1_xvf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-POST-actions__entry__40}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-POST-actions__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob die CI-Aktion für alle CIs in der Liste festgelegt wurde. Mögliche Werte: * Wahr: CI-Aktionen wurden festgelegt. * Falsch: CI-Aktionen wurden nicht festgelegt. {#cilifecyclemgmt-POST-actions__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Fügen Sie zwei CIs eine CI-Patching-Aktion hinzu.

    curl --request POST \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/actions?actionName=Patching&requestorId=621b5a09309e5010f877773aa7167c0a&sysIds=00a9a80d3790200044e0bfc8bcbe5d1c,d0fdbc8437201000deeabfc8bcbe5d33" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username":"password"

    {
      "result": {
        "result": true
      }
    }

## CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators {#ariaid-title13}

Registriert einen Operator für einen nicht-Workflow-Anwender.

### URL-Format {#cilifecyclemgmt-POST-operators__section_b3l_kv4_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/Operators

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-POST-operators__entry__2}{#cilifecyclemgmt-POST-operators__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-POST-operators__entry__6}

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

{#cilifecyclemgmt-POST-operators__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 69. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 70. Anforderungskopfzeilen.]

{#cilifecyclemgmt-POST-operators__entry__20}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 72. Statuscodes]

{#cilifecyclemgmt-POST-operators__table_oj2_wvf_mmb}

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-POST-operators__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-POST-operators__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.AnforderungsId | GUID für den registrierten Operator. Verwenden Sie diesen Wert, um CI-Aktionen und betriebsstatus festzulegen. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob der Operator erfolgreich registriert wurde. Mögliche Werte: * Wahr: Der Operator wurde erfolgreich registriert. * Falsch: Der Operator wurde nicht erfolgreich registriert. {#cilifecyclemgmt-POST-operators__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

    curl --request POST \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/operators" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username":"password"

    {
      "result": {
        "result": true,
        "requestorId": "6f992b8430121010f877773aa7167c42"
      }
    }

## CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/statuses {#ariaid-title14}

Legt den Betriebsstatus für eine angegebene Liste von Konfigurationselementen (CIs) fest.

### URL-Format {#cilifecyclemgmt-POST-statuses__section_shp_tw4_dmb}

Versionierte URL: /api/now/{api_Version}/cilifecyclemgmt/statuses

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

### Unterstützte Anforderungsparameter

{#cilifecyclemgmt-POST-statuses__entry__2}{#cilifecyclemgmt-POST-statuses__version-not_optional-RESTAPI}

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

{#cilifecyclemgmt-POST-statuses__entry__6}{#cilifecyclemgmt-POST-statuses__requestor-id-query-param-desc-entry}

| Name | Beschreibung |
|-|-|
| OldOpsBezeichnungen | Kommagetrennte Liste der alten CI-betriebsstatus, in die alle CIs einbezogen werden sollen. Datentyp: Zeichenfolge |
| OpsBezeichnung | Erforderlich. Bezeichnung des Betriebsstatus, der für die angegebenen CIs festgelegt werden soll. Datentyp: Zeichenfolge |
| Request-ID | Erforderlich. SYS_ID eines Workflow-Kontexts oder eine Operator-Anwender-ID, die von zurückgegeben wird [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/Operators](https://servicenow-prod.fluidtopics.net/REtOW1MgonplzQpNpp_KEw#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen nicht-Workflow-Anwender.")Endpunkt. Anwender-IDs des Anwenders befinden sich in der Tabelle „registrierte Anwender des CI-Status" \[statemgmt_Register_users\]. Datentyp: Zeichenfolge |
| Sys-IDs | Erforderlich. Kommagetrennte Liste von sys_IDs von CIs, für die der Betriebsstatus festgelegt werden soll. Datentyp: Zeichenfolge |
[Tabelle : 74. Abfrageparameter]

{#cilifecyclemgmt-POST-statuses__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 75. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 76. Anforderungskopfzeilen.]

{#cilifecyclemgmt-POST-statuses__entry__26}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich vom Endpunkt verarbeitet. Überprüfen Sie den Antworttext result.resultParameter zum Überprüfen des Ergebnisses des Vorgangs. Wenn der Endpunkt während der Verarbeitung der Anforderung auf Fehler stößt, werden Fehlercodes und Meldungen im Antworttext angezeigt result.errorsParameter. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 78. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cilifecyclemgmt-POST-statuses__entry__38}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| Ergebnis.Fehler | Liste der Objekte, in denen jedes Objekt einen Fehler darstellt, der bei der Verarbeitung der Anforderung aufgetreten ist. Datentyp: Array "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Fehler.Fehler | Bezeichner für einen Statusverwaltungsfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLIKAT_SYS_ID * INCIDENT_CI_ACTION * UNGÜLTIGE_CI_AKTION * UNGÜLTIG_LÖSCHEN * UNGÜLTIGE_INPUT_PARAMETERS * INVALID_LEASETIME * UNGÜLTIGER_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * UNGÜLTIGER_ANFORDERER * INVALID_REQUESTOR_FOR_CI * UNGÜLTIGE_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * NICHT SUPPORTED_SYS_ID {#cilifecyclemgmt-POST-statuses__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht, die Details zum zugeordneten enthält error. Datentyp: Zeichenfolge |
| Ergebnis.Ergebnis | Kennzeichnung, die angibt, ob der gewünschte Status für alle in der Anforderung enthaltenen CIs festgelegt wurde. Mögliche Werte: * Wahr: Betriebsstatus festgelegt. * Falsch: Betriebsstatus nicht festgelegt. {#cilifecyclemgmt-POST-statuses__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Legen Sie fest `Reparatur wird ausgeführt `Betriebsstatus für zwei CIs.

    curl --request POST \
    "https://instance.service-now.com/api/now/cilifecyclemgmt/statuses?opsLabel=Repair%20in%20Progress&requestorId=23d58bc030121010f877773aa7167c83&sysIds=affd3c8437201000deeabfc8bcbe5dc3,aac0b1213784200044e0bfc8bcbe5de3" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --user "username":"password"

Der Antworttext zeigt an, dass der gewünschte Betriebsstatus für beide in der Anforderung angegebenen CIs festgelegt wurde.

    {
      "result": {
        "result": true
      }
    }


