Skip to content

Api Gateway  >  Operations  >  create_model

create_model

Operation

create_model async

create_model(input: CreateModelInput, plugins: list[Plugin] | None = None) -> CreateModelOutput

Adds a new Model resource to an existing RestApi resource.

Parameters:

Name Type Description Default
input CreateModelInput

An instance of CreateModelInput.

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
CreateModelOutput

An instance of CreateModelOutput.

Input

CreateModelInput dataclass

Request to add a new Model to an existing RestApi resource.

Attributes

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

The content-type for the model.

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

The description of the model.

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

The name of the model. Must be alphanumeric.

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

The RestApi identifier under which the Model will be created.

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

The schema for the model. For application/json models, this should be JSON schema draft 4 model. The maximum size of the model is 400 KB.

Output

CreateModelOutput dataclass

Represents the data structure of a method's request or response payload.

Attributes

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

The content-type for the model.

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

The description of the model.

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

The identifier for the model resource.

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

The name of the model. Must be an alphanumeric string.

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

The schema for the model. For application/json models, this should be JSON schema draft 4 model. Do not include "*/" characters in the description of any properties because such "*/" characters may be interpreted as the closing marker for comments in some languages, such as Java or JavaScript, causing the installation of your API's SDK generated by API Gateway to fail.