

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

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

# Amazon CodeCatalyst 故障診斷
<a name="troubleshooting"></a>

以下資訊可協助您對 CodeCatalyst 中的常見問題進行疑難排解。您也可以使用 Amazon CodeCatalyst 運作狀態報告來判斷是否有服務問題可能會影響您的體驗。

**Topics**
+ [疑難排解一般存取問題](#troubleshooting-general)
+ [故障診斷支援問題](#troubleshoot-support)
+ [部分或全部 Amazon CodeCatalyst 無法使用](#service-unavailable)
+ [我無法在 CodeCatalyst 中建立專案](#troubleshoot-create-project)
+ [我無法以新使用者身分存取 myBID 空間，或因為使用者名稱被截斷而無法新增為新的 SSO 使用者](#troubleshoot-username-truncated)
+ [當新使用者建立重複的使用者時，將 SSO 使用者新增至我的聯合空間](#troubleshoot-username-duplicated-SSO)
+ [我想要在 CodeCatalyst 中提交意見回饋](#troubleshoot-create-feedback)
+ [對來源儲存庫的問題進行故障診斷](troubleshooting-source.md)
+ [對專案和藍圖進行故障診斷](projects-troubleshooting.md)
+ [針對開發環境的問題進行故障診斷](devenvironments-troubleshooting.md)
+ [對工作流程的問題進行故障診斷](troubleshooting-workflows.md)
+ [針對問題進行故障診斷](troubleshooting-issues.md)
+ [對 CodeCatalyst 中的搜尋問題進行故障診斷](troubleshooting-search.md)
+ [對延伸模組的問題進行故障診斷](troubleshooting-extensions.md)
+ [針對與空間相關聯的帳戶問題進行故障診斷](troubleshooting-connections.md)
+ [對 Amazon CodeCatalyst 與 AWS SDKs 或 之間的問題進行故障診斷 AWS CLI](troubleshooting-cli-sdk.md)

## 疑難排解一般存取問題
<a name="troubleshooting-general"></a>

### 我忘記密碼
<a name="id-forgot-password"></a>

**問題：**我忘記用於 AWS 建置器 ID 和 Amazon CodeCatalyst 的密碼。

**可能的修正：**修正此問題的最簡單方法是重設密碼。

1. 開啟 [Amazon CodeCatalyst](https://codecatalyst.aws/) 並輸入**您的電子郵件地址**。然後選擇 **Continue** (繼續)。

1. 選擇**忘記密碼？**

1. 我們會傳送一封電子郵件給您，其中包含變更密碼的連結。如果您在收件匣中看不到電子郵件，請檢查您的垃圾郵件資料夾。

### 部分或全部 Amazon CodeCatalyst 無法使用
<a name="service-unavailable"></a>

**問題：**我導覽至 CodeCatalyst 主控台或遵循 CodeCatalyst 主控台的連結，但我看到錯誤。

**可能的修正：**此問題的最常見原因是，您依照連結至未獲邀請的專案或空間，或是服務有一般可用性問題。檢查[運作狀態報告](health-dashboard.md)，以查看服務是否有任何已知問題。如果沒有，請聯絡邀請您加入專案或空間的人員，並要求另一個邀請。如果您尚未受邀加入任何專案或空間，您可以註冊並[建立自己的空間和專案](sign-up-create-resources.md)。

### 我無法在 CodeCatalyst 中建立專案
<a name="troubleshoot-create-project"></a>

**問題：**我想要建立專案，但**建立專案**按鈕顯示為無法使用，或我收到錯誤訊息。

**可能的修正：**此問題的最常見原因是您使用沒有 **Space 管理員**角色的 AWS 建置器 ID 登入 主控台。您必須具有此角色才能在空間中建立專案。

如果您確實有此角色，且按鈕未顯示為可用，則服務可能會出現暫時性問題。重新整理您的瀏覽器，然後再試一次。

## 故障診斷支援問題
<a name="troubleshoot-support"></a>

### 當我存取 支援 Amazon CodeCatalyst 時收到錯誤
<a name="troubleshoot-support-rolepolicy"></a>

**問題：**當我選擇 支援 for Amazon CodeCatalyst 選項時，會收到下列錯誤訊息：

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the AWS 帳戶 that is the billing account for the space.`

**可能的修正：**將必要角色新增至 AWS 帳戶 ，該角色是空間的帳單帳戶。指定為空間帳單帳戶的帳戶會使用 `AWSRoleForCodeCatalystSupport`角色和 `AmazonCodeCatalystSupportAccess` 受管政策。如需詳細資訊，請參閱[為您的帳戶和空間建立 **AWSRoleForCodeCatalystSupport**角色](ipa-iam-roles.md#ipa-iam-roles-support-create)。

**注意**  
 AWS Builder ID 只能獲得對其驗證的別名的支援，並且只能根據 CodeCatalyst 中的許可取得資源的支援。帳戶和帳單支援可供空間中的所有使用者使用。不過，建置器只能取得其在 CodeCatalyst 中具有 許可的資源和資訊的支援。

### 我無法為我的空間建立技術支援案例
<a name="troubleshoot-support-technical-cases"></a>

**問題：**我無法為我的空間建立技術支援案例。

**修正：**商業支援或企業支援計劃需要新增至空間帳單帳戶，空間中的使用者才能建立技術支援案例。請您的空間管理員將 支援 計劃新增至您的空間帳單帳戶，或造訪 https AWS ：//https://repost.aws/ 來詢問社群。

### 我的支援案例帳戶不再連接到 CodeCatalyst 中的空間
<a name="troubleshoot-support-disconnected-account"></a>

**問題：**我的支援案例帳戶不再連接到 CodeCatalyst 中的空間。

**修正：**如果具有 **Space 管理員**角色的使用者切換空間計費帳戶，這會中斷 支援 計劃和所有相關案例與空間的連線。 支援 Amazon CodeCatalyst 中將不再顯示與舊空間計費帳戶相關聯的 支援 案例。該帳單帳戶的根使用者可以從 檢視和解決舊案例， AWS 管理主控台 也可以設定 支援 IAM 許可，讓其他使用者檢視和解決舊案例。您將無法繼續透過 從舊空間帳單帳戶取得 CodeCatalyst 的技術支援 AWS 管理主控台，但您可以獲得其他服務的技術支援，直到您的 支援 計劃取消為止。

如需詳細資訊，請參閱*支援 《 使用者指南*》中的[更新、解決和重新開啟您的案例](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html)。

### 我無法在 for Amazon CodeCatalyst 支援 AWS 服務 中為另一個 開啟支援案例
<a name="troubleshoot-support-other-services"></a>

**問題：**我無法在 支援 for CodeCatalyst AWS 服務 中為另一個 開啟支援案例。

**可能的修正：**您只能從 支援 for CodeCatalyst 開啟 CodeCatalyst 支援案例。如果您需要從 CodeCatalyst 部署到另一個 AWS、Amazon 或其他第三方服務的服務或資源支援，您需要透過 AWS 管理主控台 或第三方服務支援管道建立案例。如需詳細資訊，請參閱*支援 《 使用者指南*》中的[建立支援案例和案例管理](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html)。

## 部分或全部 Amazon CodeCatalyst 無法使用
<a name="service-unavailable"></a>

**問題：**我導覽至 CodeCatalyst 主控台或遵循 CodeCatalyst 主控台的連結，但我看到錯誤。

**可能的修正：**此問題的最常見原因是，您依照連結至未獲邀請的專案或空間，或是服務有一般可用性問題。檢查[運作狀態報告](health-dashboard.md)，以查看服務是否有任何已知問題。如果沒有，請聯絡邀請您加入專案或空間的人員，並要求另一個邀請。如果您尚未受邀加入任何專案或空間，您可以註冊並[建立自己的空間和專案](sign-up-create-resources.md)。

## 我無法在 CodeCatalyst 中建立專案
<a name="troubleshoot-create-project"></a>

**問題：**我想要建立專案，但**建立專案**按鈕顯示為無法使用，或我收到錯誤訊息。

**可能的修正：**此問題的最常見原因是您使用沒有 **Space 管理員**角色的 AWS 建置器 ID 登入 主控台。您必須具有此角色才能在空間中建立專案。

如果您確實有此角色，且按鈕未顯示為可用，則服務可能會出現暫時性問題。重新整理您的瀏覽器，然後再試一次。

## 我無法以新使用者身分存取 myBID 空間，或因為使用者名稱被截斷而無法新增為新的 SSO 使用者
<a name="troubleshoot-username-truncated"></a>

**問題：**CodeCatalyst 會在 100 個字元後截斷使用者名稱，這可能會導致某些使用者名稱看起來相同。身為存取 CodeCatalyst 空間的新使用者，我會根據空間類型遇到此問題，如下所示：
+ 我有想要用來登入 CodeCatalyst 的 AWS 建置器 ID。當我嘗試登入空間時，會收到我的使用者名稱無效的訊息。
+ 我是支援聯合身分之 CodeCatalyst 空間的聯合身分管理員。在 IAM Identity Center 中將新使用者新增至 SSO 使用者和群組時，我會收到使用者無效的訊息。

**可能的修正：**第一個以 SSO 使用者身分登入 CodeCatalyst 或新增至空間的使用者，若具有指定的截斷使用者名稱，將會成功。任何使用 AWS 建置器 ID 註冊或在此之後新增至 IAM Identity Center 的使用者將無法登入，因為名稱看起來會重複。根據空間類型，執行下列其中一項操作：
+ 若要能夠登入 AWS 建置器 ID 空間，請使用不同的使用者名稱註冊。
+ 若要能夠在 IAM Identity Center 中新增使用者，請使用不同的使用者名稱新增使用者。

**注意**  
即使使用者名稱似乎被截斷，CodeCatalyst 會以不受具有截斷名稱的使用者名稱影響的方式映射到身分。不過，如果建立的使用者名稱與截斷的使用者名稱相同，則如果其他相關聯的使用者 （具有相同空間或 IAM Identity Center 應用程式） 已使用該截斷的使用者名稱加入 CodeCatalyst，則該使用者名稱將無法使用。

## 當新使用者建立重複的使用者時，將 SSO 使用者新增至我的聯合空間
<a name="troubleshoot-username-duplicated-SSO"></a>

**問題：**新增至 CodeCatalyst 空間，然後移除的 CodeCatalyst SSO 使用者可能會遇到使用者名稱嘗試重複使用的問題。這可能會導致類似以下的錯誤，即使重新建立，也不允許重複使用者。

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the AWS 帳戶 that is the billing account for the space.`

**可能的修正：**如果刪除現有的 IDC 使用者，然後使用相同的使用者名稱重新建立新使用者，則新使用者無法登入，因為使用者名稱與舊使用者衝突。使用者名稱以 SSO 使用者身分新增至空格後，就無法再次使用該名稱。任何使用 AWS 建置器 ID 註冊或在此之後新增至 IAM Identity Center 的使用者將無法登入，因為名稱看起來會重複。

根據空間類型，執行下列其中一項操作：
+ 若要能夠登入 AWS 建置器 ID 空間，請使用不同的使用者名稱註冊。
+ 若要能夠在 IAM Identity Center 中新增使用者，請使用不同的使用者名稱新增使用者。

## 我想要在 CodeCatalyst 中提交意見回饋
<a name="troubleshoot-create-feedback"></a>

**問題：**我在 CodeCatalyst 中發現錯誤，我想要提交意見回饋。

**可能的修正：**您可以直接在 CodeCatalyst 中提交意見回饋。

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

1. 在導覽窗格中，選擇**給予意見回饋**。

1. 從下拉式選單中選擇意見回饋類型，然後輸入您的意見回饋。