Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Sfoglia i record approvati

In qualità di utente, puoi sfogliare il catalogo dei record approvati in un registro utilizzando due API data-plane: per gli elenchi suddivisi ListDiscoverableRegistryRecords per pagina e BatchGetDiscoverableRegistryRecord per il recupero in blocco del contenuto completo dei record in base all'ID del record. Entrambe le API sono disponibili solo nel agent-registry namespace e restituiscono solo i record la cui ultima revisione ha lo stato Approvato. I record con stato Bozza, In attesa di approvazione, Rifiutato o Obsoleto non vengono restituiti. Per cercare nei record con una query in linguaggio naturale, usa invece. SearchDiscoverableRegistryRecords Vedi Ricerca di record di registro.

Elenca i record approvati

ListDiscoverableRegistryRecordsDa utilizzare per restituire riepiloghi suddivisi per pagina di tutti i record approvati in un registro. I riepiloghi non includono i descrittori del record: vengono utilizzati BatchGetDiscoverableRegistryRecord per recuperare il contenuto completo dei descrittori dopo aver identificato i record necessari.

Parametri della richiesta

Ogni riepilogo della risposta contiene: registryArn recordArnrecordId,name,displayName,description,recordType,recordVersion,status,createdAt,updatedAt.

Ordinamento e impaginazione delle risposte

I risultati sono ordinati alfabeticamente in base al nome del record.

ListDiscoverableRegistryRecordsnon garantisce pagine dense. Ogni singola risposta può contenere meno di maxResults record o zero record, anche quando esistono più record corrispondenti. Continua a chiamare l'API con i dati restituiti nextToken a ogni richiesta successiva finché la risposta non contiene nextToken (o non nextToken ènull) in grado di recuperare tutti i record corrispondenti.

Console

AWS CLI

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

Per scorrere i risultati, passa il nextToken valore della risposta precedente:

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

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

Recupera in batch i record approvati

BatchGetDiscoverableRegistryRecordDa utilizzare per recuperare il contenuto completo del descrittore per un massimo di 100 ID di record in una singola chiamata. Caso d'uso comune: dopo aver consultato ListDiscoverableRegistryRecords e identificato i record desiderati, recupera i relativi descrittori in una chiamata anziché effettuare una chiamata per record. SearchDiscoverableRegistryRecords

Parametri della richiesta

Risposta

La chiamata restituisce HTTP 200 anche in caso di errore parziale: i record che non è stato possibile recuperare vengono visualizzati nell'errorselenco anziché causare il fallimento dell'intera chiamata. Ogni voce di errore riecheggia registryId e viene generata recordId dalla richiesta, più un: errorCode

Batch-level gli errori (il registro non esiste, il chiamante non ha accesso al registro, errore irreversibile del servizio) si ripresentano tramite errori operativi standard, non nell'elenco dei record. 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', '')}")

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