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 liens de référentiel
Un lien de référentiel crée une association entre votre connexion et un référentiel Git externe. Le lien vers le dépôt permet à Git sync de surveiller et de synchroniser les modifications apportées aux fichiers d'un dépôt Git spécifié avec une CloudFormation pile.
Pour plus d'informations sur les liens vers les référentiels, consultez la [référence de l'AWS CodeConnections API](https://docs.aws.amazon.com/codestar-connections/latest/APIReference/Welcome.html).
**Topics**
+ [Création d'un lien de référentiel](repositorylinks-create.md)
+ [Mise à jour d'un lien de référentiel](repositorylinks-update.md)
+ [Liste des liens de référentiel](repositorylinks-list.md)
+ [Suppression d'un lien de référentiel](repositorylinks-delete.md)
+ [Affichage des détails d'un lien de référentiel](repositorylinks-view-details.md)
# Création d'un lien de référentiel
Vous pouvez utiliser la **create-repository-link** commande dans le AWS Command Line Interface (AWS CLI) pour créer un lien entre votre connexion et le référentiel externe avec lequel vous souhaitez effectuer la synchronisation.
Avant de pouvoir créer un lien vers un référentiel, vous devez déjà avoir créé votre référentiel externe auprès de votre fournisseur tiers, par exemple GitHub.
**Pour créer un lien de référentiel**
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **create-repository-link** commande. Spécifiez l'ARN de la connexion associée, l'ID du propriétaire et le nom du référentiel.
```
aws codeconnections create-repository-link --connection-arn arn:aws:codeconnections:us-east-1:account_id:connection/001f5be2-a661-46a4-b96b-4d277cac8b6e --owner-id account_id --repository-name MyRepo
```
1. Cette commande renvoie la sortie suivante.
```
{
"RepositoryLinkInfo": {
"ConnectionArn": "arn:aws:codeconnections:us-east-1:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
"OwnerId": "account_id",
"ProviderType": "GitHub",
"RepositoryLinkArn": "arn:aws:codeconnections:us-east-1:account_id:repository-link/be8f2017-b016-4a77-87b4-608054f70e77",
"RepositoryLinkId": "be8f2017-b016-4a77-87b4-608054f70e77",
"RepositoryName": "MyRepo",
"Tags": []
}
}
```
# Mise à jour d'un lien de référentiel
Vous pouvez utiliser la **update-repository-link** commande dans le AWS Command Line Interface (AWS CLI) pour mettre à jour un lien de dépôt spécifié.
Vous pouvez mettre à jour les informations suivantes pour votre lien de référentiel :
+ `--connection-arn`
+ `--owner-id`
+ `--repository-name`
Vous pouvez mettre à jour un lien de référentiel lorsque vous souhaitez modifier la connexion associée à votre référentiel. Pour utiliser une autre connexion, vous devez spécifier l'ARN de la connexion. Pour connaître les étapes permettant d'afficher l'ARN de votre connexion, consultez [Affichage des informations de connexion](connections-view-details.md).
**Pour mettre à jour un lien de référentiel**
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **update-repository-link** commande, en spécifiant la valeur à mettre à jour pour le lien du référentiel. Par exemple, la commande suivante met à jour la connexion associée à l'ID du lien de référentiel. Elle spécifie le nouvel ARN de connexion avec le paramètre `--connection`.
```
aws codestar-connections update-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173 --connection-arn arn:aws:codestar-connections:us-east-1:account_id:connection/aEXAMPLE-f055-4843-adef-4ceaefcb2167
```
1. Cette commande renvoie la sortie suivante.
```
{
"RepositoryLinkInfo": {
"ConnectionArn": "arn:aws:codestar-connections:us-east-1:account_id:connection/aEXAMPLE-f055-4843-adef-4ceaefcb2167",
"OwnerId": "owner_id",
"ProviderType": "GitHub",
"RepositoryLinkArn": "arn:aws:codestar-connections:us-east-1:account_id:repository-link/6053346f-8a33-4edb-9397-10394b695173",
"RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"RepositoryName": "MyRepo",
"Tags": []
}
}
```
# Liste des liens de référentiel
Vous pouvez utiliser la **list-repository-links** commande dans le AWS Command Line Interface (AWS CLI) pour répertorier les liens vers les référentiels de votre compte.
**Pour répertorier des liens de référentiel**
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **list-repository-links ** commande.
```
aws codeconnections list-repository-links
```
1. Cette commande renvoie la sortie suivante.
```
{
"RepositoryLinks": [
{
"ConnectionArn": "arn:aws:codestar-connections:us-east-1:account_id:connection/001f5be2-a661-46a4-b96b-4d277cac8b6e",
"OwnerId": "owner_id",
"ProviderType": "GitHub",
"RepositoryLinkArn": "arn:aws:codestar-connections:us-east-1:account_id:repository-link/6053346f-8a33-4edb-9397-10394b695173",
"RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"RepositoryName": "MyRepo",
"Tags": []
}
]
}
```
# Suppression d'un lien de référentiel
Vous pouvez utiliser la **delete-repository-link** commande dans le AWS Command Line Interface (AWS CLI) pour supprimer un lien vers un dépôt.
Avant de pouvoir supprimer un lien de référentiel, vous devez supprimer toutes les configurations de synchronisation associées à ce lien de référentiel.
**Important**
Une fois que vous avez exécuté la commande, le lien de référentiel est supprimé. Aucune boîte de dialogue de confirmation ne s'affiche. Vous pouvez créer un nouveau lien de référentiel, mais l'Amazon Resource Name (ARN) n'est pas réutilisé.
**Pour supprimer un lien de référentiel**
+ Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **delete-repository-link** commande, en spécifiant l'ID du lien du référentiel à supprimer.
```
aws codeconnections delete-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173
```
Cette commande ne donne aucun résultat.
# Affichage des détails d'un lien de référentiel
Vous pouvez utiliser la **get-repository-link** commande dans le AWS Command Line Interface (AWS CLI) pour afficher les détails d'un lien vers un dépôt.
**Pour afficher les détails d'un lien de référentiel**
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **get-repository-link** commande, en spécifiant l'ID du lien du référentiel.
```
aws codestar-connections get-repository-link --repository-link-id 6053346f-8a33-4edb-9397-10394b695173
```
1. Cette commande renvoie la sortie suivante.
```
{
"RepositoryLinkInfo": {
"ConnectionArn": "arn:aws:codestar-connections:us-east-1:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f",
"OwnerId": "owner_id",
"ProviderType": "GitHub",
"RepositoryLinkArn": "arn:aws:codestar-connections:us-east-1:account_id:repository-link/be8f2017-b016-4a77-87b4-608054f70e77",
"RepositoryLinkId": "6053346f-8a33-4edb-9397-10394b695173",
"RepositoryName": "MyRepo",
"Tags": []
}
}
```