

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.

# Importer une région
<a name="import-a-region"></a>

**Note**  
La section suivante s'applique uniquement lorsque le mode de découverte des comptes de la solution est autogéré. Pour plus d'informations sur le fonctionnement de la découverte de comptes en mode AWS Organizations, consultez la section [Mode de découverte de comptes AWS Organizations](aws-organizations-account-discovery-mode.md).

L'importation d'une région nécessite le déploiement de certaines infrastructures. Cette infrastructure comprend des ressources *mondiales* et *régionales* :

 **Global** : ressources déployées une fois dans un compte et réutilisées pour chaque région importée.
+ Un rôle IAM () WorkloadDiscoveryRole

 **Régional** — Les ressources déployées dans chaque région sont importées.
+ Un canal de diffusion AWS Config
+ Un compartiment Amazon S3 pour AWS Config
+ Un rôle IAM () ConfigRole

Il existe deux options pour déployer cette infrastructure :
+ AWS CloudFormation StackSets (recommandé)
+ AWS CloudFormation

## Importer une région
<a name="import-a-region-1"></a>

Ces étapes vous guident dans l'importation d'une région et le déploiement des CloudFormation modèles AWS.

1. Connectez-vous à Workload Discovery sur AWS. Reportez-vous à [la section Connexion à Workload Discovery sur AWS](log-in-to-workload-discovery-on-aws.md) pour obtenir l'URL.

1. Dans le menu de navigation, sélectionnez **Comptes**.

1. Choisissez **Importer**.

1. Sélectionnez la méthode d'importation :

   1.  **Ajoutez des comptes et des régions** à l'aide d'un fichier CSV.

   1.  **Ajoutez des comptes et des régions** à l'aide d'un formulaire.

### Fichier CSV
<a name="csv-file"></a>

Fournissez un fichier CSV (valeurs séparées par des virgules) contenant les régions à importer au format suivant.

```
"accountId","accountName","region"
123456789012,"test-account-1",eu-west-2
123456789013,"test-account-2",eu-west-1
123456789013,"test-account-2",eu-west-2
123456789014,"test-account-3",eu-west-3
```

1. Sélectionnez **Charger un fichier CSV**.

1. Localisez et ouvrez votre fichier CSV.

1. Consultez le tableau **des régions**, puis sélectionnez **Importer**.

1. Dans la boîte de dialogue modale, téléchargez le modèle de ressources globales et le modèle de ressources régionales.

1. Déployez les CloudFormation modèles dans les comptes concernés (reportez-vous à [la section Déployer les CloudFormation modèles AWS](#deploy-the-aws-cloudformation-templates)).

1. Une fois que les modèles de ressources mondiaux et régionaux ont été déployés, cochez les deux cases pour confirmer que l'installation est terminée et choisissez **Importer**.

### Formulaire
<a name="form"></a>

Indiquez les régions à importer à l'aide du formulaire :

1. Pour **ID de compte**, entrez un identifiant de compte à 12 chiffres ou sélectionnez un identifiant de compte existant.

1. Pour **Nom du compte**, entrez un nom de compte ou utilisez une valeur préremplie lors de la sélection d'un identifiant de compte existant.

1. Sélectionnez les régions à importer.

1. Sélectionnez **Ajouter** pour renseigner les régions dans le tableau des **régions** ci-dessous.

1. Consultez le tableau **des régions**, puis sélectionnez **Importer**.

1. Dans la boîte de dialogue modale, téléchargez le modèle de ressources globales et le modèle de ressources régionales.

1. Déployez les CloudFormation modèles dans les comptes concernés (reportez-vous à [la section Déployer les CloudFormation modèles AWS](#deploy-the-aws-cloudformation-templates)).

1. Une fois que les modèles de ressources mondiaux et régionaux ont été déployés, cochez les deux cases pour confirmer que l'installation est terminée et choisissez **Importer**.

## Déployez les CloudFormation modèles AWS
<a name="deploy-the-aws-cloudformation-templates"></a>

Les ressources globales doivent être déployées une fois par compte. Ne déployez pas ce modèle lorsque vous importez une région depuis un compte contenant une région déjà importée dans Workload Discovery sur AWS. Si la région a déjà été importée, suivez les instructions de la section [Déployer la pile pour approvisionner les ressources régionales](#deploy-the-stack-to-provision-the-regional-resources-using-cloudformation).

## CloudFormation StackSets À utiliser pour provisionner des ressources globales sur plusieurs comptes
<a name="use-cloudformation-stacksets-to-provision-global-resources-across-accounts"></a>

**Important**  
Tout d'abord, remplissez les [conditions préalables pour que les opérations de stack set](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html) soient activées StackSets dans vos comptes cibles.

1. Dans le [compte administrateur](https://docs.amazonaws.cn/en_us/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stacksets-concepts-accts), connectez-vous à la [ CloudFormation console AWS](https://console.aws.amazon.com/cloudformation/).

1. Dans le menu de navigation, sélectionnez **StackSets**.

1. Choisissez **Créer StackSet**.

1. Sur la page **Choisir un modèle**, sous **Autorisations** :

   1. Si vous utilisez AWS Organizations, choisissez soit les **autorisations gérées par le service**, soit les **autorisations en libre-service**. Pour plus de détails, consultez la section [Utilisation StackSets dans une organisation AWS](aws-organizations-account-discovery-mode.md).

   1. Si vous n'utilisez pas AWS Organizations, entrez le nom du rôle d'exécution IAM utilisé lorsque vous suivez les étapes StackSets préalables. Pour plus de détails, reportez-vous à la section [Accorder des autorisations autogérées](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html).

1. Sous **Spécifier le modèle**, sélectionnez **Télécharger un fichier modèle**. Choisissez le `global-resources.template` fichier (téléchargé plus tôt lorsque vous avez [importé une région](#import-a-region-1) par fichier CSV ou par formulaire), puis cliquez sur **Suivant**.

1. Sur la page **Spécifier StackSet les détails**, attribuez un nom à votre StackSet. Pour plus d'informations sur les limites relatives aux caractères de dénomination, reportez-vous aux [quotas IAM et AWS STS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html) dans le *guide de l'utilisateur d'AWS Identity and Access Management*.

1. Sous **Paramètres**, passez en revue les paramètres de ce modèle de solution et modifiez-les si nécessaire. Cette solution utilise les valeurs par défaut suivantes.


| Nom de champ | Par défaut | Description | 
| --- | --- | --- | 
|  **AccountId **  |  *L'ID du compte de déploiement*  | ID de compte du compte de déploiement d'origine. Vous devez laisser cette valeur par défaut. | 

1. Choisissez **Suivant**.

1. Sur la page des ** StackSet options de configuration**, choisissez **Next**.

1. Sur la page **Définir les options de déploiement**, sous **Comptes**, entrez le compte IDs pour déployer le rôle de compte dans le champ **Numéros de compte**.

1. Sous **Spécifier les régions**, sélectionnez une **région** pour installer la pile.

1. Sous **Options de déploiement**, sélectionnez **Parallèle**, puis **Next**.

1. Sur la page de **révision**, cochez la case reconnaissant qu'AWS CloudFormation peut créer des ressources IAM avec des noms personnalisés.

1. Sélectionnez **Envoyer**.

## Utilisation CloudFormation StackSets pour fournir des ressources régionales
<a name="use-cloudformation-stacksets-to-provision-regional-resources"></a>

**Important**  
Tout d'abord, remplissez les [conditions préalables pour que les opérations de stack set](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html) soient activées StackSets dans vos comptes cibles.  
Si vous avez installé AWS Config dans certaines régions et d'autres non, vous devez effectuer deux StackSet opérations, l'une pour les régions où AWS Config est installé et l'autre pour celles qui n'en ont pas.

1. Dans le [compte administrateur](https://docs.amazonaws.cn/en_us/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stacksets-concepts-accts), connectez-vous à la [ CloudFormation console AWS](https://console.aws.amazon.com/cloudformation/).

1. Dans le menu de navigation, sélectionnez **StackSets**.

1. Choisissez **Créer StackSet**.

1. Sur la page Choisir un modèle, sous **Autorisations** :

   1. Si vous utilisez AWS Organizations, choisissez soit les **autorisations gérées par le service**, soit les **autorisations en libre-service**. Pour plus de détails, consultez la section [Utilisation StackSets dans une organisation AWS](aws-organizations-account-discovery-mode.md).

   1. Si vous n'utilisez pas AWS Organizations, entrez le nom du rôle d'exécution IAM utilisé lorsque vous suivez les étapes StackSets préalables. Pour plus de détails, reportez-vous à la section [Accorder des autorisations autogérées](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html).

1. Sous **Spécifier le modèle**, sélectionnez **Télécharger un fichier modèle**. Choisissez le `regional-resources.template` fichier (téléchargé plus tôt lorsque vous avez [importé une région](#import-a-region-1) par fichier CSV ou par formulaire), puis cliquez sur **Suivant**.

1. Sur la page **Spécifier StackSet les détails**, attribuez un nom à votre StackSet. Pour plus d'informations sur les limites relatives aux caractères de dénomination, reportez-vous aux [quotas IAM et AWS STS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html) dans le *guide de l'utilisateur d'AWS Identity and Access Management*.

1. Sous **Paramètres**, passez en revue les paramètres de ce modèle de solution et modifiez-les si nécessaire. Cette solution utilise les valeurs par défaut suivantes.


| Nom de champ | Par défaut | Description | 
| --- | --- | --- | 
|  **AccountId**  |  *L'ID du compte de déploiement*  | ID de compte du compte de déploiement d'origine. Vous devez laisser cette valeur par défaut. | 
|  **AggregationRegion**  |  *La région de déploiement*  | La région dans laquelle le déploiement a été initialement effectué. Vous devez laisser cette valeur par défaut. | 
|  **AlreadyHaveConfigSetup**  |  `No`  | Confirmation indiquant si AWS Config est déjà installé dans la région. Définissez ce paramètre sur Oui si AWS Config est déjà installé dans cette région. | 

1. Choisissez **Suivant**.

1. Sur la page des ** StackSet options de configuration**, choisissez **Next**.

1. Sur la page **Définir les options de déploiement**, sous **Comptes**, entrez le compte IDs vers lequel déployer le rôle de compte dans le champ **Numéros de compte**.

1. Sous **Spécifier les régions**, sélectionnez une **région** pour installer la pile. Cela installe la pile dans ces régions dans tous les comptes saisis à l'étape 6.

1. Sous **Options de déploiement**, sélectionnez **Parallèle**, puis **Next**.

1. Sur la page de **révision**, cochez la case reconnaissant qu'AWS CloudFormation peut créer des ressources IAM avec des noms personnalisés.

1. Sélectionnez **Envoyer**.

## Déployez la pile pour approvisionner les ressources globales en utilisant CloudFormation
<a name="deploy-the-stack-to-provision-the-global-resources-using-cloudformation"></a>

Les ressources globales doivent être déployées une fois par compte. Ne déployez pas ce modèle lorsque vous importez une région depuis un compte contenant une région déjà importée dans Workload Discovery sur AWS.

1. Connectez-vous à la [ CloudFormation console AWS](https://console.aws.amazon.com/cloudformation/).

1. Choisissez **Créer une pile**, puis sélectionnez **Avec de nouvelles ressources (standard)**.

1. Sur la page **Créer une pile**, dans la section **Spécifier un modèle**, sélectionnez **Télécharger un fichier modèle**.

1. **Choisissez Choisir un fichier** et sélectionnez le `global-resources.template` fichier qui (téléchargé précédemment lorsque vous avez [importé une région](#import-a-region-1) par fichier CSV ou par formulaire), puis cliquez sur **Suivant**.

1. Sur la page **Spécifier les détails de la pile**, attribuez un nom à votre pile de solutions. Pour plus d'informations sur les limites relatives aux caractères de dénomination, reportez-vous aux [quotas IAM et AWS STS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html) dans le \_AWS Identity and Access Management *\_User* Guide.

1. Sous **Paramètres**, passez en revue les paramètres de ce modèle de solution et modifiez-les si nécessaire. Cette solution utilise les valeurs par défaut suivantes.


| Nom de champ | Par défaut | Description | 
| --- | --- | --- | 
|  **Nom de la pile**  |  `workload-discovery`  | Le nom de cette CloudFormation pile AWS. | 
|  **AccountId**  |  *ID du compte de déploiement*  | ID de compte du compte de déploiement d'origine. Vous devez laisser cette valeur par défaut. | 

1. Choisissez **Suivant**.

1. Cochez la case reconnaissant qu'AWS CloudFormation peut créer des ressources IAM avec des noms personnalisés.

1. Sélectionnez **Créer la pile**.

Les nouvelles régions seront scannées lors du prochain processus de découverte, qui se déroule à intervalles de 15 minutes, par exemple : 15 h 00, 15 h 15, 15 h 30, 15 h 45.

## Déployez la pile pour approvisionner les ressources régionales en utilisant CloudFormation
<a name="deploy-the-stack-to-provision-the-regional-resources-using-cloudformation"></a>

1. Connectez-vous à la [ CloudFormation console AWS](https://console.aws.amazon.com/cloudformation/).

1. Choisissez **Créer une pile**, puis sélectionnez **Avec de nouvelles ressources (standard)**.

1. Sur la page **Créer une pile**, dans la section **Spécifier un modèle**, sélectionnez **Télécharger un fichier modèle**.

1. **Choisissez Choisir un fichier** et sélectionnez le `regional-resources.template` fichier (téléchargé précédemment lorsque vous avez [importé une région](#import-a-region-1) par fichier CSV ou par formulaire), puis cliquez sur **Suivant**.

1. Sur la page **Spécifier les détails de la pile**, attribuez un nom à votre pile de solutions. Pour plus d'informations sur les limites relatives aux caractères de dénomination, reportez-vous aux [quotas IAM et AWS STS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html) dans le *guide de l'utilisateur d'AWS Identity and Access Management*.

1. Sous **Paramètres**, passez en revue les paramètres de ce modèle de solution et modifiez-les si nécessaire. Cette solution utilise les valeurs par défaut suivantes.


| Nom de champ | Par défaut | Description | 
| --- | --- | --- | 
|  **AccountId **  |  *ID du compte de déploiement de la solution*  | ID de compte du compte de déploiement d'origine. Doit être laissé par défaut. | 
|  **AggregationRegion**  |  *Région de déploiement de la solution*  | La région dans laquelle le déploiement a été initialement effectué. Doit être laissé par défaut. | 
|  **AlreadyHaveConfigSetup**  |  `No`  | Confirmation indiquant si AWS Config est déjà installé dans la région. Défini sur `Yes` si AWS Config est déjà installé dans cette région. | 

1. Choisissez **Suivant**.

1. Cochez la case reconnaissant qu'AWS CloudFormation peut créer des ressources IAM avec des noms personnalisés.

1. Sélectionnez **Créer la pile**.

Les nouvelles régions seront scannées lors du prochain processus de découverte, qui se déroule à intervalles de 15 minutes, par exemple à 15h00, 15h15, 15h30, 15h45.

## Vérifiez que la région a été importée correctement
<a name="verify-the-region-was-imported-correctly"></a>

1. Connectez-vous à l'interface utilisateur Web de la solution (ou actualisez la page si elle est déjà chargée). Reportez-vous à [la section Connexion à Workload Discovery sur AWS](log-in-to-workload-discovery-on-aws.md) pour obtenir l'URL.

1. Dans le panneau de navigation de gauche, sous **Paramètres**, sélectionnez **Régions importées**.

La région, le nom et l'identifiant du compte apparaissent dans le tableau. La colonne **Dernière analyse** indique les dernières ressources découvertes dans cette région.

**Note**  
Si la colonne **Dernière analyse** reste vide pendant plus de 30 minutes, reportez-vous à la section [Débogage du composant de découverte](aws-organizations-account-discovery-mode.md).