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.
# Partagez des connexions avec Comptes AWS
Vous pouvez utiliser le partage de ressources avec AWS RAM pour partager une connexion existante avec une autre Compte AWS personne ou avec des comptes de votre organisation. Vous pouvez utiliser votre connexion partagée avec des ressources AWS que vous gérez pour les connexions à des sources tierces, par exemple dans CodePipeline.
**Important**
Le partage de connexion n'est pas pris en charge pour les `codestar-connections ` ressources. Ceci n'est pris en charge que pour les `codeconnections` ressources.
Avant de commencer :
+ Vous devez déjà avoir créé une connexion avec votre Compte AWS.
+ Le partage des ressources doit être activé.
+ Vous devez avoir configuré les autorisations requises. Pour de plus amples informations, veuillez consulter [Autorisations prises en charge pour le partage de connexion](security-iam.md#permissions-reference-connections-sharing).
**Note**
Pour partager la connexion, vous devez être le propriétaire de l'organisation ou le propriétaire du référentiel s'il n'appartient pas à une organisation. Le compte avec lequel vous partagez devra également disposer d'autorisations d'accès au référentiel.
**Topics**
+ [Partager une connexion (console)](#connections-share-console)
+ [Partager une connexion (CLI)](#connections-share-cli)
+ [Afficher les connexions partagées (console)](#connections-view-console)
+ [Afficher les connexions partagées (CLI)](#connections-view-cli)
## Partager une connexion (console)
Vous pouvez utiliser la console pour créer des ressources de connexion partagées.
1. Connectez-vous au AWS Management Console.
Choisissez **Créer un partage de ressources** sur la page **[Shared by me : Shared resources](https://console.aws.amazon.com/ram/home#OwnedResources:)** de la AWS RAM console.
1. Étant donné que les partages de AWS RAM ressources existent dans des régions AWS spécifiques, choisissez la région AWS appropriée dans la liste déroulante située dans le coin supérieur droit de la console. Pour créer des partages de ressources contenant des ressources globales, vous devez définir la région AWS sur USA Est (Virginie du Nord),
Pour plus d'informations sur le partage de ressources mondiales, voir [Partage de ressources régionales par rapport aux ressources mondiales](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html).
1. Sur la page de création, dans **Nom**, entrez le nom de votre partage de ressources. Sous **Ressources**, sélectionnez **Code Connections**.
![\[\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-share-create.png)
1. Choisissez votre ressource de connexion et affectez les principaux avec lesquels vous souhaitez partager.
1. Choisissez **Créer**.
## Partager une connexion (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour partager une connexion existante avec d'autres comptes et consulter les connexions que vous possédez ou que vous avez partagées avec vous.
Pour ce faire, utilisez les `accept-resource-share-invitation ` commandes **create-resource-share** et pour AWS RAM.
**Pour partager une connexion**
1. Connectez-vous avec le compte qui partagera la connexion.
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **create-resource-share** commande, en spécifiant le `--name``--resource-arns`, et `--principals` pour votre partage de connexion. Dans cet exemple, le nom `my-shared-resource` et le nom de connexion spécifié figurent `MyConnection` dans l'ARN de la ressource. Dans`principals`, indiquez le ou les comptes de destination avec lesquels vous partagez.
```
aws ram create-resource-share --name my-shared-resource --resource-arns connection_ARN --principals destination_account
```
En cas de succès, cette commande renvoie les informations ARN de connexion semblables à ce qui suit.
```
{
"resourceShare": {
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/4476c27d-8feb-4b21-afe9-7de23EXAMPLE",
"name": "MyNewResourceShare",
"owningAccountId": "111111111111",
"allowExternalPrincipals": true,
"status": "ACTIVE",
"creationTime": 1634586271.302,
"lastUpdatedTime": 1634586271.302
}
}
```
1. Les demandes de partage peuvent être acceptées comme indiqué dans la procédure suivante.
**Pour authentifier et accepter le partage de connexion avec le compte de destination**
La procédure suivante est facultative pour les comptes de destination appartenant à la même organisation et pour lesquels le partage des ressources est activé dans Organizations.
1. Connectez-vous avec le compte de destination qui recevra l'invitation.
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **get-resource-share-invitations** commande.
```
aws ram get-resource-share-invitations
```
Capturez l'ARN de l'invitation au partage de ressources pour l'étape suivante.
1. Exécutez la **accept-resource-share-invitation** commande en spécifiant le`--resource-share-invitation-arn`.
```
aws ram accept-resource-share-invitation --resource-share-invitation-arn invitation_ARN
```
En cas de succès, cette commande renvoie le résultat suivant.
```
{
"resourceShareInvitation": {
"resourceShareInvitationArn": "arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE",
"resourceShareName": "MyResourceShare",
"resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
"senderAccountId": "111111111111",
"receiverAccountId": "222222222222",
"invitationTimestamp": "2021-09-22T15:07:35.620000-07:00",
"status": "ACCEPTED"
}
}
```
## Afficher les connexions partagées (console)
Vous pouvez utiliser la console pour afficher les ressources de connexion partagées.
1. Connectez-vous au AWS Management Console.
Ouvrez la page **[Shared by me : Shared resources](https://console.aws.amazon.com/ram/home#OwnedResources:)** dans la console AWS RAM.
1. Étant donné que les partages de ressources RAM AWS existent dans des régions AWS spécifiques, choisissez la région AWS appropriée dans la liste déroulante située dans le coin supérieur droit de la console. Pour voir les partages de ressources contenant des ressources globales, vous devez définir la région AWS sur USA Est (Virginie du Nord),
Pour plus d'informations sur le partage de ressources mondiales, voir [Partage de ressources régionales par rapport aux ressources mondiales](https://docs.aws.amazon.com/ram/latest/userguide/working-with-regional-vs-global.html).
1. Pour chaque ressource partagée, les informations suivantes sont disponibles :
+ **ID de ressource** : ID de la ressource. Choisissez l'ID d'une ressource pour ouvrir un nouvel onglet de navigateur afin d'afficher la ressource dans sa console de service native.
+ **Type de ressource** : type de ressource.
+ Date du **dernier partage : date** à laquelle la ressource a été partagée pour la dernière fois.
+ **Partage de ressources** : nombre de partages de ressources qui incluent la ressource. Pour voir la liste des partages de ressources, choisissez le numéro.
+ **Principaux** : nombre de directeurs autorisés à accéder à la ressource. Choisissez la valeur pour afficher les principes.
## Afficher les connexions partagées (CLI)
Vous pouvez utiliser le AWS CLI pour afficher les connexions que vous possédez ou que vous avez partagées avec vous.
Pour ce faire, utilisez la commande **get-resource-shares**.
**Pour afficher les connexions partagées**
+ Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **get-resource-shares** commande.
```
aws ram get-resource-shares
```
La sortie renvoie une liste des partages de ressources pour votre compte.