View a markdown version of this page

RegistryRecordSummary - AgentRegistry Control Plane API Reference

RegistryRecordSummary

A summary of a registry record returned by list operations. Contains identifying and lifecycle fields but omits descriptor content.

Contents

createdAt

The timestamp when the registry record was created.

Type: Timestamp

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, such as MCP, AGENT, SKILL, or CUSTOM.

Type: String

Valid Values: MCP | AGENT | CUSTOM | SKILL | GATEWAY

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.

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

createdBy

The ID of the AWS account that created the registry record.

Type: String

Length Constraints: Fixed length of 12.

Pattern: [0-9]{12}

Required: No

createdByAutoDetection

Specifies whether the registry record was created by auto-detection. true indicates the record was automatically created by the service based on the registry's auto-detection configuration; false indicates the record was created through a control-plane API call.

Type: Boolean

Required: No

description

A description of the registry record.

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

provenanceSummaryList

The condensed provenance lineage for the registry record. Each entry contains the source relation, source identifier, and source type of an auto-detection lineage entry. Populated for records created by auto-detection.

Type: Array of ProvenanceSummary objects

Array Members: Minimum number of 0 items. Maximum number of 1 item.

Required: No

See Also

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