기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

승인된 레코드 찾아보기

소비자는 두 개의 데이터 영역 APIs ListDiscoverableRegistryRecords 페이지 매김 목록과 레코드 ID별로 전체 레코드 콘텐츠를 BatchGetDiscoverableRegistryRecord 대량 검색할 수 있습니다. 두 APIs 모두 agent-registry 네임스페이스에서만 사용할 수 있으며 최신 개정이 승인됨 상태인 레코드만 반환합니다. 초안, 승인 보류 중, 거부됨 또는 사용 중단 상태의 레코드는 반환되지 않습니다. 자연어 쿼리로 레코드를 검색하려면 SearchDiscoverableRegistryRecords 대신를 사용합니다. 레지스트리 레코드 검색을 참조하세요.

승인된 레코드 나열

레지스트리에서 승인된 모든 레코드의 페이지가 매겨진 요약을 반환ListDiscoverableRegistryRecords하는 데 사용합니다. 요약에는 레코드의 설명자가 포함되지 않습니다. 필요한 레코드를 식별한 후 BatchGetDiscoverableRegistryRecord를 사용하여 전체 설명자 콘텐츠를 가져옵니다.

요청 파라미터

응답의 각 요약에는 registryArn, , recordArn, recordId, name, displayName, description, recordTyperecordVersion, status, , createdAt가 포함됩니다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를 사용하여 단일 호출에서 최대 100IDs에 대한 전체 설명자 콘텐츠를 검색합니다. 일반적인 사용 사례: 원하는 레코드를 찾아보ListDiscoverableRegistryRecords고 식별한 후 레코드당 하나의 호출을 수행하는 대신 한 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>"]
      }
    ]
  }'