List Schema Versions - Amazon EventBridge Schemas

List Schema Versions

URI

/v1/registries/name/registryName/schemas/name/schemaName/versions

HTTP methods

GET

Operation ID: ListSchemaVersions

Provides a list of the schema versions and related information.

Path parameters
NameTypeRequiredDescription
registryNameStringTrue

The name of the schema registry.

schemaNameStringTrue

The name of the schema.

Query parameters
NameTypeRequiredDescription
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
200ListSchemaVersionsOutput

200 response

400ErrorOutput

400 response

401ErrorOutput

401 response

403ErrorOutput

403 response

404ErrorOutput

404 response

500ErrorOutput

500 response

503ErrorOutput

503 response

OPTIONS

Path parameters
NameTypeRequiredDescription
registryNameStringTrue

The name of the schema registry.

schemaNameStringTrue

The name of the schema.

Responses
Status codeResponse modelDescription
200None

200 response

Schemas

Response bodies

{ "NextToken": "string", "SchemaVersions": [ { "Type": "string", "SchemaVersion": "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.

ListSchemaVersionsOutput

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.

SchemaVersions

Array of type SchemaVersionSummary

False

An array of schema version summaries.

SchemaVersionSummary

PropertyTypeRequiredDescription
SchemaArn

string

False

The ARN of the schema version.

SchemaName

string

False

The name of the schema.

SchemaVersion

string

False

The version number of the schema.

Type

string

False

The type of schema to export.