AddApplicationCloudWatchLoggingOption

$result = $client->addApplicationCloudWatchLoggingOption([/* ... */]);
$promise = $client->addApplicationCloudWatchLoggingOptionAsync([/* ... */]);

Adds an Amazon CloudWatch log stream to monitor application configuration errors.

Parameter Syntax

$result = $client->addApplicationCloudWatchLoggingOption([
    'ApplicationName' => '<string>', // REQUIRED
    'CloudWatchLoggingOption' => [ // REQUIRED
        'LogStreamARN' => '<string>', // REQUIRED
    ],
    'ConditionalToken' => '<string>',
    'CurrentApplicationVersionId' => <integer>,
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'CloudWatchLoggingOptionDescriptions' => [
        [
            'CloudWatchLoggingOptionId' => '<string>',
            'LogStreamARN' => '<string>',
            'RoleARN' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

AddApplicationInput

$result = $client->addApplicationInput([/* ... */]);
$promise = $client->addApplicationInputAsync([/* ... */]);

Adds a streaming source to your SQL-based Kinesis Data Analytics application.

You can add a streaming source when you create an application, or you can use this operation to add a streaming source after you create an application. For more information, see CreateApplication.

Any configuration update, including adding a streaming source using this operation, results in a new version of the application. You can use the DescribeApplication operation to find the current application version.

Parameter Syntax

$result = $client->addApplicationInput([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'Input' => [ // REQUIRED
        'InputParallelism' => [
            'Count' => <integer>,
        ],
        'InputProcessingConfiguration' => [
            'InputLambdaProcessor' => [ // REQUIRED
                'ResourceARN' => '<string>', // REQUIRED
            ],
        ],
        'InputSchema' => [ // REQUIRED
            'RecordColumns' => [ // REQUIRED
                [
                    'Mapping' => '<string>',
                    'Name' => '<string>', // REQUIRED
                    'SqlType' => '<string>', // REQUIRED
                ],
                // ...
            ],
            'RecordEncoding' => '<string>',
            'RecordFormat' => [ // REQUIRED
                'MappingParameters' => [
                    'CSVMappingParameters' => [
                        'RecordColumnDelimiter' => '<string>', // REQUIRED
                        'RecordRowDelimiter' => '<string>', // REQUIRED
                    ],
                    'JSONMappingParameters' => [
                        'RecordRowPath' => '<string>', // REQUIRED
                    ],
                ],
                'RecordFormatType' => 'JSON|CSV', // REQUIRED
            ],
        ],
        'KinesisFirehoseInput' => [
            'ResourceARN' => '<string>', // REQUIRED
        ],
        'KinesisStreamsInput' => [
            'ResourceARN' => '<string>', // REQUIRED
        ],
        'NamePrefix' => '<string>', // REQUIRED
    ],
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'InputDescriptions' => [
        [
            'InAppStreamNames' => ['<string>', ...],
            'InputId' => '<string>',
            'InputParallelism' => [
                'Count' => <integer>,
            ],
            'InputProcessingConfigurationDescription' => [
                'InputLambdaProcessorDescription' => [
                    'ResourceARN' => '<string>',
                    'RoleARN' => '<string>',
                ],
            ],
            'InputSchema' => [
                'RecordColumns' => [
                    [
                        'Mapping' => '<string>',
                        'Name' => '<string>',
                        'SqlType' => '<string>',
                    ],
                    // ...
                ],
                'RecordEncoding' => '<string>',
                'RecordFormat' => [
                    'MappingParameters' => [
                        'CSVMappingParameters' => [
                            'RecordColumnDelimiter' => '<string>',
                            'RecordRowDelimiter' => '<string>',
                        ],
                        'JSONMappingParameters' => [
                            'RecordRowPath' => '<string>',
                        ],
                    ],
                    'RecordFormatType' => 'JSON|CSV',
                ],
            ],
            'InputStartingPositionConfiguration' => [
                'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
            ],
            'KinesisFirehoseInputDescription' => [
                'ResourceARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            'KinesisStreamsInputDescription' => [
                'ResourceARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            'NamePrefix' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

CodeValidationException:

The user-provided application code (query) is not valid. This can be a simple syntax error.

InvalidRequestException:

The request JSON is not valid for the operation.

AddApplicationInputProcessingConfiguration

$result = $client->addApplicationInputProcessingConfiguration([/* ... */]);
$promise = $client->addApplicationInputProcessingConfigurationAsync([/* ... */]);

Adds an InputProcessingConfiguration to a SQL-based Kinesis Data Analytics application. An input processor pre-processes records on the input stream before the application's SQL code executes. Currently, the only input processor available is Amazon Lambda.

Parameter Syntax

$result = $client->addApplicationInputProcessingConfiguration([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'InputId' => '<string>', // REQUIRED
    'InputProcessingConfiguration' => [ // REQUIRED
        'InputLambdaProcessor' => [ // REQUIRED
            'ResourceARN' => '<string>', // REQUIRED
        ],
    ],
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'InputId' => '<string>',
    'InputProcessingConfigurationDescription' => [
        'InputLambdaProcessorDescription' => [
            'ResourceARN' => '<string>',
            'RoleARN' => '<string>',
        ],
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

AddApplicationOutput

$result = $client->addApplicationOutput([/* ... */]);
$promise = $client->addApplicationOutputAsync([/* ... */]);

Adds an external destination to your SQL-based Kinesis Data Analytics application.

If you want Kinesis Data Analytics to deliver data from an in-application stream within your application to an external destination (such as an Kinesis data stream, a Kinesis Data Firehose delivery stream, or an Amazon Lambda function), you add the relevant configuration to your application using this operation. You can configure one or more outputs for your application. Each output configuration maps an in-application stream and an external destination.

You can use one of the output configurations to deliver data from your in-application error stream to an external destination so that you can analyze the errors.

Any configuration update, including adding a streaming source using this operation, results in a new version of the application. You can use the DescribeApplication operation to find the current application version.

Parameter Syntax

$result = $client->addApplicationOutput([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'Output' => [ // REQUIRED
        'DestinationSchema' => [ // REQUIRED
            'RecordFormatType' => 'JSON|CSV', // REQUIRED
        ],
        'KinesisFirehoseOutput' => [
            'ResourceARN' => '<string>', // REQUIRED
        ],
        'KinesisStreamsOutput' => [
            'ResourceARN' => '<string>', // REQUIRED
        ],
        'LambdaOutput' => [
            'ResourceARN' => '<string>', // REQUIRED
        ],
        'Name' => '<string>', // REQUIRED
    ],
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'OutputDescriptions' => [
        [
            'DestinationSchema' => [
                'RecordFormatType' => 'JSON|CSV',
            ],
            'KinesisFirehoseOutputDescription' => [
                'ResourceARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            'KinesisStreamsOutputDescription' => [
                'ResourceARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            'LambdaOutputDescription' => [
                'ResourceARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            'Name' => '<string>',
            'OutputId' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

AddApplicationReferenceDataSource

$result = $client->addApplicationReferenceDataSource([/* ... */]);
$promise = $client->addApplicationReferenceDataSourceAsync([/* ... */]);

Adds a reference data source to an existing SQL-based Kinesis Data Analytics application.

Kinesis Data Analytics reads reference data (that is, an Amazon S3 object) and creates an in-application table within your application. In the request, you provide the source (S3 bucket name and object key name), name of the in-application table to create, and the necessary mapping information that describes how data in an Amazon S3 object maps to columns in the resulting in-application table.

Parameter Syntax

$result = $client->addApplicationReferenceDataSource([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'ReferenceDataSource' => [ // REQUIRED
        'ReferenceSchema' => [ // REQUIRED
            'RecordColumns' => [ // REQUIRED
                [
                    'Mapping' => '<string>',
                    'Name' => '<string>', // REQUIRED
                    'SqlType' => '<string>', // REQUIRED
                ],
                // ...
            ],
            'RecordEncoding' => '<string>',
            'RecordFormat' => [ // REQUIRED
                'MappingParameters' => [
                    'CSVMappingParameters' => [
                        'RecordColumnDelimiter' => '<string>', // REQUIRED
                        'RecordRowDelimiter' => '<string>', // REQUIRED
                    ],
                    'JSONMappingParameters' => [
                        'RecordRowPath' => '<string>', // REQUIRED
                    ],
                ],
                'RecordFormatType' => 'JSON|CSV', // REQUIRED
            ],
        ],
        'S3ReferenceDataSource' => [
            'BucketARN' => '<string>',
            'FileKey' => '<string>',
        ],
        'TableName' => '<string>', // REQUIRED
    ],
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'ReferenceDataSourceDescriptions' => [
        [
            'ReferenceId' => '<string>',
            'ReferenceSchema' => [
                'RecordColumns' => [
                    [
                        'Mapping' => '<string>',
                        'Name' => '<string>',
                        'SqlType' => '<string>',
                    ],
                    // ...
                ],
                'RecordEncoding' => '<string>',
                'RecordFormat' => [
                    'MappingParameters' => [
                        'CSVMappingParameters' => [
                            'RecordColumnDelimiter' => '<string>',
                            'RecordRowDelimiter' => '<string>',
                        ],
                        'JSONMappingParameters' => [
                            'RecordRowPath' => '<string>',
                        ],
                    ],
                    'RecordFormatType' => 'JSON|CSV',
                ],
            ],
            'S3ReferenceDataSourceDescription' => [
                'BucketARN' => '<string>',
                'FileKey' => '<string>',
                'ReferenceRoleARN' => '<string>',
            ],
            'TableName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

AddApplicationVpcConfiguration

$result = $client->addApplicationVpcConfiguration([/* ... */]);
$promise = $client->addApplicationVpcConfigurationAsync([/* ... */]);

Adds a Virtual Private Cloud (VPC) configuration to the application. Applications can use VPCs to store and access resources securely.

Note the following about VPC configurations for Managed Service for Apache Flink applications:

• VPC configurations are not supported for SQL applications.

• When a VPC is added to a Managed Service for Apache Flink application, the application can no longer be accessed from the Internet directly. To enable Internet access to the application, add an Internet gateway to your VPC.

Parameter Syntax

$result = $client->addApplicationVpcConfiguration([
    'ApplicationName' => '<string>', // REQUIRED
    'ConditionalToken' => '<string>',
    'CurrentApplicationVersionId' => <integer>,
    'VpcConfiguration' => [ // REQUIRED
        'SecurityGroupIds' => ['<string>', ...], // REQUIRED
        'SubnetIds' => ['<string>', ...], // REQUIRED
    ],
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'VpcConfigurationDescription' => [
        'SecurityGroupIds' => ['<string>', ...],
        'SubnetIds' => ['<string>', ...],
        'VpcConfigurationId' => '<string>',
        'VpcId' => '<string>',
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

CreateApplication

$result = $client->createApplication([/* ... */]);
$promise = $client->createApplicationAsync([/* ... */]);

Creates a Managed Service for Apache Flink application. For information about creating a Managed Service for Apache Flink application, see Creating an Application.

Parameter Syntax

$result = $client->createApplication([
    'ApplicationConfiguration' => [
        'ApplicationCodeConfiguration' => [
            'CodeContent' => [
                'S3ContentLocation' => [
                    'BucketARN' => '<string>', // REQUIRED
                    'FileKey' => '<string>', // REQUIRED
                    'ObjectVersion' => '<string>',
                ],
                'TextContent' => '<string>',
                'ZipFileContent' => <string || resource || Psr\Http\Message\StreamInterface>,
            ],
            'CodeContentType' => 'PLAINTEXT|ZIPFILE', // REQUIRED
        ],
        'ApplicationSnapshotConfiguration' => [
            'SnapshotsEnabled' => true || false, // REQUIRED
        ],
        'EnvironmentProperties' => [
            'PropertyGroups' => [ // REQUIRED
                [
                    'PropertyGroupId' => '<string>', // REQUIRED
                    'PropertyMap' => ['<string>', ...], // REQUIRED
                ],
                // ...
            ],
        ],
        'FlinkApplicationConfiguration' => [
            'CheckpointConfiguration' => [
                'CheckpointInterval' => <integer>,
                'CheckpointingEnabled' => true || false,
                'ConfigurationType' => 'DEFAULT|CUSTOM', // REQUIRED
                'MinPauseBetweenCheckpoints' => <integer>,
            ],
            'MonitoringConfiguration' => [
                'ConfigurationType' => 'DEFAULT|CUSTOM', // REQUIRED
                'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                'MetricsLevel' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
            ],
            'ParallelismConfiguration' => [
                'AutoScalingEnabled' => true || false,
                'ConfigurationType' => 'DEFAULT|CUSTOM', // REQUIRED
                'Parallelism' => <integer>,
                'ParallelismPerKPU' => <integer>,
            ],
        ],
        'SqlApplicationConfiguration' => [
            'Inputs' => [
                [
                    'InputParallelism' => [
                        'Count' => <integer>,
                    ],
                    'InputProcessingConfiguration' => [
                        'InputLambdaProcessor' => [ // REQUIRED
                            'ResourceARN' => '<string>', // REQUIRED
                        ],
                    ],
                    'InputSchema' => [ // REQUIRED
                        'RecordColumns' => [ // REQUIRED
                            [
                                'Mapping' => '<string>',
                                'Name' => '<string>', // REQUIRED
                                'SqlType' => '<string>', // REQUIRED
                            ],
                            // ...
                        ],
                        'RecordEncoding' => '<string>',
                        'RecordFormat' => [ // REQUIRED
                            'MappingParameters' => [
                                'CSVMappingParameters' => [
                                    'RecordColumnDelimiter' => '<string>', // REQUIRED
                                    'RecordRowDelimiter' => '<string>', // REQUIRED
                                ],
                                'JSONMappingParameters' => [
                                    'RecordRowPath' => '<string>', // REQUIRED
                                ],
                            ],
                            'RecordFormatType' => 'JSON|CSV', // REQUIRED
                        ],
                    ],
                    'KinesisFirehoseInput' => [
                        'ResourceARN' => '<string>', // REQUIRED
                    ],
                    'KinesisStreamsInput' => [
                        'ResourceARN' => '<string>', // REQUIRED
                    ],
                    'NamePrefix' => '<string>', // REQUIRED
                ],
                // ...
            ],
            'Outputs' => [
                [
                    'DestinationSchema' => [ // REQUIRED
                        'RecordFormatType' => 'JSON|CSV', // REQUIRED
                    ],
                    'KinesisFirehoseOutput' => [
                        'ResourceARN' => '<string>', // REQUIRED
                    ],
                    'KinesisStreamsOutput' => [
                        'ResourceARN' => '<string>', // REQUIRED
                    ],
                    'LambdaOutput' => [
                        'ResourceARN' => '<string>', // REQUIRED
                    ],
                    'Name' => '<string>', // REQUIRED
                ],
                // ...
            ],
            'ReferenceDataSources' => [
                [
                    'ReferenceSchema' => [ // REQUIRED
                        'RecordColumns' => [ // REQUIRED
                            [
                                'Mapping' => '<string>',
                                'Name' => '<string>', // REQUIRED
                                'SqlType' => '<string>', // REQUIRED
                            ],
                            // ...
                        ],
                        'RecordEncoding' => '<string>',
                        'RecordFormat' => [ // REQUIRED
                            'MappingParameters' => [
                                'CSVMappingParameters' => [
                                    'RecordColumnDelimiter' => '<string>', // REQUIRED
                                    'RecordRowDelimiter' => '<string>', // REQUIRED
                                ],
                                'JSONMappingParameters' => [
                                    'RecordRowPath' => '<string>', // REQUIRED
                                ],
                            ],
                            'RecordFormatType' => 'JSON|CSV', // REQUIRED
                        ],
                    ],
                    'S3ReferenceDataSource' => [
                        'BucketARN' => '<string>',
                        'FileKey' => '<string>',
                    ],
                    'TableName' => '<string>', // REQUIRED
                ],
                // ...
            ],
        ],
        'VpcConfigurations' => [
            [
                'SecurityGroupIds' => ['<string>', ...], // REQUIRED
                'SubnetIds' => ['<string>', ...], // REQUIRED
            ],
            // ...
        ],
        'ZeppelinApplicationConfiguration' => [
            'CatalogConfiguration' => [
                'GlueDataCatalogConfiguration' => [ // REQUIRED
                    'DatabaseARN' => '<string>', // REQUIRED
                ],
            ],
            'CustomArtifactsConfiguration' => [
                [
                    'ArtifactType' => 'UDF|DEPENDENCY_JAR', // REQUIRED
                    'MavenReference' => [
                        'ArtifactId' => '<string>', // REQUIRED
                        'GroupId' => '<string>', // REQUIRED
                        'Version' => '<string>', // REQUIRED
                    ],
                    'S3ContentLocation' => [
                        'BucketARN' => '<string>', // REQUIRED
                        'FileKey' => '<string>', // REQUIRED
                        'ObjectVersion' => '<string>',
                    ],
                ],
                // ...
            ],
            'DeployAsApplicationConfiguration' => [
                'S3ContentLocation' => [ // REQUIRED
                    'BasePath' => '<string>',
                    'BucketARN' => '<string>', // REQUIRED
                ],
            ],
            'MonitoringConfiguration' => [
                'LogLevel' => 'INFO|WARN|ERROR|DEBUG', // REQUIRED
            ],
        ],
    ],
    'ApplicationDescription' => '<string>',
    'ApplicationMode' => 'STREAMING|INTERACTIVE',
    'ApplicationName' => '<string>', // REQUIRED
    'CloudWatchLoggingOptions' => [
        [
            'LogStreamARN' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18', // REQUIRED
    'ServiceExecutionRole' => '<string>', // REQUIRED
    'Tags' => [
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[
    'ApplicationDetail' => [
        'ApplicationARN' => '<string>',
        'ApplicationConfigurationDescription' => [
            'ApplicationCodeConfigurationDescription' => [
                'CodeContentDescription' => [
                    'CodeMD5' => '<string>',
                    'CodeSize' => <integer>,
                    'S3ApplicationCodeLocationDescription' => [
                        'BucketARN' => '<string>',
                        'FileKey' => '<string>',
                        'ObjectVersion' => '<string>',
                    ],
                    'TextContent' => '<string>',
                ],
                'CodeContentType' => 'PLAINTEXT|ZIPFILE',
            ],
            'ApplicationSnapshotConfigurationDescription' => [
                'SnapshotsEnabled' => true || false,
            ],
            'EnvironmentPropertyDescriptions' => [
                'PropertyGroupDescriptions' => [
                    [
                        'PropertyGroupId' => '<string>',
                        'PropertyMap' => ['<string>', ...],
                    ],
                    // ...
                ],
            ],
            'FlinkApplicationConfigurationDescription' => [
                'CheckpointConfigurationDescription' => [
                    'CheckpointInterval' => <integer>,
                    'CheckpointingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'MinPauseBetweenCheckpoints' => <integer>,
                ],
                'JobPlanDescription' => '<string>',
                'MonitoringConfigurationDescription' => [
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                    'MetricsLevel' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
                ],
                'ParallelismConfigurationDescription' => [
                    'AutoScalingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'CurrentParallelism' => <integer>,
                    'Parallelism' => <integer>,
                    'ParallelismPerKPU' => <integer>,
                ],
            ],
            'RunConfigurationDescription' => [
                'ApplicationRestoreConfigurationDescription' => [
                    'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT',
                    'SnapshotName' => '<string>',
                ],
                'FlinkRunConfigurationDescription' => [
                    'AllowNonRestoredState' => true || false,
                ],
            ],
            'SqlApplicationConfigurationDescription' => [
                'InputDescriptions' => [
                    [
                        'InAppStreamNames' => ['<string>', ...],
                        'InputId' => '<string>',
                        'InputParallelism' => [
                            'Count' => <integer>,
                        ],
                        'InputProcessingConfigurationDescription' => [
                            'InputLambdaProcessorDescription' => [
                                'ResourceARN' => '<string>',
                                'RoleARN' => '<string>',
                            ],
                        ],
                        'InputSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'InputStartingPositionConfiguration' => [
                            'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
                        ],
                        'KinesisFirehoseInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'NamePrefix' => '<string>',
                    ],
                    // ...
                ],
                'OutputDescriptions' => [
                    [
                        'DestinationSchema' => [
                            'RecordFormatType' => 'JSON|CSV',
                        ],
                        'KinesisFirehoseOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'LambdaOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'Name' => '<string>',
                        'OutputId' => '<string>',
                    ],
                    // ...
                ],
                'ReferenceDataSourceDescriptions' => [
                    [
                        'ReferenceId' => '<string>',
                        'ReferenceSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'S3ReferenceDataSourceDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ReferenceRoleARN' => '<string>',
                        ],
                        'TableName' => '<string>',
                    ],
                    // ...
                ],
            ],
            'VpcConfigurationDescriptions' => [
                [
                    'SecurityGroupIds' => ['<string>', ...],
                    'SubnetIds' => ['<string>', ...],
                    'VpcConfigurationId' => '<string>',
                    'VpcId' => '<string>',
                ],
                // ...
            ],
            'ZeppelinApplicationConfigurationDescription' => [
                'CatalogConfigurationDescription' => [
                    'GlueDataCatalogConfigurationDescription' => [
                        'DatabaseARN' => '<string>',
                    ],
                ],
                'CustomArtifactsConfigurationDescription' => [
                    [
                        'ArtifactType' => 'UDF|DEPENDENCY_JAR',
                        'MavenReferenceDescription' => [
                            'ArtifactId' => '<string>',
                            'GroupId' => '<string>',
                            'Version' => '<string>',
                        ],
                        'S3ContentLocationDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ObjectVersion' => '<string>',
                        ],
                    ],
                    // ...
                ],
                'DeployAsApplicationConfigurationDescription' => [
                    'S3ContentLocationDescription' => [
                        'BasePath' => '<string>',
                        'BucketARN' => '<string>',
                    ],
                ],
                'MonitoringConfigurationDescription' => [
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                ],
            ],
        ],
        'ApplicationDescription' => '<string>',
        'ApplicationMaintenanceConfigurationDescription' => [
            'ApplicationMaintenanceWindowEndTime' => '<string>',
            'ApplicationMaintenanceWindowStartTime' => '<string>',
        ],
        'ApplicationMode' => 'STREAMING|INTERACTIVE',
        'ApplicationName' => '<string>',
        'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
        'ApplicationVersionId' => <integer>,
        'ApplicationVersionRolledBackFrom' => <integer>,
        'ApplicationVersionRolledBackTo' => <integer>,
        'ApplicationVersionUpdatedFrom' => <integer>,
        'CloudWatchLoggingOptionDescriptions' => [
            [
                'CloudWatchLoggingOptionId' => '<string>',
                'LogStreamARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            // ...
        ],
        'ConditionalToken' => '<string>',
        'CreateTimestamp' => <DateTime>,
        'LastUpdateTimestamp' => <DateTime>,
        'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        'ServiceExecutionRole' => '<string>',
    ],
]

Result Details

Errors

CodeValidationException:

The user-provided application code (query) is not valid. This can be a simple syntax error.

ResourceInUseException:

The application is not available for this operation.

LimitExceededException:

The number of allowed resources has been exceeded.

InvalidArgumentException:

The specified input parameter value is not valid.

InvalidRequestException:

The request JSON is not valid for the operation.

TooManyTagsException:

Application created with too many tags, or too many tags added to an application. Note that the maximum number of application tags includes system tags. The maximum number of user-defined application tags is 50.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

CreateApplicationPresignedUrl

$result = $client->createApplicationPresignedUrl([/* ... */]);
$promise = $client->createApplicationPresignedUrlAsync([/* ... */]);

Creates and returns a URL that you can use to connect to an application's extension.

The IAM role or user used to call this API defines the permissions to access the extension. After the presigned URL is created, no additional permission is required to access this URL. IAM authorization policies for this API are also enforced for every HTTP request that attempts to connect to the extension.

You control the amount of time that the URL will be valid using the SessionExpirationDurationInSeconds parameter. If you do not provide this parameter, the returned URL is valid for twelve hours.

Parameter Syntax

$result = $client->createApplicationPresignedUrl([
    'ApplicationName' => '<string>', // REQUIRED
    'SessionExpirationDurationInSeconds' => <integer>,
    'UrlType' => 'FLINK_DASHBOARD_URL|ZEPPELIN_UI_URL', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'AuthorizedUrl' => '<string>',
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

CreateApplicationSnapshot

$result = $client->createApplicationSnapshot([/* ... */]);
$promise = $client->createApplicationSnapshotAsync([/* ... */]);

Creates a snapshot of the application's state data.

Parameter Syntax

$result = $client->createApplicationSnapshot([
    'ApplicationName' => '<string>', // REQUIRED
    'SnapshotName' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ResourceInUseException:

The application is not available for this operation.

ResourceNotFoundException:

Specified application can't be found.

LimitExceededException:

The number of allowed resources has been exceeded.

InvalidArgumentException:

The specified input parameter value is not valid.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

InvalidRequestException:

The request JSON is not valid for the operation.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

DeleteApplication

$result = $client->deleteApplication([/* ... */]);
$promise = $client->deleteApplicationAsync([/* ... */]);

Deletes the specified application. Managed Service for Apache Flink halts application execution and deletes the application.

Parameter Syntax

$result = $client->deleteApplication([
    'ApplicationName' => '<string>', // REQUIRED
    'CreateTimestamp' => <integer || string || DateTime>, // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

InvalidRequestException:

The request JSON is not valid for the operation.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

DeleteApplicationCloudWatchLoggingOption

$result = $client->deleteApplicationCloudWatchLoggingOption([/* ... */]);
$promise = $client->deleteApplicationCloudWatchLoggingOptionAsync([/* ... */]);

Deletes an Amazon CloudWatch log stream from an SQL-based Kinesis Data Analytics application.

Parameter Syntax

$result = $client->deleteApplicationCloudWatchLoggingOption([
    'ApplicationName' => '<string>', // REQUIRED
    'CloudWatchLoggingOptionId' => '<string>', // REQUIRED
    'ConditionalToken' => '<string>',
    'CurrentApplicationVersionId' => <integer>,
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
    'CloudWatchLoggingOptionDescriptions' => [
        [
            'CloudWatchLoggingOptionId' => '<string>',
            'LogStreamARN' => '<string>',
            'RoleARN' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

DeleteApplicationInputProcessingConfiguration

$result = $client->deleteApplicationInputProcessingConfiguration([/* ... */]);
$promise = $client->deleteApplicationInputProcessingConfigurationAsync([/* ... */]);

Deletes an InputProcessingConfiguration from an input.

Parameter Syntax

$result = $client->deleteApplicationInputProcessingConfiguration([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'InputId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

DeleteApplicationOutput

$result = $client->deleteApplicationOutput([/* ... */]);
$promise = $client->deleteApplicationOutputAsync([/* ... */]);

Deletes the output destination configuration from your SQL-based Kinesis Data Analytics application's configuration. Kinesis Data Analytics will no longer write data from the corresponding in-application stream to the external output destination.

Parameter Syntax

$result = $client->deleteApplicationOutput([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'OutputId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

DeleteApplicationReferenceDataSource

$result = $client->deleteApplicationReferenceDataSource([/* ... */]);
$promise = $client->deleteApplicationReferenceDataSourceAsync([/* ... */]);

Deletes a reference data source configuration from the specified SQL-based Kinesis Data Analytics application's configuration.

If the application is running, Kinesis Data Analytics immediately removes the in-application table that you created using the AddApplicationReferenceDataSource operation.

Parameter Syntax

$result = $client->deleteApplicationReferenceDataSource([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
    'ReferenceId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

DeleteApplicationSnapshot

$result = $client->deleteApplicationSnapshot([/* ... */]);
$promise = $client->deleteApplicationSnapshotAsync([/* ... */]);

Deletes a snapshot of application state.

Parameter Syntax

$result = $client->deleteApplicationSnapshot([
    'ApplicationName' => '<string>', // REQUIRED
    'SnapshotCreationTimestamp' => <integer || string || DateTime>, // REQUIRED
    'SnapshotName' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

InvalidRequestException:

The request JSON is not valid for the operation.

ResourceNotFoundException:

Specified application can't be found.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

DeleteApplicationVpcConfiguration

$result = $client->deleteApplicationVpcConfiguration([/* ... */]);
$promise = $client->deleteApplicationVpcConfigurationAsync([/* ... */]);

Removes a VPC configuration from a Managed Service for Apache Flink application.

Parameter Syntax

$result = $client->deleteApplicationVpcConfiguration([
    'ApplicationName' => '<string>', // REQUIRED
    'ConditionalToken' => '<string>',
    'CurrentApplicationVersionId' => <integer>,
    'VpcConfigurationId' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationVersionId' => <integer>,
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

DescribeApplication

$result = $client->describeApplication([/* ... */]);
$promise = $client->describeApplicationAsync([/* ... */]);

Returns information about a specific Managed Service for Apache Flink application.

If you want to retrieve a list of all applications in your account, use the ListApplications operation.

Parameter Syntax

$result = $client->describeApplication([
    'ApplicationName' => '<string>', // REQUIRED
    'IncludeAdditionalDetails' => true || false,
]);

Parameter Details

Result Syntax

[
    'ApplicationDetail' => [
        'ApplicationARN' => '<string>',
        'ApplicationConfigurationDescription' => [
            'ApplicationCodeConfigurationDescription' => [
                'CodeContentDescription' => [
                    'CodeMD5' => '<string>',
                    'CodeSize' => <integer>,
                    'S3ApplicationCodeLocationDescription' => [
                        'BucketARN' => '<string>',
                        'FileKey' => '<string>',
                        'ObjectVersion' => '<string>',
                    ],
                    'TextContent' => '<string>',
                ],
                'CodeContentType' => 'PLAINTEXT|ZIPFILE',
            ],
            'ApplicationSnapshotConfigurationDescription' => [
                'SnapshotsEnabled' => true || false,
            ],
            'EnvironmentPropertyDescriptions' => [
                'PropertyGroupDescriptions' => [
                    [
                        'PropertyGroupId' => '<string>',
                        'PropertyMap' => ['<string>', ...],
                    ],
                    // ...
                ],
            ],
            'FlinkApplicationConfigurationDescription' => [
                'CheckpointConfigurationDescription' => [
                    'CheckpointInterval' => <integer>,
                    'CheckpointingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'MinPauseBetweenCheckpoints' => <integer>,
                ],
                'JobPlanDescription' => '<string>',
                'MonitoringConfigurationDescription' => [
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                    'MetricsLevel' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
                ],
                'ParallelismConfigurationDescription' => [
                    'AutoScalingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'CurrentParallelism' => <integer>,
                    'Parallelism' => <integer>,
                    'ParallelismPerKPU' => <integer>,
                ],
            ],
            'RunConfigurationDescription' => [
                'ApplicationRestoreConfigurationDescription' => [
                    'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT',
                    'SnapshotName' => '<string>',
                ],
                'FlinkRunConfigurationDescription' => [
                    'AllowNonRestoredState' => true || false,
                ],
            ],
            'SqlApplicationConfigurationDescription' => [
                'InputDescriptions' => [
                    [
                        'InAppStreamNames' => ['<string>', ...],
                        'InputId' => '<string>',
                        'InputParallelism' => [
                            'Count' => <integer>,
                        ],
                        'InputProcessingConfigurationDescription' => [
                            'InputLambdaProcessorDescription' => [
                                'ResourceARN' => '<string>',
                                'RoleARN' => '<string>',
                            ],
                        ],
                        'InputSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'InputStartingPositionConfiguration' => [
                            'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
                        ],
                        'KinesisFirehoseInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'NamePrefix' => '<string>',
                    ],
                    // ...
                ],
                'OutputDescriptions' => [
                    [
                        'DestinationSchema' => [
                            'RecordFormatType' => 'JSON|CSV',
                        ],
                        'KinesisFirehoseOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'LambdaOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'Name' => '<string>',
                        'OutputId' => '<string>',
                    ],
                    // ...
                ],
                'ReferenceDataSourceDescriptions' => [
                    [
                        'ReferenceId' => '<string>',
                        'ReferenceSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'S3ReferenceDataSourceDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ReferenceRoleARN' => '<string>',
                        ],
                        'TableName' => '<string>',
                    ],
                    // ...
                ],
            ],
            'VpcConfigurationDescriptions' => [
                [
                    'SecurityGroupIds' => ['<string>', ...],
                    'SubnetIds' => ['<string>', ...],
                    'VpcConfigurationId' => '<string>',
                    'VpcId' => '<string>',
                ],
                // ...
            ],
            'ZeppelinApplicationConfigurationDescription' => [
                'CatalogConfigurationDescription' => [
                    'GlueDataCatalogConfigurationDescription' => [
                        'DatabaseARN' => '<string>',
                    ],
                ],
                'CustomArtifactsConfigurationDescription' => [
                    [
                        'ArtifactType' => 'UDF|DEPENDENCY_JAR',
                        'MavenReferenceDescription' => [
                            'ArtifactId' => '<string>',
                            'GroupId' => '<string>',
                            'Version' => '<string>',
                        ],
                        'S3ContentLocationDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ObjectVersion' => '<string>',
                        ],
                    ],
                    // ...
                ],
                'DeployAsApplicationConfigurationDescription' => [
                    'S3ContentLocationDescription' => [
                        'BasePath' => '<string>',
                        'BucketARN' => '<string>',
                    ],
                ],
                'MonitoringConfigurationDescription' => [
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                ],
            ],
        ],
        'ApplicationDescription' => '<string>',
        'ApplicationMaintenanceConfigurationDescription' => [
            'ApplicationMaintenanceWindowEndTime' => '<string>',
            'ApplicationMaintenanceWindowStartTime' => '<string>',
        ],
        'ApplicationMode' => 'STREAMING|INTERACTIVE',
        'ApplicationName' => '<string>',
        'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
        'ApplicationVersionId' => <integer>,
        'ApplicationVersionRolledBackFrom' => <integer>,
        'ApplicationVersionRolledBackTo' => <integer>,
        'ApplicationVersionUpdatedFrom' => <integer>,
        'CloudWatchLoggingOptionDescriptions' => [
            [
                'CloudWatchLoggingOptionId' => '<string>',
                'LogStreamARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            // ...
        ],
        'ConditionalToken' => '<string>',
        'CreateTimestamp' => <DateTime>,
        'LastUpdateTimestamp' => <DateTime>,
        'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        'ServiceExecutionRole' => '<string>',
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

InvalidArgumentException:

The specified input parameter value is not valid.

InvalidRequestException:

The request JSON is not valid for the operation.

DescribeApplicationSnapshot

$result = $client->describeApplicationSnapshot([/* ... */]);
$promise = $client->describeApplicationSnapshotAsync([/* ... */]);

Returns information about a snapshot of application state data.

Parameter Syntax

$result = $client->describeApplicationSnapshot([
    'ApplicationName' => '<string>', // REQUIRED
    'SnapshotName' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'SnapshotDetails' => [
        'ApplicationVersionId' => <integer>,
        'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        'SnapshotCreationTimestamp' => <DateTime>,
        'SnapshotName' => '<string>',
        'SnapshotStatus' => 'CREATING|READY|DELETING|FAILED',
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

InvalidArgumentException:

The specified input parameter value is not valid.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

DescribeApplicationVersion

$result = $client->describeApplicationVersion([/* ... */]);
$promise = $client->describeApplicationVersionAsync([/* ... */]);

Provides a detailed description of a specified version of the application. To see a list of all the versions of an application, invoke the ListApplicationVersions operation.

Parameter Syntax

$result = $client->describeApplicationVersion([
    'ApplicationName' => '<string>', // REQUIRED
    'ApplicationVersionId' => <integer>, // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationVersionDetail' => [
        'ApplicationARN' => '<string>',
        'ApplicationConfigurationDescription' => [
            'ApplicationCodeConfigurationDescription' => [
                'CodeContentDescription' => [
                    'CodeMD5' => '<string>',
                    'CodeSize' => <integer>,
                    'S3ApplicationCodeLocationDescription' => [
                        'BucketARN' => '<string>',
                        'FileKey' => '<string>',
                        'ObjectVersion' => '<string>',
                    ],
                    'TextContent' => '<string>',
                ],
                'CodeContentType' => 'PLAINTEXT|ZIPFILE',
            ],
            'ApplicationSnapshotConfigurationDescription' => [
                'SnapshotsEnabled' => true || false,
            ],
            'EnvironmentPropertyDescriptions' => [
                'PropertyGroupDescriptions' => [
                    [
                        'PropertyGroupId' => '<string>',
                        'PropertyMap' => ['<string>', ...],
                    ],
                    // ...
                ],
            ],
            'FlinkApplicationConfigurationDescription' => [
                'CheckpointConfigurationDescription' => [
                    'CheckpointInterval' => <integer>,
                    'CheckpointingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'MinPauseBetweenCheckpoints' => <integer>,
                ],
                'JobPlanDescription' => '<string>',
                'MonitoringConfigurationDescription' => [
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                    'MetricsLevel' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
                ],
                'ParallelismConfigurationDescription' => [
                    'AutoScalingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'CurrentParallelism' => <integer>,
                    'Parallelism' => <integer>,
                    'ParallelismPerKPU' => <integer>,
                ],
            ],
            'RunConfigurationDescription' => [
                'ApplicationRestoreConfigurationDescription' => [
                    'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT',
                    'SnapshotName' => '<string>',
                ],
                'FlinkRunConfigurationDescription' => [
                    'AllowNonRestoredState' => true || false,
                ],
            ],
            'SqlApplicationConfigurationDescription' => [
                'InputDescriptions' => [
                    [
                        'InAppStreamNames' => ['<string>', ...],
                        'InputId' => '<string>',
                        'InputParallelism' => [
                            'Count' => <integer>,
                        ],
                        'InputProcessingConfigurationDescription' => [
                            'InputLambdaProcessorDescription' => [
                                'ResourceARN' => '<string>',
                                'RoleARN' => '<string>',
                            ],
                        ],
                        'InputSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'InputStartingPositionConfiguration' => [
                            'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
                        ],
                        'KinesisFirehoseInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'NamePrefix' => '<string>',
                    ],
                    // ...
                ],
                'OutputDescriptions' => [
                    [
                        'DestinationSchema' => [
                            'RecordFormatType' => 'JSON|CSV',
                        ],
                        'KinesisFirehoseOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'LambdaOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'Name' => '<string>',
                        'OutputId' => '<string>',
                    ],
                    // ...
                ],
                'ReferenceDataSourceDescriptions' => [
                    [
                        'ReferenceId' => '<string>',
                        'ReferenceSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'S3ReferenceDataSourceDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ReferenceRoleARN' => '<string>',
                        ],
                        'TableName' => '<string>',
                    ],
                    // ...
                ],
            ],
            'VpcConfigurationDescriptions' => [
                [
                    'SecurityGroupIds' => ['<string>', ...],
                    'SubnetIds' => ['<string>', ...],
                    'VpcConfigurationId' => '<string>',
                    'VpcId' => '<string>',
                ],
                // ...
            ],
            'ZeppelinApplicationConfigurationDescription' => [
                'CatalogConfigurationDescription' => [
                    'GlueDataCatalogConfigurationDescription' => [
                        'DatabaseARN' => '<string>',
                    ],
                ],
                'CustomArtifactsConfigurationDescription' => [
                    [
                        'ArtifactType' => 'UDF|DEPENDENCY_JAR',
                        'MavenReferenceDescription' => [
                            'ArtifactId' => '<string>',
                            'GroupId' => '<string>',
                            'Version' => '<string>',
                        ],
                        'S3ContentLocationDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ObjectVersion' => '<string>',
                        ],
                    ],
                    // ...
                ],
                'DeployAsApplicationConfigurationDescription' => [
                    'S3ContentLocationDescription' => [
                        'BasePath' => '<string>',
                        'BucketARN' => '<string>',
                    ],
                ],
                'MonitoringConfigurationDescription' => [
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                ],
            ],
        ],
        'ApplicationDescription' => '<string>',
        'ApplicationMaintenanceConfigurationDescription' => [
            'ApplicationMaintenanceWindowEndTime' => '<string>',
            'ApplicationMaintenanceWindowStartTime' => '<string>',
        ],
        'ApplicationMode' => 'STREAMING|INTERACTIVE',
        'ApplicationName' => '<string>',
        'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
        'ApplicationVersionId' => <integer>,
        'ApplicationVersionRolledBackFrom' => <integer>,
        'ApplicationVersionRolledBackTo' => <integer>,
        'ApplicationVersionUpdatedFrom' => <integer>,
        'CloudWatchLoggingOptionDescriptions' => [
            [
                'CloudWatchLoggingOptionId' => '<string>',
                'LogStreamARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            // ...
        ],
        'ConditionalToken' => '<string>',
        'CreateTimestamp' => <DateTime>,
        'LastUpdateTimestamp' => <DateTime>,
        'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        'ServiceExecutionRole' => '<string>',
    ],
]

Result Details

Errors

InvalidArgumentException:

The specified input parameter value is not valid.

ResourceNotFoundException:

Specified application can't be found.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

DiscoverInputSchema

$result = $client->discoverInputSchema([/* ... */]);
$promise = $client->discoverInputSchemaAsync([/* ... */]);

Infers a schema for a SQL-based Kinesis Data Analytics application by evaluating sample records on the specified streaming source (Kinesis data stream or Kinesis Data Firehose delivery stream) or Amazon S3 object. In the response, the operation returns the inferred schema and also the sample records that the operation used to infer the schema.

You can use the inferred schema when configuring a streaming source for your application. When you create an application using the Kinesis Data Analytics console, the console uses this operation to infer a schema and show it in the console user interface.

Parameter Syntax

$result = $client->discoverInputSchema([
    'InputProcessingConfiguration' => [
        'InputLambdaProcessor' => [ // REQUIRED
            'ResourceARN' => '<string>', // REQUIRED
        ],
    ],
    'InputStartingPositionConfiguration' => [
        'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
    ],
    'ResourceARN' => '<string>',
    'S3Configuration' => [
        'BucketARN' => '<string>', // REQUIRED
        'FileKey' => '<string>', // REQUIRED
    ],
    'ServiceExecutionRole' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'InputSchema' => [
        'RecordColumns' => [
            [
                'Mapping' => '<string>',
                'Name' => '<string>',
                'SqlType' => '<string>',
            ],
            // ...
        ],
        'RecordEncoding' => '<string>',
        'RecordFormat' => [
            'MappingParameters' => [
                'CSVMappingParameters' => [
                    'RecordColumnDelimiter' => '<string>',
                    'RecordRowDelimiter' => '<string>',
                ],
                'JSONMappingParameters' => [
                    'RecordRowPath' => '<string>',
                ],
            ],
            'RecordFormatType' => 'JSON|CSV',
        ],
    ],
    'ParsedInputRecords' => [
        ['<string>', ...],
        // ...
    ],
    'ProcessedInputRecords' => ['<string>', ...],
    'RawInputRecords' => ['<string>', ...],
]

Result Details

Errors

InvalidArgumentException:

The specified input parameter value is not valid.

UnableToDetectSchemaException:

The data format is not valid. Kinesis Data Analytics cannot detect the schema for the given streaming source.

ResourceProvisionedThroughputExceededException:

Discovery failed to get a record from the streaming source because of the Kinesis Streams ProvisionedThroughputExceededException. For more information, see GetRecords in the Amazon Kinesis Streams API Reference.

ServiceUnavailableException:

The service cannot complete the request.

InvalidRequestException:

The request JSON is not valid for the operation.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

ListApplicationSnapshots

$result = $client->listApplicationSnapshots([/* ... */]);
$promise = $client->listApplicationSnapshotsAsync([/* ... */]);

Lists information about the current application snapshots.

Parameter Syntax

$result = $client->listApplicationSnapshots([
    'ApplicationName' => '<string>', // REQUIRED
    'Limit' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'NextToken' => '<string>',
    'SnapshotSummaries' => [
        [
            'ApplicationVersionId' => <integer>,
            'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
            'SnapshotCreationTimestamp' => <DateTime>,
            'SnapshotName' => '<string>',
            'SnapshotStatus' => 'CREATING|READY|DELETING|FAILED',
        ],
        // ...
    ],
]

Result Details

Errors

InvalidArgumentException:

The specified input parameter value is not valid.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

ListApplicationVersions

$result = $client->listApplicationVersions([/* ... */]);
$promise = $client->listApplicationVersionsAsync([/* ... */]);

Lists all the versions for the specified application, including versions that were rolled back. The response also includes a summary of the configuration associated with each version.

To get the complete description of a specific application version, invoke the DescribeApplicationVersion operation.

Parameter Syntax

$result = $client->listApplicationVersions([
    'ApplicationName' => '<string>', // REQUIRED
    'Limit' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'ApplicationVersionSummaries' => [
        [
            'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
            'ApplicationVersionId' => <integer>,
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

InvalidArgumentException:

The specified input parameter value is not valid.

ResourceNotFoundException:

Specified application can't be found.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

ListApplications

$result = $client->listApplications([/* ... */]);
$promise = $client->listApplicationsAsync([/* ... */]);

Returns a list of Managed Service for Apache Flink applications in your account. For each application, the response includes the application name, Amazon Resource Name (ARN), and status.

If you want detailed information about a specific application, use DescribeApplication.

Parameter Syntax

$result = $client->listApplications([
    'Limit' => <integer>,
    'NextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'ApplicationSummaries' => [
        [
            'ApplicationARN' => '<string>',
            'ApplicationMode' => 'STREAMING|INTERACTIVE',
            'ApplicationName' => '<string>',
            'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
            'ApplicationVersionId' => <integer>,
            'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        ],
        // ...
    ],
    'NextToken' => '<string>',
]

Result Details

Errors

InvalidRequestException:

The request JSON is not valid for the operation.

ListTagsForResource

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Retrieves the list of key-value tags assigned to the application. For more information, see Using Tagging.

Parameter Syntax

$result = $client->listTagsForResource([
    'ResourceARN' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'Tags' => [
        [
            'Key' => '<string>',
            'Value' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

RollbackApplication

$result = $client->rollbackApplication([/* ... */]);
$promise = $client->rollbackApplicationAsync([/* ... */]);

Reverts the application to the previous running version. You can roll back an application if you suspect it is stuck in a transient status.

You can roll back an application only if it is in the UPDATING or AUTOSCALING status.

When you rollback an application, it loads state data from the last successful snapshot. If the application has no snapshots, Managed Service for Apache Flink rejects the rollback request.

This action is not supported for Managed Service for Apache Flink for SQL applications.

Parameter Syntax

$result = $client->rollbackApplication([
    'ApplicationName' => '<string>', // REQUIRED
    'CurrentApplicationVersionId' => <integer>, // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationDetail' => [
        'ApplicationARN' => '<string>',
        'ApplicationConfigurationDescription' => [
            'ApplicationCodeConfigurationDescription' => [
                'CodeContentDescription' => [
                    'CodeMD5' => '<string>',
                    'CodeSize' => <integer>,
                    'S3ApplicationCodeLocationDescription' => [
                        'BucketARN' => '<string>',
                        'FileKey' => '<string>',
                        'ObjectVersion' => '<string>',
                    ],
                    'TextContent' => '<string>',
                ],
                'CodeContentType' => 'PLAINTEXT|ZIPFILE',
            ],
            'ApplicationSnapshotConfigurationDescription' => [
                'SnapshotsEnabled' => true || false,
            ],
            'EnvironmentPropertyDescriptions' => [
                'PropertyGroupDescriptions' => [
                    [
                        'PropertyGroupId' => '<string>',
                        'PropertyMap' => ['<string>', ...],
                    ],
                    // ...
                ],
            ],
            'FlinkApplicationConfigurationDescription' => [
                'CheckpointConfigurationDescription' => [
                    'CheckpointInterval' => <integer>,
                    'CheckpointingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'MinPauseBetweenCheckpoints' => <integer>,
                ],
                'JobPlanDescription' => '<string>',
                'MonitoringConfigurationDescription' => [
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                    'MetricsLevel' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
                ],
                'ParallelismConfigurationDescription' => [
                    'AutoScalingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'CurrentParallelism' => <integer>,
                    'Parallelism' => <integer>,
                    'ParallelismPerKPU' => <integer>,
                ],
            ],
            'RunConfigurationDescription' => [
                'ApplicationRestoreConfigurationDescription' => [
                    'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT',
                    'SnapshotName' => '<string>',
                ],
                'FlinkRunConfigurationDescription' => [
                    'AllowNonRestoredState' => true || false,
                ],
            ],
            'SqlApplicationConfigurationDescription' => [
                'InputDescriptions' => [
                    [
                        'InAppStreamNames' => ['<string>', ...],
                        'InputId' => '<string>',
                        'InputParallelism' => [
                            'Count' => <integer>,
                        ],
                        'InputProcessingConfigurationDescription' => [
                            'InputLambdaProcessorDescription' => [
                                'ResourceARN' => '<string>',
                                'RoleARN' => '<string>',
                            ],
                        ],
                        'InputSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'InputStartingPositionConfiguration' => [
                            'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
                        ],
                        'KinesisFirehoseInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'NamePrefix' => '<string>',
                    ],
                    // ...
                ],
                'OutputDescriptions' => [
                    [
                        'DestinationSchema' => [
                            'RecordFormatType' => 'JSON|CSV',
                        ],
                        'KinesisFirehoseOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'LambdaOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'Name' => '<string>',
                        'OutputId' => '<string>',
                    ],
                    // ...
                ],
                'ReferenceDataSourceDescriptions' => [
                    [
                        'ReferenceId' => '<string>',
                        'ReferenceSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'S3ReferenceDataSourceDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ReferenceRoleARN' => '<string>',
                        ],
                        'TableName' => '<string>',
                    ],
                    // ...
                ],
            ],
            'VpcConfigurationDescriptions' => [
                [
                    'SecurityGroupIds' => ['<string>', ...],
                    'SubnetIds' => ['<string>', ...],
                    'VpcConfigurationId' => '<string>',
                    'VpcId' => '<string>',
                ],
                // ...
            ],
            'ZeppelinApplicationConfigurationDescription' => [
                'CatalogConfigurationDescription' => [
                    'GlueDataCatalogConfigurationDescription' => [
                        'DatabaseARN' => '<string>',
                    ],
                ],
                'CustomArtifactsConfigurationDescription' => [
                    [
                        'ArtifactType' => 'UDF|DEPENDENCY_JAR',
                        'MavenReferenceDescription' => [
                            'ArtifactId' => '<string>',
                            'GroupId' => '<string>',
                            'Version' => '<string>',
                        ],
                        'S3ContentLocationDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ObjectVersion' => '<string>',
                        ],
                    ],
                    // ...
                ],
                'DeployAsApplicationConfigurationDescription' => [
                    'S3ContentLocationDescription' => [
                        'BasePath' => '<string>',
                        'BucketARN' => '<string>',
                    ],
                ],
                'MonitoringConfigurationDescription' => [
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                ],
            ],
        ],
        'ApplicationDescription' => '<string>',
        'ApplicationMaintenanceConfigurationDescription' => [
            'ApplicationMaintenanceWindowEndTime' => '<string>',
            'ApplicationMaintenanceWindowStartTime' => '<string>',
        ],
        'ApplicationMode' => 'STREAMING|INTERACTIVE',
        'ApplicationName' => '<string>',
        'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
        'ApplicationVersionId' => <integer>,
        'ApplicationVersionRolledBackFrom' => <integer>,
        'ApplicationVersionRolledBackTo' => <integer>,
        'ApplicationVersionUpdatedFrom' => <integer>,
        'CloudWatchLoggingOptionDescriptions' => [
            [
                'CloudWatchLoggingOptionId' => '<string>',
                'LogStreamARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            // ...
        ],
        'ConditionalToken' => '<string>',
        'CreateTimestamp' => <DateTime>,
        'LastUpdateTimestamp' => <DateTime>,
        'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        'ServiceExecutionRole' => '<string>',
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

InvalidArgumentException:

The specified input parameter value is not valid.

ResourceInUseException:

The application is not available for this operation.

InvalidRequestException:

The request JSON is not valid for the operation.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.

StartApplication

$result = $client->startApplication([/* ... */]);
$promise = $client->startApplicationAsync([/* ... */]);

Starts the specified Managed Service for Apache Flink application. After creating an application, you must exclusively call this operation to start your application.

Parameter Syntax

$result = $client->startApplication([
    'ApplicationName' => '<string>', // REQUIRED
    'RunConfiguration' => [
        'ApplicationRestoreConfiguration' => [
            'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT', // REQUIRED
            'SnapshotName' => '<string>',
        ],
        'FlinkRunConfiguration' => [
            'AllowNonRestoredState' => true || false,
        ],
        'SqlRunConfigurations' => [
            [
                'InputId' => '<string>', // REQUIRED
                'InputStartingPositionConfiguration' => [ // REQUIRED
                    'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
                ],
            ],
            // ...
        ],
    ],
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

InvalidRequestException:

The request JSON is not valid for the operation.

StopApplication

$result = $client->stopApplication([/* ... */]);
$promise = $client->stopApplicationAsync([/* ... */]);

Stops the application from processing data. You can stop an application only if it is in the running status, unless you set the Force parameter to true.

You can use the DescribeApplication operation to find the application status.

Managed Service for Apache Flink takes a snapshot when the application is stopped, unless Force is set to true.

Parameter Syntax

$result = $client->stopApplication([
    'ApplicationName' => '<string>', // REQUIRED
    'Force' => true || false,
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

InvalidRequestException:

The request JSON is not valid for the operation.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

TagResource

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Adds one or more key-value tags to a Managed Service for Apache Flink application. Note that the maximum number of application tags includes system tags. The maximum number of user-defined application tags is 50. For more information, see Using Tagging.

Parameter Syntax

$result = $client->tagResource([
    'ResourceARN' => '<string>', // REQUIRED
    'Tags' => [ // REQUIRED
        [
            'Key' => '<string>', // REQUIRED
            'Value' => '<string>',
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

TooManyTagsException:

Application created with too many tags, or too many tags added to an application. Note that the maximum number of application tags includes system tags. The maximum number of user-defined application tags is 50.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

UntagResource

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Removes one or more tags from a Managed Service for Apache Flink application. For more information, see Using Tagging.

Parameter Syntax

$result = $client->untagResource([
    'ResourceARN' => '<string>', // REQUIRED
    'TagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

TooManyTagsException:

Application created with too many tags, or too many tags added to an application. Note that the maximum number of application tags includes system tags. The maximum number of user-defined application tags is 50.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

UpdateApplication

$result = $client->updateApplication([/* ... */]);
$promise = $client->updateApplicationAsync([/* ... */]);

Updates an existing Managed Service for Apache Flink application. Using this operation, you can update application code, input configuration, and output configuration.

Managed Service for Apache Flink updates the ApplicationVersionId each time you update your application.

Parameter Syntax

$result = $client->updateApplication([
    'ApplicationConfigurationUpdate' => [
        'ApplicationCodeConfigurationUpdate' => [
            'CodeContentTypeUpdate' => 'PLAINTEXT|ZIPFILE',
            'CodeContentUpdate' => [
                'S3ContentLocationUpdate' => [
                    'BucketARNUpdate' => '<string>',
                    'FileKeyUpdate' => '<string>',
                    'ObjectVersionUpdate' => '<string>',
                ],
                'TextContentUpdate' => '<string>',
                'ZipFileContentUpdate' => <string || resource || Psr\Http\Message\StreamInterface>,
            ],
        ],
        'ApplicationSnapshotConfigurationUpdate' => [
            'SnapshotsEnabledUpdate' => true || false, // REQUIRED
        ],
        'EnvironmentPropertyUpdates' => [
            'PropertyGroups' => [ // REQUIRED
                [
                    'PropertyGroupId' => '<string>', // REQUIRED
                    'PropertyMap' => ['<string>', ...], // REQUIRED
                ],
                // ...
            ],
        ],
        'FlinkApplicationConfigurationUpdate' => [
            'CheckpointConfigurationUpdate' => [
                'CheckpointIntervalUpdate' => <integer>,
                'CheckpointingEnabledUpdate' => true || false,
                'ConfigurationTypeUpdate' => 'DEFAULT|CUSTOM',
                'MinPauseBetweenCheckpointsUpdate' => <integer>,
            ],
            'MonitoringConfigurationUpdate' => [
                'ConfigurationTypeUpdate' => 'DEFAULT|CUSTOM',
                'LogLevelUpdate' => 'INFO|WARN|ERROR|DEBUG',
                'MetricsLevelUpdate' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
            ],
            'ParallelismConfigurationUpdate' => [
                'AutoScalingEnabledUpdate' => true || false,
                'ConfigurationTypeUpdate' => 'DEFAULT|CUSTOM',
                'ParallelismPerKPUUpdate' => <integer>,
                'ParallelismUpdate' => <integer>,
            ],
        ],
        'SqlApplicationConfigurationUpdate' => [
            'InputUpdates' => [
                [
                    'InputId' => '<string>', // REQUIRED
                    'InputParallelismUpdate' => [
                        'CountUpdate' => <integer>, // REQUIRED
                    ],
                    'InputProcessingConfigurationUpdate' => [
                        'InputLambdaProcessorUpdate' => [ // REQUIRED
                            'ResourceARNUpdate' => '<string>', // REQUIRED
                        ],
                    ],
                    'InputSchemaUpdate' => [
                        'RecordColumnUpdates' => [
                            [
                                'Mapping' => '<string>',
                                'Name' => '<string>', // REQUIRED
                                'SqlType' => '<string>', // REQUIRED
                            ],
                            // ...
                        ],
                        'RecordEncodingUpdate' => '<string>',
                        'RecordFormatUpdate' => [
                            'MappingParameters' => [
                                'CSVMappingParameters' => [
                                    'RecordColumnDelimiter' => '<string>', // REQUIRED
                                    'RecordRowDelimiter' => '<string>', // REQUIRED
                                ],
                                'JSONMappingParameters' => [
                                    'RecordRowPath' => '<string>', // REQUIRED
                                ],
                            ],
                            'RecordFormatType' => 'JSON|CSV', // REQUIRED
                        ],
                    ],
                    'KinesisFirehoseInputUpdate' => [
                        'ResourceARNUpdate' => '<string>', // REQUIRED
                    ],
                    'KinesisStreamsInputUpdate' => [
                        'ResourceARNUpdate' => '<string>', // REQUIRED
                    ],
                    'NamePrefixUpdate' => '<string>',
                ],
                // ...
            ],
            'OutputUpdates' => [
                [
                    'DestinationSchemaUpdate' => [
                        'RecordFormatType' => 'JSON|CSV', // REQUIRED
                    ],
                    'KinesisFirehoseOutputUpdate' => [
                        'ResourceARNUpdate' => '<string>', // REQUIRED
                    ],
                    'KinesisStreamsOutputUpdate' => [
                        'ResourceARNUpdate' => '<string>', // REQUIRED
                    ],
                    'LambdaOutputUpdate' => [
                        'ResourceARNUpdate' => '<string>', // REQUIRED
                    ],
                    'NameUpdate' => '<string>',
                    'OutputId' => '<string>', // REQUIRED
                ],
                // ...
            ],
            'ReferenceDataSourceUpdates' => [
                [
                    'ReferenceId' => '<string>', // REQUIRED
                    'ReferenceSchemaUpdate' => [
                        'RecordColumns' => [ // REQUIRED
                            [
                                'Mapping' => '<string>',
                                'Name' => '<string>', // REQUIRED
                                'SqlType' => '<string>', // REQUIRED
                            ],
                            // ...
                        ],
                        'RecordEncoding' => '<string>',
                        'RecordFormat' => [ // REQUIRED
                            'MappingParameters' => [
                                'CSVMappingParameters' => [
                                    'RecordColumnDelimiter' => '<string>', // REQUIRED
                                    'RecordRowDelimiter' => '<string>', // REQUIRED
                                ],
                                'JSONMappingParameters' => [
                                    'RecordRowPath' => '<string>', // REQUIRED
                                ],
                            ],
                            'RecordFormatType' => 'JSON|CSV', // REQUIRED
                        ],
                    ],
                    'S3ReferenceDataSourceUpdate' => [
                        'BucketARNUpdate' => '<string>',
                        'FileKeyUpdate' => '<string>',
                    ],
                    'TableNameUpdate' => '<string>',
                ],
                // ...
            ],
        ],
        'VpcConfigurationUpdates' => [
            [
                'SecurityGroupIdUpdates' => ['<string>', ...],
                'SubnetIdUpdates' => ['<string>', ...],
                'VpcConfigurationId' => '<string>', // REQUIRED
            ],
            // ...
        ],
        'ZeppelinApplicationConfigurationUpdate' => [
            'CatalogConfigurationUpdate' => [
                'GlueDataCatalogConfigurationUpdate' => [ // REQUIRED
                    'DatabaseARNUpdate' => '<string>', // REQUIRED
                ],
            ],
            'CustomArtifactsConfigurationUpdate' => [
                [
                    'ArtifactType' => 'UDF|DEPENDENCY_JAR', // REQUIRED
                    'MavenReference' => [
                        'ArtifactId' => '<string>', // REQUIRED
                        'GroupId' => '<string>', // REQUIRED
                        'Version' => '<string>', // REQUIRED
                    ],
                    'S3ContentLocation' => [
                        'BucketARN' => '<string>', // REQUIRED
                        'FileKey' => '<string>', // REQUIRED
                        'ObjectVersion' => '<string>',
                    ],
                ],
                // ...
            ],
            'DeployAsApplicationConfigurationUpdate' => [
                'S3ContentLocationUpdate' => [
                    'BasePathUpdate' => '<string>',
                    'BucketARNUpdate' => '<string>',
                ],
            ],
            'MonitoringConfigurationUpdate' => [
                'LogLevelUpdate' => 'INFO|WARN|ERROR|DEBUG', // REQUIRED
            ],
        ],
    ],
    'ApplicationName' => '<string>', // REQUIRED
    'CloudWatchLoggingOptionUpdates' => [
        [
            'CloudWatchLoggingOptionId' => '<string>', // REQUIRED
            'LogStreamARNUpdate' => '<string>',
        ],
        // ...
    ],
    'ConditionalToken' => '<string>',
    'CurrentApplicationVersionId' => <integer>,
    'RunConfigurationUpdate' => [
        'ApplicationRestoreConfiguration' => [
            'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT', // REQUIRED
            'SnapshotName' => '<string>',
        ],
        'FlinkRunConfiguration' => [
            'AllowNonRestoredState' => true || false,
        ],
    ],
    'RuntimeEnvironmentUpdate' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
    'ServiceExecutionRoleUpdate' => '<string>',
]);

Parameter Details

Result Syntax

[
    'ApplicationDetail' => [
        'ApplicationARN' => '<string>',
        'ApplicationConfigurationDescription' => [
            'ApplicationCodeConfigurationDescription' => [
                'CodeContentDescription' => [
                    'CodeMD5' => '<string>',
                    'CodeSize' => <integer>,
                    'S3ApplicationCodeLocationDescription' => [
                        'BucketARN' => '<string>',
                        'FileKey' => '<string>',
                        'ObjectVersion' => '<string>',
                    ],
                    'TextContent' => '<string>',
                ],
                'CodeContentType' => 'PLAINTEXT|ZIPFILE',
            ],
            'ApplicationSnapshotConfigurationDescription' => [
                'SnapshotsEnabled' => true || false,
            ],
            'EnvironmentPropertyDescriptions' => [
                'PropertyGroupDescriptions' => [
                    [
                        'PropertyGroupId' => '<string>',
                        'PropertyMap' => ['<string>', ...],
                    ],
                    // ...
                ],
            ],
            'FlinkApplicationConfigurationDescription' => [
                'CheckpointConfigurationDescription' => [
                    'CheckpointInterval' => <integer>,
                    'CheckpointingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'MinPauseBetweenCheckpoints' => <integer>,
                ],
                'JobPlanDescription' => '<string>',
                'MonitoringConfigurationDescription' => [
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                    'MetricsLevel' => 'APPLICATION|TASK|OPERATOR|PARALLELISM',
                ],
                'ParallelismConfigurationDescription' => [
                    'AutoScalingEnabled' => true || false,
                    'ConfigurationType' => 'DEFAULT|CUSTOM',
                    'CurrentParallelism' => <integer>,
                    'Parallelism' => <integer>,
                    'ParallelismPerKPU' => <integer>,
                ],
            ],
            'RunConfigurationDescription' => [
                'ApplicationRestoreConfigurationDescription' => [
                    'ApplicationRestoreType' => 'SKIP_RESTORE_FROM_SNAPSHOT|RESTORE_FROM_LATEST_SNAPSHOT|RESTORE_FROM_CUSTOM_SNAPSHOT',
                    'SnapshotName' => '<string>',
                ],
                'FlinkRunConfigurationDescription' => [
                    'AllowNonRestoredState' => true || false,
                ],
            ],
            'SqlApplicationConfigurationDescription' => [
                'InputDescriptions' => [
                    [
                        'InAppStreamNames' => ['<string>', ...],
                        'InputId' => '<string>',
                        'InputParallelism' => [
                            'Count' => <integer>,
                        ],
                        'InputProcessingConfigurationDescription' => [
                            'InputLambdaProcessorDescription' => [
                                'ResourceARN' => '<string>',
                                'RoleARN' => '<string>',
                            ],
                        ],
                        'InputSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'InputStartingPositionConfiguration' => [
                            'InputStartingPosition' => 'NOW|TRIM_HORIZON|LAST_STOPPED_POINT',
                        ],
                        'KinesisFirehoseInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsInputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'NamePrefix' => '<string>',
                    ],
                    // ...
                ],
                'OutputDescriptions' => [
                    [
                        'DestinationSchema' => [
                            'RecordFormatType' => 'JSON|CSV',
                        ],
                        'KinesisFirehoseOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'KinesisStreamsOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'LambdaOutputDescription' => [
                            'ResourceARN' => '<string>',
                            'RoleARN' => '<string>',
                        ],
                        'Name' => '<string>',
                        'OutputId' => '<string>',
                    ],
                    // ...
                ],
                'ReferenceDataSourceDescriptions' => [
                    [
                        'ReferenceId' => '<string>',
                        'ReferenceSchema' => [
                            'RecordColumns' => [
                                [
                                    'Mapping' => '<string>',
                                    'Name' => '<string>',
                                    'SqlType' => '<string>',
                                ],
                                // ...
                            ],
                            'RecordEncoding' => '<string>',
                            'RecordFormat' => [
                                'MappingParameters' => [
                                    'CSVMappingParameters' => [
                                        'RecordColumnDelimiter' => '<string>',
                                        'RecordRowDelimiter' => '<string>',
                                    ],
                                    'JSONMappingParameters' => [
                                        'RecordRowPath' => '<string>',
                                    ],
                                ],
                                'RecordFormatType' => 'JSON|CSV',
                            ],
                        ],
                        'S3ReferenceDataSourceDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ReferenceRoleARN' => '<string>',
                        ],
                        'TableName' => '<string>',
                    ],
                    // ...
                ],
            ],
            'VpcConfigurationDescriptions' => [
                [
                    'SecurityGroupIds' => ['<string>', ...],
                    'SubnetIds' => ['<string>', ...],
                    'VpcConfigurationId' => '<string>',
                    'VpcId' => '<string>',
                ],
                // ...
            ],
            'ZeppelinApplicationConfigurationDescription' => [
                'CatalogConfigurationDescription' => [
                    'GlueDataCatalogConfigurationDescription' => [
                        'DatabaseARN' => '<string>',
                    ],
                ],
                'CustomArtifactsConfigurationDescription' => [
                    [
                        'ArtifactType' => 'UDF|DEPENDENCY_JAR',
                        'MavenReferenceDescription' => [
                            'ArtifactId' => '<string>',
                            'GroupId' => '<string>',
                            'Version' => '<string>',
                        ],
                        'S3ContentLocationDescription' => [
                            'BucketARN' => '<string>',
                            'FileKey' => '<string>',
                            'ObjectVersion' => '<string>',
                        ],
                    ],
                    // ...
                ],
                'DeployAsApplicationConfigurationDescription' => [
                    'S3ContentLocationDescription' => [
                        'BasePath' => '<string>',
                        'BucketARN' => '<string>',
                    ],
                ],
                'MonitoringConfigurationDescription' => [
                    'LogLevel' => 'INFO|WARN|ERROR|DEBUG',
                ],
            ],
        ],
        'ApplicationDescription' => '<string>',
        'ApplicationMaintenanceConfigurationDescription' => [
            'ApplicationMaintenanceWindowEndTime' => '<string>',
            'ApplicationMaintenanceWindowStartTime' => '<string>',
        ],
        'ApplicationMode' => 'STREAMING|INTERACTIVE',
        'ApplicationName' => '<string>',
        'ApplicationStatus' => 'DELETING|STARTING|STOPPING|READY|RUNNING|UPDATING|AUTOSCALING|FORCE_STOPPING|ROLLING_BACK|MAINTENANCE|ROLLED_BACK',
        'ApplicationVersionId' => <integer>,
        'ApplicationVersionRolledBackFrom' => <integer>,
        'ApplicationVersionRolledBackTo' => <integer>,
        'ApplicationVersionUpdatedFrom' => <integer>,
        'CloudWatchLoggingOptionDescriptions' => [
            [
                'CloudWatchLoggingOptionId' => '<string>',
                'LogStreamARN' => '<string>',
                'RoleARN' => '<string>',
            ],
            // ...
        ],
        'ConditionalToken' => '<string>',
        'CreateTimestamp' => <DateTime>,
        'LastUpdateTimestamp' => <DateTime>,
        'RuntimeEnvironment' => 'SQL-1_0|FLINK-1_6|FLINK-1_8|ZEPPELIN-FLINK-1_0|FLINK-1_11|FLINK-1_13|ZEPPELIN-FLINK-2_0|FLINK-1_15|ZEPPELIN-FLINK-3_0|FLINK-1_18',
        'ServiceExecutionRole' => '<string>',
    ],
]

Result Details

Errors

CodeValidationException:

The user-provided application code (query) is not valid. This can be a simple syntax error.

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

InvalidRequestException:

The request JSON is not valid for the operation.

InvalidApplicationConfigurationException:

The user-provided application configuration is not valid.

LimitExceededException:

The number of allowed resources has been exceeded.

UpdateApplicationMaintenanceConfiguration

$result = $client->updateApplicationMaintenanceConfiguration([/* ... */]);
$promise = $client->updateApplicationMaintenanceConfigurationAsync([/* ... */]);

Updates the maintenance configuration of the Managed Service for Apache Flink application.

You can invoke this operation on an application that is in one of the two following states: READY or RUNNING. If you invoke it when the application is in a state other than these two states, it throws a ResourceInUseException. The service makes use of the updated configuration the next time it schedules maintenance for the application. If you invoke this operation after the service schedules maintenance, the service will apply the configuration update the next time it schedules maintenance for the application. This means that you might not see the maintenance configuration update applied to the maintenance process that follows a successful invocation of this operation, but to the following maintenance process instead.

To see the current maintenance configuration of your application, invoke the DescribeApplication operation.

For information about application maintenance, see Managed Service for Apache Flink for Apache Flink Maintenance.

Parameter Syntax

$result = $client->updateApplicationMaintenanceConfiguration([
    'ApplicationMaintenanceConfigurationUpdate' => [ // REQUIRED
        'ApplicationMaintenanceWindowStartTimeUpdate' => '<string>', // REQUIRED
    ],
    'ApplicationName' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'ApplicationARN' => '<string>',
    'ApplicationMaintenanceConfigurationDescription' => [
        'ApplicationMaintenanceWindowEndTime' => '<string>',
        'ApplicationMaintenanceWindowStartTime' => '<string>',
    ],
]

Result Details

Errors

ResourceNotFoundException:

Specified application can't be found.

ResourceInUseException:

The application is not available for this operation.

InvalidArgumentException:

The specified input parameter value is not valid.

ConcurrentModificationException:

Exception thrown as a result of concurrent modifications to an application. This error can be the result of attempting to modify an application without using the current application ID.

UnsupportedOperationException:

The request was rejected because a specified parameter is not supported or a specified resource is not valid for this operation.