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.
# Activation de la recherche interrégionale en créant un index agrégateur
Lorsque la recherche interrégionale est activée, vous pouvez rechercher des ressources dans toutes les régions de votre Compte AWS.
**Topics**
+ [À propos de l'indice agrégateur](#manage-aggregator-region-about)
+ [Promouvoir un indice local en tant qu'indice agrégateur pour le compte](manage-aggregator-region-turn-on.md)
+ [Rétrogradation de l'index agrégateur en index local](manage-aggregator-region-turn-off.md)
## À propos de l'indice agrégateur
Explorateur de ressources AWS stocke les informations collectées sur les ressources dans un Région AWS *index local* que Resource Explorer crée et gère dans cette région. Supposons, par exemple, que vous disposiez d'une EC2 instance Amazon dans la région de l'ouest des États-Unis (Oregon). L'explorateur de ressources stocke les informations relatives à cette ressource dans l'index local de la région USA Ouest (Oregon).
Pour faciliter la recherche de ressources Régions AWS dans l'ensemble de votre compte, vous pouvez convertir l'index local d'*une* région en index agrégateur pour votre compte.
L'index agrégateur contient une copie répliquée de l'index local dans toutes les autres régions où vous avez activé l'explorateur de ressources. Cela vous permet de créer des vues dans la région qui contient l'index agrégateur dont les résultats peuvent inclure les ressources de tous Régions AWS les utilisateurs du compte.
Le schéma suivant montre un exemple du fonctionnement de l'indice agrégateur. Dans cet exemple Compte AWS, l'administrateur effectue les opérations suivantes :
+ Active l'explorateur de ressources en trois Régions AWS (`us-east-1``us-west-2`, et`eu-west-1`) en créant des index dans ces régions. Chaque région contient son propre index local.
+ Choisit de *ne pas* créer d'index dans la `sa-east-1` région. Les utilisateurs ne peuvent pas effectuer de recherches dans `sa-east-1` cette région et aucune ressource de cette région n'apparaît dans les résultats de recherche.
+ Crée l'index agrégateur pour le compte dans la `us-west-2` région. Cela oblige Resource Explorer à répliquer les informations des index locaux de toutes les autres régions où Resource Explorer est activé dans l'index agrégateur. Cela permet aux recherches effectuées `us-west-2` d'inclure les ressources des trois régions dans lesquelles l'explorateur de ressources est activé.
Cette configuration signifie qu'un utilisateur peut effectuer des recherches interrégionales ***uniquement*** dans`us-west-2`, qui contient l'index de l'agrégateur. Seules les vues de cette région peuvent renvoyer les résultats de toutes les régions du compte.
![\[Le diagramme montre que l'explorateur de ressources est activé dans trois régions et qu'une région possède l'index agrégateur et la vue par défaut. One Region n'est pas activée.\]](http://docs.aws.amazon.com/fr_fr/resource-explorer/latest/userguide/images/AREX-Overview.png)
| |
| --- |
| Légende |
| ![\[Gear icon with magnifying glass, representing system configuration or search settings.\]](http://docs.aws.amazon.com/fr_fr/resource-explorer/latest/userguide/images/AREX-Activated-Icon.png) | L'explorateur de ressources est activé dans ce Région AWS cas, et ses ressources sont cataloguées dans un index dans cette région. L'indice de cette région est également reproduit (indiqué par les flèches) sur Région AWS celui qui contient l'indice agrégateur. |
| ![\[Notebook icon representing a document or file with lined pages.\]](http://docs.aws.amazon.com/fr_fr/resource-explorer/latest/userguide/images/Global-Index-Icon.png) | Il Région AWS contient l'indice de l'agrégateur. Resource Explorer reproduit les informations sur les ressources collectées dans toutes les autres régions Régions AWS dans cette région. |
| ![\[Blue square border with white interior, representing a placeholder for an image.\]](http://docs.aws.amazon.com/fr_fr/resource-explorer/latest/userguide/images/Default-Search-Scope.png) | La vue par défaut créée par Quick Setup inclut toutes les ressources Régions AWS. |
# Promouvoir un indice local en tant qu'indice agrégateur pour le compte
Vous avez la possibilité de créer un index agrégateur en un seulRégion AWS lors de la première configurationExplorateur de ressources AWS. Pour plus d'informations, consultez [Configuration et configuration de l'explorateur de ressources](getting-started-setting-up.md). Cette procédure consiste à promouvoir l'un des index locaux en tant qu'index agrégateur pour le compte si vous ne l'avez pas fait lors de la configuration initiale.
**Important**
Vous ne pouvez avoir qu'un seul index d'agrégation dans unCompte AWS. Si le compte possède déjà un index agrégateur, vous devez d'abord le [rétrograder dans un index local](manage-aggregator-region-turn-off.md) ou le supprimer.
Après avoir supprimé ou modifié la région qui contient l'index agrégateur, vous devez attendre 24 heures avant de pouvoir promouvoir un autre index en tant qu'index agrégateur.
------
#### [ AWS Management Console ]
**Pour promouvoir un indice local en tant qu'indice agrégateur pour le compte**
1. Ouvrez la page **[Paramètres](https://console.aws.amazon.com/resource-explorer/home#/settings)** de l'explorateur de ressources.
1. Dans la section **Index**, cochez la case à côté de l'index que vous souhaitez promouvoir, puis choisissez **Modifier le type d'index**.
1. Dans la boîte de dialogue **Modifier le type d'index pour < *Nom de la région* >**, choisissez **l'index agrégateur**, puis choisissez **Enregistrer les modifications**.
------
#### [ AWS CLI ]
**Pour promouvoir un indice local en tant qu'indice agrégateur pour le compte**
L'exemple de commande suivant met à jour l'indexRégion AWS du type`LOCAL` au type spécifié`AGGREGATOR`. Vous devez appeler l'opération à partir deRégion AWS laquelle vous souhaitez contenir l'index de l'agrégateur.
```
$ aws resource-explorer-2 update-index-type \
--arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111 \
--type AGGREGATOR \
--region us-east-1
{
"Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
"LastUpdatedAt":"2022-07-13T18:41:58.799Z",
"State":"UPDATING",
"Type":"AGGREGATOR"
}
```
L'opération fonctionne de manière asynchrone et commence par`State` set to`UPDATING`. Pour vérifier si l'opération est terminée, vous pouvez exécuter la commande suivante et rechercher la valeur`ACTIVE` dans le champ de`State` réponse. Vous devez exécuter cette commande dans la région qui contient l'index que vous souhaitez vérifier.
```
$ aws resource-explorer-2 get-index --region us-east-1
{
"Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
"CreatedAt": "2022-10-12T21:31:37.277000+00:00",
"LastUpdatedAt": "2022-10-12T21:31:37.677000+00:00",
"ReplicatingFrom": [
"us-west-2",
"us-east-2",
"us-west-1"
],
"State": "ACTIVE",
"Tags": {},
"Type": "AGGREGATOR"
}
```
------
# Rétrogradation de l'index agrégateur en index local
Vous pouvez rétrograder un index agrégateur en index local, par exemple lorsque vous souhaitez déplacer l'index agrégateur vers un autre. Région AWS
Lorsque vous rétrogradez un index agrégateur en index local, Resource Explorer arrête de répliquer les index à partir d'un autre index. Régions AWS Il lance également une tâche d'arrière-plan asynchrone pour supprimer toutes les informations répliquées provenant d'autres régions. Jusqu'à ce que cette tâche asynchrone soit terminée, certains résultats interrégionaux peuvent continuer à apparaître dans les résultats de recherche.
**Remarques**
Après avoir rétrogradé un indice agrégateur, vous devez attendre 24 heures avant de pouvoir promouvoir le même indice ou l'indice d'une autre région en tant que nouvel indice agrégateur pour le compte.
Après la rétrogradation d'un index agrégateur, il peut s'écouler jusqu'à 36 heures pour que les processus en arrière-plan soient terminés et que toutes les informations sur les ressources provenant d'autres régions disparaissent des résultats des recherches effectuées dans cette région.
Si vous rétrogradez un compte membre dans une vue globale de l'organisation, le membre peut être retiré de la recherche multi-comptes.
Vous pouvez vérifier l'état de la tâche en arrière-plan en consultant la liste des index sur la page **[Paramètres](https://console.aws.amazon.com/resource-explorer/home#/settings)** ou en utilisant l'[GetIndex](https://docs.aws.amazon.com/resource-explorer/latest/apireference/API_GetIndex.html)opération. Lorsque les tâches asynchrones sont terminées, le `Status` champ de l'index passe de à`UPDATING`. `ACTIVE` À ce stade, seuls les résultats de la région locale apparaissent dans les résultats de la requête.
------
#### [ AWS Management Console ]
**Pour rétrograder un index agrégateur en index local**
1. Ouvrez la page des **[paramètres](https://console.aws.amazon.com/resource-explorer/home#/settings)** de l'explorateur de ressources.
1. Dans la section **Index**, cochez la case à côté de la région contenant l'index agrégateur que vous souhaitez rétrograder en index local, puis choisissez **Modifier** le type d'index.
1. Dans la boîte de dialogue **Modifier le type d'index pour < *Nom de région* >**, choisissez **Index local**, puis **Enregistrer les modifications**.
------
#### [ AWS CLI ]
**Pour rétrograder un index agrégateur en index local**
L'exemple suivant rétrograde l'index agrégateur spécifié en index local. Vous devez appeler l'opération dans le fichier Région AWS qui contient actuellement l'index agrégateur.
```
$ aws resource-explorer-2 update-index-type \
--arn arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111 \
--type LOCAL \
--region us-east-1
{
"Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
"LastUpdatedAt":"2022-07-13T18:41:58.799Z",
"State":"UPDATING",
"Type":"LOCAL"
}
```
L'opération fonctionne de manière asynchrone et commence par `State` set to. `UPDATING` Pour vérifier si l'opération est terminée, vous pouvez exécuter la commande suivante et rechercher la valeur `ACTIVE` dans le champ de `State` réponse. Vous devez exécuter cette commande dans la région qui contient l'index que vous souhaitez vérifier.
```
$ aws resource-explorer-2 get-index --region us-east-1
{
"Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111",
"CreatedAt": "2022-10-12T21:31:37.277000+00:00",
"LastUpdatedAt": "2022-10-12T21:31:37.677000+00:00",
"ReplicatingFrom": [
"us-west-2",
"us-east-2",
"us-west-1"
],
"State": "ACTIVE",
"Tags": {},
"Type": "LOCAL"
}
```
------