アセスメント API をコピー
アセスメントコピー API は、アセスメントメトリクスタイプ [asmt_metric_type] テーブルにアセスメントメトリクスタイプまたはサーベイ定義のコピーを作成するためのエンドポイントを提供します。
この API は、 アセスメントとサーベイ デフォルトで利用可能なアプリケーション。
呼び出し元ユーザーには assessment_admin ロールが必要です。
アセスメントをコピー:POST /now/copy_assessments/copy
アセスメントメトリクスタイプ [asmt_metric_type] テーブルにアセスメントメトリクスタイプまたはサーベイ定義のコピーを作成します。
すべての関連する質問 (タイプ)、設定、カテゴリ、メトリクス、ドメインセパレーションルール、およびロールベースのカテゴリがコピーされます。アサインされたユーザー、カテゴリユーザー、インスタンス、およびトリガー条件はコピーされません。
URL 形式
デフォルト URL: /api/now/copy_assessments/copy
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| なし |
| 名前 | 説明 |
|---|---|
| なし |
| 名前 | 説明 |
|---|---|
| sysID | 必須です。コピーするアセスメントメトリクスタイプまたはサーベイ定義のSys_id。 テーブル:アセスメントメトリクスタイプ [asmt_metric_type] データタイプ:文字列 |
ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| Content-Type | 応答本文のデータフォーマット。application/json;charset=UTF-8 のみをサポートします。 |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
応答本文のパラメーター (JSON)
| 名前 | 説明 |
|---|---|
| result | API 要求の詳細。 データタイプ: オブジェクト |
| result.name | アセスメントメトリクスタイプまたはサーベイ定義のコピーの名前。コピーには、「 コピー対象 <元の名前>」という形式で名前が付けられます。データタイプ:文字列 |
| result.sysID | アセスメントメトリクスタイプまたはサーベイ定義のコピーのSys_id。 テーブル:アセスメントメトリクスタイプ [asmt_metric_type] データタイプ:文字列 |
cURL 要求
この例では、アセスメントメトリクスタイプのコピーを作成します。
curl "https://instance.service-now.com/api/now/copy_assessments/copy" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"sysID\":\"d2fbde248f033300e7e16c7827bdee11\"}" \
--user 'username':'password'
応答本文。
{
"result": {
"sysID": "19d54d2447f336d027d48b41516d43ee",
"name": "Copy of Assessment: Basic flow"
}
}