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

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

# 針對與空間相關聯的帳戶問題進行故障診斷
<a name="troubleshooting-connections"></a>

在 CodeCatalyst 中，您可以將 AWS 帳戶 新增至您的空間，以授予 資源許可，並用於計費目的。以下資訊可協助您疑難排解 CodeCatalyst 中關聯帳戶的常見問題。

**Topics**
+ [我的 AWS 帳戶 連線請求收到無效的字符錯誤](#troubleshooting-connection-token)
+ [我的 Amazon CodeCatalyst 專案工作流程失敗，並出現所設定帳戶、環境或 IAM 角色的錯誤](#connections-troubleshoot-workflow)
+ [我需要相關聯的帳戶、角色和環境來建立專案](#connections-troubleshoot-environment)
+ [我無法存取 中的 Amazon CodeCatalyst Spaces 頁面 AWS 管理主控台](#connections-troubleshoot-console)
+ [我想要與我的帳單帳戶不同的帳戶](#connections-troubleshoot-billing)
+ [我的專案工作流程失敗並出現連線名稱錯誤](#connections-troubleshoot-restriction)

## 我的 AWS 帳戶 連線請求收到無效的字符錯誤
<a name="troubleshooting-connection-token"></a>

**問題：**使用連線字符建立連線請求時，頁面不接受字符，並顯示錯誤，指出字符無效。

**可能的修正：**請確定您提供要新增至空間的帳戶 ID。您必須擁有 的管理許可， AWS 帳戶 或能夠與您的管理員合作來新增帳戶。

當您選擇驗證帳戶時，新的瀏覽器視窗會在 中開啟 AWS 管理主控台。必須在主控台端登入相同的帳戶。驗證下列項目後再試一次：
+ 您會使用 AWS 帳戶 您要新增至空間 AWS 管理主控台 的相同 來登入 。
+ 您會登入 ， AWS 管理主控台 並將區域設定為適合您空間的正確區域。
+ 如果您已從帳單頁面抵達，且想要將 新增 AWS 帳戶 為空間的指定帳單帳戶，請確定帳戶尚未達到配額，做為其他空間的帳單帳戶。

## 我的 Amazon CodeCatalyst 專案工作流程失敗，並出現所設定帳戶、環境或 IAM 角色的錯誤
<a name="connections-troubleshoot-workflow"></a>

**問題：**當工作流程執行且找不到與空間相關聯的已設定帳戶或 IAM 角色時，您必須在工作流程 YAML 中手動填入角色、連線和環境欄位。檢視失敗的工作流程動作，並注意錯誤訊息是否如下所示：
+ 此角色無法與與環境相關聯的連線搭配使用。
+ 動作未成功。狀態：失敗；帳戶連線或環境提供的值無效。確認連線與您的空間相關聯，且環境與您的專案相關聯。
+ 動作未成功。狀態：FAILED；IAM 角色提供的值無效。確認名稱存在、IAM 角色已新增至您的帳戶連線，且連線已與您的 Amazon CodeCatalyst 空間建立關聯

**可能的修正：**確定工作流程 YAML 欄位具有[準確的環境](build-action-ref.md#build.environment)、[連線](build-action-ref.md#build.environment.connections)和[角色](build-action-ref.md#build.environment.connections.role)值。需要環境的 CodeCatalyst 工作流程動作是建置或部署執行 AWS 資源或產生 AWS 資源堆疊的動作。

選擇失敗的工作流程動作區塊，然後選擇**視覺化**。選擇 **Configuration** (組態) 索引標籤。如果未填入**環境**、**連線名稱**和**角色名稱**欄位，則您需要手動更新工作流程。使用下列步驟來編輯工作流程 YAML：
+ 展開`/.codecatalyst`目錄，然後展開`/workflows`目錄。開啟工作流程 YAML 檔案。請確定已在您已為工作流程設定的 YAML 中指定 IAM 角色和帳戶資訊。範例：

  ```
  Actions:
    cdk_bootstrap:
      Identifier: action-@v1
      Inputs:
        Sources:
          - WorkflowSource
      Environment:
        Name: Staging
        Connections:
          - Name: account-connection
            Role: build-role
  ```

  執行 CodeCatalyst 工作流程建置和部署具有 AWS 資源的動作時，需要**環境、連線和角色**屬性。如需範例，請參閱 CodeCatalyst 建置動作參考[環境](build-action-ref.md#build.environment)、[連線](build-action-ref.md#build.environment.connections)和[角色](build-action-ref.md#build.environment.connections.role)的 YAML 參數。
+ 請確定您的空間已新增帳戶，並確保帳戶已將適當的 IAM 角色新增至帳戶。如果您有**空間管理員**角色，您可以調整或新增帳戶。如需詳細資訊，請參閱[允許存取已連線 AWS 的資源 AWS 帳戶](ipa-connect-account.md)。

## 我需要相關聯的帳戶、角色和環境來建立專案
<a name="connections-troubleshoot-environment"></a>

**問題：**在專案建立選項中，我的專案在我的空間中沒有可用的新增帳戶，或者我需要在我的空間中新增另一個帳戶，才能使用我的專案。

**可能的修正：**對於您的空間，如果您有 **Space 管理員**角色，您可以新增授權 AWS 帳戶 以將其新增至您的專案。您還必須擁有具有管理許可的 AWS 帳戶 ，或者可以與您的 AWS 管理員搭配使用。

若要確保帳戶和角色可在專案建立畫面中使用，您必須先新增帳戶和角色。如需詳細資訊，請參閱[允許存取已連線 AWS 的資源 AWS 帳戶](ipa-connect-account.md)。

您可以選擇使用稱為角色政策的角色政策來建立服務**CodeCatalystWorkflowDevelopmentRole-{{spaceName}}**角色。角色會有附加`CodeCatalystWorkflowDevelopmentRole-{{spaceName}}`唯一識別符的名稱。如需角色和角色政策的詳細資訊，請參閱 [了解 **CodeCatalystWorkflowDevelopmentRole-{{spaceName}}** 服務角色](ipa-iam-roles.md#ipa-iam-roles-service-role)。如需建立角色的步驟，請參閱 [為您的帳戶和空間建立 **CodeCatalystWorkflowDevelopmentRole-{{spaceName}}**角色](ipa-iam-roles.md#ipa-iam-roles-service-create)。角色會新增至您的帳戶，並可在 CodeCatalyst 的專案建立頁面中使用。

## 我無法存取 中的 Amazon CodeCatalyst Spaces 頁面 AWS 管理主控台
<a name="connections-troubleshoot-console"></a>

**問題：**當我嘗試存取 中的 Amazon CodeCatalyst AWS 管理主控台 頁面，將帳戶新增至我的 CodeCatalyst 空間或將角色新增至其中的帳戶時 AWS，我會收到許可錯誤。

**可能的修正：**

對於您的空間，如果您有 **Space 管理員**角色，則可以新增授權 AWS 帳戶 以將其新增至您的專案。您還必須擁有 AWS 帳戶 具有管理許可的 ，或者可以與您的 AWS 管理員搭配使用。您必須先確定已 AWS 管理主控台 使用您要管理的相同帳戶登入 。登入 後 AWS 管理主控台，您可以開啟 主控台，然後再試一次。

在 中開啟 Amazon CodeCatalyst 頁面， AWS 管理主控台 網址為 [https：//https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2\#/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/)。

## 我想要與我的帳單帳戶不同的帳戶
<a name="connections-troubleshoot-billing"></a>

**問題：**當我設定 CodeCatalyst 登入時，我完成了幾個步驟來設定我的空間並關聯已授權的 AWS 帳戶。現在，我想要授權不同的 帳戶來計費。

**可能的修正：**對於您的空間，如果您有 **Space 管理員**角色，您可以授權帳單帳戶。您還必須擁有 AWS 帳戶 具有管理許可的 ，或者可以與您的 AWS 管理員搭配使用。

如需詳細資訊，請參閱《Amazon CodeCatalyst 管理員指南》中的[管理帳單](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)。

## 我的專案工作流程失敗並出現連線名稱錯誤
<a name="connections-troubleshoot-restriction"></a>

**問題：**建立專案然後執行專案工作流程時，工作流程會失敗，並顯示錯誤，指出連線名稱無效，如下所示：

在 <action\_name> 失敗：連線名稱無效。

**可能的修正：**請確定您提供要新增至空間的帳戶 ID，並確認帳戶未針對專案限制的帳戶連線啟用。如果帳戶已啟用專案限制帳戶連線，則您可能需要啟用新專案的存取權來更新帳戶連線。如需詳細資訊，請參閱[設定專案限制帳戶連線](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction)。