Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142021,119944.8 KB

Retrieves a schema by the <code>SchemaDefinition</code>. The schema definition is sent to the Schema Registry, canonicalized, and hashed. If the hash is matched within the scope of the <code>SchemaName</code> or ARN (or the default registry, if none is supplied), that schema’s metadata is returned. Otherwise, a 404 or NotFound error is returned. Schema versions in <code>Deleted</code> statuses will not be included in the results.

post/#X-Amz-Target=AWSGlue.GetSchemaByDefinition

Headers

X-Amz-Target'AWSGlue.GetSchemaByDefinition' required

Request body

SchemaDefinitionstring required

The definition of the schema for which schema details are required.

Response

Success

SchemaVersionIdstring

The schema ID of the schema version.

SchemaArnstring

The Amazon Resource Name (ARN) of the schema.

DataFormat'AVRO' | 'JSON' | 'PROTOBUF'

The data format of the schema definition. Currently <code>AVRO</code>, <code>JSON</code> and <code>PROTOBUF</code> are supported.

Status'AVAILABLE' | 'PENDING' | 'FAILURE' | 'DELETING'

The status of the schema version.

CreatedTimestring

The date and time the schema was created.