---
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


---

# CdmSnapshotApi

# CdmSnapshotApi {#ariaid-title1}

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

CdmSnapshotAPI は、構成データ管理 (CDM) でスナップショットを公開、非公開、および再検証できるようにするエンドポイントを提供します。
スナップショットを公開してエクスポートできるようにすると、 継続的インテグレーションと継続的デリバリ (CICD) パイプラインが関連する構成データにアクセスして使用できるようになります。エクスポーターは、公開されたスナップショットでのみ実行できます。スナップショットが不要になった場合は、スナップショットを非公開にすることで、スナップショットが実行可能かどうかに関する混乱を軽減できます。  
この API にアクセスするには、次のいずれかのロールが必要です。

* スクリプト済み REST CDM ビュー ACL (sn_cdm.cdm.viewer)
* スクリプト済み REST CDM エディター ACL (sn_cdm.cdm_editor)

さらに、この API をインスタンスで使用するには、 構成データ管理 (CDM) プラグインをアクティブ化する必要があります。

スナップショットの詳細については、「 [スナップショットの表示」](https://www.servicenow.com/docs/access?context=cdm-snapshots-view-list&version=australia&pubname=australia-it-service-management&ft:locale=en-US)を参照してください。

## CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/publish {#ariaid-title2}

指定された未公開のスナップショットを公開します。
スナップショットを公開する前に、スナップショットを検証する必要があります。[CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/validate](https://servicenow-prod.fluidtopics.net/pvyl7R6DeMBfuzsCI7Evzg#snapshot-POST-validate "指定された未公開のスナップショットを検証します。") エンドポイントを使用してスナップショットを検証したり、コミットの実行時にスナップショットを自動的に検証したりできます。スナップショットを公開するには、展開可能項目をサービスに接続する必要があります。また、スナップショットが既に公開されている場合、要求は失敗します。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/snapshots/{snapshot_id}/publish

デフォルト URL: /api/sn_cdm/snapshots/{snapshot_id}/publish  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

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

{#snapshot-POST-publish__entry__2}{#snapshot-POST-publish__version-not_optional-RESTAPI}

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

{#snapshot-POST-publish__entry__8}

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

{#snapshot-POST-publish__entry__12}

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

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 4. 要求ヘッダー]

{#snapshot-POST-publish__entry__22}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

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

{#snapshot-POST-publish__entry__34}

| 名前 | 説明 |
|-|-|
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| status | 要求のエラーステータス。 可能な値:失敗 データタイプ：文字列 |
[ ]

### cURL 要求

次の例は、3a168d9dc342301054c1582e1340dd68 のsys_idでスナップショットを公開する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/snapshots/3a168d9dc342301054c1582e1340dd68/publish"\ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \
    --user 'username':'password' 

公開要求に対する成功と失敗の両方の応答を次に示します。

    // Example of a successful response
    { 
      "" 
    }

    // Example of an error response
    {
      "error": {
        "message": "Error: Unexpected error occurred in publish request.Error:Snapshot not found",
        "detail": ""
      },
      "status": "failure"
    }

## CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/unpublish {#ariaid-title3}

以前に公開されたスナップショットを非公開にします。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/snapshots/{snapshot_id}/unpublish

デフォルト URL: /api/sn_cdm/snapshots/{snapshot_id}/unpublish  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

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

{#snapshot-POST-unpublish__entry__2}{#snapshot-POST-unpublish__version-not_optional-RESTAPI}

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

{#snapshot-POST-unpublish__entry__8}

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

{#snapshot-POST-unpublish__entry__12}

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

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 10. 要求ヘッダー]

{#snapshot-POST-unpublish__entry__22}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 12. ステータスコード]

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

{#snapshot-POST-unpublish__entry__34}

| 名前 | 説明 |
|-|-|
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| status | 要求のエラーステータス。 可能な値:失敗 データタイプ：文字列 |
[ ]

### cURL 要求

次の例は、3a168d9dc342301054c1582e1340dd68 のsys_idでスナップショットを非公開にする方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/snapshots/3a168d9dc342301054c1582e1340dd68/unpublish"\ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \
    --user 'username':'password' 

非公開要求に対する成功と失敗の両方の応答を次に示します。

    // Example of a successful response
    { 
      "" 
    }

    // Example of an error response
    {
      "error": {
        "message": "Error: Unexpected error occurred in publish request.Error:Snapshot not found",
        "detail": ""
      },
      "status": "failure"
    }

## CdmSnapshotAPI - POST /sn_cdm/snapshots/{snapshot_id}/validate {#ariaid-title4}

指定された未公開のスナップショットを検証します。
検証は非同期プロセスとして実行されます。このエンドポイントを呼び出すと、検証プロセスのみが開始されます。この呼び出しから返される結果は、検証プロセスが開始されたかどうかのみを示し、検証自体の結果は示しません。スナップショットが検証済みかどうかを確認するには、 テーブル API を使用してスナップショットを見つけ、その検証ステータスを確認します。  
注:  
公開されたスナップショットは検証できません。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/snapshots/{snapshot_id}/validate

デフォルト URL: /api/sn_cdm/snapshots/{snapshot_id}/validate  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

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

{#snapshot-POST-validate__entry__2}{#snapshot-POST-validate__version-not_optional-RESTAPI}

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

{#snapshot-POST-validate__entry__8}

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

{#snapshot-POST-validate__entry__12}

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

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 16. 要求ヘッダー]

{#snapshot-POST-validate__entry__22}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。指定されたスナップショットは既に公開されているか、見つかりません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 18. ステータスコード]

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

{#snapshot-POST-validate__entry__34}

| 名前 | 説明 |
|-|-|
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| status | 要求のエラーステータス。 可能な値:失敗 データタイプ：文字列 |
[ ]

### cURL 要求

次の例は、3a168d9dc342301054c1582e1340dd68 のsys_idでスナップショットを検証する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/snapshots/3a168d9dc342301054c1582e1340dd68/validate"\ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \
    --user 'username':'password' 

次に、検証要求に対する成功応答と失敗応答の両方を示します。

    // Example of a successful response
    { 
      "" 
    }

    // Example of an error response
    {
      "error": {
        "message": "Invalid Snapshot id:test",
        "detail": ""
      },
      "status": "failure"
    }

## CdmSnapshotApi - PUT /sn_cdm/snapshots/publish {#ariaid-title5}

指定された未公開のスナップショットを公開します。
スナップショットを公開する前に、スナップショットを検証する必要があります。[CdmSnapshotApi - PUT /sn_cdm/snapshots/validate](https://servicenow-prod.fluidtopics.net/pvyl7R6DeMBfuzsCI7Evzg#snapshot-PUT-validate "指定された未公開スナップショットを、マッピングされたポリシーに対して検証します。") エンドポイントを使用してスナップショットを検証したり、コミットの実行時にスナップショットを自動的に検証したりできます。スナップショットを公開するには、展開可能項目をサービスに接続する必要があります。また、スナップショットが既に公開されている場合、要求は失敗します。

このエンドポイントの呼び出し元には、CDM エディターロールが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/snapshots/publish

デフォルト URL: /api/sn_cdm/snapshots/publish  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

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

{#snapshot-PUT-publish__entry__2}{#snapshot-PUT-publish__version-not_optional-RESTAPI}

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

{#snapshot-PUT-publish__id_evn_23g_15b__entry__2}{#snapshot-PUT-publish__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| appName | 必須です。スナップショットを作成する 構成データ管理 (CDM) アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。スナップショットを作成する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| name | 必須です。スナップショットの名前。 データタイプ：文字列 テーブル:CDM スナップショット \[sn_cdm_snapshot\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
[表 : 20. クエリパラメーター]

{#snapshot-PUT-publish__id_evn_23g_15b} {#snapshot-PUT-publish__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 21. 要求本文のパラメーター]

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 22. 要求ヘッダー]

{#snapshot-PUT-publish__entry__26}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 24. ステータスコード]

### 応答本文のパラメーター

{#snapshot-PUT-publish__id_lrr_frg_15b__entry__2}

| 名前 | 説明 |
|-|-|
| cdm_application_id | スナップショットに関連付けられた CDM アプリケーションの詳細。 データタイプ: オブジェクト "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | REST テーブル API を使用して CDM アプリケーションレコードにアクセスするために使用する呼び出し。 データタイプ：文字列 |
| cdm_application_id.value | 関連付けられた CDM アプリケーションレコードのSys_id。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| cdm_deployable_id | スナップショットに関連付けられた CDM 展開可能項目の詳細。 データタイプ: オブジェクト "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | Table REST API を使用してこの展開可能レコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| cdm_deployable_id.value | 展開可能レコードのSys_id。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| changeset_id | スナップショットに関連付けられた変更セットの詳細。 データタイプ: オブジェクト "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Table REST API を使用してこの変更セットレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| changeset_id.value | 変更セットレコードの一意の識別子。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| description | スナップショットの簡単な説明。 データタイプ：文字列 |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| last_published | スナップショットが最後に公開された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| last_validated | スナップショットが最後に検証された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| name | スナップショットの名前。 データタイプ：文字列 |
| number | スナップショットを識別する一意の番号。この値は、人間が判読できるマッピングの識別子を提供します。 データタイプ：文字列 |
| 公開済み | スナップショットが公開されたかどうかを示すフラグ。 可能な値： * true:スナップショットが公開されました。 * false:スナップショットは公開されませんでした。 データタイプ：ブーリアン |
| sys_created_by | スナップショットを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | スナップショットが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | スナップショットのSys_id。 データタイプ：文字列 テーブル:CDM スナップショット \[sn_cdm_snapshot\] |
| sys_updated_by | スナップショットを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | スナップショットが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| 妥当性検証 | スナップショットの現在の検証ステータス。 可能な値： * execution_error * 失敗 * 進行中 * not_validated * 合格 * passed_with_exception * 要求済み データタイプ：文字列 |
[ ]

{#snapshot-PUT-publish__id_lrr_frg_15b}  

### cURL 要求

このコード例は、スナップショットを公開する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/snapshots/publish?deployableName=Development_1&name=Development_1-v1.dpl&appName=testApp" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

結果を返します:

     
    { 
      "result": { 
        "changeset_id": { 
          "value": "d4b9446e53001110a1d3ddeeff7b126c", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d4b9446e53001110a1d3ddeeff7b126c" 
        }, 
        "cdm_deployable_id": { 
          "value": "6dc517a953b70110a1d3ddeeff7b129b", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_deployable/6dc517a953b70110a1d3ddeeff7b129b" 
        }, 
        "description": null, 
        "cdm_application_id": { 
          "value": "62b517a953b70110a1d3ddeeff7b128c", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
        }, 
        "published": true, 
        "sys_updated_on": "2022-06-30 12:57:02", 
        "last_published": "2022-06-30 12:57:02", 
        "number": "SNAP0001002", 
        "sys_id": "9017fc2e53801110a1d3ddeeff7b12d7", 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-15 14:19:38", 
        "name": "Development_1-v2.dpl", 
        "last_validated": "2022-06-30 12:56:07", 
        "validation": "passed", 
        "sys_created_by": "admin" 
      } 
    }

## CdmSnapshotApi - PUT /sn_cdm/snapshots/unpublish {#ariaid-title6}

以前に公開されたスナップショットを非公開にします。
<br />

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/snapshots/unpublish

デフォルト URL: /api/sn_cdm/snapshots/unpublish  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

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

{#snapshot-PUT-unpublish__entry__2}{#snapshot-PUT-unpublish__version-not_optional-RESTAPI}

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

{#snapshot-PUT-unpublish__entry__6}{#snapshot-PUT-unpublish__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| appName | 必須です。スナップショットを作成する 構成データ管理 (CDM) アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。スナップショットを作成する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| name | 必須です。スナップショットの名前。 データタイプ：文字列 テーブル:CDM スナップショット \[sn_cdm_snapshot\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
[表 : 26. クエリパラメーター]

{#snapshot-PUT-unpublish__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 27. 要求本文のパラメーター]

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 28. 要求ヘッダー]

{#snapshot-PUT-unpublish__entry__26}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 30. ステータスコード]

### 応答本文のパラメーター

{#snapshot-PUT-unpublish__entry__38}

| 名前 | 説明 |
|-|-|
| cdm_application_id | スナップショットに関連付けられた CDM アプリケーションの詳細。 データタイプ: オブジェクト "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | REST テーブル API を使用して CDM アプリケーションレコードにアクセスするために使用する呼び出し。 データタイプ：文字列 |
| cdm_application_id.value | 関連付けられた CDM アプリケーションレコードのSys_id。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| cdm_deployable_id | スナップショットに関連付けられた CDM 展開可能項目の詳細。 データタイプ: オブジェクト "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | Table REST API を使用してこの展開可能レコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| cdm_deployable_id.value | 展開可能レコードのSys_id。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| changeset_id | スナップショットに関連付けられた変更セットの詳細。 データタイプ: オブジェクト "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Table REST API を使用してこの変更セットレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| changeset_id.value | 変更セットレコードの一意の識別子。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| description | スナップショットの簡単な説明。 データタイプ：文字列 |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| last_published | スナップショットが最後に公開された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| last_validated | スナップショットが最後に検証された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| name | スナップショットの名前。 データタイプ：文字列 |
| number | スナップショットを識別する一意の番号。この値は、人間が判読できるマッピングの識別子を提供します。 データタイプ：文字列 |
| 公開済み | スナップショットが公開されたかどうかを示すフラグ。 可能な値： * true:スナップショットが公開されました。 * false:スナップショットは公開されませんでした。 データタイプ：ブーリアン |
| sys_created_by | スナップショットを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | スナップショットが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | スナップショットのSys_id。 データタイプ：文字列 テーブル:CDM スナップショット \[sn_cdm_snapshot\] |
| sys_updated_by | スナップショットを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | スナップショットが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| 妥当性検証 | スナップショットの現在の検証ステータス。 可能な値： * execution_error * 失敗 * 進行中 * not_validated * 合格 * passed_with_exception * 要求済み データタイプ：文字列 |
[ ]

### cURL 要求

このコード例は、スナップショットを非公開にする方法を示しています。

```

```

結果を返します:

```

```

## CdmSnapshotApi - PUT /sn_cdm/snapshots/validate {#ariaid-title7}

指定された未公開スナップショットを、マッピングされたポリシーに対して検証します。
検証は非同期プロセスとして実行されます。このエンドポイントを呼び出すと、検証プロセスのみが開始されます。この呼び出しから返される結果は、検証プロセスが開始されたかどうかのみを示し、検証自体の結果は示しません。スナップショットが検証済みかどうかを確認するには、 テーブル API を使用してスナップショットを見つけ、その検証ステータスを確認します。  
注:  
公開されたスナップショットは検証できません。

このエンドポイントの呼び出し元には、CDM エディターロールが必要です。

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/snapshots/validate

デフォルト URL: /api/sn_cdm/snapshots/validate  
注:  
使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。

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

{#snapshot-PUT-validate__entry__2}{#snapshot-PUT-validate__version-not_optional-RESTAPI}

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

{#snapshot-PUT-validate__id_x2b_qvg_15b__entry__2}{#snapshot-PUT-validate__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| appName | 必須です。スナップショットを作成する 構成データ管理 (CDM) アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。スナップショットを作成する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| name | 必須です。スナップショットの名前。 データタイプ：文字列 テーブル:CDM スナップショット \[sn_cdm_snapshot\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
[表 : 32. クエリパラメーター]

{#snapshot-PUT-validate__id_x2b_qvg_15b} {#snapshot-PUT-validate__entry__16}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 33. 要求本文のパラメーター]

### ヘッダー

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

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 34. 要求ヘッダー]

{#snapshot-PUT-validate__entry__26}

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

### ステータスコード

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

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。指定されたスナップショットは既に公開されているか、見つかりません。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 36. ステータスコード]

### 応答本文のパラメーター

{#snapshot-PUT-validate__id_dsl_5vg_15b__entry__2}

| 名前 | 説明 |
|-|-|
| cdm_application_id | スナップショットに関連付けられた CDM アプリケーションの詳細。 データタイプ: オブジェクト "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | REST テーブル API を使用して CDM アプリケーションレコードにアクセスするために使用する呼び出し。 データタイプ：文字列 |
| cdm_application_id.value | 関連付けられた CDM アプリケーションレコードのSys_id。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| cdm_deployable_id | スナップショットに関連付けられた CDM 展開可能項目の詳細。 データタイプ: オブジェクト "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | Table REST API を使用してこの展開可能レコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| cdm_deployable_id.value | 展開可能レコードのSys_id。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| changeset_id | スナップショットに関連付けられた変更セットの詳細。 データタイプ: オブジェクト "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Table REST API を使用してこの変更セットレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| changeset_id.value | 変更セットレコードの一意の識別子。 データタイプ：文字列 テーブル:CDM 変更セット \[sn_cdm_changeset\] |
| description | スナップショットの簡単な説明。 データタイプ：文字列 |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| last_published | スナップショットが最後に公開された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| last_validated | スナップショットが最後に検証された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| name | スナップショットの名前。 データタイプ：文字列 |
| number | スナップショットを識別する一意の番号。この値は、人間が判読できるマッピングの識別子を提供します。 データタイプ：文字列 |
| 公開済み | スナップショットが公開されたかどうかを示すフラグ。 可能な値： * true:スナップショットが公開されました。 * false:スナップショットは公開されませんでした。 データタイプ：ブーリアン |
| sys_created_by | スナップショットを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | スナップショットが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | スナップショットのSys_id。 データタイプ：文字列 テーブル:CDM スナップショット \[sn_cdm_snapshot\] |
| sys_updated_by | スナップショットを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | スナップショットが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| 妥当性検証 | スナップショットの現在の検証ステータス。 可能な値： * execution_error * 失敗 * 進行中 * not_validated * 合格 * passed_with_exception * 要求済み データタイプ：文字列 |
[ ]

{#snapshot-PUT-validate__id_dsl_5vg_15b}  

### cURL 要求

このコード例は、スナップショットを検証する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/snapshots/validate?name=Development_1-v2.dpl&deployableName=Development_1&appName=testApp" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

結果を返します:

    { 
      "result": { 
        "changeset_id": { 
          "value": "d4b9446e53001110a1d3ddeeff7b126c", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/d4b9446e53001110a1d3ddeeff7b126c" 
        }, 
        "cdm_deployable_id": { 
          "value": "6dc517a953b70110a1d3ddeeff7b129b", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_deployable/6dc517a953b70110a1d3ddeeff7b129b" 
        }, 
        "description": null, 
        "cdm_application_id": { 
          "value": "62b517a953b70110a1d3ddeeff7b128c", 
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
        }, 
        "published": false, 
        "sys_updated_on": "2022-06-30 12:57:02", 
        "last_published": "2022-06-30 12:57:02", 
        "number": "SNAP0001002", 
        "sys_id": "9017fc2e53801110a1d3ddeeff7b12d7", 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-15 14:19:38", 
        "name": "Development_1-v2.dpl", 
        "last_validated": "2022-06-30 12:56:07", 
        "validation": "passed", 
        "sys_created_by": "admin" 
      } 
    }