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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CI Lifecycle Management-API

# CI Lifecycle Management-API {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 27 Minuten Lesedauer

Die CI Lifecycle Management- API stellt Endpunkte bereit, um den Betriebsstatus von Configuration Item (CI) zu bearbeiten und CI-Aktionen anzuwenden.
Die API-Schnittstellen müssen Einschränkungen und Toleranzen einhalten, die durch unzulässige CI-Aktionen, kompatible CI-Aktionen und unzulässige Betriebsübergänge festgelegt sind. Wenn eine Schnittstelle einen eingeschränkten Vorgang versucht, wird der Vorgang blockiert, ein Fehler protokolliert und gegebenenfalls eine Aufgabe erstellt.

## CI-Lebenszyklus-Management -- /now/cilifecyclemgmt/actions löschen {#ariaid-title2}

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

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/actions

Standard-URL: /api/now/cilifecyclemgmt/actions

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

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

| Name | Beschreibung |
|-|-|
| actionName | Erforderlich. Name der Configuration Item-Aktion. Datentyp: Zeichenfolge |
| requestorId | Erforderlich. Sys_id eines Workflow-Kontexts oder eine vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[statemgmt_register_users\]. Datentyp: Zeichenfolge |
| sysIds | Erforderlich. Kommagetrennte Liste der CI sys_ids. Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#cilifecyclemgmt-DELETE-actions__entry__14}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-DELETE-actions__entry__18}{#cilifecyclemgmt-DELETE-actions__accept-RESTAPI}

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

{#cilifecyclemgmt-DELETE-actions__entry__22}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

{#cilifecyclemgmt-DELETE-actions__table_od5_2wf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-DELETE-actions__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | 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

Entfernt 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-Lebenszyklus-Management -- DELETE /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}

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/operators/{req_id}

Standard-URL: /api/now/cilifecyclemgmt/operators/{req_id}

### Unterstützte Anforderungsparameter

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

| Parameter | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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 vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-DELETE-operators__entry__16}{#cilifecyclemgmt-DELETE-operators__accept-RESTAPI}

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

{#cilifecyclemgmt-DELETE-operators__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

{#cilifecyclemgmt-DELETE-operators__table_hsj_2wf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-DELETE-operators__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | Kennzeichnung, die angibt, ob die Registrierung des Operators erfolgreich aufgehoben wurde. Mögliche Werte: * wahr: Die Registrierung des Operators wurde erfolgreich aufgehoben. * „falsch": Die Registrierung des Anwenders 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-Lebenszyklus-Management -- GET /now/cilifecyclemgmt/actions/{sys_id} {#ariaid-title4}

Gibt eine Liste aktiver Configuration Item-Aktionen (CI) für das angegebene CI zurück.

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/actions/{sys_id}

Standard-URL: /api/now/cilifecyclemgmt/actions/{sys_id}

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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 zugehörige CI-Aktionen zurückgegeben werden sollen. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfadparameter]

{#cilifecyclemgmt-GET-actions__entry__8}

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

{#cilifecyclemgmt-GET-actions__entry__12}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-actions__entry__16}{#cilifecyclemgmt-GET-actions__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-actions__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.ciActions, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

{#cilifecyclemgmt-GET-actions__table_lrs_cwf_mmb}

### Parameter des Antworttexts (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" } |
| result.ciActions | Kommagetrennte Liste der aktiven CI-Aktionen für das CI oder `„no_active_action"`, wenn keine gefunden wurden. Datentyp: Zeichenfolge |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-GET-actions__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | 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, dass für das angegebene CI keine CI-Aktionen aktiv sind.

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

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

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

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/compatActions

Standard-URL: /api/now/cilifecyclemgmt/compatActions

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-compatAction__entry__16}{#cilifecyclemgmt-GET-compatAction__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-compatAction__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

{#cilifecyclemgmt-GET-compatAction__table_vz1_cwf_mmb}

### Parameter des Antworttexts (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üft die Kompatibilität von CI-Aktionen für das Patchen und Bereitstellen.

    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-Lebenszyklus-Management -- GET /now/cilifecyclemgmt/leases/{sys_id}/expired {#ariaid-title6}

Bestimmt, ob die Mietdauer für den Anforderer einer Configuration Item-Aktion (CI) abgelaufen ist, die auf das angegebene CI angewendet wurde.

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}/expired

Standard-URL: /api/now/cilifecyclemgmt/leases/{sys_id}/expired

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#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 wurde. Datentyp: Zeichenfolge |
| requestorId | Erforderlich. Sys_id eines Workflow-Kontexts oder eine vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[statemgmt_register_users\]. Datentyp: Zeichenfolge |
[Tabelle : 26. Abfrageparameter]

{#cilifecyclemgmt-GET-leases-expired__entry__14}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-leases-expired__entry__18}{#cilifecyclemgmt-GET-leases-expired__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-leases-expired__entry__22}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

{#cilifecyclemgmt-GET-leases-expired__table_hwr_bwf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-GET-leases-expired__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | Kennzeichnung, die angibt, ob die Miete für den Anforderer der angewendeten CI-Aktion abgelaufen ist. Mögliche Werte: * „wahr": Miete der anfordernden Person ist abgelaufen. * „falsch": Mietdauer 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, dass die Miete für den Anforderer der angewendeten CI-Aktion nicht abgelaufen ist.

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

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

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

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/notAllowedAction

Standard-URL: /api/now/cilifecyclemgmt/notAllowedAction

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#cilifecyclemgmt-GET-notAllowedAct__entry__6}

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__14}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-notAllowedAct__entry__18}{#cilifecyclemgmt-GET-notAllowedAct__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-notAllowedAct__entry__22}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 36. Statuscodes]

{#cilifecyclemgmt-GET-notAllowedAct__table_qqg_bwf_mmb}

### Parameter des Antworttexts (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 nicht eingeschränkt (zulässig). {#cilifecyclemgmt-GET-notAllowedAct__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Überprüfen Sie, ob die Aktion „CI 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-Lebenszyklus-Management -- GET /now/cilifecyclemgmt/notAllowedOpsTransition {#ariaid-title8}

Bestimmt, ob ein Configuration Item (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}

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/notAllowedOpsTransition

Standard-URL: /api/now/cilifecyclemgmt/notAllowedOpsTransition

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#cilifecyclemgmt-GET-notAllowedOps__entry__6}

| Name | Beschreibung |
|-|-|
| ciClass | Erforderlich. CI-Klasse, für die Übergangsbeschränkungen überprüft werden sollen. Datentyp: Zeichenfolge |
| opsLabel | Erforderlich. Bezeichnung des aktuellen CI-Betriebsstatus. Datentyp: Zeichenfolge |
| transitionOpsLabel | 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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-notAllowedOps__entry__18}{#cilifecyclemgmt-GET-notAllowedOps__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-notAllowedOps__entry__22}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 41. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 42. Statuscodes]

{#cilifecyclemgmt-GET-notAllowedOps__table_clt_1wf_mmb}

### Parameter des Antworttexts (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: Betriebsstatusübergang ist eingeschränkt (nicht zulässig). * „falsch": Der Betriebsstatusübergang ist nicht eingeschränkt (zulässig). {#cilifecyclemgmt-GET-notAllowedOps__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Überprüfen Sie, ob der Übergang vom Betriebsstatus „Deaktiviert" in den DR-Standby-Status 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, dass der angegebene Betriebsstatusübergang für diese CI-Klasse nicht eingeschränkt (zulässig) ist.

    {
      "result": false
    }

## CI-Lebenszyklus-Management -- GET /now/cilifecyclemgmt/requestors/{req_id}/valid {#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}

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/requestors/{req_id}/valid

Standard-URL: /api/now/cilifecyclemgmt/requestors/{req_id}/valid

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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 vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[statemgmt_register_users\].{#cilifecyclemgmt-GET-req-valid__req-id-table-p} Datentyp: Zeichenfolge |
[Tabelle : 43. Pfadparameter]

{#cilifecyclemgmt-GET-req-valid__entry__8}

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

{#cilifecyclemgmt-GET-req-valid__entry__12}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-req-valid__entry__16}{#cilifecyclemgmt-GET-req-valid__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-req-valid__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 47. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 48. Statuscodes]

{#cilifecyclemgmt-GET-req-valid__table_mbj_1wf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-GET-req-valid__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | Kennzeichnung, die angibt, ob der angegebene aktive Workflow-Anwender oder der registrierte Anwender eine gültige anfordernde Person ist. Mögliche Werte: * true: Gültiger Anforderer. * „falsch": Ungültiger Anforderer. {#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-Lebenszyklus-Management -- GET /now/cilifecyclemgmt/statuses/{sys_id} {#ariaid-title10}

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

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

URL mit Versionsangabe: /api/now/{api_version}/cilifecyclemgmt/statuses/{sys_id}

Standard-URL: /api/now/cilifecyclemgmt/statuses/{sys_id}

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#cilifecyclemgmt-GET-statuses__entry__8}

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

{#cilifecyclemgmt-GET-statuses__entry__12}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-GET-statuses__entry__16}{#cilifecyclemgmt-GET-statuses__accept-RESTAPI}

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

{#cilifecyclemgmt-GET-statuses__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 53. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 54. Statuscodes]

{#cilifecyclemgmt-GET-statuses__table_pdp_yvf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-GET-statuses__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.operationalStates | 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-Lebenszyklus-Management -- PATCH /now/cilifecyclemgmt/leases/{sys_id} {#ariaid-title11}

Verlängert die Ablaufzeit der Miete der angegebenen Configuration Item(CI)-Aktion für den angegebenen Anwender.
Wenn die vorherige Miete abgelaufen ist, beginnt die neue Mietzeit sofort.

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}

Standard-URL: /api/now/cilifecyclemgmt/leases/{sys_id}

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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 die Miete verlängert werden soll. Datentyp: Zeichenfolge |
[Tabelle : 55. Pfadparameter]

{#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 actionNameangegebene CI-Aktion gültig ist. Datentyp: Zeichenfolge Format: HH:MM:SS |
| requestorId | Erforderlich. Sys_id eines Workflow-Kontexts oder eine vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[statemgmt_register_users\]. Datentyp: Zeichenfolge |
[Tabelle : 56. Abfrageparameter]

{#cilifecyclemgmt-PATCH-leases__entry__16}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-PATCH-leases__entry__20}{#cilifecyclemgmt-PATCH-leases__accept-RESTAPI}{#cilifecyclemgmt-PATCH-leases__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 58. Anforderungskopfzeilen]

{#cilifecyclemgmt-PATCH-leases__entry__26}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 59. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 60. Statuscodes]

{#cilifecyclemgmt-PATCH-leases__table_rwq_xvf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-PATCH-leases__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | Kennzeichnung, die angibt, ob die Mietdauer verlängert wurde. Mögliche Werte: * „wahr": Lease-Zeit wurde verlängert. * „falsch": Lease-Zeit wurde nicht verlängert. {#cilifecyclemgmt-PATCH-leases__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Verlängern Sie die Dauer der Mietdauer einer anfordernden Person einer Patch-CI-Aktion 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-Lebenszyklus-Management -- POST /now/cilifecyclemgmt/actions {#ariaid-title12}

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

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/actions

Standard-URL: /api/now/cilifecyclemgmt/actions

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#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 alter CI-Aktionen, in der sich alle CIs befinden müssen. Datentyp: Zeichenfolge |
| requestorId | Erforderlich. Sys_id eines Workflow-Kontexts oder eine vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[statemgmt_register_users\]. Datentyp: Zeichenfolge |
| sysIds | Erforderlich. Kommagetrennte Liste der 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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-POST-actions__entry__22}{#cilifecyclemgmt-POST-actions__accept-RESTAPI}{#cilifecyclemgmt-POST-actions__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 64. Anforderungskopfzeilen]

{#cilifecyclemgmt-POST-actions__entry__28}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 65. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 66. Statuscodes]

{#cilifecyclemgmt-POST-actions__table_wj1_xvf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-POST-actions__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | 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": Es wurden keine CI-Aktionen festgelegt. {#cilifecyclemgmt-POST-actions__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Fügen Sie zwei CIs eine Patch-CI-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}

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/operators

Standard-URL: /api/now/cilifecyclemgmt/operators

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#cilifecyclemgmt-POST-operators__entry__6}

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

{#cilifecyclemgmt-POST-operators__entry__10}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-POST-operators__entry__14}{#cilifecyclemgmt-POST-operators__accept-RESTAPI}{#cilifecyclemgmt-POST-operators__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 70. Anforderungskopfzeilen]

{#cilifecyclemgmt-POST-operators__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 71. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 72. Statuscodes]

{#cilifecyclemgmt-POST-operators__table_oj2_wvf_mmb}

### Parameter des Antworttexts (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" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-POST-operators__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.requestorId | GUID für den registrierten Operator. Verwenden Sie diesen Wert, um CI-Aktionen und Betriebsstatus festzulegen. Datentyp: Zeichenfolge |
| result.result | Kennzeichnung, die angibt, ob der Operator erfolgreich registriert wurde. Mögliche Werte: * wahr: 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-Lebenszyklus-Management -- POST /now/cilifecyclemgmt/statuses {#ariaid-title14}

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

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

URL mit Versionsnummer: /api/now/{api_version}/cilifecyclemgmt/statuses

Standard-URL: /api/now/cilifecyclemgmt/statuses

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

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

| Name | Beschreibung |
|-|-|
| alteOpsLabels | Kommagetrennte Liste der alten CI-Betriebsstatus, in der alle CIs enthalten sein sollen. Datentyp: Zeichenfolge |
| opsLabel | Erforderlich. Bezeichnung des Betriebsstatus, der für die angegebenen CIs festgelegt werden soll. Datentyp: Zeichenfolge |
| requestorId | Erforderlich. Sys_id eines Workflow-Kontexts oder eine vom Endpunkt [CI-Lebenszyklusmanagement -- POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/zeQddOtj5gku59iGDl_q1Q#cilifecyclemgmt-POST-operators "Registriert einen Operator für einen Nicht-Workflow-Anwender.") zurückgegebene Operator-Anwender-ID. Die IDs der Operator-Anwender befinden sich in der Tabelle „CI Status registrierter Anwender" \[statemgmt_register_users\]. Datentyp: Zeichenfolge |
| sysIds | Erforderlich. Kommagetrennte Liste der 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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cilifecyclemgmt-POST-statuses__entry__20}{#cilifecyclemgmt-POST-statuses__accept-RESTAPI}{#cilifecyclemgmt-POST-statuses__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 76. Anforderungskopfzeilen]

{#cilifecyclemgmt-POST-statuses__entry__26}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 77. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 vom Endpunkt erfolgreich verarbeitet. Überprüfen Sie den Parameter des Antworttexts result.result, um das Ergebnis des Vorgangs zu überprüfen. Wenn für den Endpunkt bei der Verarbeitung der Anforderung Fehler auftreten, werden im Parameter des Antworttexts result.errors Fehlercodes und Meldungen angezeigt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 78. Statuscodes]

### Parameter des Antworttexts (JSON oder XML)

{#cilifecyclemgmt-POST-statuses__entry__38}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das das Ergebnis der Anforderung kapselt. Datentyp: Objekt "result": { "errors": [Array], "result": "String" } |
| result.errors | Liste von Objekten, in der 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 Statusmanagementfehler, der bei der Verarbeitung der Anforderung aufgetreten ist. Mögliche Werte: * CI_ACTION_ALREADY_SET * CI_AKTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBEL_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * UNGÜLTIGE_EINGABETASTE_PARAMETER * UNGÜLTIGE_MIETZEIT * INVALID_OPS_STATUS * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_NICHT VERFÜGBAR * NOT_ALLOWED_CI_ACTION * OPS_STATUS_NOT_SET * UNPRIORITÄT_OPS_STATUS * NICHT UNTERSTÜTZT_SYS_ID {#cilifecyclemgmt-POST-statuses__ul_ghk_2fk_lmb} Datentyp: Zeichenfolge |
| Ergebnis.Fehler.Nachricht | Nachricht mit Details zum zugeordneten error. Datentyp: Zeichenfolge |
| result.result | Kennzeichnung, die angibt, ob der gewünschte Zustand für alle in der Anforderung enthaltenen CIs festgelegt wurde. Mögliche Werte: * true: Betriebsstatus festgelegt. * „falsch": Betriebsstatus nicht festgelegt. {#cilifecyclemgmt-POST-statuses__ul_hsp_chn_dmb} Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Legen Sie den Betriebsstatus „ `Reparatur in Bearbeitung` " für zwei CIs fest.

    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, dass der gewünschte Betriebsstatus für beide in der Anforderung angegebenen CIs festgelegt wurde.

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