Search Schemas - Amazon EventBridge Schemas

Search Schemas

URI

/v1/registries/name/registryName/schemas/search

HTTP methods

GET

Operation ID: SearchSchemas

Search the schemas

Path parameters
NameTypeRequiredDescription
registryNameStringTrue

The name of the schema registry.

Query parameters
NameTypeRequiredDescription
keywordsStringTrue

Specifying this limits the results to only schemas that include the provided keywords.

limitStringFalse

The maximum number of results to return per page.

nextTokenStringFalse

The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.

Responses
Status codeResponse modelDescription
200SearchSchemasOutput

200 response

400ErrorOutput

400 response

401ErrorOutput

401 response

403ErrorOutput

403 response

500ErrorOutput

500 response

503ErrorOutput

503 response

OPTIONS

Path parameters
NameTypeRequiredDescription
registryNameStringTrue

The name of the schema registry.

Responses
Status codeResponse modelDescription
200None

200 response

Schemas

Response bodies

{ "NextToken": "string", "Schemas": [ { "Type": "string", "RegistryName": "string", "SchemaVersions": [ { "SchemaVersion": "string", "CreatedDate": "string" } ], "SchemaName": "string", "SchemaArn": "string" } ] }
{ "Message": "string", "Code": "string" }

Properties

ErrorOutput

PropertyTypeRequiredDescription
Code

string

True

The error code.

Message

string

True

The message string of the error output.

SearchSchemaSummary

PropertyTypeRequiredDescription
RegistryName

string

False

The name of the registry.

SchemaArn

string

False

The ARN of the schema.

SchemaName

string

False

The name of the schema.

SchemaVersions

Array of type SearchSchemaVersionSummary

False

An array of schema version summaries.

Type

string

False

The type of schema to export.

Valid types include OpenApi3 and JSONSchemaDraft4.

SearchSchemaVersionSummary

PropertyTypeRequiredDescription
CreatedDate

string

Format: date-time

False

The date the schema version was created.

SchemaVersion

string

False

The version number of the schema

SearchSchemasOutput

PropertyTypeRequiredDescription
NextToken

string

False

The token that specifies the next page of results to return. To request the first page, leave NextToken empty. The token will expire in 24 hours, and cannot be shared with other accounts.

Schemas

Array of type SearchSchemaSummary

False

An array of SearchSchemaSummary information.