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
Name	Type	Required	Description
registryName	String	True	The name of the schema registry.
schemaName	String	True	The name of the schema.

Query parameters
Name	Type	Required	Description
limit	String	False	The maximum number of results to return per page.
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.

Responses
Status code	Response model	Description
200	ListSchemaVersionsOutput	200 response
400	ErrorOutput	400 response
401	ErrorOutput	401 response
403	ErrorOutput	403 response
404	ErrorOutput	404 response
500	ErrorOutput	500 response
503	ErrorOutput	503 response

OPTIONS

Path parameters
Name	Type	Required	Description
registryName	String	True	The name of the schema registry.
schemaName	String	True	The name of the schema.

Responses
Status code	Response model	Description
200	None	200 response

Schemas

Response bodies

ListSchemaVersionsOutput schema

{
  "NextToken": "string",
  "SchemaVersions": [
    {
      "Type": "string",
      "SchemaVersion": "string",
      "SchemaName": "string",
      "SchemaArn": "string"
    }
  ]
}

ErrorOutput schema

{
  "Message": "string",
  "Code": "string"
}

Properties

ErrorOutput

Property	Type	Required	Description
Code	string	True	The error code.
Message	string	True	The message string of the error output.

ListSchemaVersionsOutput

Property	Type	Required	Description
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

Property	Type	Required	Description
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.