Utilisation des ressources - AWS Boîte à outils pour VS Code

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.

Utilisation des ressources

Outre l'accès aux AWS services répertoriés par défaut dans l' AWS explorateur, vous pouvez également accéder à Ressources et choisir parmi des centaines de ressources à ajouter à l'interface. Dans AWS, une ressource est une entité avec laquelle vous pouvez travailler. Certaines des ressources qui peuvent être ajoutées incluent Amazon AppFlow, Amazon Kinesis Data Streams AWS IAM, les rôles, VPC Amazon et les distributions CloudFront Amazon.

Après avoir fait votre sélection, vous pouvez aller dans Ressources et développer le type de ressource pour lister les ressources disponibles pour ce type. Par exemple, si vous sélectionnez le type de ressource AWS Toolkit:Lambda::Function, vous pouvez accéder aux ressources qui définissent différentes fonctions, leurs propriétés et leurs attributs.

Après avoir ajouté un type de ressource à Resources (Ressources), vous pouvez interagir avec lui et ses ressources de la manière suivante :

  • Consultez la liste des ressources existantes disponibles dans la AWS région actuelle pour ce type de ressource.

  • Afficher une version en lecture seule du fichier JSON qui décrit une ressource.

  • Copier l'identifiant de la ressource.

  • Consultez la AWS documentation qui explique l'objectif du type de ressource et le schéma (dans JSON et YAML formats) de modélisation d'une ressource.

  • Créez une nouvelle ressource en modifiant et en enregistrant un modèle JSON au format conforme à un schéma. *

  • Mettre à jour ou supprimer une ressource existante.*

Important

* Dans la version actuelle, AWS Toolkit for Visual Studio Code l'option permettant de créer, de modifier et de supprimer des ressources est une fonctionnalité expérimentale. Comme les fonctionnalités expérimentales continuent d'être testées et mises à jour, elles peuvent présenter des problèmes d'utilisation. Et les fonctionnalités expérimentales peuvent être supprimées du AWS Toolkit for Visual Studio Code sans préavis.

Pour autoriser l'utilisation de fonctionnalités expérimentales pour les ressources, ouvrez le volet Paramètres de votre VS CodeIDE, développez les extensions et choisissez AWS Toolkit.

Sous AWS Toolkit Experiments, sélectionnez jsonResourceModificationcette option pour vous permettre de créer, de mettre à jour et de supprimer des ressources.

Pour de plus amples informations, veuillez consulter Utilisation des fonctions expérimentales.

IAMautorisations d'accès aux ressources

Vous avez besoin d' AWS Identity and Access Management autorisations spécifiques pour accéder aux ressources associées aux AWS services. Par exemple, une IAM entité, telle qu'un utilisateur ou un rôle, nécessite des autorisations Lambda pour accéder AWS Toolkit:Lambda::Function aux ressources.

Outre les autorisations pour les ressources de service, une IAM entité a besoin d'autorisations pour permettre au Toolkit for VS Code d'appeler les API opérations AWS Cloud Control en son nom. Les API opérations Cloud Control permettent à l'IAMutilisateur ou au rôle d'accéder aux ressources distantes et de les mettre à jour.

Le moyen le plus simple d'accorder des autorisations consiste à associer la politique AWS gérée à l'IAMentité qui appelle ces API opérations à l'aide de l'interface du Toolkit. PowerUserAccess Cette politique gérée accorde une série d'autorisations pour effectuer des tâches de développement d'applications, y compris API des opérations d'appel.

Pour les autorisations spécifiques qui définissent les API opérations autorisées sur les ressources distantes, consultez le guide de l'APIutilisateur de AWS Cloud Control.

Ajout et interaction avec des ressources existantes

  1. Dans l'AWS explorateur, cliquez avec le bouton droit sur Ressources et choisissez Afficher les ressources.

    Un volet affiche la liste des types de ressources disponibles à la sélection.

    Sélection des ressources à configurer.
  2. Dans le volet de sélection, sélectionnez les types de ressources à ajouter à l'AWS explorateur et appuyez sur Retour ou choisissez OK pour confirmer.

    Les types de ressources que vous avez sélectionnés sont répertoriés sous Ressources.

    Note

    Si vous avez déjà ajouté un type de ressource à AWS Explorer et que vous décochez ensuite la case de ce type, il n'est plus répertorié sous Ressources après que vous avez cliqué sur OK. Seuls les types de ressources actuellement sélectionnés sont visibles dans AWS Explorer.

  3. Pour afficher les ressources qui existent déjà pour un type de ressource, développez l'entrée correspondant à ce type.

    Une liste des ressources disponibles s'affiche sous son type de ressource.

  4. Pour interagir avec une ressource spécifique, cliquez avec le bouton droit de la souris sur son nom et choisissez l'une des options suivantes :

    • Copier l'identifiant de ressource : copiez l'identifiant de la ressource spécifique dans le presse-papiers. (Par exemple, la ressource AWS Toolkit:DynamoDB::Table peut être identifiée à l'aide de la propriété TableName.)

    • Preview (Prévisualiser) : pour afficher une version en lecture seule du modèle au format JSON qui décrit la ressource.

      Une fois le modèle de ressource affiché, vous pouvez le modifier en cliquant sur l'icône Mettre à jour à droite de l'onglet de l'éditeur. Pour mettre à jour une ressource, vous devez experimental feature activer l'option requise.

    • Mise à jour : modifiez le modèle JSON formaté pour la ressource dans un éditeur VS Code. Pour de plus amples informations, veuillez consulter Création et modification de ressources.

    • Supprimer : supprimez la ressource en confirmant la suppression dans une boîte de dialogue qui s'affiche. (La suppression de ressources est actuellement une experimental feature option dans cette version de AWS Toolkit for Visual Studio Code.)

      Avertissement

      Si vous supprimez une ressource, toute AWS CloudFormation pile utilisant cette ressource ne sera pas mise à jour. Pour corriger cet échec de mise à jour, vous devez soit recréer la ressource, soit supprimer la référence à celle-ci dans le AWS CloudFormation modèle de la pile. Pour plus d'informations, consultez cet article du Centre de connaissances.

    Options de menu pour une ressource sélectionnée.

Création et modification de ressources

Important

La création et la mise à jour des ressources est actuellement un experimental feature dans cette version d' AWS Toolkit for Visual Studio Code.

La création d'une nouvelle ressource implique l'ajout d'un type de ressource à la liste des ressources, puis la modification d'un modèle JSON formaté qui définit la ressource, ses propriétés et ses attributs.

Par exemple, une ressource appartenant au type de AWS Toolkit:SageMaker::UserProfile ressource est définie à l'aide d'un modèle qui crée un profil utilisateur pour Amazon SageMaker AI Studio. Le modèle qui définit cette ressource de profil utilisateur doit être conforme au schéma du type de ressource AWS Toolkit:SageMaker::UserProfile. Si le modèle n'est pas conforme au schéma en raison de propriétés manquantes ou incorrectes, par exemple, la ressource ne peut pas être créée ou mise à jour.

  1. Ajoutez le type de ressource pour la ressource que vous souhaitez créer en cliquant avec le bouton droit sur Ressources et en choisissant Afficher les ressources.

  2. Une fois le type de ressource ajouté sous Ressources, cliquez sur l'icône plus (« + ») pour ouvrir le fichier modèle dans un nouvel éditeur.

    Vous pouvez également cliquer avec le bouton droit sur le nom du type de ressource et sélectionner Créer. Vous pouvez également accéder aux informations relatives à la modélisation de la ressource en choisissant Afficher la documentation.

    Options de menu pour un type de ressource sélectionné.
  3. Dans l'éditeur, commencez à définir les propriétés qui composent le modèle de ressource. La fonction de saisie semi-automatique suggère des noms de propriétés conformes au schéma de votre modèle. Lorsque vous survolez un type de propriété, un volet affiche une description de son utilisation. Pour obtenir des informations détaillées sur le schéma, choisissez Afficher la documentation.

    Tout texte non conforme au schéma de ressource est indiqué par un soulignement rouge ondulé.

    Editeur affichant le modèle qui décrit un type de ressource.
  4. Après avoir déclaré votre ressource, cliquez sur l'icône Enregistrer pour valider votre modèle et enregistrer la ressource dans le AWS cloud distant.

    Si votre modèle définit la ressource conformément à son schéma, un message s'affiche pour confirmer la création de la ressource. (Si la ressource existe déjà, le message confirme que la ressource a été mise à jour.)

    Une fois la ressource créée, elle est ajoutée à la liste sous l'en-tête du type de ressource.

  5. Si votre fichier contient des erreurs, un message s'affiche pour expliquer que la ressource n'a pas pu être créée ou mise à jour. Choisissez Afficher les journaux pour identifier les éléments du modèle que vous devez corriger.