ディレクトリバケット内のオブジェクトの名前の変更

AWS SDK for Java を使用してオブジェクトの名前を変更できます。これらの例を使用するには、ユーザー入力プレースホルダーを独自の情報に置き換えます

次の例では、AWS SDK for Java を使用して 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();

このコードは以下の処理を実行します。

次の例は、AWS SDK for Java を使用して none-match 条件で 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 エラーで失敗します。

SDK for Python を使用してオブジェクトの名前を変更できます。これらの例を使用するには、ユーザー入力プレースホルダーを独自の情報に置き換えます。

次の例は、AWS SDK for Python (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}")

このコードは以下の処理を実行します。

次の例は、AWS SDK for Python (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(())
}

このコードは以下の処理を実行します。