You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/SDK 参考/Java/对象接口/管理对象/重命名对象（Java SDK）
重命名对象（Java SDK）
最近更新时间：2024.06.20 20:04:17首次发布时间：2024.04.26 18:00:05
我的收藏

本文介绍如何通过 TOS Java SDK 重命名对象。

注意事项

  • 从 2.6.0 版本开始，TOS Java SDK 支持重命名对象。
  • 使用重命名功能前，您需要先开启重命名功能。
  • 仅支持重命名开启 RenameObject 后新上传的对象，不支持重命名开启该功能前的存量对象。
  • 同一个对象不支持并发重命名。
  • 重命名对象元数据上的所有信息都与源对象一致。
  • 仅支持单个对象重命名，不支持批量重命名。
  • 多版本对象不支持重命名。
  • 重命名的 objectKey 相同会报错 400，例如将 objectA 重命名为 objectA。
  • 如果重命名的 objectKey 存在，默认会覆盖。例如存在 objectA 和 objectB 两个对象，将 objectA 重命名为 objectB，则 objectB 数据会被覆盖。更多信息，请参见使用 RenameObject。

示例代码

import com.volcengine.tos.TOSV2;
import com.volcengine.tos.TOSV2ClientBuilder;
import com.volcengine.tos.TosClientException;
import com.volcengine.tos.TosServerException;
import com.volcengine.tos.model.object.RenameObjectInput;
import com.volcengine.tos.model.object.RenameObjectOutput;

public class RenameObjectExample {
    public static void main(String[] args) {
        String endpoint = "your endpoint";
        String region = "your region";
        String accessKey = System.getenv("TOS_ACCESS_KEY");
        String secretKey = System.getenv("TOS_SECRET_KEY");

        String bucketName = "bucket-example";
        String objectKey = "example_dir/example_object.txt";
        String renamedObjectKey = "example_dir/example_object_rename.txt";

        TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);

        try{
            RenameObjectInput input = new RenameObjectInput().setBucket(bucketName).setKey(objectKey)
                    .setNewKey(renamedObjectKey);
            RenameObjectOutput output = tos.renameObject(input);
            System.out.println(output.getRequestInfo().getRequestId());
            System.out.println("renameObject succeed.");
        } catch (TosClientException e) {
            // 操作失败，捕获客户端异常，一般情况是请求参数错误，此时请求并未发送
            System.out.println("renameObject failed");
            System.out.println("Message: " + e.getMessage());
            if (e.getCause() != null) {
                e.getCause().printStackTrace();
            }
        } catch (TosServerException e) {
            // 操作失败，捕获服务端异常，可以获取到从服务端返回的详细错误信息
            System.out.println("renameObject failed");
            System.out.println("StatusCode: " + e.getStatusCode());
            System.out.println("RequestID: " + e.getRequestID());
        } catch (Throwable t) {
            // 作为兜底捕获其他异常，一般不会执行到这里
            System.out.println("renameObject failed");
            System.out.println("unexpected exception, message: " + t.getMessage());
        }
    }
}

相关文档

关于 RenameObject 的 API 文档，请参见 RenameObject。