Skip to content

Bedrock Agentcore Control  >  Operations  >  create_registry

create_registry

Operation

create_registry async

create_registry(input: CreateRegistryInput, plugins: list[Plugin] | None = None) -> CreateRegistryOutput

Creates a new registry in your Amazon Web Services account. A registry serves as a centralized catalog for organizing and managing registry records, including MCP servers, A2A agents, agent skills, and custom resource types.

If you specify CUSTOM_JWT as the authorizerType, you must provide an authorizerConfiguration.

Parameters:

Name Type Description Default
input CreateRegistryInput

An instance of CreateRegistryInput.

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
CreateRegistryOutput

An instance of CreateRegistryOutput.

Input

CreateRegistryInput dataclass

Dataclass for CreateRegistryInput structure.

Attributes

approval_configuration class-attribute instance-attribute
approval_configuration: ApprovalConfiguration | None = None

The approval configuration for registry records. Controls whether records require explicit approval before becoming active. See the ApprovalConfiguration data type for supported configuration options.

authorizer_configuration class-attribute instance-attribute
authorizer_configuration: AuthorizerConfiguration | None = None

The authorizer configuration for the registry. Required if authorizerType is CUSTOM_JWT. For details, see the AuthorizerConfiguration data type.

authorizer_type class-attribute instance-attribute
authorizer_type: RegistryAuthorizerType | None = None

The type of authorizer to use for the registry. This controls the authorization method for the Search and Invoke APIs used by consumers, and does not affect the standard CRUDL APIs for registry and registry record management used by administrators.

  • CUSTOM_JWT - Authorize with a bearer token.

  • AWS_IAM - Authorize with your Amazon Web Services IAM credentials.

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

description class-attribute instance-attribute
description: str | None = field(repr=False, default=None)

A description of the registry.

name class-attribute instance-attribute
name: str | None = None

The name of the registry. The name must be unique within your account and can contain alphanumeric characters and underscores.

Output

CreateRegistryOutput dataclass

Dataclass for CreateRegistryOutput structure.

Attributes

registry_arn instance-attribute
registry_arn: str

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