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

Delete a subject. The response will be an array of versions of the deleted subject.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

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

Query parameters

Parameters
permanent

boolean

Optional. If true, the subject and all associated metadata including the schema ID will be deleted permanently. Otherwise, only the subject is soft-deleted. The default is false. Soft-deleted subjects can still be searched in subjects.list API call with deleted=true query parameter. A soft-delete of a subject 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.