包括的なレジストリ移行ガイド

AWS エージェントレジストリ — 新しいagent-registry名前空間への移行

序章

2026 年 8 月 6 日の新しいagent-registry名前空間のリリースの一環として、 AWS Agent Registry はサービスプリンシパル、データ、API モデルに大きな変更を導入しています。bedrock-agentcore 名前空間で AWS エージェントレジストリを使用した場合は、次の 3 つの領域にまたがる移行を完了する必要があります。

このガイドでは、移行の計画と実行に役立つbefore-and-afterの例を使用して、各領域について詳しく説明します。

移行のタイムラインを教えてください。

この移行では、次の 2 つの重要なマイルストーンを覚えておく必要があります。

名前空間と設定の変更

agent-registry 名前空間は次の場所で置き換えbedrock-agentcoreられます。このセクションでは、変更されるすべての表面を一覧表示し、コードを更新する方法の例を示します。

サービスエンドポイント

アプリケーションは、新しいエンドポイントホスト名を指す必要があります。新しいエンドポイントは .api.awsドメインを使用します。

IAM とセキュリティ

参照するすべての IAM ポリシー、サービスコントロールポリシー (SCPsおよびアクセス許可の境界を更新bedrock-agentcoreする必要があります。リソース ARNs新しい名前空間を反映するように変更されます。

ARNs を解析または保存するオートメーションがある場合は、それらのリファレンスも更新します。IAM アクションプレフィックスまたはサービスプリンシパルの条件を持つカスタムポリシーは、新しい値と一致するように更新する必要があります。 AWS エージェントレジストリに関連付けられた IAM アクセス許可の完全なリストを確認するには、AWS 「 エージェントレジストリ IAM アクセス許可リファレンス」を参照してください。

SDK、CLI、インフラストラクチャ

アプリケーションコード、デプロイスクリプト、infrastructure-as-code テンプレートを更新して、新しいクライアントクラスと CLI 名前空間を参照します。

以前にbedrock-agentcoreサービスコードでカスタムクォータの引き上げをリクエストした場合は、 でそれらを再リクエストする必要がありますagent-registry。

オブザーバビリティとイベント

CloudTrail Lake クエリ、Athena クエリ、SIEM 統合、EventBridge ルール、CloudWatch ダッシュボード、および古い名前空間を参照するアラームを更新します。

EventBridge 通知

bedrock-agentcore 名前空間で、 AWS エージェントレジストリはイベントソースの下に 2 つの Amazon EventBridge aws.bedrock-agentcore イベントを出力します。イベントソースが に変更されaws.agent-registry、リソース ARNs が新しい名前空間を採用し、通知カバレッジがレジストリレコードとレジストリのライフサイクル全体に拡張されるようになりました。イベントは、リソース自身のアカウントのデフォルトの EventBridge バスに引き続き送信されます。古いソースまたは古い詳細タイプの文字列に一致する EventBridge ルールを更新する必要があります。

レジストリレコードイベント。レジストリレコードが承認ワークフロー状態間で移行するときに発行されます。 Resourcesは完全なレコード ARN であり、 registryRecordIdと detailが含まれますregistryId。

レジストリイベント。レジストリのプロビジョニングとライフサイクルの移行時に発行されます。 Resourcesは完全なレジストリ ARN であり、 registryIdと detailが含まれていますregistryName。

イベントの例 (レジストリレコード）。

Before (bedrock-agentcore名前空間、廃止予定):

{
  "version": "0",
  "detail-type": "Registry Record State changed to Pending Approval",
  "source": "aws.bedrock-agentcore",
  "account": "123456789012",
  "region": "us-west-2",
  "resources": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:registry/REG_ID/record/REC_ID"],
  "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" }
}

後 (agent-registry 名前空間):

{
  "version": "0",
  "detail-type": "Registry Record State changed to Pending Approval",
  "source": "aws.agent-registry",
  "account": "123456789012",
  "region": "us-west-2",
  "resources": ["arn:aws:agent-registry:us-west-2:123456789012:registry/REG_ID/record/REC_ID"],
  "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" }
}

例: IAM ポリシーの更新

すべての IAM ポリシーでアクションプレフィックスとリソース ARN 名前空間を置き換えます。

Before (bedrock-agentcore名前空間、廃止予定):

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "bedrock-agentcore:CreateRegistry",
      "bedrock-agentcore:GetRegistry",
      "bedrock-agentcore:UpdateRegistry",
      "bedrock-agentcore:ListRegistries",
      "bedrock-agentcore:DeleteRegistry",
      "bedrock-agentcore:CreateRegistryRecord",
      "bedrock-agentcore:GetRegistryRecord",
      "bedrock-agentcore:UpdateRegistryRecord",
      "bedrock-agentcore:ListRegistryRecords",
      "bedrock-agentcore:DeleteRegistryRecord",
      "bedrock-agentcore:SubmitRegistryRecordForApproval",
      "bedrock-agentcore:UpdateRegistryRecordStatus",
      "bedrock-agentcore:SearchRegistryRecords"
    ],
    "Resource": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:*"]
  }]
}

後 (agent-registry 名前空間):

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "agent-registry:CreateRegistry",
      "agent-registry:GetRegistry",
      "agent-registry:UpdateRegistry",
      "agent-registry:ListRegistries",
      "agent-registry:DeleteRegistry",
      "agent-registry:CreateRegistryRecord",
      "agent-registry:GetRegistryRecord",
      "agent-registry:UpdateRegistryRecord",
      "agent-registry:ListRegistryRecords",
      "agent-registry:DeleteRegistryRecord",
      "agent-registry:SubmitRegistryRecordForApproval",
      "agent-registry:UpdateRegistryRecordStatus",
      "agent-registry:SearchDiscoverableRegistryRecords",
      "agent-registry:ListDiscoverableRegistryRecords",
      "agent-registry:GetDiscoverableRegistryRecord"
    ],
    "Resource": ["arn:aws:agent-registry:us-west-2:123456789012:*"]
  }]
}

"bedrock-agentcore:CreateWorkloadIdentity",
"bedrock-agentcore:GetWorkloadIdentity",
"bedrock-agentcore:DeleteWorkloadIdentity"

例: SDK クライアント設定の更新

SDK 呼び出しのサービス名、クライアントクラス、エンドポイント URL を更新します。

Before (bedrock-agentcore名前空間、廃止予定):

import boto3

session = boto3.Session(region_name="us-west-2")

cp_client = session.client(
    "bedrock-agentcore-control",
    endpoint_url="https://bedrock-agentcore-control.us-west-2.amazonaws.com"
)

dp_client = session.client(
    "bedrock-agentcore",
    endpoint_url="https://bedrock-agentcore.us-west-2.amazonaws.com"
)

後 (agent-registry 名前空間):

import boto3

session = boto3.Session(region_name="us-west-2")

cp_client = session.client(
    "agent-registry-control",
    endpoint_url="https://agent-registry-control.us-west-2.api.aws"
)

dp_client = session.client(
    "agent-registry",
    endpoint_url="https://agent-registry.us-west-2.api.aws"
)

例: CLI コマンドの更新

すべてのスクリプトとオートメーションで CLI 名前空間を置き換えます。

Before (bedrock-agentcore名前空間、廃止予定):

aws bedrock-agentcore-control create-registry \
    --name "MyRegistry" \
    --description "Production registry" \
    --region us-west-2 \
    --endpoint-url https://bedrock-agentcore-control.us-west-2.amazonaws.com

後 (agent-registry 名前空間):

aws agent-registry-control create-registry \
    --name "MyRegistry" \
    --description "Production registry" \
    --region us-west-2 \
    --endpoint-url https://agent-registry-control.us-west-2.api.aws

API スキーマの変更

名前空間の移行に加えて、 agent-registry 名前空間のレジストリとレジストリレコードのデータモデルを更新しました。これらの変更により、bedrock-agentcore名前空間からのフィードバックに基づいて API の一貫性と拡張性が向上します。このセクションでは、アプリケーションコードを更新できるように、各変更カテゴリを前後の例で説明します。

変更 1: レジストリエンティティの更新

レジストリのデータプレーンへのアクセス方法を制御するレジストリリソースの認可設定が、目的を明示する専用discoveryConfigurationラッパーの下に置かれるようになりました。承認設定 (PENDING_APPROVALステータスに送信されたレコードがAPPROVEDステータスに自動的に移行するかどうかを制御する) は、ブール型から拡張可能な列挙型配列に移行します。

特定のフィールドの変更は次のとおりです。

Before (bedrock-agentcore名前空間、廃止予定):

{
  "name": "string",
  "description": "string",
  "authorizerConfiguration": { ... },
  "authorizerType": "string",
  "approvalConfiguration": {
    "autoApproval": true
  }
}

After (agent-registry 名前空間): Approval ALL

{
  "name": "string",
  "description": "string",
  "discoveryConfiguration": {
    "authorizerConfiguration": { ... },
    "authorizerType": "string"
  },
  "approvalConfiguration": {
    "autoApprovalRules": ["APPROVE_ALL"]
  }
}

After (agent-registry 名前空間): 列挙型リストに NULL を含む

{
  "name": "string",
  "description": "Registry with manual approval only",
  "approvalConfiguration": {
    "autoApprovalRules": []
  }
}

変更 2: レジストリレコードの新しい必須フィールド

レジストリレコードは、より良い分類と重複排除をサポートするために、2 つの新しい必須の最上位フィールドを取得します。CreateRegistryRecord API を使用してレジストリレコードを作成するときは両方のフィールドを指定する必要があり、後で UpdateRegistryRecord API を使用して変更できます。

変更 3: レジストリレコードの再構築

descriptors フィールドは、識別されたユニオンからフラットキー構造に変わります。

前のモデルでは、 descriptorTypeフィールド (MCP、A2A、AGENT_SKILLS、CUSTOM) が内部シェイプを決定しました。この結合された記述子コンテンツは、粗いプロトコルまたは形式分類になります。そのフィールドは存在しません。別の最上位属性recordTypeである は、セマンティック分類に置き換えます。API は、構造的にシェイプするのではなく、実行recordType時に各 に有効な記述子キーを適用します。の各最上位キーは、詳細なプライマリ記述子タイプ (、、a2aAgentCardmcpServeragentSkillsDefinition、 など) を表すdescriptorsようになりましたcustom。補足記述子 (、 などtoolsskillMd) は、プライマリ記述子の の下にネストされますadditionalData。inlineContent フィールドは になりますdata。フィールドschemaVersionと protocolVersionフィールドは に統合されますdataSchemaVersion。

最上位synchronizationConfiguration属性は になりsource、各記述子 (additionalData子を含む) 内を移動します。

既存のnameフィールドは になりdisplayName、意味がより明確になります。net-new nameフィールドは重複排除キーとして機能し、レジストリ内のすべてのレコードで一意である必要があります。同じレコードrecordVersionに対して nameと の両方を指定する場合、それらの組み合わせは一意である必要があります。

次のフィールドの名前が変更されました。

Before (bedrock-agentcore名前空間、廃止予定):

{
  "recordId": "string",
  "name": "string",
  "descriptorType": "string", // A2A, MCP, AGENT_SKILL, CUSTOM
  "descriptors": {
    "agent": {
      "a2aAgentCard": {
        "inlineContent": "string",
        "schemaVersion": "string"
      }
    },
    "agentSkills": {
      "skillDefinition": {
        "inlineContent": "string",
        "schemaVersion": "string"
      },
      "skillMd": {
        "inlineContent": "string"
      }
    },
    "mcp": {
      "server": {
        "inlineContent": "string",
        "schemaVersion": "string"
      },
      "tools": {
        "inlineContent": "string",
        "protocolVersion": "string"
      }
    },
    "custom": {
      "inlineContent": "string"
    }
  },
  "synchronizationType": "URL",
  "synchronizationConfiguration": {
    "fromUrl": {
      "url": "string",
      "credentialProviderConfigurations": [
        {
          "credentialProvider": { ... },
          "credentialProviderType": "string"
        }
      ]
    }
  },
  ...
}

後 (agent-registry 名前空間):

{
  "recordId": "string",
  "displayName": "string",
  "name": "string",
  "recordVersion": "string",
  "recordType": "AGENT" | "MCP" | "SKILL" | "CUSTOM",
  "descriptors": {
    "a2aAgentCard": {
      "data": "string",
      "dataSchemaVersion": "string",
      "source": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [...] } }
    },
    "mcpServer": {
      "data": "string",
      "dataSchemaVersion": "string",
      "source": { "fromUrl": { ... } },
      "additionalData": {
        "tools": { "data": "string", "dataSchemaVersion": "string" }
      }
    },
    "agentSkillsDefinition": {
      "data": "string",
      "dataSchemaVersion": "string",
      "additionalData": {
        "skillMd": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } } }
      }
    },
    "custom"?: {
      "data": "string"
    }
  }
  ...
}

以下の制約が適用されます。

レコードごとに 1 つのプライマリ記述子キーを正確に入力できます。あたりの有効なプライマリ記述子recordTypeは次のとおりです。

source は、単一の最上位ブロックではなく、記述子ごとです。スキーマ内のsourceフィールドを持つ記述子 - mcpServerおよび にアタッチしますa2aAgentCard。tools 子 ( の下mcpServer.additionalData)、agentSkillsDefinition親、customおよび記述子には がありませんsource。

agent-registry 名前空間では、 source.fromUrl のみがサポートされています。

自動同期は、 mcpServerおよびa2aAgentCardプライマリ記述子、つまり MCP および AGENT レコードタイプに対してのみトリガーされます。skillMd 子sourceの は保持されますが、同期の実行には使用されず、SKILL レコードは自動同期できません。CUSTOM レコードは、 dataを直接指定して手動で作成する必要があります。

変更 4: データプレーンフィルターの更新

SearchRegistryRecords は SearchDiscoverableRegistryRecords () になりますPOST /discoverable-records-search。そのリクエストとレスポンスは、新しいフィールド名とデータモデルを取得します。

MCP 検索ツールは search_registry_recordsになりsearch_discoverable_registry_records、新しい記述子形式を返し、新しいフィルター名を使用します。

変更 5: 新しいブラウジング APIs

2 つの新しいデータプレーン APIs承認されたレコードでのブラウジングとカタログエクスペリエンスの構築をサポートします。これらの APIs明示的な移行は必要ありません。ここでは、 agent-registry名前空間の AWS エージェントレジストリ API モデルへの追加として言及します。

ListDiscoverableRegistryRecords — 承認されたレジストリレコードのページ分割されたリストを返します。これを使用して、公開されたコンテンツにブラウジングインターフェイスを構築します。

// HTTP: POST /registries/{registryId}/discoverable-records-list
{
  "registryId": "string",           // path param, required (ARN or ID)
  "maxResults": 1-100,              // query param, optional
  "nextToken": "string",            // query param, optional
  "filters": [ { "name": "recordType", "values": ["MCP"] } ]
}
{
  "registryRecords": [
    {
      "registryArn": "string",
      "recordArn": "string",
      "recordId": "string",
      "name": "string",
      "displayName": "string",
      "description": "string",
      "recordType": "string",
      "recordVersion": "string",
      "status": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "nextToken": "string"
}

BatchGetDiscoverableRegistryRecord — 1 回の呼び出しで 1 つ以上のレジストリにまたがるレコードのバッチの完全な詳細を取得します。

// HTTP: POST /discoverable-records-batch
{
  "entries": [
    { "registryId": "reg-AAA", "recordIds": ["rec-111", "rec-222"] }
  ]
}
{
  "registryRecords": [
    {
      "registryArn": "string",
      "recordArn": "string",
      "recordId": "string",
      "name": "string",
      "displayName": "string",
      "description": "string",
      "recordType": "string",
      "descriptors": { ... },
      "recordVersion": "string",
      "status": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "errors": [
    {
      "registryId": "string",
      "recordId": "string",
      "errorCode": "RESOURCE_NOT_FOUND" | "ACCESS_DENIED" | "INTERNAL_ERROR",
      "message": "string"
    }
  ]
}

レスポンスには、完全なレコードの詳細を含むregistryRecords配列と、取得できなかったレコードのerrors配列が含まれます。

起動時に、1 つのエントリ (1 つのレジストリ、1～100 個のレコード IDs。グループ化されたシェイプは、将来のリリースでクロスレジストリバッチ処理と前方互換性があります。

変更 6: APIs構造化フィルターパラメータを採用する一覧表示

bedrock-agentcore 名前空間では、List APIsフィルタリング可能な各フィールドを独自のクエリパラメータ (、 など) として公開--status READYします--recordType MCP。agent-registry 名前空間では、単一の構造化filtersパラメータがこれらの個別のパラメータを置き換えます。filters 値は{ "name": "<dotted.path>", "values": ["<value>"] }エントリのリストで、 nameはドット区切りの属性パスです。ネストされたフィールドを含む新しいフィルタリング可能なフィールドは、新しい API パラメータではなく新しいnameパスになります。リストオペレーションも から GETに変更されますPOST。ページ分割パラメータ (maxResults、nextToken) は変更されません。

Before (bedrock-agentcore名前空間、廃止予定):

GET /registries?status=READY&authorizerType=AWS_IAM
GET /registries/{registryId}/records?name=my-agent&status=APPROVED&recordType=MCP

後 (agent-registry 名前空間):

// ListRegistries
// POST /registries-list
{
  "filters": [
    { "name": "status", "values": ["READY"] },
    { "name": "discoveryConfiguration.authorizerType", "values": ["AWS_IAM"] }
  ],
  "maxResults": 100,
  "nextToken": "string"
}

// ListRegistryRecords
// POST /registries/{registryId}/records-list
{
  "filters": [
    { "name": "name", "values": ["my-agent"] },
    { "name": "status", "values": ["APPROVED"] },
    { "name": "recordType", "values": ["MCP"] }
  ],
  "maxResults": 100,
  "nextToken": "string"
}

データ移行

既存のレジストリとレジストリレコードを bedrock-agentcore名前空間から agent-registry名前空間に移行する必要があります。移行を支援する移行ツールを提供しています。このツールは、既存のデータの抽出、古いスキーマから新しいスキーマへの変換、新しい名前空間のレジストリへのロードを処理します。このツールは、同じアカウントとリージョン内のagent-registry名前空間に新しいレジストリを作成します。既存のすべてのレコードを古いレジストリから新しいレコードに移行し、名前空間と API スキーマの変更を考慮します。

移行ツールは、GitHub ウェブサイトの agentcore-samples リポジトリで利用できます。詳細なセットアップ手順、コマンドリファレンス、運用ガイダンスについては、リポジトリ README を参照してください。

移行アプローチの選択

適切なアプローチは、1 回限りのフル移行で十分かどうか、または無人実行が必要かどうか、カットオーバー時に増分負荷を実行する能力によって異なります。

ケース 1: 簡単な移行

ケース 2: Glue AWS によるマネージド移行

ケース 3: アクティブ/アクティブ移行

移行の検証

移行を実行したら、データが正しく移行されたことを確認します。

同期されたレコードの IAM 信頼ポリシーを更新する

いずれかのレジストリレコードが IAM ロールの認証情報タイプと同期を使用している場合は、ライブロードを実行する前にロールの信頼ポリシーを更新する必要があります。ロールを引き受けるサービスプリンシパルが、新しい名前空間agent-registry.amazonaws.comで から bedrock-agentcore.amazonaws.com に変更されました。OAuth 認証情報を使用するレコードや認可がないレコードは影響を受けません。

影響を受ける各レコードによって参照されるロールの信頼ポリシーを更新します。

Before (bedrock-agentcore名前空間、廃止予定):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": { "Service": "bedrock-agentcore.amazonaws.com" },
      "Action": "sts:AssumeRole"
    }
  ]
}

後 (agent-registry 名前空間):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": { "Service": "agent-registry.amazonaws.com" },
      "Action": "sts:AssumeRole"
    }
  ]
}

この理由でレコードがすでに失敗している場合、移行されたレコードは CREATE_FAILEDステータスで存在します。移行ツールは失敗ステータスのレコードの上書きを拒否するため、信頼ポリシーのみを修正しても解決されません。復旧するには:

よくある質問

AWS エージェントレジストリの変更点

AWS エージェントレジストリは、 bedrock-agentcore名前空間から新しい専用agent-registry名前空間に移行しています。移行には、名前空間と設定の変更 (エンドポイント、IAM、SDK、CLI、ARNs、オブザーバビリティ）、API スキーマの変更 (レジストリとレコードの再構築されたデータモデル）、データ移行 (既存のレジストリとレコードを新しい名前空間に移動する) の 3 つの領域があります。

bedrock-agentcore 名前空間で Registry を引き続き使用できますか?

bedrock-agentcore 名前空間での既存のレジストリの使用状況は、移行期間中も中断することなく動作し続けます。ただし、データ移行とコード更新の両方を完了するのに十分な時間を確保するために、ツールが利用可能になったらすぐに移行を開始することをお勧めします。

ただし、2026 年 8 月 6 日の時点で既存のレジストリまたはレコードがない場合は、2026 年 8 月 6 日以降は AWS エージェントレジストリbedrock-agentcoreの名前空間にアクセスできません。2026 年 8 月 6 日現在の既存のレジストリまたはレコードがある場合は、移行期間中 (2026 年 8 月 6 日～2026 年 9 月 17 日) エージェント AWS レジストリbedrock-agentcoreの名前空間にアクセスできます。

データは自動的に移行されますか?

いいえ。提供されている移行ツールを使用して、移行を自分で開始する必要があります。スケールに基づく利用可能なアプローチの詳細については、「データ移行」セクションを参照してください。

どのような API スキーマの変更が含まれていますか?

名前空間の変更に加えて、レジストリエンティティ ( でグループ化された認可設定discoveryConfiguration)、レジストリレコードの新しいフィールド (name および )、レジストリレコードの再編成 (記述子のフラット化、フィールドの名前変更recordType)、検索 API フィルターの更新 (recordType、recordVersion)、新しいブラウジング API (ListDiscoverableRegistryRecords、BatchGetDiscoverableRegistryRecord)、リストオペレーションの構造化フィルターの 6 つの領域で APIs データモデルを更新しました。

データ移行にはどのくらいの時間がかかりますか?

移行時間は、アカウントのレジストリとレコードの数によって異なります。レコード数が 100 未満のアカウントの場合、ローカルで を実行すると移行が数分で完了します。数千のレコードを持つアカウントの場合、マネージドジョブとして を実行すると、移行が 15 分以内に完了するはずです。

アクティブな書き込みを含む大規模なデプロイがある場合はどうなりますか?

本番環境bedrock-agentcoreの名前空間にデータをアクティブに書き込む場合は、ケース 3 で説明されているアクティブ/アクティブ移行アプローチを使用します。完全な移行から始めてagent-registry名前空間を最新の状態にしてから、両方の名前空間に同時に書き込み、統合を検証し、新しい名前空間の信頼性を構築します。準備ができagent-registryたら、読み取りと書き込みを にカットオーバーします。

ヘルプはどこで入手できますか?

移行に関するご質問やサポートについては、 AWS サポートにお問い合わせください。