Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_schema_version

get_schema_version(**kwargs)

Get the specified schema by its unique ID assigned when a version of the schema is created or registered. Schema versions in Deleted status will not be included in the results.

See also: AWS API Documentation

Request Syntax

response = client.get_schema_version(
    SchemaId={
        'SchemaArn': 'string',
        'SchemaName': 'string',
        'RegistryName': 'string'
    },
    SchemaVersionId='string',
    SchemaVersionNumber={
        'LatestVersion': True|False,
        'VersionNumber': 123
    }
)
Parameters
  • SchemaId (dict) --

    This is a wrapper structure to contain schema identity fields. The structure contains:

    • SchemaId$SchemaArn: The Amazon Resource Name (ARN) of the schema. Either SchemaArn or SchemaName and RegistryName has to be provided.
    • SchemaId$SchemaName: The name of the schema. Either SchemaArn or SchemaName and RegistryName has to be provided.
    • SchemaArn (string) --

      The Amazon Resource Name (ARN) of the schema. One of SchemaArn or SchemaName has to be provided.

    • SchemaName (string) --

      The name of the schema. One of SchemaArn or SchemaName has to be provided.

    • RegistryName (string) --

      The name of the schema registry that contains the schema.

  • SchemaVersionId (string) -- The SchemaVersionId of the schema version. This field is required for fetching by schema ID. Either this or the SchemaId wrapper has to be provided.
  • SchemaVersionNumber (dict) --

    The version number of the schema.

    • LatestVersion (boolean) --

      The latest version available for the schema.

    • VersionNumber (integer) --

      The version number of the schema.

Return type

dict

Returns

Response Syntax

{
    'SchemaVersionId': 'string',
    'SchemaDefinition': 'string',
    'DataFormat': 'AVRO'|'JSON'|'PROTOBUF',
    'SchemaArn': 'string',
    'VersionNumber': 123,
    'Status': 'AVAILABLE'|'PENDING'|'FAILURE'|'DELETING',
    'CreatedTime': 'string'
}

Response Structure

  • (dict) --

    • SchemaVersionId (string) --

      The SchemaVersionId of the schema version.

    • SchemaDefinition (string) --

      The schema definition for the schema ID.

    • DataFormat (string) --

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

    • SchemaArn (string) --

      The Amazon Resource Name (ARN) of the schema.

    • VersionNumber (integer) --

      The version number of the schema.

    • Status (string) --

      The status of the schema version.

    • CreatedTime (string) --

      The date and time the schema version was created.

Exceptions

  • Glue.Client.exceptions.InvalidInputException
  • Glue.Client.exceptions.AccessDeniedException
  • Glue.Client.exceptions.EntityNotFoundException
  • Glue.Client.exceptions.InternalServiceException