阅读本文，您可以获取 Java SDK 数据迁移的接口调用示例，实现快速开发。

调用说明

• 本文提供的接口调用示例均通过 AK 和 SK 初始化实例。
• 接口的参数说明和错误码等信息可通过接口文档查看。

前提条件

调用接口前，请先完成 Java SDK 的安装及初始化操作。

调用示例

本节为您介绍数据迁移相关接口的功能和调用示例。

创建数据迁移任务

您可以调用 CreateImageMigrateTask 接口创建从源存储至 veImageX 的数据迁移任务。详细的参数说明可参见 CreateImageMigrateTask 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class CreateImageMigrateTaskExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        CreateImageMigrateTaskBody body = new CreateImageMigrateTaskBody();

        try {
            CreateImageMigrateTaskRes resp = service.createImageMigrateTask(body);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

获取迁移任务详情

您可以调用 GetImageMigrateTasks 接口分页获取当前账号下的迁移任务及其迁移详情。详细的参数说明可参见 GetImageMigrateTasks 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class GetImageMigrateTasksExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        GetImageMigrateTasksQuery query = new GetImageMigrateTasksQuery();

        try {
            GetImageMigrateTasksRes resp = service.getImageMigrateTasks(query);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

更新迁移任务策略

您可以调用 UpdateImageTaskStrategy 接口指定任务 ID 来更新该任务的迁移策略。详细的参数说明可参见 UpdateImageTaskStrategy 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class UpdateImageTaskStrategyExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        UpdateImageTaskStrategyBody body = new UpdateImageTaskStrategyBody();

        try {
            UpdateImageTaskStrategyRes resp = service.updateImageTaskStrategy(body);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

获取服务商 Bucket

您可以调用 GetVendorBuckets 接口指定云服务商和访问密钥获取迁移源 Bucket 详情。详细的参数说明可参见 GetVendorBuckets 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class GetVendorBucketsExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        GetVendorBucketsBody body = new GetVendorBucketsBody();

        try {
            GetVendorBucketsRes resp = service.getVendorBuckets(body);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

结束迁移任务

您可以调用 TerminateImageMigrateTask 接口指定任务 ID 来结束该迁移任务。详细的参数说明可参见 TerminateImageMigrateTask 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class TerminateImageMigrateTaskExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        TerminateImageMigrateTaskQuery query = new TerminateImageMigrateTaskQuery();

        try {
            TerminateImageMigrateTaskRes resp = service.terminateImageMigrateTask(query);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

删除迁移任务

您可以调用 DeleteImageMigrateTask 接口指定任务 ID 来删除该迁移任务。详细的参数说明可参见 DeleteImageMigrateTask 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class DeleteImageMigrateTaskExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        DeleteImageMigrateTaskQuery query = new DeleteImageMigrateTaskQuery();

        try {
            DeleteImageMigrateTaskRes resp = service.deleteImageMigrateTask(query);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

重启迁移任务

您可以调用 RerunImageMigrateTask 接口指定任务 ID 来重启该迁移任务（仅对状态为部分迁移完成的任务生效）。详细的参数说明可参见 RerunImageMigrateTask 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class RerunImageMigrateTaskExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        RerunImageMigrateTaskQuery query = new RerunImageMigrateTaskQuery();

        try {
            RerunImageMigrateTaskRes resp = service.rerunImageMigrateTask(query);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

导出迁移失败列表

您可以调用 ExportFailedMigrateTask 接口指定迁移失败的任务 ID 来导出文件地址和迁移失败错误信息。详细的参数说明可参见 ExportFailedMigrateTask 接口文档。

接口调用示例如下所示。

package com.volcengine.example.imagex.v2.api;


import com.volcengine.model.imagex.v2.*; 
import com.volcengine.service.imagex.v2.ImagexService;

public class ExportFailedMigrateTaskExample {
    public static void main(String[] args) {
        ImagexService service = ImagexService.getInstance();
        service.setAccessKey("ak");
        service.setSecretKey("sk");

        ExportFailedMigrateTaskQuery query = new ExportFailedMigrateTaskQuery();

        try {
            ExportFailedMigrateTaskRes resp = service.exportFailedMigrateTask(query);
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}