As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Procure registros aprovados

Como consumidor, você pode navegar pelo catálogo de registros aprovados em um registro usando duas APIs de plano de dados — ListDiscoverableRegistryRecords para listagem paginada e para recuperação em massa do conteúdo completo do registro BatchGetDiscoverableRegistryRecord por ID de registro. Ambas as APIs estão disponíveis somente sob o agent-registry namespace e retornam somente registros cuja revisão mais recente tenha o status Aprovada. Registros com status Rascunho, Aprovação pendente , Rejeitado ou Obsoleto não são retornados. Para pesquisar registros com uma consulta em idioma natural, use em vez disso. SearchDiscoverableRegistryRecords Consulte Pesquisar registros de registro.

Listar registros aprovados

Use ListDiscoverableRegistryRecords para retornar resumos paginados de cada registro aprovado em um registro. Os resumos não incluem os descritores do registro — use BatchGetDiscoverableRegistryRecord para buscar o conteúdo completo do descritor depois de identificar os registros de que você precisa.

Parâmetros de solicitação

Cada resumo na resposta contém:registryArn,recordArn,recordId,name,displayName, descriptionrecordType,recordVersion,status,createdAt,updatedAt.

Ordenação e paginação de respostas

Os resultados são classificados alfabeticamente pelo nome do registro.

ListDiscoverableRegistryRecordsnão garante páginas densas. Qualquer resposta individual pode conter menos de maxResults registros ou zero registros, mesmo quando existem mais registros correspondentes. Continue chamando a API com o retornado nextToken em cada solicitação subsequente até que a resposta não contenha nextToken (ou nextToken estejanull) para recuperar todos os registros correspondentes.

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

Para folhear os resultados, passe o nextToken valor da resposta 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ção em lote de registros aprovados

Use BatchGetDiscoverableRegistryRecord para recuperar o conteúdo completo do descritor para até 100 IDs de registro em uma única chamada. Caso de uso comum: depois de navegar ListDiscoverableRegistryRecords e identificar os registros desejados, busque seus descritores em uma chamada em vez de fazer uma SearchDiscoverableRegistryRecords chamada por registro.

Parâmetros de solicitação

Resposta

A chamada retorna HTTP 200 mesmo em caso de falha parcial — os registros que não puderam ser recuperados aparecem na errors lista em vez de causar falha na chamada inteira. Cada entrada de erro ecoa registryId e recordId sai da solicitação, além deerrorCode:

Batch-level falhas (o registro não existe, o chamador não tem acesso ao registro, erro de serviço irrecuperável) retornam por meio de erros de operação padrão, não da 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>"]
      }
    ]
  }'