Skip to content

Create Registry Record

bedrockagentcorecontrol_create_registry_record R Documentation

Creates a new registry record within the specified registry

Description

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.

Usage

bedrockagentcorecontrol_create_registry_record(registryId, name,
  description, descriptorType, descriptors, recordVersion,
  synchronizationType, synchronizationConfiguration, clientToken)

Arguments

registryId

[required] 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.
name

[required] The name of the registry record.
description

A description of the registry record.
descriptorType

[required] 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.
descriptors

The descriptor-type-specific configuration containing the resource schema and metadata. The structure of this field depends on the descriptorType you specify.
recordVersion

The version of the registry record. Use this to track different versions of the record's content.
synchronizationType

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.
synchronizationConfiguration

The configuration for synchronizing registry record metadata from an external source, such as a URL-based MCP server.
clientToken

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.

Value

A list with the following syntax:

list(
  recordArn = "string",
  status = "DRAFT"|"PENDING_APPROVAL"|"APPROVED"|"REJECTED"|"DEPRECATED"|"CREATING"|"UPDATING"|"CREATE_FAILED"|"UPDATE_FAILED"
)

Request syntax

svc$create_registry_record(
  registryId = "string",
  name = "string",
  description = "string",
  descriptorType = "MCP"|"A2A"|"CUSTOM"|"AGENT_SKILLS",
  descriptors = list(
    mcp = list(
      server = list(
        schemaVersion = "string",
        inlineContent = "string"
      ),
      tools = list(
        protocolVersion = "string",
        inlineContent = "string"
      )
    ),
    a2a = list(
      agentCard = list(
        schemaVersion = "string",
        inlineContent = "string"
      )
    ),
    custom = list(
      inlineContent = "string"
    ),
    agentSkills = list(
      skillMd = list(
        inlineContent = "string"
      ),
      skillDefinition = list(
        schemaVersion = "string",
        inlineContent = "string"
      )
    )
  ),
  recordVersion = "string",
  synchronizationType = "URL",
  synchronizationConfiguration = list(
    fromUrl = list(
      url = "string",
      credentialProviderConfigurations = list(
        list(
          credentialProviderType = "OAUTH"|"IAM",
          credentialProvider = list(
            oauthCredentialProvider = list(
              providerArn = "string",
              grantType = "CLIENT_CREDENTIALS",
              scopes = list(
                "string"
              ),
              customParameters = list(
                "string"
              )
            ),
            iamCredentialProvider = list(
              roleArn = "string",
              service = "string",
              region = "string"
            )
          )
        )
      )
    )
  ),
  clientToken = "string"
)