翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラブルシューティング

スキーマ検証エラー

異なるタイプのレコードを作成すると、記述子の検証例外が表示される場合があります。有効なスキーマについては、「サポートされているレコードタイプ」セクションを参照してください。

一般的なエラー。

レコード同期エラー

同期機能を使用してレコードを作成または更新すると、レコードは CREATE_FAILED または UPDATE_FAILED ステータスに移行し、何が起こったかstatusReasonを説明する が表示されます。

大まかに言うと、エラーはアクセス許可エラー、接続エラー、検証エラー、サーバー側のエラーに分類できます。

アクセス許可エラー

同期設定が間違っているか、有効期限切れです。

接続エラー

サーバーに到達できません。

検証エラー

サーバーは応答しましたが、コンテンツはサポートされていません。

サーバー側のエラー

自動検出エラー

「組織スコープのレジストリを作成するには、呼び出し元が AWS Organization の一部である必要があります。」

レジストリを作成するアカウントは、 AWS 組織のメンバーではありません (スタンドアロンアカウントなど）。組織に属するアカウントからレジストリを作成します。

「この組織では自動検出の前提条件が満たされていません。」

組織がまだ自動検出の前提条件を満たしていないか、伝播が完了していません。信頼されたアクセスが自動検出で有効になっており、管理アカウントまたは登録された委任管理者からレジストリを作成していることを確認し、しばらく待ってから再試行します。「組織全体の自動検出の有効化」を参照してください。

「このアカウントには組織スコープのレジストリが既に存在します。」

このアカウントはすでに組織スコープのレジストリを所有しており、アカウントは 1 つのみ持つことができます。既存のレジストリを使用するか、別のレジストリを作成する前に削除します。このアカウントでレジストリが見つからない場合は、「既存の組織スコープレジストリの検索」を参照してください。

「この組織には、アクティブな自動検出を持つ別の組織スコープのレジストリが既に存在します。」

組織内の別のアカウントは、アクティブな自動検出を持つ組織スコープのレジストリをすでに所有しており、組織は一度に 1 つのみを持つことができます。セキュリティ上の理由から、エラーメッセージは既存のレジストリを所有するアカウントに名前を付けません。これを見つけて競合を解決する方法を選択するには、「既存の組織スコープレジストリの検索」を参照してください。

既存の組織スコープレジストリの検索

が、組織スコープのレジストリがアカウント内または組織内の別の場所に既に存在することをCreateRegistry報告した場合、エラーは特定のレジストリまたはそれを所有するアカウントに名前を付けません。まず既存のレジストリを見つけ、競合を解決する方法を決定します。

組織スコープのレジストリは通常、次のいずれかのアカウントによって所有されます。

これらのアカウントにアクセスできる管理者に、失敗した呼び出しと同じリージョンのレジストリを一覧表示するように依頼し、 autoDetectionConfiguration.scope が であるレジストリを探しますORGANIZATION。

aws agent-registry-control list-registries --region us-east-1

管理アカウントから、どのアカウントが現在委任管理者であるかを確認します。

aws organizations list-delegated-administrators \
  --service-principal agent-registry.amazonaws.com

競合は同じリージョン内にのみ適用されます。 のレジストリus-east-1は、 でのレジストリの作成を妨げませんus-west-2。

既存のレジストリを見つけたら、次のいずれかのパスを選択します。

CreateRegistry 信頼されたアクセスが有効で、委任された管理者が登録されていても失敗する

管理アカウントに AWS エージェントレジストリサービスにリンクされたロール () があることを確認しますAWSServiceRoleForAgentRegistry。委任された管理者が作成しているレジストリであっても、組織スコープのレジストリを作成する前に管理アカウントに存在する必要があります。ステップ 1: 信頼されたアクセスを有効にし、サービスにリンクされたロールを作成するを参照してください。

レジストリは READYですが、レコードは表示されません

レジストリの自動検出ステータスが ACTIVE ( でget-registry) であり、メンバーアカウントにサポートされているリソースタイプ (AgentCore ランタイムまたはゲートウェイ) が含まれていることを確認します。検出が完了するまで待ちます。最初のセットアップでは、既存のリソースの初期検出に最大 20 分かかることがあります。

自動検出のステータスは、委任された管理者が再登録された後も「レジストリの委任された管理者アカウントが登録解除されました」と表示されます。

管理アカウントが組織スコープレジストリを所有する委任管理者の登録を解除すると、 AWS Agent Registry はそのレジストリで自動検出をオフにし、ステータスの理由を記録します。The registry’s delegated administrator account was deregistered.このステータスの理由は、自動検出が最初に無効になった理由を示しています。これは履歴レコードであり、後で組織の状態が変更されたときに更新されません。

委任された管理者が再度登録された場合、レジストリの自動検出は自動的に再開されず、ステータスの理由には登録解除メッセージが表示され続けます。これは、以下の各状況で予期されます。

自動検出を再開するには、影響を受けるレジストリを所有するアカウントを明示的に に設定enabledし直す必要がありますtrue。リージョンごとに 1 つの組織スコープレジストリのみが組織ACTIVE内で を autoDetection.statusに設定できるため、複数のレジストリが適格である場合は、アクティブにしたいレジストリでのみ自動検出を再度有効にします。

aws agent-registry-control update-registry \
  --registry-id <registry-id-or-arn> \
  --auto-detection-configuration '{"optionalValue":{"scope":"ORGANIZATION","enabled":true}}' \
  --region us-east-1

ライフサイクル全体については、「自動検出をオフにする」を参照してください。

「自動検出が有効になっている間は、レジストリを削除できません。最初に自動検出を無効にします。」

組織スコープのレジストリを削除する前に、自動検出を無効にする必要があります。レジストリを削除するには、次の手順を順に実行します。

詳細については、「レジストリの自動検出を無効にする」を参照してください。