本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 變更 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：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在 **Repositories (儲存庫)** 中，選擇您要變更設定所在的儲存庫名稱。

1. 在導覽窗格中，選擇**設定**。

1. 若要變更儲存庫的名稱，在 **Repository name (儲存庫名稱)** 中，於 **Name (名稱)** 文字方塊輸入新的名稱，然後選擇 **Save (儲存)**。系統提示時，請確認您的選擇。
**重要**  
變更 AWS CodeCommit 儲存庫的名稱會變更使用者連線到儲存庫所需的 SSH 和 HTTPS URLs。使用者將無法連接到此儲存庫，直到他們更新連線設定為止。此外，因為儲存庫的 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. 若要變更預設分支，請在 **Default branch (預設分支)** 中選擇分支下拉式清單，然後選擇不同的分支。選擇**儲存**。

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>

若要搭配 CodeCommit 使用 AWS CLI 命令，請安裝 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 儲存庫的名稱，請執行 [list-repositories](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 儲存庫的名稱會變更使用者連線到儲存庫所需的 SSH 和 HTTPS URLs。使用者需要更新其連線設定，才能連接到此儲存庫。此外，由於儲存庫的 ARN 變更，變更儲存庫名稱會使依賴此儲存庫 ARN 的任何 IAM 使用者政策失效。

1. 若要驗證變更的名稱，請執行 **list-repositories** 命令並檢閱儲存庫名稱的清單。