Renomear objetos em buckets de diretório

Você pode usar o AWS SDK para Java para renomear objetos. Para usar esses exemplos, substitua os espaços reservados para entrada do usuário por suas próprias informações.

O exemplo a seguir demonstra como criar um RenameObjectRequest usando o AWS SDK para Java.

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();

Esse código faz o seguinte:

O exemplo a seguir mostra como criar uma RenameObjectRequest com uma condição de não correspondência usando o AWS SDK para Java.

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();

Esse código faz o seguinte:

A operação não terá êxito e exibirá o erro 412 Precondition Failed se um objeto com o novo nome especificado existir e tiver a ETag especificada.

Você pode usar o SDK para Python para renomear objetos. Para usar esses exemplos, substitua os espaços reservados para entrada do usuário por suas próprias informações.

O exemplo a seguir demonstra como renomear um objeto usando o AWS SDK para 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}")

Esse código faz o seguinte:

O exemplo a seguir demonstra como renomear um objeto com as condições SourceIfMatch e DestinationIfNoneMatch usando o AWS SDK para Python (Boto3).

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}")

Esse código faz o seguinte:

Você pode usar o SDK para Rust para renomear objetos. Para usar esses exemplos, substitua os espaços reservados para entrada do usuário por suas próprias informações.

O exemplo a seguir demonstra como renomear um objeto no bucket de diretório amzn-s3-demo-bucket--usw2-az1--x-s3 usando o SDK para Rust.

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(())
}

Esse código faz o seguinte: