アセスメント API をコピー

  • リリースバージョン: Australia
  • 更新日 2026年03月19日
  • 所要時間:3分
  • アセスメントコピー API は、アセスメントメトリクスタイプ [asmt_metric_type] テーブルにアセスメントメトリクスタイプまたはサーベイ定義のコピーを作成するためのエンドポイントを提供します。

    この API は、 アセスメントとサーベイ デフォルトで利用可能なアプリケーション。

    呼び出し元ユーザーには assessment_admin ロールが必要です。

    アセスメントをコピー:POST /now/copy_assessments/copy

    アセスメントメトリクスタイプ [asmt_metric_type] テーブルにアセスメントメトリクスタイプまたはサーベイ定義のコピーを作成します。

    すべての関連する質問 (タイプ)、設定、カテゴリ、メトリクス、ドメインセパレーションルール、およびロールベースのカテゴリがコピーされます。アサインされたユーザー、カテゴリユーザー、インスタンス、およびトリガー条件はコピーされません。

    URL 形式

    デフォルト URL: /api/now/copy_assessments/copy

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

    表 : 1. パスパラメーター
    名前 説明
    なし
    表 : 2. クエリパラメーター
    名前 説明
    なし
    表 : 3. 要求本文パラメーター (JSON)
    名前 説明
    sysID 必須です。コピーするアセスメントメトリクスタイプまたはサーベイ定義のSys_id。

    テーブル:アセスメントメトリクスタイプ [asmt_metric_type]

    データタイプ:文字列

    ヘッダー

    次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

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

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 6. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    500 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

    応答本文のパラメーター (JSON)

    名前 説明
    result API 要求の詳細。

    データタイプ: オブジェクト

    "result": {
       "name": "String",
       "sysID": "String"
    }
    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"
      }
    }