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

承認されたレコードを参照する

コンシューマーは、2 つのデータプレーン APIs を使用してレジストリ内の承認済みレコードのカタログを参照できます。ページ分割されたリストと、レコード ID ListDiscoverableRegistryRecords による完全なレコードコンテンツの一括取得BatchGetDiscoverableRegistryRecordです。どちらの APIs「承認済み」であるレコードのみを返します。 agent-registry ドラフト、保留中の承認、拒否、または廃止ステータスのレコードは返されません。自然言語クエリでレコードを検索するには、SearchDiscoverableRegistryRecords代わりに を使用します。「レジストリレコードの検索」を参照してください。

承認されたレコードを一覧表示する

を使用してListDiscoverableRegistryRecords、レジストリ内のすべての承認済みレコードのページ分割された概要を返します。概要にはレコードの記述子は含まれません。必要なレコードを特定した後、完全な記述子コンテンツを取得BatchGetDiscoverableRegistryRecordするために使用します。

リクエストパラメータ

レスポンスの各概要には、registryArn、、recordArn、recordId、name、displayName、、description、recordType、recordVersionstatuscreatedAt、、 が含まれますupdatedAt。

レスポンスの順序付けとページ分割

結果はレコード名でアルファベット順にソートされます。

ListDiscoverableRegistryRecords は、高密度ページを保証するものではありません。一致するmaxResultsレコードがさらに存在する場合でも、個々のレスポンスに含めることができるレコードは 未満または 0 です。レスポンスに一致するすべてのレコードを取得するための が含まれていない nextToken (または nextToken であるnull) まで、後続の各リクエストnextTokenで返された を使用して API を呼び出し続けます。

コンソール

AWS CLI

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --filters '[{"name": "recordType", "values": ["MCP"]}]' \
  --max-results 50 \
  --region us-east-1

結果をページスルーするには、前のレスポンスのnextToken値を渡します。

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --next-token "<tokenFromPreviousResponse>" \
  --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='<registryARN>',
    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.<region>.api.aws/registries/<registryARN>/discoverable-records-list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "filters": [{"name": "recordType", "values": ["MCP"]}],
    "maxResults": 50
  }'

承認済みレコードをバッチ取得する

を使用してBatchGetDiscoverableRegistryRecord、1 回の呼び出しで最大 100 のレコード IDs の完全な記述子コンテンツを取得します。一般的なユースケース: で参照ListDiscoverableRegistryRecordsして目的のレコードを特定した後、レコードごとに 1 回の呼び出しを行うのではなく、1 回のSearchDiscoverableRegistryRecords呼び出しで記述子を取得します。

リクエストパラメータ

[応答]

呼び出しは、部分的な障害が発生した場合でも HTTP 200 を返します。取得できなかったレコードは、呼び出し全体が失敗するのではなく、errorsリストに表示されます。各エラーエントリは、リクエストrecordIdの registryIdと に加えて、 をエコーしますerrorCode。

バッチレベルの障害 (レジストリが存在しない、呼び出し元がレジストリにアクセスできない、回復不可能なサービスエラー) は、レコードごとのerrorsリストではなく、標準オペレーションエラーを通じて返されます。

AWS CLI

aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registryARN>", "recordIds": ["<recordId1>", "<recordId2>", "<recordId3>"]}]' \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('agent-registry')

response = client.batch_get_discoverable_registry_record(
    entries=[
        {
            'registryId': '<registryARN>',
            'recordIds': ['<recordId1>', '<recordId2>', '<recordId3>']
        }
    ]
)

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.<region>.api.aws/discoverable-records-batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "entries": [
      {
        "registryId": "<registryARN>",
        "recordIds": ["<recordId1>", "<recordId2>", "<recordId3>"]
      }
    ]
  }'