

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
<a name="more-resources"></a>

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 , les rôles IAM, Amazon VPC et les distributions Amazon. CloudFront 

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 (aux formats JSON et YAML) pour modéliser une ressource. 
+ Créez une nouvelle ressource en éditant et en enregistrant un modèle au format JSON conforme à un schéma.**\$1**
+ Mettre à jour ou supprimer une ressource existante.**\$1**

**Important**  
**\$1** 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 IDE VS Code, développez les **extensions** et choisissez **AWS Toolkit**.  
Sous **AWS Toolkit Experiments**, sélectionnez **jsonResourceModification**cette option pour vous permettre de créer, de mettre à jour et de supprimer des ressources.  
  
Pour de plus amples informations, veuillez consulter [Travailler avec des fonctionnalités expérimentales](experimental-features.md).

## Autorisations IAM pour l'accès aux ressources
<a name="cloud-api-permissions"></a>

Vous avez besoin d' Gestion des identités et des accès AWS autorisations spécifiques pour accéder aux ressources associées aux AWS services. Par exemple, une entité IAM, telle qu'un utilisateur ou un rôle, a besoin des autorisations Lambda pour accéder aux ressources `AWS Toolkit:Lambda::Function`. 

Outre les autorisations pour les ressources de service, une entité IAM a besoin d'autorisations pour permettre au Toolkit for VS Code d'appeler les opérations de l'API AWS Cloud Control en son nom. Les opérations d'API Cloud Control permettent à l'utilisateur ou au rôle IAM 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'entité IAM qui appelle ces opérations d'API à l'aide de l'interface du Toolkit. **PowerUserAccess** Cette [politique gérée](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_job-functions.html#jf_developer-power-user) accorde une série d'autorisations pour effectuer des tâches de développement d'applications, y compris l'appel d'opérations d'API. 

Pour connaître les autorisations spécifiques qui définissent les opérations d'API autorisées sur les ressources distantes, consultez le [Guide de l'utilisateur de l'API AWS Cloud Control](https://docs.aws.amazon.com//cloudcontrolapi/latest/userguide/security.html).

## Ajout et interaction avec des ressources existantes
<a name="configure-resources"></a>

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.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-vscode/latest/userguide/images/show-resources.png)

1. 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**.

1. 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.

1. 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](#experimental-feature-warning) activer l'option requise.
   + **Mise à jour** : modifiez le modèle au format JSON pour la ressource dans un éditeur VS Code. Pour de plus amples informations, veuillez consulter [Création et modification de ressources](#create-resources).
   + **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](#experimental-feature-warning) 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 CloudFormation modèle de la pile. Pour plus d'informations, consultez cet [article du Centre de connaissances](https://aws.amazon.com/premiumsupport/knowledge-center/failing-stack-updates-deleted/).  
![\[Options de menu pour une ressource sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-vscode/latest/userguide/images/resource-menu-options-updated.png)

## Création et modification de ressources
<a name="create-resources"></a>

**Important**  
La création et la mise à jour des ressources est actuellement un [experimental feature](#experimental-feature-warning) 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 **Ressources**, puis l'édition d'un modèle au format JSON 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**.

1. Une fois le type de ressource ajouté sous **Ressources**, cliquez sur l'icône plus (« \$1 ») 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é.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-vscode/latest/userguide/images/resource-create.png)

1. 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.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-vscode/latest/userguide/images/resource-template.png)

1. 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.

1. 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.