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。アカウント接続または環境に指定された値が無効です。接続がスペースに関連付けられていること、および環境がプロジェクトに関連付けられていることを確認してください。
+ アクションは成功しませんでした。ステータス: 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 リソーススタックを生成するアクションを構築またはデプロイします。

失敗したワークフローアクションブロックを選択し、**[ビジュアル]** を選択します。**[設定]** タブを選択します。**[環境]**、**[接続名]**、**[ロール名]** の各フィールドが入力されていない場合は、ワークフローを手動で更新する必要があります。ワークフロー 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 ワークフローのビルドアクションとデプロイアクションを実行するために必要です。例については、「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>

**問題:** プロジェクト作成オプションには、プロジェクトに自分のスペースで使用できる追加アカウントがないか、プロジェクトで使用するために自分のスペースに別のアカウントを追加する必要があります。

**解決方法:** スペースにスペース**管理者**ロールがある場合は、プロジェクト 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>

**問題:** の AWS マネジメントコンソール Amazon CodeCatalyst ページにアクセスして CodeCatalyst スペースにアカウントを追加したり、 のアカウントにロールを追加しようとすると AWS、アクセス許可エラーが発生します。

**解決方法:**

スペース管理者ロールがある場合は、**スペース**にプロジェクト AWS アカウント への追加が許可されている を追加できます。また、管理者権限を持っているか、 AWS 管理者と連携できる AWS アカウント も必要です。まず、管理するのと同じアカウント AWS マネジメントコンソール で にサインインしていることを確認する必要があります。にサインインしたら AWS マネジメントコンソール、コンソールを開いてもう一度試すことができます。

\$1/ の で Amazon CodeCatalyst AWS マネジメントコンソール ページを開きます。 [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 アカウントの関連付けを行いました。それなのに、請求用に別のアカウントを承認する必要があります。

解決方法: お使いのスペースについては、**スペース管理者**ロールがある場合は、請求アカウントを承認できます。また、管理者権限 AWS アカウント を持っているか、 AWS 管理者と連携できる も必要です。

詳細については、「Amazon CodeCatalyst Administrator Guide」の「[請求管理](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)」を参照してください。

## 接続名エラーでプロジェクトワークフローが失敗します
<a name="connections-troubleshoot-restriction"></a>

**問題:** プロジェクトを作成してからプロジェクトワークフローを実行すると、ワークフローは失敗し、次のように接続名が無効であるというエラーが表示されます。

<action\$1name> で失敗: 接続名が無効です。

**解決方法:** スペースに追加するアカウント ID を指定し、そのアカウントがプロジェクト制限アカウント接続に対して有効になっていないことを確認します。アカウントでプロジェクト制限アカウント接続が有効になっている場合は、新しいプロジェクトへのアクセスを有効にしてアカウント接続を更新する必要がある場合があります。詳細については、[「プロジェクト制限アカウント接続の設定](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction)」を参照してください。