本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 更改 AWS CodeCommit 存储库设置
<a name="how-to-change-repository"></a>

您可以使用 AWS CLI 和 AWS CodeCommit 控制台来更改 CodeCommit 存储库的设置，例如其描述或名称。

**重要**  
更改存储库的名称可能导致在其远程 URL 中使用旧名称的所有本地存储库连接中断。运行 **git remote set-url** 命令可以更新远程 URL，使其使用新的存储库名称。

**Topics**
+ [更改存储库设置（控制台）](#how-to-change-repository-console)
+ [更改 AWS CodeCommit 存储库设置 (AWS CLI)](#how-to-change-repository-cli)

## 更改存储库设置（控制台）
<a name="how-to-change-repository-console"></a>

要使用 AWS CodeCommit 控制台在中更改 CodeCommit 存储库的设置 AWS CodeCommit，请按照以下步骤操作。

1. 在 [https://console.aws.amazon.com/codesuite/codemmit](https://console.aws.amazon.com/codesuite/codecommit/home) /home 打开 CodeCommit 控制台。

1. 在**存储库**中，选择要更改设置的存储库的名称。

1. 在导航窗格中，选择**设置**。

1. 要更改存储库的名称，请在**存储库名称**中的**名称**文本框中输入新名称，然后选择**保存**。在出现提示时，确认您的选择。
**重要**  
更改 AWS CodeCommit 存储库的名称将更改用户连接到存储库所需 URLs 的 SSH 和 HTTPS。在更新连接设置之前，用户无法连接到此存储库。此外，由于存储库的 ARN 会发生更改，更改存储库名称会使依赖该存储库 ARN 的所有 IAM 用户策略失效。  
更改名称后，所有用户都必须使用 **git remote set-url** 命令并指定要使用的新 URL，然后才能连接到存储库。例如，如果您将仓库名称从 MyDemoRepo 更改为 MyRenamedDemoRepo，则使用 HTTPS 连接仓库的用户将运行以下 Git 命令：  

   ```
   git remote set-url origin https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo
   ```
使用 SSH 连接该存储库的用户需要运行下面的 Git 命令：  

   ```
   git remote set-url origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyRenamedDemoRepo
   ```
有关更多选项，请参阅 Git 文档。

1. 要更改存储库的说明，请修改 **Description** 文本框中的文本，然后选择 **Save **。
**注意**  
“描述”字段在控制台中显示“Markdown”，并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用`GetRepository`或的应用程序开发人员，`BatchGetRepositories` APIs 并且计划在 Web 浏览器中显示存储库描述字段，请参阅 [CodeCommit API 参考](https://docs.aws.amazon.com/codecommit/latest/APIReference/)。

1. 要更改默认分支，请在**默认分支**中选择分支下拉列表，然后选择其他分支。选择**保存**。

1. 要更改用于 AWS KMS 加密和解密存储库中数据的加密密钥，请在存储**库加密密钥**中，选择其中一个**AWS 托管式密钥**或**客户托管密钥**以指定要使用的密钥类型。如果选择客户管理的密钥，请输入密钥的 ARN。选择**保存**。

1. 要删除存储库，请选择 **Delete repository**。在 **Type the name of the repository to confirm deletion (键入存储库名称以确认删除)** 旁边的框中，输入 **delete**，然后选择 **Delete (删除)**。
**重要**  
在中删除此存储库后 AWS CodeCommit，您将无法再将其克隆到任何本地存储库或共享存储库。也无法再从任何本地存储库或共享存储库向其推送数据或从其提取数据。并且无法撤消。

## 更改 AWS CodeCommit 存储库设置 (AWS CLI)
<a name="how-to-change-repository-cli"></a>

要将 AWS CLI 命令与一起使用 CodeCommit，请安装 AWS CLI。有关更多信息，请参阅 [命令行参考](cmd-ref.md)。

 AWS CLI 要使用在中更改 CodeCommit 存储库的设置 AWS CodeCommit，请运行以下一个或多个命令：
+ [update-repository-description](#how-to-change-repository-cli-description)更改 CodeCommit 存储库的描述。
+ [update-repository-name](#how-to-change-repository-cli-name)更改 CodeCommit 存储库的名称。

### 更改 CodeCommit 仓库的描述
<a name="how-to-change-repository-cli-description"></a>

1. 运行 **update-repository-description** 命令，并指定：
   +  CodeCommit 存储库的名称（带`--repository-name`选项）。
**提示**  
要获取 CodeCommit 存储库的名称，请运行**[list-repositories](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli)**命令。
   + 新存储库说明 (使用 `--repository-description` 选项)。
**注意**  
“描述”字段在控制台中显示“Markdown”，并接受所有 HTML 字符和有效的 Unicode 字符。如果您是使用`GetRepository`或的应用程序开发人员，`BatchGetRepositories` APIs 并且计划在 Web 浏览器中显示存储库描述字段，请参阅 [CodeCommit API 参考](https://docs.aws.amazon.com/codecommit/latest/APIReference/)。

   例如，要将名为的 CodeCommit 存储库的描述更改`MyDemoRepo`为`This description was changed`：

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

   该命令只在出现错误时生成输出。

1. 要验证更改后的描述，请运行**get-repository**命令，指定使用该`--repository-name`选项更改其描述的 CodeCommit 存储库的名称。

   该命令的输出会在 `repositoryDescription` 中显示已更改的文本。

### 更改 CodeCommit 仓库的名称
<a name="how-to-change-repository-cli-name"></a>

1. 运行 **update-repository-name** 命令，并指定：
   +  CodeCommit 存储库的当前名称（带`--old-name`选项）。
**提示**  
要获取 CodeCommit 存储库的名称，请运行[列表存储库](how-to-view-repository-details.md#how-to-view-repository-details-no-name-cli)命令。
   +  CodeCommit 存储库的新名称（带`--new-name`选项）。

   例如，要将名为 `MyDemoRepo` 的存储库更改为 `MyRenamedDemoRepo`：

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

   该命令只在出现错误时生成输出。
**重要**  
更改 AWS CodeCommit 存储库的名称会更改用户连接到存储库所需 URLs 的 SSH 和 HTTPS。在更新连接设置之前，用户无法连接到此存储库。此外，由于存储库的 ARN 会发生更改，更改存储库名称会使依赖该存储库 ARN 的任何 IAM 用户策略失效。

1. 要验证更改的名称，请运行 **list-repositories** 命令并查看存储库名称列表。