重命名目录存储桶中的对象

您可以使用适用于 Java 的 Amazon SDK 来重命名对象。要使用这些示例，请将用户输入占位符替换为您自己的信息

以下示例演示如何使用适用于 Java 的 Amazon SDK 来创建 RenameObjectRequest

String key = "key";
String newKey = "new-key";
String expectedETag = "e5f3g7h8i9j0";
RenameObjectRequest renameRequest = RenameObjectRequest.builder()
    .bucket(amzn-s3-demo-bucket--usw2-az1--x-s3)
    .key(newKey)
    .renameSource(key)
    .destinationIfMatch(e5f3g7h8i9j0)
    .build();

此代码将执行以下操作：

以下示例显示如何使用适用于 Java 的 Amazon SDK 通过不匹配条件来创建 RenameObjectRequest。

String key = "key";
String newKey = "new-key";
String noneMatchETag = "e5f3g7h8i9j0";
RenameObjectRequest renameRequest = RenameObjectRequest.builder()
    .bucket(amzn-s3-demo-bucket--usw2-az1--x-s3)
    .key(newKey)
    .renameSource(key)
    .destinationIfNoneMatch(noneMatchETag)
    .build();

此代码将执行以下操作：

如果具有新的指定名称的对象存在且该对象具有指定的 ETag，则操作将失败并显示 412 Precondition Failed 错误。

您可以使用适用于 Python 的 SDK 来重命名对象。要使用这些示例，请将用户输入占位符替换为您自己的信息。

以下示例演示了如何使用适用于 Python 的 Amazon SDK（Boto3）来重命名对象。

def basic_rename(bucket, source_key, destination_key):
    try:
        s3.rename_object(
            Bucket=amzn-s3-demo-bucket--usw2-az1--x-s3,
            Key=destination_key,
            RenameSource=f"{amzn-s3-demo-bucket--usw2-az1--x-s3}/{source_key}"
        )
        print(f"Successfully renamed {source_key} to {destination_key}")
    except ClientError as e:
        print(f"Error renaming object: {e}")

此代码将执行以下操作：

以下示例演示如何使用适用于 Python 的 Amazon SDK（Boto3）通过 SourceIfMatch 和 DestinationIfNoneMatch 条件来重命名对象。

def rename_with_conditions(bucket, source_key, destination_key, source_etag, dest_etag):
    try:
        s3.rename_object(
            Bucket=amzn-s3-demo-bucket--usw2-az1--x-s3,
            Key=destination_key,
            RenameSource=f"{amzn-s3-demo-bucket--usw2-az1--x-s3}/{source_key}",
            SourceIfMatch=source_ETag,
            DestinationIfNoneMatch=dest_ETag
        )
        print(f"Successfully renamed {source_key} to {destination_key} with conditions")
    except ClientError as e:
        print(f"Error renaming object: {e}")

此代码将执行以下操作：

您可以使用适用于 Rust 的 SDK 来重命名对象。要使用这些示例，请将用户输入占位符替换为您自己的信息。

以下示例演示如何使用适用于 Rust 的 SDK 来重命名 amzn-s3-demo-bucket--usw2-az1--x-s3 目录存储桶中的对象。

async fn basic_rename_example(client: &Client) -> Result<(), Box<dyn Error>> {
    let response = client
        .rename_object()
        .bucket(" amzn-s3-demo-bucket--usw2-az1--x-s3")
        .key("new-name.txt")  // New name/path for the object
        .rename_source("old-name.txt")  // Original object name/path
        .send()
        .await?;
    Ok(())
}

此代码将执行以下操作：