

Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 使用個人存取權杖授予使用者儲存庫存取權
<a name="ipa-tokens-keys"></a>

若要在具有 Git 用戶端或整合式開發環境 (IDE) 的本機電腦上存取一些 CodeCatalyst 資源，例如來源儲存庫，您必須輸入應用程式特定的密碼。您可以建立個人存取字符 (PAT) 以用於此目的。您建立PATs 與 CodeCatalyst 中所有空間和專案的使用者身分相關聯。您可以為 CodeCatalyst 身分建立多個 PAT。

您可以檢視已建立的 PATs 名稱和過期日期，也可以刪除不再需要的 PAT。您只能在建立 PAT 秘密時複製秘密。

**注意**  
根據預設，PATs會在 1 年後過期。

## 建立 PATs
<a name="ipa-tokens-keys-create"></a>

PATs與 CodeCatalyst 中的使用者身分相關聯。您只能在建立 PAT 秘密時複製秘密。

### 建立 PATs（主控台）
<a name="ipa-tokens-keys-create-console"></a>

您可以使用 主控台在 CodeCatalyst 中建立 PATs。

**建立個人存取字符 （主控台）**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的名稱，以尋找您的使用者設定檔。

1. 在**個人存取字符**下，選擇**建立**。

   隨即顯示**建立 PAT** 頁面。

1. 在 **PAT 名稱**中，輸入 PAT 的描述性名稱。

1. 在**過期日期**中，保留預設日期或選擇行事曆圖示以選取自訂日期。過期日期預設為自目前日期起算 1 年。

1. 選擇**建立**。
**提示**  
您也可以在為來源**儲存庫選擇複製**儲存庫時建立此字符。

1. 若要複製 PAT 秘密，請選擇**複製**。將 PAT 秘密存放在您可以擷取的地方。
**重要**  
PAT 秘密只會顯示一次。關閉視窗後就無法擷取它。如果您未將 PAT 秘密儲存在安全的位置，您可以建立另一個秘密。

.

### 建立 PATs(CLI)
<a name="ipa-tokens-keys-create-cli"></a>

您可以使用 CLI 在 CodeCatalyst 中建立 PATs。

**建立個人存取字符 (AWS CLI)**

1. 在終端機或命令列，執行 **create-access-token**命令，如下所示。

   ```
   aws codecatalyst create-access-token
   ```

   如果成功，命令會傳回所建立 PAT 的相關資訊，如下列範例所示。

   ```
   {
       "secret": "{{value}}",
       "name": "{{marymajor-22222EXAMPLE}}",
       "expiresTime": "2024-02-04T01:56:04.402000+00:00"
   }
   ```

1. 

建立 PAT 時，您只能檢視一次 PAT 秘密。如果您忘記 PAT 秘密，或擔心未安全地存放，您可以建立另一個秘密。

您可以使用 檢視與您的使用者帳戶相關聯的 PATs AWS CLI。您只能檢視 PAT 的相關資訊，不能檢視 PAT 秘密本身的值。

**注意**  
請確定您使用最新版本的 AWS CLI 來使用 CodeCatalyst。舊版可能不包含 CodeCatalyst 命令。您必須先設定 AWS CLI 設定檔，才能將其與 CodeCatalyst 搭配使用。如需詳細資訊，請參閱[設定 以 AWS CLI 搭配 CodeCatalyst 使用](set-up-cli.md)。

## 檢視 PATs
<a name="ipa-tokens-keys-view"></a>

您可以在 CodeCatalyst 中檢視 PATs。此清單會顯示您已與使用者身分相關聯的所有 PATs。您的 PAT 與 CodeCatalyst 中所有空間和專案的使用者設定檔相關聯。過期PATs 不會顯示，因為它們會在過期後刪除。

### 檢視 PATs（主控台）
<a name="ipa-tokens-keys-view-console"></a>

您可以使用 主控台來檢視與 CodeCatalyst 中的使用者身分相關聯的 PATs。

**檢視您的個人存取權杖 （主控台）**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的名稱，以尋找您的使用者設定檔。

1. 在**個人存取字符**下，檢視目前 PATs的名稱和過期日期。

### 檢視 PATs(CLI)
<a name="ipa-tokens-keys-view-cli"></a>

您可以使用 CLI 在 CodeCatalyst 中檢視與您使用者身分相關聯的 PATs。<a name="ipa-view-pat-cli"></a>

**檢視您的個人存取權杖 (AWS CLI)**
+ 在終端機或命令列，執行 **list-access-tokens**命令，如下所示。

  ```
  aws codecatalyst list-access-tokens
  ```

  如果成功，命令會傳回與您的使用者帳戶相關聯之 PATs的相關資訊，如下列範例所示。

  ```
  {
      "items": [
          {
              "id": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa}}",
              "name": "{{marymajor-22222EXAMPLE}}",
              "expiresTime": "2024-02-04T01:56:04.402000+00:00"
          },
          {
              "id": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb}}",
              "name": "{{marymajor-11111EXAMPLE}}",
              "expiresTime": "2023-03-12T01:58:40.694000+00:00"
          }
      ]
  }
  ```

## 刪除 PATs
<a name="ipa-tokens-keys-delete"></a>

您可以在 CodeCatalyst 中刪除與您的使用者身分相關聯的 PATs。

### 刪除 PATs（主控台）
<a name="ipa-tokens-keys-delete-console"></a>

您可以使用 主控台來刪除 CodeCatalyst PATs。

**刪除個人存取字符 （主控台）**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在頂端選單列中，選擇您的設定檔徽章，然後選擇**我的設定**。CodeCatalyst **我的設定**頁面隨即開啟。
**提示**  
您也可以前往專案或空間的成員頁面，並從成員清單中選擇您的名稱，以尋找您的使用者設定檔。

1. 在**個人存取字符**下，選擇您要刪除的 PAT 旁的選擇器，然後選擇**刪除**。

   在**刪除 PAT 上：<name>？** 頁面，若要確認刪除，請在文字欄位中輸入 *Delete*。選擇 **刪除**。

### 刪除 PATs(CLI)
<a name="ipa-tokens-keys-delete-cli"></a>

您可以使用 刪除與您的使用者身分相關聯的 PAT AWS CLI。若要這樣做，您必須提供 PAT 的 ID，您可以使用 **delete-access-token**命令來檢視。

**注意**  
請確定您使用最新版本的 AWS CLI 來使用 CodeCatalyst。舊版可能不包含 CodeCatalyst 命令。如需 AWS CLI 搭配 CodeCatalyst 使用 的詳細資訊，請參閱 [設定 以 AWS CLI 搭配 CodeCatalyst 使用](set-up-cli.md)。

**刪除個人存取字符 (AWS CLI)**
+ 在終端機或命令列，執行 **delete-access-token**命令，提供您要刪除之 PAT 的 ID。例如，執行下列命令來刪除 ID 為 {{123EXAMPLE}} 的 PAT。

  ```
  aws codecatalyst delete-access-token --id {{a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb}}
  ```

  如果成功，此命令不會傳回任何回應。