Skip to content

create_registry

Operation

create_registry

create_registry(request: CreateRegistryInput | CreateRegistryInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateRegistryInputDict]) -> 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
request CreateRegistryInput | CreateRegistryInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[CreateRegistryInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
CreateRegistryOutput

An instance of CreateRegistryOutput.

create_registry async

create_registry(request: CreateRegistryInput | CreateRegistryInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateRegistryInputDict]) -> 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
request CreateRegistryInput | CreateRegistryInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[CreateRegistryInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
CreateRegistryOutput

An instance of CreateRegistryOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

CreateRegistryInputDict

Bases: TypedDict

Dictionary form of CreateRegistryInput.

Attributes

approval_configuration instance-attribute
approval_configuration: ApprovalConfiguration | ApprovalConfigurationDict | 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 instance-attribute
authorizer_configuration: AuthorizerConfiguration | AuthorizerConfigurationDict | None

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

authorizer_type instance-attribute
authorizer_type: str | 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 instance-attribute
client_token: str | 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.

This field is autopopulated if not provided.

description instance-attribute
description: str | None

A description of the registry.

name instance-attribute
name: Required[str]

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

CreateRegistryInput dataclass

Bases: _SerdeShape

Dataclass for CreateRegistryInput structure.

Attributes

approval_configuration class-attribute instance-attribute
approval_configuration: ApprovalConfiguration | 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 = ...

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: str | 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 = ...

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.

This field is autopopulated if not provided.

description class-attribute instance-attribute
description: str | None = ...

A description of the registry.

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

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

Output

CreateRegistryOutput dataclass

Bases: _SerdeShape

Dataclass for CreateRegistryOutput structure.

Attributes

registry_arn instance-attribute
registry_arn: str

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

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.