翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 承認されたレコードを参照する **移行がオープンに** AWS エージェントレジストリが新しい`agent-registry`名前空間で起動されました。パブリックプレビュー`bedrock-agentcore`名前空間のサポートは、2026 年 9 月 17 日に終了します。移行手順については、[「包括的なレジストリ移行ガイド](registry-faq.md)」を参照してください。 コンシューマーは、2 つのデータプレーン APIs を使用してレジストリ内の承認済みレコードのカタログを参照できます。ページ分割されたリストと、レコード ID `ListDiscoverableRegistryRecords` による完全なレコードコンテンツの一括取得`BatchGetDiscoverableRegistryRecord`です。どちらの APIs「承認済み」であるレコードのみを返します。 `agent-registry` ******ドラフト**、**保留中の承認**、**拒否**、または**廃止**ステータスのレコードは返されません。自然言語クエリでレコードを検索するには、`SearchDiscoverableRegistryRecords`代わりに を使用します。[「レジストリレコードの検索](registry-search-records.md)」を参照してください。 **注記** `ListDiscoverableRegistryRecords` および `BatchGetDiscoverableRegistryRecord`は、 `agent-registry`名前空間でのみ使用できます。`bedrock-agentcore` 名前空間で作成されたレジストリは、これらの APIsを公開しません。 を使用します`SearchDiscoverableRegistryRecords`。 ## 承認されたレコードを一覧表示する を使用して`ListDiscoverableRegistryRecords`、レジストリ内のすべての承認済みレコードのページ分割された概要を返します。概要にはレコードの記述子は含まれません。必要なレコードを特定した後、完全な記述子コンテンツを取得`BatchGetDiscoverableRegistryRecord`するために使用します。 ### リクエストパラメータ + **registryId** (必須、パス): リストするレジストリの ARN または ID。 + **maxResults** (オプション): ページあたりの結果の最大数。有効な範囲は 1～100 です。 + **nextToken** (オプション): 前のレスポンスからのページ分割トークン。最初のページには を省略します。 + **filters** (オプション): 形式のフィルターエントリのリスト`{"name": "", "values": [""]}`。サポートされているフィルター名: + `recordType` — レコードのセマンティックタイプ。有効な値は、`AGENT`、`MCP`、`SKILL`、`CUSTOM` です。 + `descriptorType` — レコードで使用されるプライマリ記述子キー。有効な値は、`a2aAgentCard`、`mcpServer`、`agentSkillsDefinition`、`custom` です。 重複するフィルター名は拒否されます。1 つのフィルターに複数の値を指定すると、値は **OR** で結合されます。複数のフィルターを指定すると、フィルターは **AND** で結合されます。 レスポンスの各概要には、`registryArn`、、`recordArn`、`recordId`、`name`、`displayName`、、`description`、`recordType`、`recordVersion``status``createdAt`、、 が含まれます`updatedAt`。 ### レスポンスの順序付けとページ分割 結果はレコード名でアルファベット順にソートされます。 `ListDiscoverableRegistryRecords` は、高密度ページを保証するものではありません。一致する`maxResults`レコードがさらに存在する場合でも、個々のレスポンスに含めることができるレコードは 未満または 0 です。レスポンスに一致するすべてのレコードを取得するための が含まれていない `nextToken` (または `nextToken` である`null`) まで、後続の各リクエスト`nextToken`で返された を使用して API を呼び出し続けます。 ### コンソール **Example** 1. [AWS エージェントレジストリコンソール](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#)を開きます。 1. ナビゲーションペインで、**ディレクトリの記録**を選択します。 1. 参照するレジストリを選択します。このページでは`ListDiscoverableRegistryRecords`、承認されたレコードが自動的に呼び出され、ページ分割されたテーブルに表示されます。 1. (オプション) 検索バーの横にある**プロパティ**メニューを使用して、**レコードタイプ**でフィルタリングします。 1. レコードの名前を選択すると、その完全な記述子コンテンツが表示されます。 で承認済みレコードカタログを閲覧`ListDiscoverableRegistryRecords`できるのは、 `agent-registry`名前空間のみです。古い Bedrock-AgentCore コンソールには、**レコードディレクトリ**ページや参照機能はありません。`bedrock-agentcore` 名前空間で作成されたレジストリ内のレコードを検索するには、レジストリの詳細ページの**「レコードの検索**」タブを使用します。[「レジストリレコードの検索](registry-search-records.md)」を参照してください。 **注記** **レコードディレクトリ**ページには、選択したレジストリに対する IAM ベースのインバウンド認可が必要です。JWT 認可レジストリの場合は、HTTP クライアントと有効な JWT ベアラートークンを使用して `ListDiscoverableRegistryRecords` を直接呼び出します。 ### AWS CLI ``` aws agent-registry list-discoverable-registry-records \ --registry-id "" \ --filters '[{"name": "recordType", "values": ["MCP"]}]' \ --max-results 50 \ --region us-east-1 ``` 結果をページスルーするには、前のレスポンスの`nextToken`値を渡します。 ``` aws agent-registry list-discoverable-registry-records \ --registry-id "" \ --next-token "" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('agent-registry') paginator = client.get_paginator('list_discoverable_registry_records') for page in paginator.paginate( registryId='', filters=[{'name': 'recordType', 'values': ['MCP']}] ): for record in page['registryRecords']: print(f"{record['displayName']} ({record['name']}) - {record['recordType']} v{record['recordVersion']}") ``` ### HTTP クライアント ``` curl -X POST "https://agent-registry..api.aws/registries//discoverable-records-list" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "filters": [{"name": "recordType", "values": ["MCP"]}], "maxResults": 50 }' ``` ## 承認済みレコードをバッチ取得する を使用して`BatchGetDiscoverableRegistryRecord`、1 回の呼び出しで最大 100 のレコード IDs の完全な記述子コンテンツを取得します。一般的なユースケース: で参照`ListDiscoverableRegistryRecords`して目的のレコードを特定した後、レコードごとに 1 回の呼び出しを行うのではなく、1 回の`SearchDiscoverableRegistryRecords`呼び出しで記述子を取得します。 ### リクエストパラメータ + **entries** (必須): レジストリスコープのレコードグループのリスト。起動時に受け入れられるエントリは 1 つだけです (リクエストごとに 1 つのレジストリ）。これは、将来のクロスレジストリバッチ用に前方互換性があります。 各エントリには以下が含まれます。 + **registryId** (必須): レジストリの ARN または ID。 + **recordIds** (必須): レジストリから取得する 1～100 個のレコード ARNs または IDs のリスト。 ### [応答] + **registryRecords**: 正常に取得されたレコードの完全なレコードオブジェクト (記述子付き）。 + **errors**: レコードごとのエラーリスト。リクエストされたすべてのレコードが正常に返されたら空になります。 呼び出しは、部分的な障害が発生した場合でも HTTP 200 を返します。取得できなかったレコードは、呼び出し全体が失敗するのではなく、`errors`リストに表示されます。各エラーエントリは、リクエスト`recordId`の `registryId`と に加えて、 をエコーします`errorCode`。 + **RESOURCE\_NOT\_FOUND** — レコードが存在しないか、削除されているか、最新のリビジョンが承認されていません****。承認されていないレコードはこのコードに折りたたまれるため、可視性のない発信者には公開されません。 + **ACCESS\_DENIED** — 発信者には、この特定のレコードを読み取る権限がありません。 + **INTERNAL\_ERROR** — 一時的な取り出しエラー。エクスポネンシャルバックオフを使用して、障害が発生したサブセットを安全に再試行できます。 バッチレベルの障害 (レジストリが存在しない、呼び出し元がレジストリにアクセスできない、回復不可能なサービスエラー) は、レコードごとの`errors`リストではなく、標準オペレーションエラーを通じて返されます。 ### AWS CLI ``` aws agent-registry batch-get-discoverable-registry-record \ --entries '[{"registryId": "", "recordIds": ["", "", ""]}]' \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('agent-registry') response = client.batch_get_discoverable_registry_record( entries=[ { 'registryId': '', 'recordIds': ['', '', ''] } ] ) for record in response['registryRecords']: print(f"Retrieved: {record['displayName']} ({record['recordId']})") for error in response['errors']: print(f"Failed: {error['recordId']} ({error['errorCode']}): {error.get('message', '')}") ``` ### HTTP クライアント ``` curl -X POST "https://agent-registry..api.aws/discoverable-records-batch" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "entries": [ { "registryId": "", "recordIds": ["", "", ""] } ] }' ```