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


---

# CdmPoliciesApi

# CdmPoliciesApi {#ariaid-title1}

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

CdmPoliciesApi は、構成データ管理 (CDM) で展開可能項目のポリシー マッピングを管理できるようにするエンドポイントを提供します。展開可能項目に適切にマッピングされたポリシーは、展開可能項目のスナップショットの検証時に実行されます。  
この API のエンドポイントにアクセスするには、次のいずれかのロールが必要です。

* スクリプト済み REST CDM ビュー ACL
* スクリプト済み REST CDM アドミン ACL

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

ポリシーマッピングの詳細については、「 [展開可能項目へのポリシーのマッピング](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US)」を参照してください。

## CdmPoliciesApi - 削除 /sn_cdm/policies/mappings {#ariaid-title2}

展開可能項目への指定されたポリシーのマッピングを削除します。
このエンドポイントの呼び出し元には、CDM admin ロールが必要です。

### URL 形式

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

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

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

{#policies-DELETE-mappings__entry__2}{#policies-DELETE-mappings__version-not_optional-RESTAPI}

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

{#policies-DELETE-mappings__entry__6}{#policies-DELETE-mappings__appName-policy-entry}{#policies-DELETE-mappings__deployableName-policy-entry}{#policies-DELETE-mappings__policyName-policy-entry}

| 名前 | 説明 |
|-|-|
| appName | 必須です。ポリシーへのマッピングを削除する 構成データ管理 (CDM) アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。ポリシーへのマッピングを削除する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ：文字列 テーブル:ポリシー \[sn_pace_policy\] |
[表 : 2. クエリパラメーター]

{#policies-DELETE-mappings__entry__14}

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

### ヘッダー

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

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

{#policies-DELETE-mappings__entry__22}

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

### ステータスコード

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

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

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

{#policies-DELETE-mappings__entry__34}

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

### cURL 要求

次のコード例は、ポリシーマッピングを削除する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings?deployableName=Development_1&policyName=testALPolicy1&appName=testApp" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

マッピングが正常に削除された場合、HTTP ステータスコード以外の応答は返されません。

    None - results defined by the HTTP status code

## CdmPoliciesApi:GET /sn_cdm/policies/mappings/inputs/resolved {#ariaid-title3}

展開可能項目の指定されたポリシーマッピングの解決済み入力を返します。
ポリシーマッピングの詳細については、「 [展開可能項目へのポリシーのマッピング](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 」および [「構成データの検証と修正](https://www.servicenow.com/docs/access?context=cdm-validating-cfg-data&version=australia&pubname=australia-it-service-management&ft:locale=en-US)」を参照してください。

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

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings/inputs/resolved

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

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

{#policies-GET-map-input-resolved__entry__2}{#policies-GET-map-input-resolved__version-not_optional-RESTAPI}

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

{#policies-GET-map-input-resolved__entry__6}{#policies-GET-map-input-resolved__appName-policy-row}{#policies-GET-map-input-resolved__deployableName-policy-row}{#policies-GET-map-input-resolved__policyName-policy-entry}

| 名前 | 説明 |
|-|-|
| appName | 必須です。解決済みのポリシー入力を返す展開可能項目に関連付けられた 構成データ管理 (CDM) アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。解決済みポリシーを返す CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ：文字列 テーブル:ポリシー \[sn_pace_policy\] |
[表 : 8. クエリパラメーター]

{#policies-GET-map-input-resolved__entry__14}

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

### ヘッダー

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

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

{#policies-GET-map-input-resolved__entry__22}

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

### ステータスコード

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

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

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

{#policies-GET-map-input-resolved__entry__34}

| 名前 | 説明 |
|-|-|
| result | 指定されたポリシーマッピングのすべての解決済み入力の名前と値のペアのリスト。 例: `{"input_name": "user_1", "input_password": "" }` データタイプ: オブジェクト |
[ ]

### cURL 要求

次の例は、このエンドポイントを使用して解決済みのポリシー入力を取得する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs/resolved?policyName=testALPolicy1&deployableName=Development_1&appName=testApp" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

結果を返します:

    { 
      "result": { 
        "key1": "someVal", 
        "additionalDeployablesInput": "[{\"id\":\"e7e34a531b501110636e0fe0604bcba9\",\"label\":\"testApp-Development_2\"}]" 
      } 
    }

## CdmPoliciesApi - POST /sn_cdm/policies/mappings {#ariaid-title4}

指定されたポリシーを展開可能項目にマッピングします。
このエンドポイントの呼び出し元には、CDM admin ロールが必要です。

### URL 形式

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

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

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

{#policies-POST-mappings__entry__2}{#policies-POST-mappings__version-not_optional-RESTAPI}

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

{#policies-POST-mappings__id_ds3_yyg_15b__entry__2}{#policies-POST-mappings__appName-policy-entry}{#policies-POST-mappings__deployableName-policy-entry}{#policies-POST-mappings__policyName-policy-entry}{#policies-POST-mappings__cdm_apps-returnFields-entry}

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

{#policies-POST-mappings__id_ds3_yyg_15b} {#policies-POST-mappings__entry__16}

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

### ヘッダー

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

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

{#policies-POST-mappings__entry__26}

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

### ステータスコード

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

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

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

{#policies-POST-mappings__id_b5l_rbh_15b__entry__2}{#policies-POST-mappings__sys_created_by-policies-entry}{#policies-POST-mappings__sys_created_onpolicies-entry}{#policies-POST-mappings__sys_id-policies-entry}{#policies-POST-mappings__sys_updated_by-policies-entry}{#policies-POST-mappings__sys_updated_on-policies-entry}

| 名前 | 説明 |
|-|-|
| description | マッピングの説明。 データタイプ：文字列 |
| ドキュメント | ドキュメントのSys_id。 データタイプ：文字列 |
| document_ref | ノードに関連付けられたdocument_refレコードの詳細。 データタイプ: オブジェクト "document_ref": { "link": "String", "value": "String" } |
| document_ref.link | Table REST API を使用して、ポリシーにマッピングされた展開可能レコードをクエリするための呼び出し構文。 PaCE このフィールドを使用して、ポリシーにマッピングされた展開可能項目への参照を保存します。 データタイプ：文字列 |
| document_ref.sys_id | ポリシーにマッピングされた展開可能項目レコードのSys_id。 データタイプ：文字列 |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } |
| error.detail | エラーに関する追加情報。 データタイプ：文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ：文字列 |
| 例外 | マッピングの実行中に例外が発生した場合は、例外レコードへのリンク。 データタイプ：文字列 |
| exception_allowed | ポリシーで例外を許可するかどうかを示すフラグ。 可能な値： * true:例外が許可されます。 * false:例外は許可されません。 データタイプ：ブーリアン |
| input_status | 入力のステータス。 可能な値： * invalid * 有効 データタイプ：文字列 |
| last_updated_by | ポリシーマッピングを最後に更新したユーザーの詳細。 データタイプ: オブジェクト "last_updated_by": { "link": "String", "value": "String" } |
| last_updated_by.link | Table REST API を使用してユーザーレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| last_updated_by.sys_id | ユーザーレコードの Sys_id。 データタイプ：文字列 テーブル： ユーザー \[sys_user\] |
| number | マッピングを識別する一意の番号。この値は、人間が判読できるマッピングの識別子を提供します。 データタイプ：文字列 |
| policy | マッピングに関連付けられたポリシーレコードの詳細。 データタイプ: オブジェクト "policy": { "link": "String", "value": "String" } |
| policy.link | Table REST API を使用して、ポリシーにマッピングされたポリシーレコードを照会するための呼び出し構文。 データタイプ：文字列 |
| policy.sys_id | ポリシーレコードのSys_id。 データタイプ：文字列 テーブル:ポリシー \[sn_pace_policy\] |
| 理由 | 現在のステータスの理由の説明。 データタイプ：文字列 |
| 状況 | マッピングの現在のステータス。 可能な値： * アクティブ * inactive データタイプ：文字列 |
| sys_class_name | ポリシーマッピングのテーブル名。 データタイプ：文字列 |
| sys_created_by | マッピングを作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | マッピングが作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | マッピングのSys_id。 データタイプ：文字列 テーブル:ポリシーマッピング \[sn_pace_policy_mapping\] |
| sys_updated_by | マッピングを更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | マッピングが最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
[ ]

{#policies-POST-mappings__id_b5l_rbh_15b}  

### cURL 要求

このコード例は、特定のポリシーを展開可能項目にマップする方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings?appName=testApp&deployableName=Development_1&policyName=testALPolicy1" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

結果を返します:

    { 
      "result": { 
        "exception": null, 
        "reason": null, 
        "exception_allowed": "--", 
        "document": "0be34a531b501110636e0fe0604bcb21", 
        "input_status": "valid", 
        "description": null, 
        "sys_updated_on": "2022-06-30 14:07:37", 
        "sys_class_name": "sn_cdm_pace_policy_mapping", 
        "sys_id": "ea24469f1b101110636e0fe0604bcbed", 
        "number": "MAP0001001", 
        "last_updated_by": { 
          "value": "48630e131b501110636e0fe0604bcb53", 
          "link": "https://instance.servicenow.com/api/now/table/sys_user/48630e131b501110636e0fe0604bcb53" 
        }, 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-30 14:07:37", 
        "document_ref": { 
          "value": "0be34a531b501110636e0fe0604bcb21", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_deployable/0be34a531b501110636e0fe0604bcb21" 
        }, 
        "state": "active", 
        "sys_created_by": "admin", 
        "policy": { 
          "value": "12a3c2531b501110636e0fe0604bcb9b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_pace_policy/12a3c2531b501110636e0fe0604bcb9b" 
        } 
      } 
    }

## CdmPoliciesApi:PUT /sn_cdm/policies/mappings/inputs/additional-deployables {#ariaid-title5}

構成データ管理 (CDM) ポリシーマッピングの additionalDeployablesInput 入力変数を更新します。
additionalDeployablesInput 入力変数には、既存のポリシーマッピングに割り当てることができる追加の展開可能項目が含まれています。これらはマッピング入力に似ていますが、特定の配列構造を持っています。

ポリシーマッピングの詳細については、「 [展開可能項目へのポリシーのマッピング](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US)」を参照してください。

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

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings/inputs/additional-deployables

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

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

{#policies-PUT-map-input-add-deploy__entry__2}{#policies-PUT-map-input-add-deploy__version-not_optional-RESTAPI}

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

{#policies-PUT-map-input-add-deploy__entry__6}{#policies-PUT-map-input-add-deploy__appName-policy-row}{#policies-PUT-map-input-add-deploy__deployableName-policy-row}{#policies-PUT-map-input-add-deploy__policyName-policy-entry}{#policies-PUT-map-input-add-deploy__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| additionalDeployables | 必須です。additionalDeployablesInput 入力変数に追加する展開可能項目のリスト。 データタイプ：オブジェクトのアレイ "additionalDeployables": [ { "appName": "String", "deployableName": "String" } ] |
| additionalDeployables.appName | 必須です。展開可能項目が関連付けられている CDM アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| additionalDeployables.deployableName | 必須です。additionalDeployablesInput 入力変数に追加する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| appName | 必須です。additionalDeployablesInput 入力変数を更新する CDM アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。additionalDeployablesInput 入力変数を更新する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ：文字列 テーブル:ポリシー \[sn_pace_policy\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
[表 : 20. クエリパラメーター]

{#policies-PUT-map-input-add-deploy__entry__22}

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

### ヘッダー

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

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

{#policies-PUT-map-input-add-deploy__entry__32}

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

### ステータスコード

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

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

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

{#policies-PUT-map-input-add-deploy__id_jx1_px2_c5b__entry__2}

| 名前 | 説明 |
|-|-|
| io_definition | 関連する PaCE IO 定義レコードの詳細。 PaCEの詳細については、「[Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト "io_definition": { "link": "String", "value": "String" } |
| io_definition.link | Table REST API を使用してこの PaCE IO 定義レコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| io_definition.value | PaCE IO 定義レコードのSys_id。 データタイプ：文字列 テーブル:IO マッピング \[sn_pace_io_mapping\] |
| is_unused | マッピング入力変数が使用されていないかどうかを示すフラグ。 可能な値： * true:関連するマッピング入力変数は現在使用されていません。 * false:関連するマッピング入力変数が現在使用されています。 {#policies-PUT-map-input-add-deploy__ul_gcm_t1l_25b} データタイプ：ブーリアン |
| mapped_value | マッピング入力変数の現在の値。 データタイプ:オブジェクトのアレイまたは文字列 |
| policy_mapping | PaCEポリシーマッピングレコードの詳細。 PaCEの詳細については、「[Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト "policy_mapping": { "link": "String", "value": "String" } |
| policy_mapping.link | Table REST API を使用してポリシーマッピングレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| policy_mapping.value | PaCEポリシーマッピングレコードのSys_id。 データタイプ：文字列 テーブル:ポリシーマッピング \[sn_pace_policy_mapping\] |
| sys_created_by | マッピング入力変数を作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | マッピング入力変数が作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | 関連付けられたマッピングレコードのSys_id。 データタイプ：文字列 テーブル:IO マッピング \[sn_pace_io_mapping\] |
| sys_updated_by | マッピング入力変数を更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | マッピング入力変数が最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
[ ]

{#policies-PUT-map-input-add-deploy__id_jx1_px2_c5b}  

### cURL 要求

次の例は、additionalDeployablesInput 入力変数に展開可能項目を追加する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs/additional-deployables?additionalDeployables=%5B%7B%22appName%22%3A%20%22testApp%22%2C%20%22deployableName%22%3A%22Development_2%22%7D%5D&policyName=testALPolicy1&deployableName=Development_1&appName=testApp" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'admin':'admin

結果を返します:

    { 
      "result": { 
        "sys_id": "6bb746171b501110636e0fe0604bcb1c", 
        "policy_mapping": { 
          "value": "6bb746171b501110636e0fe0604bcb1b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_pace_policy_mapping/6bb746171b501110636e0fe0604bcb1b" 
        }, 
        "sys_updated_by": "ameya", 
        "sys_created_on": "2022-06-30 14:23:15", 
        "io_definition": { 
          "value": "4d0b061b1b501110636e0fe0604bcb2f", 
          "link": "https://instance.servicenow.com/api/now/table/sn_pace_io_definition/4d0b061b1b501110636e0fe0604bcb2f" 
        }, 
        "mapped_value": "[{\"id\":\"e7e34a531b501110636e0fe0604bcba9\",\"label\":\"testApp-Development_2\"}]", 
        "sys_updated_on": "2022-06-30 14:53:21", 
        "sys_created_by": "ameya", 
        "is_unused": false 
      } 
    } 

## CdmPoliciesApi:PUT /sn_cdm/policies/mappings/inputs {#ariaid-title6}

構成データ管理 (CDM) ポリシーマッピングの指定された入力変数を更新します。
ポリシーマッピングの詳細については、「 [展開可能項目へのポリシーのマッピング](https://www.servicenow.com/docs/access?context=cdm-deployable-map-policy-to&version=australia&pubname=australia-it-service-management&ft:locale=en-US)」を参照してください。

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

### URL 形式

バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings/inputs

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

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

{#policies-PUT-mappings-inputs__entry__2}{#policies-PUT-mappings-inputs__version-not_optional-RESTAPI}

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

{#policies-PUT-mappings-inputs__entry__6}{#policies-PUT-mappings-inputs__appName-policy-row}{#policies-PUT-mappings-inputs__deployableName-policy-row}{#policies-PUT-mappings-inputs__policyName-policy-entry}{#policies-PUT-mappings-inputs__cdm_apps-returnFields-entry}

| 名前 | 説明 |
|-|-|
| appName | 必須です。ポリシーマッピング入力を更新する CDM アプリケーションの名前。 データタイプ：文字列 テーブル:CDM アプリケーション \[sn_cdm_application\] |
| deployableName | 必須です。ポリシーマッピング入力を更新する CDM 展開可能項目の名前。 データタイプ：文字列 テーブル:CDM 展開可能項目 \[sn_cdm_deployable\] |
| 入力名 | 必須です。更新する入力変数の名前。 データタイプ：文字列 テーブル:IO マッピング \[sn_pace_io_mapping\] |
| 入力値 | 必須です。入力変数にアサインする値。 データタイプ:入力変数に依存します。データタイプは、IO マッピング \[sn_pace_io_mapping\] テーブルにあります。 |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ：文字列 テーブル:ポリシー \[sn_pace_policy\] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ：アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
[表 : 26. クエリパラメーター]

{#policies-PUT-mappings-inputs__entry__20}

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

### ヘッダー

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

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

{#policies-PUT-mappings-inputs__entry__30}

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

### ステータスコード

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

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

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

{#policies-PUT-mappings-inputs__id_tny_nx2_c5b__entry__2}

| 名前 | 説明 |
|-|-|
| io_definition | 関連する PaCE IO 定義レコードの詳細。 PaCEの詳細については、「[Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト "io_definition": { "link": "String", "value": "String" } |
| io_definition.link | Table REST API を使用してこの PaCE IO 定義レコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| io_definition.value | PaCE IO 定義レコードのSys_id。 データタイプ：文字列 テーブル:IO マッピング \[sn_pace_io_mapping\] |
| is_unused | マッピング入力変数が使用されていないかどうかを示すフラグ。 可能な値： * true:関連するマッピング入力変数は現在使用されていません。 * false:関連するマッピング入力変数が現在使用されています。 {#policies-PUT-mappings-inputs__ul_gcm_t1l_25b} データタイプ：ブーリアン |
| mapped_value | マッピング入力変数の現在の値。 データタイプ:オブジェクトのアレイまたは文字列 |
| policy_mapping | PaCEポリシーマッピングレコードの詳細。 PaCEの詳細については、「[Policy as Code Engine (PaCE)](https://www.servicenow.com/docs/access?context=pace-managing-policies&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト "policy_mapping": { "link": "String", "value": "String" } |
| policy_mapping.link | Table REST API を使用してポリシーマッピングレコードをクエリするための呼び出し構文。 データタイプ：文字列 |
| policy_mapping.value | PaCEポリシーマッピングレコードのSys_id。 データタイプ：文字列 テーブル:ポリシーマッピング \[sn_pace_policy_mapping\] |
| sys_created_by | マッピング入力変数を作成したユーザーの名前。 データタイプ：文字列 |
| sys_created_on | マッピング入力変数が作成された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
| sys_id | 関連付けられたマッピングレコードのSys_id。 データタイプ：文字列 テーブル:IO マッピング \[sn_pace_io_mapping\] |
| sys_updated_by | マッピング入力変数を更新したユーザーの名前。 データタイプ：文字列 |
| sys_updated_on | マッピング入力変数が最後に更新された日時。 データタイプ：文字列 形式:yyyy-mm-dd hh:mm:ss |
[ ]

{#policies-PUT-mappings-inputs__id_tny_nx2_c5b}  

### cURL 要求

次の例は、testALPolicy に関連付けられた key1 入力変数を更新する方法を示しています。

    curl "http://instance.servicenow.com/api/sn_cdm/policies/mappings/inputs?policyName=testALPolicy1&appName=testApp&inputValue=value1&inputName=key1&deployableName=Development_1" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

結果を返します:

    { 
      "result": { 
        "sys_id": "631b861b1b501110636e0fe0604bcb6f", 
        "policy_mapping": { 
          "value": "6bb746171b501110636e0fe0604bcb1b", 
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_pace_policy_mapping/6bb746171b501110636e0fe0604bcb1b" 
        }, 
        "sys_updated_by": "admin", 
        "sys_created_on": "2022-06-30 14:38:00", 
        "io_definition": { 
          "value": "fe1b061b1b501110636e0fe0604bcb90", 
          "link": "https://instance.servicenow.comm/api/now/table/sn_pace_io_definition/fe1b061b1b501110636e0fe0604bcb90" 
        }, 
        "mapped_value": "someVal", 
        "sys_updated_on": "2022-06-30 14:39:21", 
        "sys_created_by": "admin", 
        "is_unused": false 
      } 
    }