重新命名目錄儲存貯體中的物件

您可以使用 AWS SDK for Java 來重新命名物件。若要使用這些範例，請以您自己的資訊取代使用者輸入預留位置。

下列範例示範如何使用適用於 Java RenameObjectRequest的 AWS 開發套件建立

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 的 AWS 開發套件建立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 的 AWS 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"{source_key}"
        )
        print(f"Successfully renamed {source_key} to {destination_key}")
    except ClientError as e:
        print(f"Error renaming object: {e}")

該程式碼會執行下列作業：

下列範例示範如何使用適用於 Python 的 AWS 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}")

該程式碼會執行下列作業：

您可以使用 SDK for Rust 重新命名物件。若要使用這些範例，請以您自己的資訊取代使用者輸入預留位置。

下列範例示範如何使用 SDK for Rust 重新命名 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(())
}

該程式碼會執行下列作業：