

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.

# Modifier les paramètres AWS CodeCommit du référentiel
<a name="how-to-change-repository"></a>

Vous pouvez utiliser la AWS CodeCommit console AWS CLI et pour modifier les paramètres d'un CodeCommit référentiel, tels que sa description ou son nom.

**Important**  
La modification du nom d'un référentiel peut rompre tout référentiel local qui utilise l'ancien nom dans son URL distante. Exécutez la commande **git remote set-url** pour mettre à jour l'URL distante afin d'utiliser le nouveau nom du référentiel.

**Topics**
+ [Modifier les paramètres du référentiel (console)](#how-to-change-repository-console)
+ [Modifier les paramètres du AWS CodeCommit référentiel (AWS CLI)](#how-to-change-repository-cli)

## Modifier les paramètres du référentiel (console)
<a name="how-to-change-repository-console"></a>

Pour utiliser la AWS CodeCommit console afin de modifier les paramètres d'un CodeCommit dépôt dans AWS CodeCommit, procédez comme suit.

1. Ouvrez la CodeCommit console sur [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Dans **Référentiels**, sélectionnez le nom du référentiel dans lequel vous souhaitez modifier les paramètres. 

1. Dans le panneau de navigation, sélectionnez **Settings** (Paramètres). 

1. Pour modifier le nom du référentiel dans **Nom du référentiel**, saisissez un nouveau nom dans la zone de texte **Nom**, puis choisissez **Enregistrer**. Vérifiez vos choix lorsque vous y êtes invité. 
**Important**  
La modification du nom du AWS CodeCommit référentiel modifiera les protocoles SSH et HTTPS URLs dont les utilisateurs ont besoin pour se connecter au référentiel. Les utilisateurs ne pourront pas se connecter à ce référentiel tant qu’ils n’auront pas mis à jour leurs paramètres de connexion. En outre, comme l’ARN du référentiel changera, la modification du nom du référentiel invalidera les stratégies utilisateur IAM basées sur l’ARN de ce référentiel.  
Pour se connecter au référentiel après que le nom a été modifié, chaque utilisateur doit utiliser la commande **git remote set-url** et spécifier la nouvelle URL à utiliser. Par exemple, si vous remplacez le nom du dépôt par « » MyRenamedDemoRepo, MyDemoRepo les utilisateurs utilisant le protocole HTTPS pour se connecter au dépôt exécuteront la commande Git suivante :  

   ```
   git remote set-url origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo
   ```
Les utilisateurs qui utilisent SSH pour se connecter au référentiel doivent exécuter la commande Git suivante :  

   ```
   git remote set-url origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo
   ```
Pour plus d'options, consultez votre documentation Git.

1. Pour modifier la description du référentiel, changez le texte de la zone de texte **Description**, puis sélectionnez **Enregistrer les modifications**.
**Note**  
Le champ de description affiche Markdown dans la console et accepte tous les caractères HTML et les caractères Unicode valides. Si vous êtes un développeur d'applications qui utilise le `GetRepository` ou `BatchGetRepositories` APIs et que vous envisagez d'afficher le champ de description du référentiel dans un navigateur Web, consultez la [référence des CodeCommit API](https://docs.aws.amazon.com/codecommit/latest/APIReference/).

1. Pour modifier la branche par défaut, dans **Branche par défaut**, choisissez une autre branche dans la liste déroulante des branches. Choisissez **Enregistrer**.

1. Pour modifier la clé de AWS KMS chiffrement utilisée pour chiffrer et déchiffrer les données du référentiel, dans Clé de **chiffrement du référentiel, choisissez soit la clé** gérée par le client, **Clé gérée par AWS**soit la **clé gérée par le client** pour spécifier le type de clé à utiliser. Si vous choisissez une clé gérée par le client, entrez l'ARN de la clé. Choisissez **Enregistrer**.

1. Pour supprimer le référentiel, choisissez **Supprimer le référentiel**. Dans la zone en regard de **Tapez le nom du référentiel pour confirmer la suppression**, saisissez **delete**, puis choisissez **Supprimer**.
**Important**  
Une fois ce dépôt supprimé AWS CodeCommit, vous ne pourrez plus le cloner dans un dépôt local ou un dépôt partagé. Vous ne pourrez plus non plus en extraire des données, ni y transférer des données, à partir d'un dépôt local ou d'un dépôt partagé. Cette action ne peut pas être annulée.

## Modifier les paramètres du AWS CodeCommit référentiel (AWS CLI)
<a name="how-to-change-repository-cli"></a>

Pour utiliser AWS CLI des commandes avec CodeCommit, installez le AWS CLI. Pour de plus amples informations, veuillez consulter [Référence des commandes en ligne](cmd-ref.md). 

 AWS CLI Pour modifier les paramètres d'un CodeCommit dépôt dans AWS CodeCommit, exécutez une ou plusieurs des commandes suivantes :
+ [update-repository-description](#how-to-change-repository-cli-description)pour modifier la description d'un CodeCommit dépôt.
+ [update-repository-name](#how-to-change-repository-cli-name)pour modifier le nom d'un CodeCommit dépôt.

### Pour modifier la description d'un CodeCommit dépôt
<a name="how-to-change-repository-cli-description"></a>

1. Exécutez la commande **update-repository-description** en indiquant :
   +  Le nom du CodeCommit dépôt (avec l'`--repository-name`option).
**Astuce**  
Pour obtenir le nom du CodeCommit dépôt, exécutez la **[list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli)** commande.
   + La description du nouveau référentiel (avec l'option `--repository-description`).
**Note**  
Le champ de description affiche Markdown dans la console et accepte tous les caractères HTML et les caractères Unicode valides. Si vous êtes un développeur d'applications qui utilise le `GetRepository` ou `BatchGetRepositories` APIs et que vous envisagez d'afficher le champ de description du référentiel dans un navigateur Web, consultez la [référence des CodeCommit API](https://docs.aws.amazon.com/codecommit/latest/APIReference/).

   Par exemple, pour modifier la description du CodeCommit référentiel nommé comme `MyDemoRepo` suit `This description was changed` :

   ```
   aws codecommit update-repository-description --repository-name MyDemoRepo --repository-description "This description was changed"
   ```

   Cette commande génère une sortie uniquement en cas d’erreurs.

1. Pour vérifier la description modifiée, exécutez la **get-repository** commande en spécifiant le nom du CodeCommit référentiel dont vous avez modifié la description à l'aide de l'`--repository-name`option.

   La sortie de la commande affiche le texte modifié dans `repositoryDescription`.

### Pour modifier le nom d'un CodeCommit dépôt
<a name="how-to-change-repository-cli-name"></a>

1. Exécutez la commande **update-repository-name** en indiquant :
   + Le nom actuel du CodeCommit dépôt (avec l'`--old-name`option).
**Astuce**  
Pour obtenir le nom du CodeCommit dépôt, exécutez la commande [list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli).
   + Le nouveau nom du CodeCommit dépôt (avec l'`--new-name`option). 

   Par exemple, pour modifier le référentiel nommé `MyDemoRepo` en `MyRenamedDemoRepo` :

   ```
   aws codecommit update-repository-name --old-name MyDemoRepo --new-name MyRenamedDemoRepo
   ```

   Cette commande génère une sortie uniquement en cas d’erreurs.
**Important**  
La modification du nom du AWS CodeCommit référentiel modifie les protocoles SSH et HTTPS URLs dont les utilisateurs ont besoin pour se connecter au référentiel. Les utilisateurs ne peuvent pas se connecter à ce référentiel tant qu'ils n'ont pas mis pas à jour leurs paramètres de connexion. De plus, étant donné que l'ARN du référentiel change, la modification du nom du référentiel invalide toutes les politiques utilisateur IAM qui s'appuient sur l'ARN de ce référentiel.

1. Pour vérifier le nom modifié, exécutez la commande **list-repositories** et consultez la liste des noms de référentiel.