NAME

Paws::Glue::CreateSchema - Arguments for method CreateSchema on Paws::Glue

DESCRIPTION

This class represents the parameters used for calling the method CreateSchema on the AWS Glue service. Use the attributes of this class as arguments to method CreateSchema.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateSchema.

SYNOPSIS

    my $glue = Paws->service('Glue');
    my $CreateSchemaResponse = $glue->CreateSchema(
      DataFormat    => 'AVRO',
      SchemaName    => 'MySchemaRegistryNameString',
      Compatibility => 'NONE',                         # OPTIONAL
      Description   => 'MyDescriptionString',          # OPTIONAL
      RegistryId    => {
        RegistryArn  => 'MyGlueResourceArn',    # min: 1, max: 10240; OPTIONAL
        RegistryName => 'MySchemaRegistryNameString',    # min: 1, max: 255
      },    # OPTIONAL
      SchemaDefinition => 'MySchemaDefinitionString',    # OPTIONAL
      Tags             => {
        'MyTagKey' => 'MyTagValue',    # key: min: 1, max: 128, value: max: 256
      },    # OPTIONAL
    );
    # Results:
    my $Compatibility       = $CreateSchemaResponse->Compatibility;
    my $DataFormat          = $CreateSchemaResponse->DataFormat;
    my $Description         = $CreateSchemaResponse->Description;
    my $LatestSchemaVersion = $CreateSchemaResponse->LatestSchemaVersion;
    my $NextSchemaVersion   = $CreateSchemaResponse->NextSchemaVersion;
    my $RegistryArn         = $CreateSchemaResponse->RegistryArn;
    my $RegistryName        = $CreateSchemaResponse->RegistryName;
    my $SchemaArn           = $CreateSchemaResponse->SchemaArn;
    my $SchemaCheckpoint    = $CreateSchemaResponse->SchemaCheckpoint;
    my $SchemaName          = $CreateSchemaResponse->SchemaName;
    my $SchemaStatus        = $CreateSchemaResponse->SchemaStatus;
    my $SchemaVersionId     = $CreateSchemaResponse->SchemaVersionId;
    my $SchemaVersionStatus = $CreateSchemaResponse->SchemaVersionStatus;
    my $Tags                = $CreateSchemaResponse->Tags;
    # Returns a L<Paws::Glue::CreateSchemaResponse> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/glue/CreateSchema>

ATTRIBUTES

Compatibility => Str

The compatibility mode of the schema. The possible values are:

NONE: No compatibility mode applies. You can use this choice in development scenarios or if you do not know the compatibility mode that you want to apply to schemas. Any new version added will be accepted without undergoing a compatibility check.
DISABLED: This compatibility choice prevents versioning for a particular schema. You can use this choice to prevent future versioning of a schema.
BACKWARD: This compatibility choice is recommended as it allows data receivers to read both the current and one previous schema version. This means that for instance, a new schema version cannot drop data fields or change the type of these fields, so they can't be read by readers using the previous version.
BACKWARD_ALL: This compatibility choice allows data receivers to read both the current and all previous schema versions. You can use this choice when you need to delete fields or add optional fields, and check compatibility against all previous schema versions.
FORWARD: This compatibility choice allows data receivers to read both the current and one next schema version, but not necessarily later versions. You can use this choice when you need to add fields or delete optional fields, but only check compatibility against the last schema version.
FORWARD_ALL: This compatibility choice allows data receivers to read written by producers of any new registered schema. You can use this choice when you need to add fields or delete optional fields, and check compatibility against all previous schema versions.
FULL: This compatibility choice allows data receivers to read data written by producers using the previous or next version of the schema, but not necessarily earlier or later versions. You can use this choice when you need to add or remove optional fields, but only check compatibility against the last schema version.
FULL_ALL: This compatibility choice allows data receivers to read data written by producers using all previous schema versions. You can use this choice when you need to add or remove optional fields, and check compatibility against all previous schema versions.

Valid values are: "NONE", "DISABLED", "BACKWARD", "BACKWARD_ALL", "FORWARD", "FORWARD_ALL", "FULL", "FULL_ALL"

REQUIRED DataFormat => Str

The data format of the schema definition. Currently "AVRO" and "JSON" are supported.

Valid values are: "AVRO", "JSON"

Description => Str

An optional description of the schema. If description is not provided, there will not be any automatic default value for this.

RegistryId => Paws::Glue::RegistryId

This is a wrapper shape to contain the registry identity fields. If this is not provided, the default registry will be used. The ARN format for the same will be: "arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id".

SchemaDefinition => Str

The schema definition using the "DataFormat" setting for "SchemaName".

REQUIRED SchemaName => Str

Name of the schema to be created of max length of 255, and may only contain letters, numbers, hyphen, underscore, dollar sign, or hash mark. No whitespace.

Tags => Paws::Glue::TagsMap

Amazon Web Services tags that contain a key value pair and may be searched by console, command line, or API. If specified, follows the Amazon Web Services tags-on-create pattern.

BUGS and CONTRIBUTIONS

The source code is located here: <https://github.com/pplu/aws-sdk-perl>

Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>