View a markdown version of this page

RegistryRecordSummary - AgentRegistry Data Plane API Reference

RegistryRecordSummary

Summary information about a registry record, including its descriptors.

Contents

createdAt

The timestamp when the registry record was created.

Type: Timestamp

Required: Yes

descriptors

The protocol-specific descriptors that describe how to connect to and use the record.

Type: Descriptors object

Required: Yes

name

The name of the registry record. Names are unique within a registry.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9][a-zA-Z0-9_\-\.\/]*

Required: Yes

recordArn

The Amazon Resource Name (ARN) of the registry record.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/[a-zA-Z0-9]{12}

Required: Yes

recordId

The unique identifier of the registry record.

Type: String

Length Constraints: Fixed length of 12.

Pattern: [a-zA-Z0-9]{12}

Required: Yes

recordType

The type of the registry record. MCP is a Model Context Protocol server record, AGENT is an Agent-to-Agent (A2A) agent card record, SKILL is an agent skills definition record, and CUSTOM is a record with a custom descriptor.

Type: String

Valid Values: MCP | AGENT | CUSTOM | SKILL

Required: Yes

recordVersion

The version identifier of the registry record.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9.-]+

Required: Yes

registryArn

The Amazon Resource Name (ARN) of the parent registry that owns the record.

Type: String

Length Constraints: Minimum length of 46. Maximum length of 2048.

Pattern: arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}

Required: Yes

status

The lifecycle status of the registry record. A record is DRAFT before it is submitted, PENDING_APPROVAL while awaiting curator review, and APPROVED once it is approved and discoverable. REJECTED and DEPRECATED records are not discoverable. The CREATING, UPDATING, CREATE_FAILED, and UPDATE_FAILED values reflect the state of an in-progress or failed asynchronous change.

Type: String

Valid Values: DRAFT | PENDING_APPROVAL | APPROVED | REJECTED | DEPRECATED | CREATING | UPDATING | CREATE_FAILED | UPDATE_FAILED

Required: Yes

updatedAt

The timestamp when the registry record was last updated.

Type: Timestamp

Required: Yes

description

A human-readable description of the registry record. Use this field to explain the record's purpose or content to consumers discovering it in the registry.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No

displayName

The human-readable display name of the registry record.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: