Utilisation des objets Amazon S3

Vos fichiers, dossiers et toutes les autres données stockées dans un compartiment de ressources S3 sont appelés objets S3.

Les sections suivantes décrivent comment utiliser les objets Amazon S3 à partir duAWS Toolkit for Visual Studio Code. Pour en savoir plus sur l'utilisation des ressources Amazon S3, telles que les compartiments S3, depuis leAWS Toolkit for Visual Studio Code, consultez la rubrique Utilisation des ressources S3 dans ce guide de l'utilisateur.

Pagination des objets

Si vous travaillez avec un grand nombre d'objets et de dossiers Amazon S3, la pagination vous permet de spécifier le nombre d'éléments que vous souhaitez afficher sur une page.

1. Accédez à la barre d'activité VS Code et choisissez Extensions.

2. Dans l'extension AWS Toolkit, choisissez l'icône des paramètres, puis sélectionnez Paramètres de l'extension.

3. Sur la page Paramètres, faites défiler la page vers le bas jusqu'au paramètre AWS> S3 : nombre maximum d'éléments par page.

4. Modifiez la valeur par défaut par le nombre d'éléments S3 que vous souhaitez afficher avant que « en charger plus » ne soit affiché.

   Note

   Les valeurs valides incluent tout nombre compris entre 3 et 1 000. Ce paramètre s'applique uniquement au nombre d'objets ou de dossiers affichés simultanément. Tous les compartiments que vous avez créés sont affichés en même temps. Par défaut, vous pouvez créer jusqu'à 100 compartiments par compte AWS.

5. Fermez la page Paramètres pour confirmer vos modifications.

Vous pouvez également mettre à jour les paramètres d'un fichier au format JSON en choisissant l'icône Ouvrir les paramètres (JSON) en haut à droite de la page des paramètres.

Chargement et téléchargement d'objets Amazon S3

Vous pouvez télécharger des fichiers stockés localement dans vos compartiments Amazon S3 ou télécharger des objets Amazon S3 distants sur votre système local, depuis le. AWS Toolkit for Visual Studio Code

Téléchargez un fichier à l'aide de la boîte à outils

1. Dans l'explorateur du Toolkit, étendez le service Amazon S3 pour afficher la liste de vos ressources S3.

2. Cliquez sur l'icône Upload File située à côté d'un bucket ou d'un dossier pour ouvrir la boîte de dialogue Upload File. Vous pouvez également ouvrir le menu contextuel (clic droit) et choisir Charger un fichier.

   Note

   Pour télécharger un fichier dans le dossier ou la ressource parent de l'objet, ouvrez le menu contextuel (clic droit) de n'importe quel objet S3 et choisissez Upload to Parent.

3. Utilisez le gestionnaire de fichiers de votre système pour sélectionner un fichier, puis choisissez Charger un fichier pour fermer la boîte de dialogue et charger le fichier.

Téléchargez un fichier à l'aide de la palette de commandes

Vous pouvez utiliser l'interface du Toolkit ou la palette de commandes pour télécharger un fichier dans un bucket.

1. Pour sélectionner un fichier à télécharger, choisissez l'onglet correspondant dans VS Code.

2. Appuyez sur Ctrl+Shift+P pour afficher la palette de commandes.

3. Dans la palette de commandes, entrez la phrase upload file pour afficher la liste des commandes recommandées.

4. Choisissez la commande AWS: Charger un fichier pour ouvrir la boîte de dialogue AWS: Charger un fichier.

5. Lorsque vous y êtes invité, choisissez le fichier que vous souhaitez télécharger, puis le compartiment dans lequel vous souhaitez télécharger ce fichier.

6. Confirmez votre téléchargement pour fermer la boîte de dialogue et commencer le processus de téléchargement. Lorsque le téléchargement est terminé, l'objet s'affiche dans le menu de la boîte à outils avec des métadonnées qui incluent la taille de l'objet, la date de dernière modification et le chemin.

Téléchargement d'un objet Amazon S3

1. À partir de l'explorateur du Toolkit, étendez le service S3.

2. À partir d'un compartiment ou d'un dossier, ouvrez le menu contextuel (clic droit) de l'objet que vous souhaitez télécharger. Choisissez ensuite Télécharger sous pour ouvrir la boîte de dialogue Télécharger sous. Vous pouvez également choisir l'icône Télécharger sous située à côté de l'objet.

3. À l'aide du gestionnaire de fichiers de votre système, choisissez un dossier de destination, entrez un nom de fichier, puis choisissez Télécharger pour fermer la boîte de dialogue et démarrer le téléchargement.

Modification d'objets distants

Vous pouvez utiliser le AWS Toolkit for Visual Studio Code pour modifier vos objets Amazon S3 stockés dans vos ressources Amazon S3 distantes.

1. À partir de l'explorateur du Toolkit, étendez le service S3.

2. Développez la ressource S3 qui contient le fichier que vous souhaitez modifier.

3. Pour modifier le fichier, cliquez sur l'icône en forme de crayon (Modifier le fichier).

4. Pour modifier un fichier ouvert en mode lecture seule, visualisez-le dans l'éditeur VS Code, puis choisissez l'icône en forme de crayon située dans le coin supérieur droit de l'interface utilisateur.

Note

• Si vous redémarrez ou quittez VS Code, votre IDE se déconnecte de vos ressources S3. Si des fichiers S3 distants sont en cours de modification lorsque vous vous déconnectez, la modification s'arrête. Vous devez redémarrer VS Code et rouvrir l'onglet d'édition pour reprendre la modification.

• Le bouton Modifier le fichier se trouve dans le coin supérieur droit de l'interface utilisateur. Il n'est visible que lorsque vous visualisez activement un fichier en lecture seule dans l'éditeur VS Code.

• Les fichiers autres que du texte ne peuvent pas être ouverts en mode lecture seule. Ils s'ouvrent toujours en mode édition.

• Vous ne pouvez pas passer du mode édition seule au mode lecture seule, mais inversement.

Copier le chemin d'un objet Amazon S3

La procédure suivante décrit comment copier le chemin d'un objet Amazon S3 depuis leAWS Toolkit for Visual Studio Code.

1. À partir de l'explorateur du Toolkit, étendez le service S3.

2. Développez le compartiment de ressources qui contient l'objet dont vous souhaitez copier le chemin.

3. Ouvrez le menu contextuel (clic droit) de l'objet dont vous souhaitez copier le chemin, puis choisissez Copier le chemin pour copier le chemin de l'objet dans votre presse-papiers local.

Génération d'une URL présignée pour un objet Amazon S3

Vous pouvez partager des objets Amazon S3 privés avec d'autres personnes en accordant des autorisations de téléchargement limitées dans le temps via la fonctionnalité d'URL présignée. Pour plus d'informations, consultez la section Partage d'un objet avec une URL présignée.

1. À partir de l'explorateur du Toolkit, étendez le service S3.

2. À partir d'un compartiment ou d'un dossier, ouvrez le menu contextuel (clic droit) de l'objet que vous souhaitez partager. Choisissez ensuite Générer une URL présignée pour ouvrir la palette de commandes.

3. Dans la palette de commandes, entrez le nombre de minutes pendant lesquelles l'URL peut être utilisée pour accéder à votre objet. Choisissez ensuite Entrée pour confirmer et fermer la boîte de dialogue.

4. Une fois l'URL présignée générée, la barre d'état du code VS affiche l'URL présignée de l'objet qui a été copié dans votre presse-papiers local.

Suppression d'un objet Amazon S3

Si un objet se trouve dans un compartiment non versionné, vous pouvez le supprimer définitivement. Pour les buckets dont le versionnement est activé, une demande de suppression ne supprime pas définitivement cet objet. Dans ce cas, Amazon S3 insère un marqueur de suppression. Pour plus d'informations, consultez la section Suppression de versions d'objets.

1. Dans l'explorateur du Toolkit, étendez le service S3 pour afficher la liste de vos ressources S3.

2. Ouvrez le menu contextuel (clic droit) de l'objet que vous souhaitez supprimer, puis choisissez Supprimer pour ouvrir la boîte de dialogue de confirmation.

3. Choisissez Supprimer. pour confirmer que vous souhaitez supprimer l'objet S3. Fermez ensuite la boîte de dialogue.