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.
Ajouter des données à des objets dans des compartiments de répertoire
Vous pouvez ajouter des données à la fin des objets existants stockés dans la classe de stockage S3 Express One Zone dans des compartiments de répertoire. Nous vous recommandons d'utiliser la possibilité d'ajouter des données à un objet si les données sont écrites en continu pendant un certain temps ou si vous devez lire l'objet pendant que vous écrivez sur celui-ci. L'ajout de données à des objets est courant dans des cas d'utilisation tels que l'ajout de nouvelles entrées de journal aux fichiers journaux ou l'ajout de nouveaux segments vidéo aux fichiers vidéo lors de leur transcodage puis de leur diffusion en continu. En ajoutant des données aux objets, vous pouvez simplifier les applications qui combinaient auparavant les données dans le stockage local avant de copier l'objet final sur Amazon S3.
Aucune taille minimale n'est requise pour les données que vous pouvez ajouter à un objet. Toutefois, la taille maximale des données que vous pouvez ajouter à un objet dans une seule demande est de 5 Go. Il s'agit de la même limite que la plus grande taille de demande lors du téléchargement de données à l'aide d'un Amazon S3API.
À chaque opération d'ajout réussie, vous créez une partie de l'objet et chaque objet peut comporter jusqu'à 10 000 parties. Cela signifie que vous pouvez ajouter des données à un objet jusqu'à 10 000 fois. Si un objet est créé à l'aide du téléchargement partitionné S3, chaque partie téléchargée est prise en compte dans le calcul du maximum de 10 000 parties. Par exemple, vous pouvez ajouter jusqu'à 9 000 fois à un objet créé par téléchargement partitionné comprenant 1 000 parties.
Note
Si vous atteignez la limite de pièces, vous recevrez un TooManyPartsmessage d'erreur. Vous pouvez utiliser le CopyObject API pour réinitialiser le décompte.
Si vous souhaitez charger des parties dans un objet en parallèle et que vous n'avez pas besoin de les lire pendant le chargement, nous vous recommandons d'utiliser le téléchargement partitionné sur Amazon S3. Pour plus d'informations, consultez la section Utilisation du téléchargement partitionné.
L'ajout de données aux objets n'est pris en charge que pour les objets des compartiments de répertoire stockés dans la classe de stockage S3 Express One Zone. Pour plus d'informations sur S3 Express One Zone Zone, consultez Commencer à utiliser S3 Express One Zone.
Pour commencer à ajouter des données aux objets de vos compartiments de répertoire, vous pouvez utiliser le AWS
SDKs AWS CLI, et le. PutObject API Lorsque vous faites une PutObject demande, vous définissez l'x-amz-write-offset-bytesen-tête en fonction de la taille de l'objet auquel vous ajoutez. Pour utiliser cette PutObject API opération, vous devez utiliser le CreateSession API pour établir des informations d'identification de sécurité temporaires afin d'accéder aux objets de vos compartiments de répertoire. Pour plus d'informations, CreateSessionconsultez PutObjectle manuel Amazon S3 API Reference.
Chaque opération d'ajout réussie est facturée comme une PutObject demande. Pour en savoir plus sur les tarifs, consultez Amazon S3
pricing
À partir de la version 1.12, Mountpoint pour Amazon S3 prend en charge l'ajout de données aux objets stockés dans S3 Express One Zone. Pour commencer, vous devez vous inscrire en configurant le--incremental-upload . Pour plus d'informations sur Mountpoint, consultez la section Travailler avec Mountpoint.
Si vous utilisez un algorithme CRC (contrôle de redondance cyclique) lors du téléchargement des données ajoutées, vous pouvez récupérer des sommes de contrôle complètes CRC basées sur des objets à l'aide de la requête or. HeadObject GetObject Si vous utilisez l'algorithme SHA -1 ou SHA -256 lors du téléchargement des données ajoutées, vous pouvez récupérer une somme de contrôle des parties ajoutées et vérifier leur intégrité à l'aide des sommes de SHA contrôle renvoyées lors des réponses précédentes. PutObject Pour plus d'informations, consultez la section Protection des données et chiffrement.
Ajouter des données à vos objets à l'aide AWS CLI AWS SDKs des REST API
Vous pouvez ajouter des données à vos objets en utilisant les touches AWS Command Line Interface (AWS CLI) AWS SDKs et RESTAPI.
L'put-objectexemple de commande suivant montre comment vous pouvez utiliser le AWS CLI pour ajouter des données à un objet. Pour exécuter cette commande, remplacez user input placeholders avec vos propres informations
aws s3api put-object --bucketamzn-s3-demo-bucket--azid--x-s3 --keysampleinput/file001.bin--body bucket-seed/file001.bin --write-offset-bytes size-of-sampleinput/file001.bin
Vous pouvez envoyer REST des demandes pour ajouter des données à un objet. Pour de plus amples informations, veuillez consulter PutObject.
