---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CI ライフサイクル管理 API

# CI ライフサイクル管理 API {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：60分

CI ライフサイクル管理 API は、構成アイテム (CI) の運用状況を操作し、CI アクションを適用するためのエンドポイントを提供します。
API インターフェイスは、許可されていない CI アクション、互換性のある CI アクション、および許可されていない運用上の移行によって指定された制限と許可に準拠しています。インターフェイスが制限付き操作を試みると、その操作はブロックされ、エラーが記録され、必要に応じてタスクが作成されます。

## CI ライフサイクル管理:DELETE /now/cilifecyclemgmt/actions {#ariaid-title2}

CI のリストの構成アイテム (CI) アクションを削除します。

### URL 形式 {#cilifecyclemgmt-DELETE-actions__section_fcm_jph_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/actions

デフォルト URL: /api/now/cilifecyclemgmt/actions  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

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

| 名前 | 説明 |
|-|-|
| actionName | 必須です。構成アイテムアクション名。 データタイプ：文字列 |
| requestorId | 必須です。 ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。 データタイプ：文字列 |
| sysIds | 必須です。CI sys_idsのカンマ区切りリスト。 データタイプ：文字列 |
[表 : 2. クエリパラメーター]

{#cilifecyclemgmt-DELETE-actions__entry__14}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-DELETE-actions__entry__18}{#cilifecyclemgmt-DELETE-actions__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]

{#cilifecyclemgmt-DELETE-actions__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

{#cilifecyclemgmt-DELETE-actions__table_od5_2wf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-DELETE-actions__entry__34}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-DELETE-actions__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | CI アクションが正常に削除されたかどうかを示すフラグ。 可能な値： * true:CI アクションが削除されました。 * false:CI アクションは削除されませんでした。 {#cilifecyclemgmt-DELETE-actions__ul_psg_lsh_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

2 つの CI から CI アクションを削除します。

    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"

応答本文は、CI アクションが CI から削除されたことを確認します。

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

## CI ライフサイクル管理 - DELETE /now/cilifecyclemgmt/operators/{req_id} {#ariaid-title3}

ワークフロー以外のユーザーのオペレーターの登録を解除します。

### URL 形式 {#cilifecyclemgmt-DELETE-operators__section_xyw_syh_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/operators/{req_id}

デフォルト URL: /api/now/cilifecyclemgmt/operators/{req_id}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| パラメーター | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| req_id | ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。{#cilifecyclemgmt-DELETE-operators__req-id-table-p} データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#cilifecyclemgmt-DELETE-operators__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 8. クエリパラメーター]

{#cilifecyclemgmt-DELETE-operators__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 9. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-DELETE-operators__entry__16}{#cilifecyclemgmt-DELETE-operators__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 10. 要求ヘッダー]

{#cilifecyclemgmt-DELETE-operators__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 12. ステータスコード]

{#cilifecyclemgmt-DELETE-operators__table_hsj_2wf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb__entry__2}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-DELETE-operators__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | オペレーターが正常に登録解除されたかどうかを示すフラグ。 可能な値： * true:オペレーターの登録は正常に解除されました。 * false:オペレーターの登録が正常に解除されませんでした。 {#cilifecyclemgmt-DELETE-operators__ul_mkt_tlk_lmb} データタイプ：文字列 |
[ ]

{#cilifecyclemgmt-DELETE-operators__table_kkt_tlk_lmb}  

### cURL 要求

ユーザー ID でオペレーターを登録解除します。

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

応答本文は、オペレーターが登録解除されたことを確認します。

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

## CI ライフサイクル管理:GET /now/cilifecyclemgmt/actions/{sys_id} {#ariaid-title4}

指定された CI のアクティブな構成アイテム (CI) アクションのリストを返します。

### URL 形式 {#cilifecyclemgmt-GET-actions__section_m1y_5xm_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/actions/{sys_id}

デフォルト URL: /api/now/cilifecyclemgmt/actions/{sys_id}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | 関連する CI アクションを返す CI のSys_id。 データタイプ：文字列 |
[表 : 13. パスパラメーター]

{#cilifecyclemgmt-GET-actions__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 14. クエリパラメーター]

{#cilifecyclemgmt-GET-actions__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 15. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-actions__entry__16}{#cilifecyclemgmt-GET-actions__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 16. 要求ヘッダー]

{#cilifecyclemgmt-GET-actions__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 17. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.ciActions パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 18. ステータスコード]

{#cilifecyclemgmt-GET-actions__table_lrs_cwf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-actions__entry__32}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.ciActions | CI のアクティブな CI アクションのカンマ区切りリスト。何も見つからない場合は `no_active_action` 。 データタイプ：文字列 |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-actions__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | 指定されたすべての CI に対してアクティブな CI アクションのリストが返されたかどうかを示すフラグ。 可能な値： * true:アクティブな CI アクションのリストが返されました。 * false:アクティブな CI アクションのリストが返されませんでした。 {#cilifecyclemgmt-GET-actions__ul_psg_lsh_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

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

応答本文には、指定された CI に対してアクティブな CI アクションがないことが示されます。

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

## CI ライフサイクル管理:GET /now/cilifecyclemgmt/compatActions {#ariaid-title5}

指定された 2 つの構成アイテム (CI) アクションに互換性があるかどうかを判断します。

### URL 形式 {#cilifecyclemgmt-GET-compatAction__section_rgg_g2n_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/compatActions

デフォルト URL: /api/now/cilifecyclemgmt/compatActions  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 19. パスパラメーター]

{#cilifecyclemgmt-GET-compatAction__entry__6}

| 名前 | 説明 |
|-|-|
| actionName | 必須です。比較する CI アクションの名前。 データタイプ：文字列 |
| その他のアクション名 | 必須です。比較する CI アクションの名前。 データタイプ：文字列 |
[表 : 20. クエリパラメーター]

{#cilifecyclemgmt-GET-compatAction__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 21. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-compatAction__entry__16}{#cilifecyclemgmt-GET-compatAction__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 22. 要求ヘッダー]

{#cilifecyclemgmt-GET-compatAction__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 23. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 24. ステータスコード]

{#cilifecyclemgmt-GET-compatAction__table_vz1_cwf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-compatAction__entry__32}

| 名前 | 説明 |
|-|-|
| result | 指定された 2 つの CI アクションに互換性があるかどうかを示すフラグ。 可能な値： * true:CI アクションに互換性があります。 * false:CI アクションに互換性がありません。 {#cilifecyclemgmt-GET-compatAction__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

パッチ適用とプロビジョニング CI アクションの互換性を確認します。

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

応答本文は、2 つの CI アクションに互換性があることを確認します。

    {
      "result": true
    }

## CI ライフサイクル管理:GET /now/cilifecyclemgmt/leases/{sys_id}/expired {#ariaid-title6}

指定された CI に適用される構成アイテム (CI) アクションの要求者のリースが期限切れかどうかを判断します。

### URL 形式 {#cilifecyclemgmt-GET-leases-expired__section_kgl_mjn_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}/expired

デフォルト URL: /api/now/cilifecyclemgmt/leases/{sys_id}/expired  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | 適用された CI アクションのターゲットである CI のSys_id。 データタイプ：文字列 |
[表 : 25. パスパラメーター]

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

| 名前 | 説明 |
|-|-|
| actionName | 必須です。指定された CI に適用される CI アクションの名前。 データタイプ：文字列 |
| requestorId | 必須です。 ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。 データタイプ：文字列 |
[表 : 26. クエリパラメーター]

{#cilifecyclemgmt-GET-leases-expired__entry__14}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 27. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-leases-expired__entry__18}{#cilifecyclemgmt-GET-leases-expired__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 28. 要求ヘッダー]

{#cilifecyclemgmt-GET-leases-expired__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 29. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 30. ステータスコード]

{#cilifecyclemgmt-GET-leases-expired__table_hwr_bwf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-leases-expired__entry__34}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-leases-expired__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | 適用された CI アクションの要求者のリースが期限切れになったかどうかを示すフラグ。 可能な値： * true:要求者のリースは期限切れです。 * false:要求者のリースは期限切れになっていません。 {#cilifecyclemgmt-GET-leases-expired__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

    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"

応答本文は、適用された CI アクションの要求者のリースが期限切れになっていないことを示しています。

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

## CI ライフサイクル管理:GET /now/cilifecyclemgmt/notAllowedAction {#ariaid-title7}

指定された運用ステータスにあるときに、指定された構成アイテム (CI) アクションが指定されたクラスの CI に対して許可されないかどうかを決定します。

### URL 形式 {#cilifecyclemgmt-GET-notAllowedAct__section_wbv_pln_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/notAllowedAction

デフォルト URL: /api/now/cilifecyclemgmt/notAllowedAction  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 31. パスパラメーター]

{#cilifecyclemgmt-GET-notAllowedAct__entry__6}

| 名前 | 説明 |
|-|-|
| actionName | 必須です。チェックする CI アクションの名前。 データタイプ：文字列 |
| ciClass | 必須です。CI クラス。 データタイプ：文字列 |
| opsLabel | 必須です。確認する運用ステータス。 データタイプ：文字列 |
[表 : 32. クエリパラメーター]

{#cilifecyclemgmt-GET-notAllowedAct__entry__14}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 33. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-notAllowedAct__entry__18}{#cilifecyclemgmt-GET-notAllowedAct__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 34. 要求ヘッダー]

{#cilifecyclemgmt-GET-notAllowedAct__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 35. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 36. ステータスコード]

{#cilifecyclemgmt-GET-notAllowedAct__table_qqg_bwf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-notAllowedAct__entry__34}

| 名前 | 説明 |
|-|-|
| result | 指定された運用ステータスにあるときに、指定されたタイプの CI に対して CI アクションが制限される (許可されない) かどうかを示すフラグ。 可能な値： * true:CI アクションは制限されています (許可されていません)。 * false:CI アクションは制限なし (許可されています) です。 {#cilifecyclemgmt-GET-notAllowedAct__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

DR スタンバイ運用ステータスのコンピューターに対してパッチ適用 CI アクションが制限されている (許可されていない) かどうかを確認します。

    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"

応答本文は、指定された運用ステータスにあるときに、このアクションが指定された CI クラスに対して制限されている (許可されていない) ことを確認します。

    {
      "result": true
    }

## CI ライフサイクル管理:GET /now/cilifecyclemgmt/notAllowedOpsTransition {#ariaid-title8}

指定されたクラスの構成アイテム (CI) が、指定された運用ステータスから指定された 2 番目の運用ステータスに移行できるかどうかを決定します。

### URL 形式 {#cilifecyclemgmt-GET-notAllowedOps__section_dmp_44n_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/notAllowedOpsTransition

デフォルト URL: /api/now/cilifecyclemgmt/notAllowedOpsTransition  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 37. パスパラメーター]

{#cilifecyclemgmt-GET-notAllowedOps__entry__6}

| 名前 | 説明 |
|-|-|
| ciClass | 必須です。移行制限を確認する CI クラス。 データタイプ：文字列 |
| opsLabel | 必須です。現在の CI 運用ステータスのラベル。 データタイプ：文字列 |
| transitionOpsLabel | 必須です。移行のターゲットである運用ステータスのラベル。 データタイプ：文字列 |
[表 : 38. クエリパラメーター]

{#cilifecyclemgmt-GET-notAllowedOps__entry__14}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 39. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-notAllowedOps__entry__18}{#cilifecyclemgmt-GET-notAllowedOps__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 40. 要求ヘッダー]

{#cilifecyclemgmt-GET-notAllowedOps__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 41. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 42. ステータスコード]

{#cilifecyclemgmt-GET-notAllowedOps__table_clt_1wf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-notAllowedOps__entry__34}

| 名前 | 説明 |
|-|-|
| result | 指定された CI クラスに対して、指定された運用ステータスの移行が制限されている (許可されない) かどうかを示すフラグ。 可能な値： * true:運用ステータスの移行は制限されています (許可されていません)。 * false:運用ステータスの移行は制限なし (許可) です。 {#cilifecyclemgmt-GET-notAllowedOps__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

Linux サーバー CI について、\[廃止\] 運用ステータスから DR スタンバイ運用ステータスへの移行が制限付き (許可されない) かどうかを確認します。

    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"

応答本文は、指定された運用ステータスの移行がこの CI クラスに対して無制限 (許可) であることを示しています。

    {
      "result": false
    }

## CI ライフサイクル管理:GET /now/cilifecyclemgmt/requestors/{req_id}/valid {#ariaid-title9}

指定されたアクティブなワークフローユーザーまたは登録されたユーザーが有効な要求者かどうかを決定します。

### URL 形式 {#cilifecyclemgmt-GET-req-valid__section_gdl_3d4_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/requestors/{req_id}/valid

デフォルト URL: /api/now/cilifecyclemgmt/requestors/{req_id}/valid  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| req_id | ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。{#cilifecyclemgmt-GET-req-valid__req-id-table-p} データタイプ：文字列 |
[表 : 43. パスパラメーター]

{#cilifecyclemgmt-GET-req-valid__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 44. クエリパラメーター]

{#cilifecyclemgmt-GET-req-valid__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 45. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-req-valid__entry__16}{#cilifecyclemgmt-GET-req-valid__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 46. 要求ヘッダー]

{#cilifecyclemgmt-GET-req-valid__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 47. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 48. ステータスコード]

{#cilifecyclemgmt-GET-req-valid__table_mbj_1wf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-req-valid__entry__32}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-req-valid__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | 指定されたアクティブなワークフローユーザーまたは登録されたユーザーが有効な要求者であるかどうかを示すフラグ。 可能な値： * true:有効な要求者。 * false:無効な要求者。 {#cilifecyclemgmt-GET-req-valid__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

    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 ライフサイクル管理:GET /now/cilifecyclemgmt/statuses/{sys_id} {#ariaid-title10}

指定された構成アイテム (CI) の現在の運用ステータスを返します。

### URL 形式 {#cilifecyclemgmt-GET-statuses__section_bgd_bf4_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/statuses/{sys_id}

デフォルト URL: /api/now/cilifecyclemgmt/statuses/{sys_id}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | CI のSys_id。 データタイプ：文字列 |
[表 : 49. パスパラメーター]

{#cilifecyclemgmt-GET-statuses__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 50. クエリパラメーター]

{#cilifecyclemgmt-GET-statuses__entry__12}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 51. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-GET-statuses__entry__16}{#cilifecyclemgmt-GET-statuses__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 52. 要求ヘッダー]

{#cilifecyclemgmt-GET-statuses__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 53. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 54. ステータスコード]

{#cilifecyclemgmt-GET-statuses__table_pdp_yvf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-GET-statuses__entry__32}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-GET-statuses__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.operationalStates | 指定された CI の運用ステータス。ステータスが指定されていない場合は `不明` です。 データタイプ：文字列 |
[ ]

### cURL 要求

    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 ライフサイクル管理:PATCH /now/cilifecyclemgmt/leases/{sys_id} {#ariaid-title11}

指定されたユーザーの指定された構成アイテム (CI) アクションのリース有効期限を延長します。
前のリース期間が切れている場合は、新しいリース時間がすぐに開始されます。

### URL 形式 {#cilifecyclemgmt-PATCH-leases__section_c22_hp4_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/leases/{sys_id}

デフォルト URL: /api/now/cilifecyclemgmt/leases/{sys_id}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | リースを延長する CI のSys_id。 データタイプ：文字列 |
[表 : 55. パスパラメーター]

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

| 名前 | 説明 |
|-|-|
| actionName | 必須です。関連付けられた CI アクションの名前。 データタイプ：文字列 |
| leaseTime | 必須です。actionNameで指定された CI アクションに対してリースが有効な期間。 データタイプ：文字列 形式:HH:MM:SS |
| requestorId | 必須です。 ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。 データタイプ：文字列 |
[表 : 56. クエリパラメーター]

{#cilifecyclemgmt-PATCH-leases__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 57. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-PATCH-leases__entry__20}{#cilifecyclemgmt-PATCH-leases__accept-RESTAPI}{#cilifecyclemgmt-PATCH-leases__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 58. 要求ヘッダー]

{#cilifecyclemgmt-PATCH-leases__entry__26}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 59. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 60. ステータスコード]

{#cilifecyclemgmt-PATCH-leases__table_rwq_xvf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-PATCH-leases__entry__38}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-PATCH-leases__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | リース時間が延長されたかどうかを示すフラグ。 可能な値： * true:リース時間が延長されました。 * false:リース時間が延長されませんでした。 {#cilifecyclemgmt-PATCH-leases__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

パッチ適用 CI アクション要求者のリース期間を 24 時間延長します。

    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 ライフサイクル管理:POST /now/cilifecyclemgmt/actions {#ariaid-title12}

指定された構成アイテム (CI) アクションを指定された CI のリストに追加します。

### URL 形式 {#cilifecyclemgmt-POST-actions__section_lmz_dv4_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/actions

デフォルト URL: /api/now/cilifecyclemgmt/actions  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 61. パスパラメーター]

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

| 名前 | 説明 |
|-|-|
| actionName | 必須です。リストに追加する CI アクションの名前。 データタイプ：文字列 |
| leaseTime | 指定された CI アクションに対してリースが有効な期間。 データタイプ：文字列 形式:HH:MM:SS |
| oldActionName | すべての CI を含めるべき古い CI アクションのカンマ区切りリスト。 データタイプ：文字列 |
| requestorId | 必須です。 ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。 データタイプ：文字列 |
| sysIds | 必須です。CI アクションを追加する CI sys_idsのカンマ区切りリスト。 データタイプ：文字列 |
[表 : 62. クエリパラメーター]

{#cilifecyclemgmt-POST-actions__entry__18}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 63. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-POST-actions__entry__22}{#cilifecyclemgmt-POST-actions__accept-RESTAPI}{#cilifecyclemgmt-POST-actions__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 64. 要求ヘッダー]

{#cilifecyclemgmt-POST-actions__entry__28}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 65. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 66. ステータスコード]

{#cilifecyclemgmt-POST-actions__table_wj1_xvf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-POST-actions__entry__40}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-POST-actions__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | リスト内のすべての CI に対して CI アクションが設定されたかどうかを示すフラグ。 可能な値： * true:CI アクションが設定されました。 * false:CI アクションが設定されていません。 {#cilifecyclemgmt-POST-actions__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

2 つの CI にパッチ適用 CI アクションを追加します。

    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 ライフサイクル管理:POST /now/cilifecyclemgmt/operators {#ariaid-title13}

ワークフロー以外のユーザーのオペレーターを登録します。

### URL 形式 {#cilifecyclemgmt-POST-operators__section_b3l_kv4_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/operators

デフォルト URL: /api/now/cilifecyclemgmt/operators  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 67. パスパラメーター]

{#cilifecyclemgmt-POST-operators__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 68. クエリパラメーター]

{#cilifecyclemgmt-POST-operators__entry__10}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 69. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-POST-operators__entry__14}{#cilifecyclemgmt-POST-operators__accept-RESTAPI}{#cilifecyclemgmt-POST-operators__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 70. 要求ヘッダー]

{#cilifecyclemgmt-POST-operators__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 71. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 72. ステータスコード]

{#cilifecyclemgmt-POST-operators__table_oj2_wvf_mmb}

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-POST-operators__entry__32}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-POST-operators__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.requestorId | 登録された演算子の GUID。この値を使用して、CI アクションと運用状況を設定します。 データタイプ：文字列 |
| result.result | オペレーターが正常に登録されたかどうかを示すフラグ。 可能な値： * true:オペレーターが正常に登録されました。 * false:オペレーターが正常に登録されませんでした。 {#cilifecyclemgmt-POST-operators__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

    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 ライフサイクル管理:POST /now/cilifecyclemgmt/statuses {#ariaid-title14}

構成アイテム (CI) の指定されたリストの運用ステータスを設定します。

### URL 形式 {#cilifecyclemgmt-POST-statuses__section_shp_tw4_dmb}

バージョニングされた URL: /api/now/{api_version}/cilifecyclemgmt/statuses

デフォルト URL: /api/now/cilifecyclemgmt/statuses  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

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

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 73. パスパラメーター]

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

| 名前 | 説明 |
|-|-|
| oldOpsLabels | すべての CI を含める必要がある古い CI 運用状況のカンマ区切りリスト。 データタイプ：文字列 |
| opsLabel | 必須です。指定された CI に設定する運用ステータスのラベル。 データタイプ：文字列 |
| requestorId | 必須です。 ワークフローコンテキストのSys_id、または [CI ライフサイクル管理:POST /now/cilifecyclemgmt/operators](https://servicenow-prod.fluidtopics.net/y~G5Hlr~FpNjEv78LyCm0A#cilifecyclemgmt-POST-operators "ワークフロー以外のユーザーのオペレーターを登録します。") エンドポイントから返されたオペレーターユーザー ID。 オペレーターユーザー ID は、CI ステータス登録ユーザー \[statemgmt_register_users\] テーブルにあります。 データタイプ：文字列 |
| sysIds | 必須です。運用ステータスを設定する CI のsys_idsのカンマ区切りリスト。 データタイプ：文字列 |
[表 : 74. クエリパラメーター]

{#cilifecyclemgmt-POST-statuses__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 75. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#cilifecyclemgmt-POST-statuses__entry__20}{#cilifecyclemgmt-POST-statuses__accept-RESTAPI}{#cilifecyclemgmt-POST-statuses__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 76. 要求ヘッダー]

{#cilifecyclemgmt-POST-statuses__entry__26}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 77. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求はエンドポイントによって正常に処理されました。 応答本文 result.result パラメーターを確認して、操作の結果を確認します。 要求の処理中にエンドポイントでエラーが発生した場合、エラーコードとメッセージが応答本文 result.errors パラメーターに表示されます。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 78. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#cilifecyclemgmt-POST-statuses__entry__38}

| 名前 | 説明 |
|-|-|
| result | 要求の結果をカプセル化するオブジェクト。 データタイプ: オブジェクト "result": { "errors": [Array], "result": "String" } |
| result.errors | 各オブジェクトが要求の処理中に発生したエラーを表すオブジェクトのリスト。 データタイプ：アレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.errors.error | 要求の処理中に発生した状況管理エラーの識別子。 可能な値： * CI_ACTION_ALREADY_SET * CI_ACTION_NOT_SET * DUPLICATE_CI_ACTION_RECORD * DUPLICATE_OPS_STATE_RECORD * DUPLICATE_SYS_ID * INCOMPATIBLE_CI_ACTION * INVALID_CI_ACTION * INVALID_DELETE * INVALID_INPUT_PARAMETERS * INVALID_LEASETIME * INVALID_OPS_STATE * INVALID_OPS_STATE_TRANSITION * INVALID_REQUESTOR * INVALID_REQUESTOR_FOR_CI * INVALID_SYS_ID * MUTEX_UNAVAILABLE * NOT_ALLOWED_CI_ACTION * OPS_STATE_NOT_SET * UNPRIORITIZED_OPS_STATE * UNSUPPORTED_SYS_ID {#cilifecyclemgmt-POST-statuses__ul_ghk_2fk_lmb} データタイプ：文字列 |
| result.errors.message | 関連する errorの詳細を提供するメッセージ。 データタイプ：文字列 |
| result.result | 要求に含まれるすべての CI に適切な状況が設定されているかどうかを示すフラグ。 可能な値： * true:運用ステータスが設定されました。 * false:運用ステータスが設定されていません。 {#cilifecyclemgmt-POST-statuses__ul_hsp_chn_dmb} データタイプ：文字列 |
[ ]

### cURL 要求

2 つの CI の \[ `修理中` \] 運用ステータスを設定します。

    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"

応答本文は、要求で指定された両方の CI に対して目的の運用ステータスが設定されたことを示しています。

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