CdmPoliciesApi
CdmPoliciesApi は、構成データ管理 (CDM) で展開可能項目のポリシー マッピングを管理できるようにするエンドポイントを提供します。展開可能項目に適切にマッピングされたポリシーは、展開可能項目のスナップショットの検証時に実行されます。
- スクリプト済み REST CDM ビュー ACL
- スクリプト済み REST CDM アドミン ACL
さらに、この API をインスタンスで使用するには、 構成データ管理 (CDM) プラグインをアクティブ化する必要があります。
ポリシーマッピングの詳細については、「 展開可能項目へのポリシーのマッピング」を参照してください。
CdmPoliciesApi - 削除 /sn_cdm/policies/mappings
展開可能項目への指定されたポリシーのマッピングを削除します。
このエンドポイントの呼び出し元には、CDM admin ロールが必要です。
URL 形式
バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings
デフォルト URL: /api/sn_cdm/policies/mappings
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| appName | 必須です。ポリシーへのマッピングを削除する 構成データ管理 (CDM) アプリケーションの名前。 データタイプ:文字列 テーブル:CDM アプリケーション [sn_cdm_application] |
| deployableName | 必須です。ポリシーへのマッピングを削除する CDM 展開可能項目の名前。 データタイプ:文字列 テーブル:CDM 展開可能項目 [sn_cdm_deployable] |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ:文字列 テーブル:ポリシー [sn_pace_policy] |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。渡された policyName パラメーターが無効です。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト |
| 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
展開可能項目の指定されたポリシーマッピングの解決済み入力を返します。
ポリシーマッピングの詳細については、「 展開可能項目へのポリシーのマッピング 」および 「構成データの検証と修正」を参照してください。
このエンドポイントの呼び出し元には、CDM ビューアーロールが必要です。
URL 形式
バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings/inputs/resolved
デフォルト URL: /api/sn_cdm/policies/mappings/inputs/resolved
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| appName | 必須です。解決済みのポリシー入力を返す展開可能項目に関連付けられた 構成データ管理 (CDM) アプリケーションの名前。 データタイプ:文字列 テーブル:CDM アプリケーション [sn_cdm_application] |
| deployableName | 必須です。解決済みポリシーを返す CDM 展開可能項目の名前。 データタイプ:文字列 テーブル:CDM 展開可能項目 [sn_cdm_deployable] |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ:文字列 テーブル:ポリシー [sn_pace_policy] |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。渡された policyName パラメーターが無効です。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| result | 指定されたポリシーマッピングのすべての解決済み入力の名前と値のペアのリスト。 例: データタイプ: オブジェクト |
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
指定されたポリシーを展開可能項目にマッピングします。
このエンドポイントの呼び出し元には、CDM admin ロールが必要です。
URL 形式
バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings
デフォルト URL: /api/sn_cdm/policies/mappings
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| appName | 必須です。ポリシーをマッピングする 構成データ管理 (CDM) アプリケーションの名前。 データタイプ:文字列 テーブル:CDM アプリケーション [sn_cdm_application] |
| deployableName | 必須です。ポリシーをマッピングする CDM 展開可能項目の名前。 データタイプ:文字列 テーブル:CDM 展開可能項目 [sn_cdm_deployable] |
| policyName | 必須です。関連付けられたポリシーの名前。 データタイプ:文字列 テーブル:ポリシー [sn_pace_policy] |
| returnFields | 応答の一部として返されるフィールドのリスト。sys_id、sys_updated_by、ステータスなどのレコード列名を渡します。 データタイプ:アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| description | マッピングの説明。 データタイプ:文字列 |
| ドキュメント | ドキュメントのSys_id。 データタイプ:文字列 |
| document_ref | ノードに関連付けられたdocument_refレコードの詳細。 データタイプ: オブジェクト |
| document_ref.link | Table REST API を使用して、ポリシーにマッピングされた展開可能レコードをクエリするための呼び出し構文。 PaCE このフィールドを使用して、ポリシーにマッピングされた展開可能項目への参照を保存します。 データタイプ:文字列 |
| document_ref.sys_id | ポリシーにマッピングされた展開可能項目レコードのSys_id。 データタイプ:文字列 |
| エラー | 処理中にエラーが発生した場合は、エラーの詳細。 データタイプ: オブジェクト |
| error.detail | エラーに関する追加情報。 データタイプ:文字列 |
| error.message | 要求の処理中に生成されたエラーメッセージ。 データタイプ:文字列 |
| 例外 | マッピングの実行中に例外が発生した場合は、例外レコードへのリンク。 データタイプ:文字列 |
| exception_allowed | ポリシーで例外を許可するかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| input_status | 入力のステータス。 可能な値:
データタイプ:文字列 |
| last_updated_by | ポリシーマッピングを最後に更新したユーザーの詳細。 データタイプ: オブジェクト |
| last_updated_by.link | Table REST API を使用してユーザーレコードをクエリするための呼び出し構文。 データタイプ:文字列 |
| last_updated_by.sys_id | ユーザーレコードの Sys_id。 データタイプ:文字列 テーブル: ユーザー [sys_user] |
| number | マッピングを識別する一意の番号。この値は、人間が判読できるマッピングの識別子を提供します。 データタイプ:文字列 |
| policy | マッピングに関連付けられたポリシーレコードの詳細。 データタイプ: オブジェクト |
| policy.link | Table REST API を使用して、ポリシーにマッピングされたポリシーレコードを照会するための呼び出し構文。 データタイプ:文字列 |
| policy.sys_id | ポリシーレコードのSys_id。 データタイプ:文字列 テーブル:ポリシー [sn_pace_policy] |
| 理由 | 現在のステータスの理由の説明。 データタイプ:文字列 |
| 状況 | マッピングの現在のステータス。 可能な値:
データタイプ:文字列 |
| 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 |
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
構成データ管理 (CDM) ポリシーマッピングの additionalDeployablesInput 入力変数を更新します。
additionalDeployablesInput 入力変数には、既存のポリシーマッピングに割り当てることができる追加の展開可能項目が含まれています。これらはマッピング入力に似ていますが、特定の配列構造を持っています。
ポリシーマッピングの詳細については、「 展開可能項目へのポリシーのマッピング」を参照してください。
このエンドポイントの呼び出し元には、CDM admin ロールが必要です。
URL 形式
バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings/inputs/additional-deployables
デフォルト URL: /api/sn_cdm/policies/mappings/inputs/additional-deployables
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| additionalDeployables | 必須です。additionalDeployablesInput 入力変数に追加する展開可能項目のリスト。 データタイプ:オブジェクトのアレイ |
| 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、ステータスなどのレコード列名を渡します。 データタイプ:アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。渡された policyName パラメーターが無効です。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| io_definition | 関連する PaCE IO 定義レコードの詳細。 PaCEの詳細については、「Policy as Code Engine (PaCE)」を参照してください。 データタイプ: オブジェクト |
| io_definition.link | Table REST API を使用してこの PaCE IO 定義レコードをクエリするための呼び出し構文。 データタイプ:文字列 |
| io_definition.value | PaCE IO 定義レコードのSys_id。 データタイプ:文字列 テーブル:IO マッピング [sn_pace_io_mapping] |
| is_unused | マッピング入力変数が使用されていないかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| mapped_value | マッピング入力変数の現在の値。 データタイプ:オブジェクトのアレイまたは文字列 |
| policy_mapping | PaCEポリシーマッピングレコードの詳細。 PaCEの詳細については、「Policy as Code Engine (PaCE)」を参照してください。 データタイプ: オブジェクト |
| 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 |
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
構成データ管理 (CDM) ポリシーマッピングの指定された入力変数を更新します。
ポリシーマッピングの詳細については、「 展開可能項目へのポリシーのマッピング」を参照してください。
このエンドポイントの呼び出し元には、CDM admin ロールが必要です。
URL 形式
バージョニングされた URL: /api/sn_cdm/{api_version}/policies/mappings/inputs
デフォルト URL: /api/sn_cdm/policies/mappings/inputs
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| 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、ステータスなどのレコード列名を渡します。 データタイプ:アレイ デフォルト:エンドポイントによって決定されたすべてのフィールド |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。渡された policyName パラメーターが無効です。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
応答本文のパラメーター
| 名前 | 説明 |
|---|---|
| io_definition | 関連する PaCE IO 定義レコードの詳細。 PaCEの詳細については、「Policy as Code Engine (PaCE)」を参照してください。 データタイプ: オブジェクト |
| io_definition.link | Table REST API を使用してこの PaCE IO 定義レコードをクエリするための呼び出し構文。 データタイプ:文字列 |
| io_definition.value | PaCE IO 定義レコードのSys_id。 データタイプ:文字列 テーブル:IO マッピング [sn_pace_io_mapping] |
| is_unused | マッピング入力変数が使用されていないかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| mapped_value | マッピング入力変数の現在の値。 データタイプ:オブジェクトのアレイまたは文字列 |
| policy_mapping | PaCEポリシーマッピングレコードの詳細。 PaCEの詳細については、「Policy as Code Engine (PaCE)」を参照してください。 データタイプ: オブジェクト |
| 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 |
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
}
}