discoverable_registry_records

Creates, updates, deletes, gets or lists a discoverable_registry_records resource.

Overview

Name	discoverable_registry_records
Type	Resource
Id	aws.agent_registry.discoverable_registry_records

Fields

The following fields are returned by SELECT queries:

search_discoverable_registry_records

Name	Datatype	Description
registry_records	array	The registry records that match the search query, ordered by relevance.

batch_get_discoverable_registry_record

Name	Datatype	Description
errors	array	The per-record errors for records that could not be retrieved. This list is empty when all requested records were returned.
registry_records	array	The records that were successfully retrieved. Each record correlates to the request by its recordId.

list_discoverable_registry_records

Name	Datatype	Description
name	string	Registry Record name (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9_-./]*</code>)
created_at	string (date-time)	Timestamp in ISO 8601 date-time format
description	string	Description of the Resource
display_name	string	Display name for a registry record
record_arn	string	Registry Record Amazon Resource Name (pattern: <code>arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/[a-zA-Z0-9]{12}</code>)
record_id	string	Registry Record unique identifier - 12-character alphanumeric string (pattern: <code>[a-zA-Z0-9]{12}</code>)
record_type	string	Record type enum for registry record classification (MCP, AGENT, CUSTOM, SKILL)
record_version	string	Version of the registry record (pattern: <code>[a-zA-Z0-9.-]+</code>)
registry_arn	string	Registry Amazon Resource Name (pattern: <code>arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}</code>)
status	string	Registry record status (DRAFT, PENDING_APPROVAL, APPROVED, REJECTED, DEPRECATED, CREATING, UPDATING, CREATE_FAILED, UPDATE_FAILED)
updated_at	string (date-time)	Timestamp in ISO 8601 date-time format

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
search_discoverable_registry_records	select	region		Searches the discoverable registry records in a registry using a natural language query. Returns metadata for the matching records ordered by relevance.
batch_get_discoverable_registry_record	select	region		Retrieves multiple discoverable registry records by ID from a single registry. Records that cannot be retrieved are reported individually in the errors list rather than failing the entire request.
list_discoverable_registry_records	select	registry_id, region		Lists the discoverable registry records in a registry. You can optionally filter and paginate the results.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
registry_id	string

SELECT examples

search_discoverable_registry_records

Searches the discoverable registry records in a registry using a natural language query. Returns metadata for the matching records ordered by relevance.

SELECT
registry_records
FROM aws.agent_registry.discoverable_registry_records
WHERE region = '{{ region }}' -- required
;

batch_get_discoverable_registry_record

Retrieves multiple discoverable registry records by ID from a single registry. Records that cannot be retrieved are reported individually in the errors list rather than failing the entire request.

SELECT
errors,
registry_records
FROM aws.agent_registry.discoverable_registry_records
WHERE region = '{{ region }}' -- required
;

list_discoverable_registry_records

Lists the discoverable registry records in a registry. You can optionally filter and paginate the results.

SELECT
name,
created_at,
description,
display_name,
record_arn,
record_id,
record_type,
record_version,
registry_arn,
status,
updated_at
FROM aws.agent_registry.discoverable_registry_records
WHERE registry_id = '{{ registry_id }}' -- required
AND region = '{{ region }}' -- required
;