As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Alterar as AWS CodeCommit configurações do repositório
<a name="how-to-change-repository"></a>

Você pode usar o console AWS CLI e o AWS CodeCommit console para alterar as configurações de um CodeCommit repositório, como sua descrição ou nome.

**Importante**  
A alteração do nome de um repositório pode corromper repositórios locais que usem o nome antigo no URL remoto. Execute o comando **git remote set-url** para atualizar a URL remota para usar o novo nome do repositório.

**Topics**
+ [Alteração de configurações de repositório (console)](#how-to-change-repository-console)
+ [Alterar as configurações AWS CodeCommit do repositório ()AWS CLI](#how-to-change-repository-cli)

## Alteração de configurações de repositório (console)
<a name="how-to-change-repository-console"></a>

Para usar o AWS CodeCommit console para alterar as configurações de um CodeCommit repositório AWS CodeCommit, siga estas etapas.

1. Abra o CodeCommit console em [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).

1. Em **Repositories (Repositórios)**, escolha o nome do repositório onde você deseja alterar as configurações. 

1. No painel de navegação, selecione **Configurações**. 

1. Para alterar o nome do repositório, em **Repository name (Nome do repositório)**, insira um nome novo na caixa de texto **Name (Nome)** e selecione **Save (Salvar)**. Quando solicitado, verifique sua opção. 
**Importante**  
A alteração do nome do AWS CodeCommit repositório mudará o SSH e o HTTPS URLs que os usuários precisam para se conectar ao repositório. Os usuários não poderão se conectar ao repositório até que atualizem suas configurações de conexão. Além disso, devido à alteração no ARN do repositório, alterar o nome do repositório invalidará todas as políticas de usuário do IAM que dependem do ARN desse repositório.  
Para se conectar ao repositório após o nome ter sido alterado, cada usuário deve usar o comando **git remote set-url** e especificar a nova URL a ser usada. Por exemplo, se você alterou o nome do repositório de MyDemoRepo para MyRenamedDemoRepo, os usuários que usam HTTPS para se conectar ao repositório executarão o seguinte comando Git:  

   ```
   git remote set-url origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo
   ```
Os usuários usando o SSH para se conectar ao repositório executariam o seguinte comando do Git:  

   ```
   git remote set-url origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo
   ```
Para obter mais opções, consulte a documentação do Git.

1. Para alterar a descrição do repositório, modifique o texto na caixa de texto **Description (Descrição)** e selecione **Save (Salvar)**.
**nota**  
O campo de descrição exibe o Markdown no console e aceita todos os caracteres HTML e caracteres Unicode válidos. Se você é um desenvolvedor de aplicativos que está usando o `GetRepository` ou `BatchGetRepositories` APIs e planeja exibir o campo de descrição do repositório em um navegador da Web, consulte a [Referência da CodeCommit API](https://docs.aws.amazon.com/codecommit/latest/APIReference/).

1. Para alterar a ramificação padrão, na **Default branch (Ramificação padrão)**, escolha a lista suspensa da ramificação e escolha uma ramificação diferente. Escolha **Salvar**.

1. Para alterar a chave de AWS KMS criptografia usada para criptografar e descriptografar dados no repositório, em Chave de **criptografia do repositório, escolha uma **Chave gerenciada pela AWS**ou Chave** **gerenciada pelo cliente para especificar o tipo de chave** a ser usada. Se escolher uma chave gerenciada pelo cliente, insira o ARN da chave. Escolha **Salvar**.

1. Para excluir o repositório, selecione **Delete repository**. Na caixa ao lado de **Type the name of the repository to confirm deletion (Digite o nome do repositório para confirmar a exclusão)**, insira **delete** e escolha **Delete (Excluir)**.
**Importante**  
Depois de excluir esse repositório AWS CodeCommit, você não poderá mais cloná-lo em nenhum repositório local ou repositório compartilhado. Também não será mais possível extrair dados dele nem enviar via push dados para ele de nenhum repositório local ou compartilhado. Esta ação não pode ser desfeita.

## Alterar as configurações AWS CodeCommit do repositório ()AWS CLI
<a name="how-to-change-repository-cli"></a>

Para usar AWS CLI comandos com CodeCommit, instale AWS CLI o. Para obter mais informações, consulte [Referência da linha de comando](cmd-ref.md). 

Para usar AWS CLI para alterar as configurações de um CodeCommit repositório AWS CodeCommit, execute um ou mais dos seguintes comandos:
+ [update-repository-description](#how-to-change-repository-cli-description)para alterar a descrição de um CodeCommit repositório.
+ [update-repository-name](#how-to-change-repository-cli-name)para alterar o nome de um CodeCommit repositório.

### Para alterar a descrição de um CodeCommit repositório
<a name="how-to-change-repository-cli-description"></a>

1. Execute o comando **update-repository-description**, especificando:
   +  O nome do CodeCommit repositório (com a `--repository-name` opção).
**dica**  
Para obter o nome do CodeCommit repositório, execute o **[list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli)** comando.
   + A nova descrição do repositório (com a opção `--repository-description`).
**nota**  
O campo de descrição exibe Markdown no console e aceita todos os caracteres HTML e caracteres Unicode válidos. Se você é um desenvolvedor de aplicativos que está usando o `GetRepository` ou `BatchGetRepositories` APIs e planeja exibir o campo de descrição do repositório em um navegador da Web, consulte a [Referência da CodeCommit API](https://docs.aws.amazon.com/codecommit/latest/APIReference/).

   Por exemplo, para alterar a descrição do CodeCommit repositório chamado `MyDemoRepo` para`This description was changed`:

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

   Esse comando gerará saídas somente se houver erros.

1. Para verificar a descrição alterada, execute o **get-repository** comando, especificando o nome do CodeCommit repositório cuja descrição você alterou com a `--repository-name` opção.

   A saída do comando exibe o texto alterado em `repositoryDescription`.

### Para alterar o nome de um CodeCommit repositório
<a name="how-to-change-repository-cli-name"></a>

1. Execute o comando **update-repository-name**, especificando:
   + O nome atual do CodeCommit repositório (com a `--old-name` opção).
**dica**  
Para obter o nome do CodeCommit repositório, execute o comando [list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli).
   + O novo nome do CodeCommit repositório (com a `--new-name` opção). 

   Por exemplo, para alterar o repositório chamado `MyDemoRepo` para `MyRenamedDemoRepo`:

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

   Esse comando gerará saídas somente se houver erros.
**Importante**  
A alteração do nome do AWS CodeCommit repositório altera o SSH e o HTTPS URLs que os usuários precisam para se conectar ao repositório. Os usuários não poderão se conectar a este repositório até que atualizem suas configurações de conexão. Além disso, devido às alterações no ARN do repositório, a alteração do nome do repositório invalidará todas as políticas de usuário do IAM que dependem do ARN desse repositório.

1. Para verificar o nome alterado, execute o comando **list-repositories** e revise a lista de nomes de repositório.