Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13356598.3 KB
projects

Register a new version under a given subject with the given schema.

post/v1/{+parent}/versions

Path parameters

parentstring required

Required. The subject to create the version for. Structured like: projects/{project}/locations/{location}/schemaRegistries/{schema_registry}/subjects/{subject} or projects/{project}/locations/{location}/schemaRegistries/{schema_registry}/contexts/{context}/subjects/{subject}

Request body

schemastring

Required. The schema payload

normalizeboolean

Optional. If true, the schema will be normalized before being stored. The default is false.

schemaType'SCHEMA_TYPE_UNSPECIFIED' | 'AVRO' | 'JSON' | 'PROTOBUF'

Optional. The type of the schema. It is optional. If not specified, the schema type will be AVRO.

idinteger

Optional. The schema ID of the schema. If not specified, the schema ID will be generated by the server. If the schema ID is specified, it must not be used by an existing schema that is different from the schema to be created.

versioninteger

Optional. The version to create. It is optional. If not specified, the version will be created with the max version ID of the subject increased by 1. If the version ID is specified, it will be used as the new version ID and must not be used by an existing version of the subject.

Response

Successful response