Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Changement de nom des objets de compartiments de répertoires
À l’aide de l’opération RenameObject, vous pouvez renommer de manière atomique un objet d’un compartiment de répertoires qui utilise la classe de stockage S3 Express One Zone, sans aucun déplacement de données. Vous pouvez renommer un objet en spécifiant son nom initial comme source et son nouveau nom comme destination dans le même compartiment de répertoires. L’opération d’API RenameObject échoue sur les objets qui se terminent par une barre oblique (/). Pour plus d’informations, consultez Attribution d’un nom aux objets Amazon S3.
L’opération RenameObject est exécutée généralement en quelques millisecondes, quelle que soit la taille de l’objet. Cette fonctionnalité accélère les applications telles que la gestion des fichiers journaux, le traitement multimédia et l’analytique des données. En outre, RenameObject préserve toutes les propriétés des métadonnées des objets, notamment la classe de stockage, le type de chiffrement, la date de création, la date de dernière modification et les propriétés des sommes de contrôle.
Note
RenameObject n’est pris en charge que pour les objets stockés dans la classe de stockage S3 Express One Zone.
Pour autoriser l’accès à l’opération RenameObject, nous vous recommandons d’utiliser l’opération CreateSession pour accorder une autorisation basée sur la session. Plus précisément, vous accordez l’autorisation s3express:CreateSession au compartiment de répertoires dans le cadre d’une stratégie de compartiment ou d’une politique basée sur l’identité. Ensuite, vous effectuez l’appel d’API CreateSession sur le compartiment de répertoires pour obtenir un jeton de session. Avec le jeton de session dans l’en-tête de votre demande, vous pouvez envoyer des demandes d’API à cette opération. À l’expiration du jeton de session, vous effectuez un nouvel appel d’API CreateSession pour générer un nouveau jeton de session à utiliser. La AWS CLI créera et AWS SDKs gérera votre session, notamment en actualisant automatiquement le jeton de session pour éviter les interruptions de service lorsqu'une session expire. Pour plus d’information sur l’autorisation, consultez CreateSession dans la Référence des API Amazon S3. Pour plus d’informations sur les opérations d’API de point de terminaison zonal, consultez Autorisation des opérations d’API de point de terminaison zonal avec CreateSession.
Si vous ne souhaitez pas remplacer un objet existant, vous pouvez ajouter l’en-tête conditionnel If-None-Match avec la valeur ‘*’ dans la demande RenameObject. Amazon S3 renvoie une erreur 412 Precondition Failed si le nom de l’objet existe déjà. Pour plus d’informations, consultez RenameObject dans la Référence d’API Amazon S3.
RenameObject est une opération d’API de point de terminaison zonal (niveau de l’objet ou plan de données) qui est journalisée dans AWS CloudTrail. Vous pouvez l'utiliser CloudTrail pour recueillir des informations sur les RenameObject opérations effectuées sur vos objets dans des compartiments de répertoire. Pour plus d'informations, consultez la section Journalisation avec AWS CloudTrail pour les compartiments de répertoire et les exemples de fichiers CloudTrail journaux pour les compartiments de répertoire.
S3 Express One Zone est la seule classe de stockage qui prend en charge RenameObject, au même prix que les demandes PUT, COPY, POST et LIST (pour 1 000 demandes) dans S3 Express One Zone. Pour plus d’informations, consultez Tarification Amazon S3
Changement de nom d’un objet
Pour renommer un objet dans votre compartiment de répertoire, vous pouvez utiliser la console Amazon S3, la AWS CLI AWS SDKs, l'API REST ou Mountpoint pour Amazon S3 (version 1.19.0 ou ultérieure).
Pour renommer un objet d’un compartiment de répertoires
Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/
. -
Dans le volet de navigation, choisissez Compartiments, puis l’onglet Compartiments de répertoires. Accédez au compartiment de répertoires Amazon S3 contenant l’objet que vous souhaitez renommer.
-
Cochez la case située à côté de l’objet que vous voulez renommer.
-
Dans le menu Actions, sélectionnez Renommer l’objet.
-
Dans la zone Nouveau nom d’objet, saisissez le nouveau nom de l’objet.
Note
Si vous spécifiez le nom d’un objet existant, l’opération échoue et Amazon S3 renvoie le message d’erreur
412 Precondition Failed. La longueur du nom de la clé de l’objet ne peut pas dépasser 1 024 octets. Les préfixes inclus dans le nom de l’objet sont pris en compte dans la longueur totale. Choisissez Renommer l’objet. Amazon S3 renommera votre objet.
Les exemples rename-object montrent comment utiliser l’interface de ligne de commande AWS pour renommer un objet. Pour exécuter ces commandes, remplacez le user input placeholders par vos propres informations
L'exemple suivant montre comment renommer un objet à l'aide d'une vérification conditionnelle sur celui de l'objet source. ETag
aws s3api rename-object \ --bucketamzn-s3-demo-bucket--usw2-az1--x-s3\ --keynew-file.txt\ --rename-sourceoriginal-file.txt\ --source-if-match "\"a1b7c3d2e5f6\""
Cette commande exécute les opérations suivantes :
Renomme un objet de
original-file.txtànew-file.txtdans le compartiment deamzn-s3-demo-bucket--usw2-az1--x-s3répertoire.N'effectue le changement de nom que si l'objet source ETag correspond à «
a1b7c3d4e5f6».
Si ce ETag n'est pas le cas, l'opération échouera avec une 412
Precondition Failed erreur.
L’exemple suivant montre comment renommer un objet avec une vérification conditionnelle du nouveau nom d’objet spécifié.
aws s3api rename-object \ --bucketamzn-s3-demo-bucket--usw2-az1--x-s3\ --keynew-file.txt\ --rename-sourceamzn-s3-demo-bucket--usw2-az1--x-s3/original-file.txt\ --destination-if-none-match "\"e5f3g7h8i9j0\""
Cette commande exécute les opérations suivantes :
Renomme un objet de
original-file.txtànew-file.txtdans le compartiment deamzn-s3-demo-bucket--usw2-az1--x-s3répertoire.N'exécute l'opération de renommage que si l'objet existe et que celui de l'objet ETag ne correspond pas à «
e5f3g7h8i9j0».
Si un objet existe déjà avec le nouveau nom spécifié et la correspondance ETag, l'opération échouera avec une 412 Precondition Failed erreur.
Vous pouvez envoyer des demandes REST pour renommer un objet. Pour plus d’informations, consultez RenameObject dans la Référence d’API Amazon S3.
À partir de la version 1.19.0 ou supérieure, Mountpoint pour Amazon S3 prend en charge le changement de nom des objets dans S3 Express One Zone. Pour plus d’informations sur Mountpoint, consultez Utilisation de Mountpoint.