亚马逊 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 中手动填写角色、连接和环境字段。查看失败的工作流操作，并注意错误消息是否如下：
+ 角色不适用于与环境关联的连接。
+ 操作失败。状态：“失败”；为账户连接或环境提供的值无效。确认连接与您的空间关联，并且环境与您的项目关联。
+ 操作失败。状态：“失败”；为 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 资源堆栈的生成或部署操作。

选择失败的工作流操作块，然后选择**可视化**。选择**配置**选项卡。如果未填写**环境**、**连接名称**和**角色名称**字段，则需要手动更新工作流。使用以下步骤编辑工作流 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
  ```

  使用 AWS 资源运行 CodeCatalyst 工作流程生成**和部署操作需要环境、连接和角色**属性。有关示例，请参阅[环境](build-action-ref.md#build.environment)、[连接](build-action-ref.md#build.environment.connections)和[角色](build-action-ref.md#build.environment.connections.role)的 CodeCatalyst 构建操作参考 YAML 参数。
+ 确保您的空间中添加了一个账户，并确保该账户中添加了一个或多个适当的 IAM 角色。如果您拥有**空间管理员**角色，则可以调整或添加账户。有关更多信息，请参阅 [允许在已连接的情况下访问 AWS 资源 AWS 账户](ipa-connect-account.md)。

## 我需要一个关联的账户、角色和环境来创建项目
<a name="connections-troubleshoot-environment"></a>

**问题：**在项目创建选项中，我的项目在空间中没有添加可用的账户，或者我需要在空间中添加另一个账户以供项目使用。

**可能的修复方法：**对于您的空间，如果您具有**空间管理员**角色，则可以添加已授权 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，我收到权限错误。

**可能的修复方法：**

对于您的空间，如果您具有**空间管理员**角色，则可以添加已授权 AWS 账户 将其添加到您的项目中。您还必须拥有一个具有管理权限或可以与 AWS 管理员合作处理的 AWS 账户 。您必须首先确保使用您想要管理 AWS 管理控制台 的相同账户登录。登录后 AWS 管理控制台，您可以打开控制台并重试。

在[https://us-west-2.console.aws.amazon.com/codecatalyst/家中打开 Amazon CodeCatalyst 页面？ AWS 管理控制台 region=us-west](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/) -2\#/。

## 我想要一个不同的账户作为计费账户
<a name="connections-troubleshoot-billing"></a>

**问题：**当我设置 CodeCatalyst 登录名时，我完成了几个步骤来设置我的空间并关联已获得授权的人 AWS 账户。现在，我想授权另一个账户进行计费。

**可能的修复方法：**对于您的空间，如果您具有**空间管理员**角色，则可以授权计费账户。您还必须拥有一个拥有管理权限或可以与 AWS 管理员合作 AWS 账户 的地方。

有关更多信息，请参阅《Amazon CodeCatalyst 管理员指南》中的[管理账单](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)。

## 我的项目工作流因连接名称错误而失败
<a name="connections-troubleshoot-restriction"></a>

**问题：**创建项目然后运行项目工作流时，工作流失败并显示错误，指出连接名称无效，如下所示：

<action\_name> 失败：连接名称无效。

**可能的修复方法：**确保提供要添加到空间的账户 ID，并确保该账户未启用受项目限制的账户连接。如果该账户启用了受项目限制的账户连接，则您可能需要通过启用对新项目的访问权限来更新账户连接。有关更多信息，请参阅 [Configuring project-restricted account connections](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction)。