DeleteSchema - AWS Glue

DeleteSchema

Deletes the entire schema set, including the schema set and all of its versions. To get the status of the delete operation, you can call GetSchema API after the asynchronous call. Deleting a registry will deactivate all online operations for the schema, such as the GetSchemaByDefinition, and RegisterSchemaVersion APIs.

Request Syntax

{ "SchemaId": { "RegistryName": "string", "SchemaArn": "string", "SchemaName": "string" } }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

SchemaId

This is a wrapper structure that may contain the schema name and Amazon Resource Name (ARN).

Type: SchemaId object

Required: Yes

Response Syntax

{ "SchemaArn": "string", "SchemaName": "string", "Status": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

SchemaArn

The Amazon Resource Name (ARN) of the schema being deleted.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 10240.

Pattern: arn:(aws|aws-us-gov|aws-cn):glue:.*

SchemaName

The name of the schema being deleted.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [a-zA-Z0-9-_$#.]+

Status

The status of the schema.

Type: String

Valid Values: AVAILABLE | PENDING | DELETING

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

Access to a resource was denied.

HTTP Status Code: 400

ConcurrentModificationException

Two processes are trying to modify a resource simultaneously.

HTTP Status Code: 400

EntityNotFoundException

A specified entity does not exist

HTTP Status Code: 400

InvalidInputException

The input provided was not valid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: