Available in VPC
Delete a schema from a topic.
:::(Caution)
Deleting a schema may affect the serialization and deserialization of messages that use that schema. If you delete a topic, any schemas under that topic will also be deleted.
:::
Request
This section describes the request format. The method and URI are as follows:
| Method | URI |
|---|---|
| DELETE | /api/v1/topics/{topicId}/schemas/{resourceId} |
Request headers
For information about the headers common to all Data Stream APIs, see Data Stream request headers.
Request path parameters
You can use the following path parameters with your request:
| Field | Type | Required | Description |
|---|---|---|---|
topicId |
String | Required | Topic ID
|
resourceId |
String | Required | Schema resource ID
|
Request example
The request example is as follows:
curl --location --request DELETE 'https://datastream.apigw.ntruss.com/api/v1/topics/mgNWA*****/schemas/abc1*****' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
Response
This section describes the response format.
Response status codes
For information about the HTTP status codes common to all Data Stream APIs, see Data Stream response status codes.
Response example
If the schemas are successfully deleted, there is no response body, and a status code 200 is returned.
HTTP/1.1 200 OK