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