Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Parcourir les enregistrements approuvés

En tant que consommateur, vous pouvez parcourir le catalogue des enregistrements approuvés dans un registre à l'aide de deux API de plan de données : ListDiscoverableRegistryRecords pour la liste paginée et BatchGetDiscoverableRegistryRecord pour la récupération groupée du contenu complet des enregistrements par ID d'enregistrement. Les deux API ne sont disponibles que dans l'agent-registryespace de noms et renvoient uniquement les enregistrements dont la dernière révision a le statut Approuvé. Les enregistrements dont le statut est Brouillon , En attente d'approbation, Rejeté ou Obsolète ne sont pas renvoyés. Pour rechercher des enregistrements à l'aide d'une requête en langage naturel, utilisez SearchDiscoverableRegistryRecords plutôt. Voir Rechercher des enregistrements de registre.

Répertorier les enregistrements approuvés

Permet ListDiscoverableRegistryRecords de renvoyer des résumés paginés de chaque enregistrement approuvé dans un registre. Les résumés n'incluent pas les descripteurs de l'enregistrement. Utilisez-les BatchGetDiscoverableRegistryRecord pour récupérer le contenu complet du descripteur après avoir identifié les enregistrements dont vous avez besoin.

Paramètres de demande

Chaque résumé de la réponse contient :registryArn,recordArn,recordId,name,displayName,description,recordType,recordVersion,status,createdAt,updatedAt.

Ordre des réponses et pagination

Les résultats sont triés par ordre alphabétique par nom d'enregistrement.

ListDiscoverableRegistryRecordsne garantit pas la densité des pages. Chaque réponse individuelle peut contenir moins d'maxResultsenregistrements, voire aucun enregistrement, même s'il existe d'autres enregistrements correspondants. Continuez à appeler l'API avec le résultat renvoyé nextToken à chaque demande suivante jusqu'à ce que la réponse contienne non nextToken (ou nextToken contientnull) pour récupérer tous les enregistrements correspondants.

Console

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

Pour parcourir les résultats, transmettez la nextToken valeur de la réponse précédente :

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --next-token "<tokenFromPreviousResponse>" \
  --region us-east-1

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

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

Récupération par lots des enregistrements approuvés

Permet BatchGetDiscoverableRegistryRecord de récupérer le contenu complet du descripteur pour un maximum de 100 ID d'enregistrement en un seul appel. Cas d'utilisation courant : après avoir parcouru ListDiscoverableRegistryRecords et identifié les enregistrements souhaités, récupérez leurs descripteurs en un seul appel plutôt que de passer un SearchDiscoverableRegistryRecords appel par enregistrement.

Paramètres de demande

Réponse

L'appel renvoie le protocole HTTP 200 même en cas d'échec partiel : les enregistrements qui n'ont pas pu être récupérés apparaissent dans la errors liste au lieu de provoquer l'échec de l'ensemble de l'appel. Chaque entrée d'erreur fait écho registryId et recordId provient de la demande, plus un errorCode :

Batch-level les échecs (le registre n'existe pas, l'appelant n'a pas accès au registre, erreur de service irrécupérable) sont renvoyés par le biais d'erreurs de fonctionnement standard, et non par la liste par enregistrement. errors

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

AWS Kit 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', '')}")

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