Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Navegar por los registros aprobados

Como consumidor, puede explorar el catálogo de registros aprobados de un registro mediante dos API de plano de datos: ListDiscoverableRegistryRecords para la publicación paginada y BatchGetDiscoverableRegistryRecord para la recuperación masiva del contenido completo de los registros por ID de registro. Ambas API solo están disponibles en el espacio de agent-registry nombres y solo muestran los registros cuya última revisión tenga el estado Aprobada. Los registros en estado Borrador, Pendiente de aprobación , Rechazado o Obsoleto no se devuelven. Para buscar registros con una consulta en lenguaje natural, utilice en su lugar. SearchDiscoverableRegistryRecords Consulte Buscar registros de registro.

Enumere los registros aprobados

ListDiscoverableRegistryRecordsUtilícelo para obtener resúmenes paginados de cada registro aprobado en un registro. Los resúmenes no incluyen los descriptores del registro; utilícelos BatchGetDiscoverableRegistryRecord para obtener el contenido completo del descriptor después de identificar los registros que necesita.

Parámetros de solicitud

Cada resumen de la respuesta contiene:registryArn,recordArn,recordId,name,displayName,description,recordType,recordVersion,status,createdAt,updatedAt.

Orden y paginación de las respuestas

Los resultados se ordenan alfabéticamente por nombre de registro.

ListDiscoverableRegistryRecordsno garantiza páginas densas. Cualquier respuesta individual puede contener menos maxResults registros o cero registros, incluso cuando existen más registros coincidentes. Continúe llamando a la API con nextToken el resultado de cada solicitud subsiguiente hasta que la respuesta no contenga nextToken (o nextToken contenganull) ningún registro coincidente.

Consola

AWS CLI

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

Para ver los resultados, pasa el nextToken valor de la respuesta anterior:

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']}")

Cliente 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
  }'

Recupera por lotes los registros aprobados

BatchGetDiscoverableRegistryRecordUtilícelo para recuperar el contenido completo del descriptor de hasta 100 ID de registro en una sola llamada. Caso práctico habitual: después de buscar ListDiscoverableRegistryRecords e identificar los registros que desea, busque sus descriptores en una llamada en lugar de realizar una SearchDiscoverableRegistryRecords llamada por registro.

Parámetros de solicitud

Respuesta

La llamada devuelve el protocolo HTTP 200 incluso si se produce un error parcial: los registros que no se han podido recuperar aparecen en la errors lista, en lugar de provocar un error en toda la llamada. Cada entrada de error se repite recordId desde registryId y hacia la solicitud, además deerrorCode:

Batch-level los errores (el registro no existe, la persona que llama no tiene acceso al registro, error de servicio irrecuperable) se devuelven mediante errores de operación estándar, no mediante la lista por registro. 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', '')}")

Cliente 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>"]
      }
    ]
  }'