Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

PutSchemaVersionMetadata

Puts the metadata key value pair for a specified schema version ID. A maximum of 10 key value pairs will be allowed per schema version. They can be added over one or more calls.

Request Syntax


{
   "MetadataKeyValue": { 
      "MetadataKey": "string",
      "MetadataValue": "string"
   },
   "SchemaId": { 
      "RegistryName": "string",
      "SchemaArn": "string",
      "SchemaName": "string"
   },
   "SchemaVersionId": "string",
   "SchemaVersionNumber": { 
      "LatestVersion": boolean,
      "VersionNumber": number
   }
}

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.

MetadataKeyValue

The metadata key's corresponding value.

Type: MetadataKeyValuePair object

Required: Yes

SchemaId

The unique ID for the schema.

Type: SchemaId object

Required: No

SchemaVersionId

The unique version ID of the schema version.

Type: String

Length Constraints: Fixed length of 36.

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

SchemaVersionNumber

The version number of the schema.

Type: SchemaVersionNumber object

Required: No

Response Syntax


{
   "LatestVersion": boolean,
   "MetadataKey": "string",
   "MetadataValue": "string",
   "RegistryName": "string",
   "SchemaArn": "string",
   "SchemaName": "string",
   "SchemaVersionId": "string",
   "VersionNumber": number
}

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.

LatestVersion

The latest version of the schema.

Type: Boolean

MetadataKey

The metadata key.

Type: String

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

Pattern: [a-zA-Z0-9+-=._./@]+

MetadataValue

The value of the metadata key.

Type: String

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

Pattern: [a-zA-Z0-9+-=._./@]+

RegistryName

The name for the registry.

Type: String

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

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

SchemaArn

The Amazon Resource Name (ARN) for the schema.

Type: String

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

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

SchemaName

The name for the schema.

Type: String

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

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

SchemaVersionId

The unique version ID of the schema version.

Type: String

Length Constraints: Fixed length of 36.

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

VersionNumber

The version number of the schema.

Type: Long

Valid Range: Minimum value of 1. Maximum value of 100000.

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

AlreadyExistsException

A resource to be created or added already exists.

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

ResourceNumberLimitExceededException

A resource numerical limit was exceeded.

HTTP Status Code: 400