REST APIリファレンス

前へ次へ

エクスポートジョブの開始

POST要求を使用してエクスポートジョブを開始します。

POST要求

アセット、接続、Secure Agentの設定、スケジュールなどのオブジェクトをエクスポートできます。エクスポートするオブジェクトを指定してエクスポートジョブを開始するには、次のURIを使用します。

/public/core/v3/export

要求に次のフィールドを含めます。

フィールド	タイプ	必須	説明
name	String		エクスポートジョブの名前。名前を指定しない場合、次の形式のデフォルト名が使用されます: job-<currentTimeInMilliseconds>
objects	Collection<複合型>	はい	エクスポートするオブジェクトのオブジェクトID。 1つのエクスポートファイルに含めるオブジェクトは1000個以内にすることをお勧めします。
id	String	○	objectsオブジェクトに含まれます。エクスポートオブジェクトのグローバル一意識別子。これは、プロジェクト、フォルダ、またはアセットのIDです。
includeDependencies	Boolean		objectsオブジェクトに含まれます。アセットの依存オブジェクトをエクスポートに含めるかどうかを決定します。デフォルトはTrueです。

POST要求の例

次の例のような要求を使用できます。

POST <baseApiUrl>/public/core/v3/export
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: <sessionId>

{
    "name" : "testJob1",
    "objects" : [
        {
            "id": "l7bgB85m5oGiXObDxwnvK9",
            "includeDependencies" : true
        },
        {
            "id": "1MW0GDAE1sFgnvWkvom7mK",
            "includeDependencies" : false
        },
        {
            "id": "iIVBNZSpUKFg4N6g2PKUox"
        }
    ]
}

POST応答

成功した場合、エクスポートジョブの次の情報が返されます。

フィールド	タイプ	説明
id	String	エクスポートジョブのID。
createTime	String	エクスポートパッケージが作成された時間。
updateTime	String	エクスポートパッケージが最後に更新された時間。
name	String	インポートジョブの名前。
startTime	String	エクスポートジョブが開始された時間。
endTime	String	エクスポートジョブが終了した時間。
status	複合型	エクスポートのステータス。
state	String	ステータスのオブジェクトで返されます。エクスポートジョブのステータス（例: 実行中、成功、失敗）。
message	String	ステータスのオブジェクトで返されます。エクスポートジョブのステータスメッセージ。
objects	Collection	オブジェクトのコレクション。空白の場合、NULLを返します。

POST応答の例

成功した場合、次の例のような応答を受信します。

{
  "id": "7evG9CokA1whk8ehF3opKM",
  "createTime": "2017-10-26T08:15:48.502Z",
  "updateTime": "2017-10-26T08:15:48.502Z",
  "name": "testJob1",
  "startTime": "2017-10-26T08:15:48.501Z",
  "endTime": null,
  "status": {
    "state": "IN_PROGRESS",
    "message": "In Progress"
  },
  "objects": null
}

エラーを受信した場合、次の例のような応答が表示されます。

{
  "error": {
    "code": "MigrationSvc_034",
    "message": "Invalid object id/s [[242973wgfscbwasd23]]. Object resolution failed.",
    "requestId": "2ataXVlgw3ydI1Yb2MA4sq"
  }
}

オブジェクトのエクスポート

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal