create_registry_record¶
Operation¶
async
¶
create_registry_record(input: CreateRegistryRecordInput, plugins: list[Plugin] | None = None) -> CreateRegistryRecordOutput
Creates a new registry record within the specified registry. A registry record represents an individual AI resource's metadata in the registry. This could be an MCP server (and associated tools), A2A agent, agent skill, or a custom resource with a custom schema.
The record is processed asynchronously and returns HTTP 202 Accepted.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
CreateRegistryRecordInput
|
An instance of |
required |
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
Returns:
| Type | Description |
|---|---|
CreateRegistryRecordOutput
|
An instance of |
Input¶
dataclass
¶
Dataclass for CreateRegistryRecordInput structure.
Attributes¶
class-attribute
instance-attribute
¶
client_token: str | None = None
A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.
class-attribute
instance-attribute
¶
description: str | None = field(repr=False, default=None)
A description of the registry record.
class-attribute
instance-attribute
¶
descriptor_type: DescriptorType | None = None
The descriptor type of the registry record.
-
MCP- Model Context Protocol descriptor for MCP-compatible servers and tools. -
A2A- Agent-to-Agent protocol descriptor. -
CUSTOM- Custom descriptor type for resources such as APIs, Lambda functions, or servers not conforming to a standard protocol. -
AGENT_SKILLS- Agent skills descriptor for defining agent skill definitions.
class-attribute
instance-attribute
¶
descriptors: Descriptors | None = None
The descriptor-type-specific configuration containing the resource
schema and metadata. The structure of this field depends on the
descriptorType you specify.
class-attribute
instance-attribute
¶
record_version: str | None = None
The version of the registry record. Use this to track different versions of the record's content.
class-attribute
instance-attribute
¶
registry_id: str | None = None
The identifier of the registry where the record will be created. You can specify either the Amazon Resource Name (ARN) or the ID of the registry.
class-attribute
instance-attribute
¶
synchronization_configuration: SynchronizationConfiguration | None = None
The configuration for synchronizing registry record metadata from an external source, such as a URL-based MCP server.
class-attribute
instance-attribute
¶
synchronization_type: SynchronizationType | None = None
The type of synchronization to use for keeping the record metadata up to
date from an external source. Possible values include FROM_URL and
NONE.
Output¶
dataclass
¶
Dataclass for CreateRegistryRecordOutput structure.
Attributes¶
instance-attribute
¶
record_arn: str
The Amazon Resource Name (ARN) of the created registry record.
instance-attribute
¶
status: RegistryRecordStatus
The status of the registry record. Set to CREATING while the
asynchronous workflow is in progress.