Changement de nom des objets de compartiments de répertoires

Vous pouvez utiliser le kit AWS SDK pour Java pour renommer vos objets. Pour utiliser ces exemples, remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

L’exemple suivant montre comment créer une RenameObjectRequest à l’aide du kit AWS SDK pour 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();

Ce code effectue les opérations suivantes :

L’exemple suivant montre comment créer une RenameObjectRequest avec une condition de non-correspondance à l’aide du kit AWS SDK pour 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();

Ce code effectue les opérations suivantes :

L’opération échoue et renvoie l’erreur 412 Precondition Failed si un objet porte déjà le nouveau nom spécifié et possède la balise d’entité spécifiée.

Vous pouvez utiliser le kit SDK pour Python pour renommer vos objets. Pour utiliser ces exemples, remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

L’exemple suivant montre comment renommer un objet à l’aide du kit 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"{source_key}"
        )
        print(f"Successfully renamed {source_key} to {destination_key}")
    except ClientError as e:
        print(f"Error renaming object: {e}")

Ce code effectue les opérations suivantes :

L’exemple suivant montre comment renommer un objet avec les conditions SourceIfMatch et DestinationIfNoneMatch à l’aide du kit AWS SDK pour 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}")

Ce code effectue les opérations suivantes :

Vous pouvez utiliser le kit SDK pour Rust pour renommer vos objets. Pour utiliser ces exemples, remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

L’exemple suivant montre comment renommer un objet du compartiment de répertoires amzn-s3-demo-bucket--usw2-az1--x-s3 à l’aide du kit SDK pour 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(())
}

Ce code effectue les opérations suivantes :