Method: projects.locations.schemaRegistries.subjects.versions.delete

Delete a version of a subject. The response will be the deleted version id.

HTTP request

DELETE https://managedkafka.googleapis.com/v1/{name=projects/*/locations/*/schemaRegistries/*/subjects/*/versions/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the subject version to delete. Structured like: projects/{project}/locations/{location}/schemaRegistries/{schemaRegistry}/subjects/{subject}/versions/{version} or projects/{project}/locations/{location}/schemaRegistries/{schemaRegistry}/contexts/{context}/subjects/{subject}/versions/{version}

Query parameters

Parameters
permanent

boolean

Optional. If true, both the version and the referenced schema ID will be permanently deleted. The default is false. If false, the version will be deleted but the schema ID will be retained. Soft-deleted versions can still be searched in versions.list API call with deleted=true query parameter. A soft-delete of a version must be performed before a hard-delete.

Request body

The request body must be empty.

Response body

If successful, the response is a generic HTTP response whose format is defined by the method.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.