Struct aws_sdk_kinesisanalyticsv2::client::Client
source · pub struct Client { /* private fields */ }
Expand description
Client for Amazon Kinesis Analytics
Client for invoking operations on Amazon Kinesis Analytics. Each operation on Amazon Kinesis Analytics is a method on this
this struct. .send()
MUST be invoked on the generated operations to dispatch the request to the service.
§Constructing a Client
A Config
is required to construct a client. For most use cases, the aws-config
crate should be used to automatically resolve this config using
aws_config::load_from_env()
, since this will resolve an SdkConfig
which can be shared
across multiple different AWS SDK clients. This config resolution process can be customized
by calling aws_config::from_env()
instead, which returns a ConfigLoader
that uses
the builder pattern to customize the default config.
In the simplest case, creating a client looks as follows:
let config = aws_config::load_from_env().await;
let client = aws_sdk_kinesisanalyticsv2::Client::new(&config);
Occasionally, SDKs may have additional service-specific values that can be set on the Config
that
is absent from SdkConfig
, or slightly different settings for a specific client may be desired.
The Config
struct implements From<&SdkConfig>
, so setting these specific settings can be
done as follows:
let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_kinesisanalyticsv2::config::Builder::from(&sdk_config)
.some_service_specific_setting("value")
.build();
See the aws-config
docs and Config
for more information on customizing configuration.
Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.
§Using the Client
A client has a function for every operation that can be performed by the service.
For example, the AddApplicationCloudWatchLoggingOption
operation has
a Client::add_application_cloud_watch_logging_option
, function which returns a builder for that operation.
The fluent builder ultimately has a send()
function that returns an async future that
returns a result, as illustrated below:
let result = client.add_application_cloud_watch_logging_option()
.application_name("example")
.send()
.await;
The underlying HTTP requests that get made by this can be modified with the customize_operation
function on the fluent builder. See the customize
module for more
information.
Implementations§
source§impl Client
impl Client
sourcepub fn add_application_cloud_watch_logging_option(
&self
) -> AddApplicationCloudWatchLoggingOptionFluentBuilder
pub fn add_application_cloud_watch_logging_option( &self ) -> AddApplicationCloudWatchLoggingOptionFluentBuilder
Constructs a fluent builder for the AddApplicationCloudWatchLoggingOption
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe Kinesis Data Analytics application name.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: falseThe version ID of the SQL-based Kinesis Data Analytics application. You must provide the
CurrentApplicationVersionId
or theConditionalToken
.You can retrieve the application version ID usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.cloud_watch_logging_option(CloudWatchLoggingOption)
/set_cloud_watch_logging_option(Option<CloudWatchLoggingOption>)
:
required: trueProvides the Amazon CloudWatch log stream Amazon Resource Name (ARN).
conditional_token(impl Into<String>)
/set_conditional_token(Option<String>)
:
required: falseA value you use to implement strong concurrency for application updates. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You get the application’s currentConditionalToken
usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.
- On success, responds with
AddApplicationCloudWatchLoggingOptionOutput
with field(s):application_arn(Option<String>)
:The application’s ARN.
application_version_id(Option<i64>)
:The new version ID of the SQL-based Kinesis Data Analytics application. Kinesis Data Analytics updates the
ApplicationVersionId
each time you change the CloudWatch logging options.cloud_watch_logging_option_descriptions(Option<Vec::<CloudWatchLoggingOptionDescription>>)
:The descriptions of the current CloudWatch logging options for the SQL-based Kinesis Data Analytics application.
- On failure, responds with
SdkError<AddApplicationCloudWatchLoggingOptionError>
source§impl Client
impl Client
sourcepub fn add_application_input(&self) -> AddApplicationInputFluentBuilder
pub fn add_application_input(&self) -> AddApplicationInputFluentBuilder
Constructs a fluent builder for the AddApplicationInput
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of your existing application to which you want to add the streaming source.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe current version of your application. You must provide the
ApplicationVersionID
or theConditionalToken
.You can use theDescribeApplication
operation to find the current application version.input(Input)
/set_input(Option<Input>)
:
required: trueThe
Input
to add.
- On success, responds with
AddApplicationInputOutput
with field(s):application_arn(Option<String>)
:The Amazon Resource Name (ARN) of the application.
application_version_id(Option<i64>)
:Provides the current application version.
input_descriptions(Option<Vec::<InputDescription>>)
:Describes the application input configuration.
- On failure, responds with
SdkError<AddApplicationInputError>
source§impl Client
impl Client
sourcepub fn add_application_input_processing_configuration(
&self
) -> AddApplicationInputProcessingConfigurationFluentBuilder
pub fn add_application_input_processing_configuration( &self ) -> AddApplicationInputProcessingConfigurationFluentBuilder
Constructs a fluent builder for the AddApplicationInputProcessingConfiguration
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application to which you want to add the input processing configuration.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe version of the application to which you want to add the input processing configuration. You can use the
DescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned.input_id(impl Into<String>)
/set_input_id(Option<String>)
:
required: trueThe ID of the input configuration to add the input processing configuration to. You can get a list of the input IDs for an application using the
DescribeApplication
operation.input_processing_configuration(InputProcessingConfiguration)
/set_input_processing_configuration(Option<InputProcessingConfiguration>)
:
required: trueThe
InputProcessingConfiguration
to add to the application.
- On success, responds with
AddApplicationInputProcessingConfigurationOutput
with field(s):application_arn(Option<String>)
:The Amazon Resource Name (ARN) of the application.
application_version_id(Option<i64>)
:Provides the current application version.
input_id(Option<String>)
:The input ID that is associated with the application input. This is the ID that Kinesis Data Analytics assigns to each input configuration that you add to your application.
input_processing_configuration_description(Option<InputProcessingConfigurationDescription>)
:The description of the preprocessor that executes on records in this input before the application’s code is run.
- On failure, responds with
SdkError<AddApplicationInputProcessingConfigurationError>
source§impl Client
impl Client
sourcepub fn add_application_output(&self) -> AddApplicationOutputFluentBuilder
pub fn add_application_output(&self) -> AddApplicationOutputFluentBuilder
Constructs a fluent builder for the AddApplicationOutput
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application to which you want to add the output configuration.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe version of the application to which you want to add the output configuration. You can use the
DescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned.output(Output)
/set_output(Option<Output>)
:
required: trueAn array of objects, each describing one output configuration. In the output configuration, you specify the name of an in-application stream, a destination (that is, a Kinesis data stream, a Kinesis Data Firehose delivery stream, or an Amazon Lambda function), and record the formation to use when writing to the destination.
- On success, responds with
AddApplicationOutputOutput
with field(s):application_arn(Option<String>)
:The application Amazon Resource Name (ARN).
application_version_id(Option<i64>)
:The updated application version ID. Kinesis Data Analytics increments this ID when the application is updated.
output_descriptions(Option<Vec::<OutputDescription>>)
:Describes the application output configuration. For more information, see Configuring Application Output.
- On failure, responds with
SdkError<AddApplicationOutputError>
source§impl Client
impl Client
sourcepub fn add_application_reference_data_source(
&self
) -> AddApplicationReferenceDataSourceFluentBuilder
pub fn add_application_reference_data_source( &self ) -> AddApplicationReferenceDataSourceFluentBuilder
Constructs a fluent builder for the AddApplicationReferenceDataSource
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe version of the application for which you are adding the reference data source. You can use the
DescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned.reference_data_source(ReferenceDataSource)
/set_reference_data_source(Option<ReferenceDataSource>)
:
required: trueThe reference data source can be an object in your Amazon S3 bucket. Kinesis Data Analytics reads the object and copies the data into the in-application table that is created. You provide an S3 bucket, object key name, and the resulting in-application table that is created.
- On success, responds with
AddApplicationReferenceDataSourceOutput
with field(s):application_arn(Option<String>)
:The application Amazon Resource Name (ARN).
application_version_id(Option<i64>)
:The updated application version ID. Kinesis Data Analytics increments this ID when the application is updated.
reference_data_source_descriptions(Option<Vec::<ReferenceDataSourceDescription>>)
:Describes reference data sources configured for the application.
- On failure, responds with
SdkError<AddApplicationReferenceDataSourceError>
source§impl Client
impl Client
sourcepub fn add_application_vpc_configuration(
&self
) -> AddApplicationVpcConfigurationFluentBuilder
pub fn add_application_vpc_configuration( &self ) -> AddApplicationVpcConfigurationFluentBuilder
Constructs a fluent builder for the AddApplicationVpcConfiguration
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: falseThe version of the application to which you want to add the VPC configuration. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You can use theDescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.vpc_configuration(VpcConfiguration)
/set_vpc_configuration(Option<VpcConfiguration>)
:
required: trueDescription of the VPC to add to the application.
conditional_token(impl Into<String>)
/set_conditional_token(Option<String>)
:
required: falseA value you use to implement strong concurrency for application updates. You must provide the
ApplicationVersionID
or theConditionalToken
. You get the application’s currentConditionalToken
usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.
- On success, responds with
AddApplicationVpcConfigurationOutput
with field(s):application_arn(Option<String>)
:The ARN of the application.
application_version_id(Option<i64>)
:Provides the current application version. Managed Service for Apache Flink updates the ApplicationVersionId each time you update the application.
vpc_configuration_description(Option<VpcConfigurationDescription>)
:The parameters of the new VPC configuration.
- On failure, responds with
SdkError<AddApplicationVpcConfigurationError>
source§impl Client
impl Client
sourcepub fn create_application(&self) -> CreateApplicationFluentBuilder
pub fn create_application(&self) -> CreateApplicationFluentBuilder
Constructs a fluent builder for the CreateApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of your application (for example,
sample-app
).application_description(impl Into<String>)
/set_application_description(Option<String>)
:
required: falseA summary description of the application.
runtime_environment(RuntimeEnvironment)
/set_runtime_environment(Option<RuntimeEnvironment>)
:
required: trueThe runtime environment for the application.
service_execution_role(impl Into<String>)
/set_service_execution_role(Option<String>)
:
required: trueThe IAM role used by the application to access Kinesis data streams, Kinesis Data Firehose delivery streams, Amazon S3 objects, and other external resources.
application_configuration(ApplicationConfiguration)
/set_application_configuration(Option<ApplicationConfiguration>)
:
required: falseUse this parameter to configure the application.
cloud_watch_logging_options(CloudWatchLoggingOption)
/set_cloud_watch_logging_options(Option<Vec::<CloudWatchLoggingOption>>)
:
required: falseUse this parameter to configure an Amazon CloudWatch log stream to monitor application configuration errors.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of one or more tags to assign to the application. A tag is a key-value pair that identifies an 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.
application_mode(ApplicationMode)
/set_application_mode(Option<ApplicationMode>)
:
required: falseUse the
STREAMING
mode to create a Managed Service for Apache Flink application. To create a Managed Service for Apache Flink Studio notebook, use theINTERACTIVE
mode.
- On success, responds with
CreateApplicationOutput
with field(s):application_detail(Option<ApplicationDetail>)
:In response to your
CreateApplication
request, Managed Service for Apache Flink returns a response with details of the application it created.
- On failure, responds with
SdkError<CreateApplicationError>
source§impl Client
impl Client
sourcepub fn create_application_presigned_url(
&self
) -> CreateApplicationPresignedUrlFluentBuilder
pub fn create_application_presigned_url( &self ) -> CreateApplicationPresignedUrlFluentBuilder
Constructs a fluent builder for the CreateApplicationPresignedUrl
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application.
url_type(UrlType)
/set_url_type(Option<UrlType>)
:
required: trueThe type of the extension for which to create and return a URL. Currently, the only valid extension URL type is
FLINK_DASHBOARD_URL
.session_expiration_duration_in_seconds(i64)
/set_session_expiration_duration_in_seconds(Option<i64>)
:
required: falseThe duration in seconds for which the returned URL will be valid.
- On success, responds with
CreateApplicationPresignedUrlOutput
with field(s):authorized_url(Option<String>)
:The URL of the extension.
- On failure, responds with
SdkError<CreateApplicationPresignedUrlError>
source§impl Client
impl Client
sourcepub fn create_application_snapshot(
&self
) -> CreateApplicationSnapshotFluentBuilder
pub fn create_application_snapshot( &self ) -> CreateApplicationSnapshotFluentBuilder
Constructs a fluent builder for the CreateApplicationSnapshot
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: trueAn identifier for the application snapshot.
- On success, responds with
CreateApplicationSnapshotOutput
- On failure, responds with
SdkError<CreateApplicationSnapshotError>
source§impl Client
impl Client
sourcepub fn delete_application(&self) -> DeleteApplicationFluentBuilder
pub fn delete_application(&self) -> DeleteApplicationFluentBuilder
Constructs a fluent builder for the DeleteApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application to delete.
create_timestamp(DateTime)
/set_create_timestamp(Option<DateTime>)
:
required: trueUse the
DescribeApplication
operation to get this value.
- On success, responds with
DeleteApplicationOutput
- On failure, responds with
SdkError<DeleteApplicationError>
source§impl Client
impl Client
sourcepub fn delete_application_cloud_watch_logging_option(
&self
) -> DeleteApplicationCloudWatchLoggingOptionFluentBuilder
pub fn delete_application_cloud_watch_logging_option( &self ) -> DeleteApplicationCloudWatchLoggingOptionFluentBuilder
Constructs a fluent builder for the DeleteApplicationCloudWatchLoggingOption
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe application name.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: falseThe version ID of the application. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You can retrieve the application version ID usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.cloud_watch_logging_option_id(impl Into<String>)
/set_cloud_watch_logging_option_id(Option<String>)
:
required: trueThe
CloudWatchLoggingOptionId
of the Amazon CloudWatch logging option to delete. You can get theCloudWatchLoggingOptionId
by using theDescribeApplication
operation.conditional_token(impl Into<String>)
/set_conditional_token(Option<String>)
:
required: falseA value you use to implement strong concurrency for application updates. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You get the application’s currentConditionalToken
usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.
- On success, responds with
DeleteApplicationCloudWatchLoggingOptionOutput
with field(s):application_arn(Option<String>)
:The application’s Amazon Resource Name (ARN).
application_version_id(Option<i64>)
:The version ID of the application. Kinesis Data Analytics updates the
ApplicationVersionId
each time you change the CloudWatch logging options.cloud_watch_logging_option_descriptions(Option<Vec::<CloudWatchLoggingOptionDescription>>)
:The descriptions of the remaining CloudWatch logging options for the application.
- On failure, responds with
SdkError<DeleteApplicationCloudWatchLoggingOptionError>
source§impl Client
impl Client
sourcepub fn delete_application_input_processing_configuration(
&self
) -> DeleteApplicationInputProcessingConfigurationFluentBuilder
pub fn delete_application_input_processing_configuration( &self ) -> DeleteApplicationInputProcessingConfigurationFluentBuilder
Constructs a fluent builder for the DeleteApplicationInputProcessingConfiguration
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe application version. You can use the
DescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned.input_id(impl Into<String>)
/set_input_id(Option<String>)
:
required: trueThe ID of the input configuration from which to delete the input processing configuration. You can get a list of the input IDs for an application by using the
DescribeApplication
operation.
- On success, responds with
DeleteApplicationInputProcessingConfigurationOutput
with field(s):application_arn(Option<String>)
:The Amazon Resource Name (ARN) of the application.
application_version_id(Option<i64>)
:The current application version ID.
- On failure, responds with
SdkError<DeleteApplicationInputProcessingConfigurationError>
source§impl Client
impl Client
sourcepub fn delete_application_output(&self) -> DeleteApplicationOutputFluentBuilder
pub fn delete_application_output(&self) -> DeleteApplicationOutputFluentBuilder
Constructs a fluent builder for the DeleteApplicationOutput
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe application name.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe application version. You can use the
DescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned.output_id(impl Into<String>)
/set_output_id(Option<String>)
:
required: trueThe ID of the configuration to delete. Each output configuration that is added to the application (either when the application is created or later) using the
AddApplicationOutput
operation has a unique ID. You need to provide the ID to uniquely identify the output configuration that you want to delete from the application configuration. You can use theDescribeApplication
operation to get the specificOutputId
.
- On success, responds with
DeleteApplicationOutputOutput
with field(s):application_arn(Option<String>)
:The application Amazon Resource Name (ARN).
application_version_id(Option<i64>)
:The current application version ID.
- On failure, responds with
SdkError<DeleteApplicationOutputError>
source§impl Client
impl Client
sourcepub fn delete_application_reference_data_source(
&self
) -> DeleteApplicationReferenceDataSourceFluentBuilder
pub fn delete_application_reference_data_source( &self ) -> DeleteApplicationReferenceDataSourceFluentBuilder
Constructs a fluent builder for the DeleteApplicationReferenceDataSource
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe current application version. You can use the
DescribeApplication
operation to get the current application version. If the version specified is not the current version, theConcurrentModificationException
is returned.reference_id(impl Into<String>)
/set_reference_id(Option<String>)
:
required: trueThe ID of the reference data source. When you add a reference data source to your application using the
AddApplicationReferenceDataSource
, Kinesis Data Analytics assigns an ID. You can use theDescribeApplication
operation to get the reference ID.
- On success, responds with
DeleteApplicationReferenceDataSourceOutput
with field(s):application_arn(Option<String>)
:The application Amazon Resource Name (ARN).
application_version_id(Option<i64>)
:The updated version ID of the application.
- On failure, responds with
SdkError<DeleteApplicationReferenceDataSourceError>
source§impl Client
impl Client
sourcepub fn delete_application_snapshot(
&self
) -> DeleteApplicationSnapshotFluentBuilder
pub fn delete_application_snapshot( &self ) -> DeleteApplicationSnapshotFluentBuilder
Constructs a fluent builder for the DeleteApplicationSnapshot
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: trueThe identifier for the snapshot delete.
snapshot_creation_timestamp(DateTime)
/set_snapshot_creation_timestamp(Option<DateTime>)
:
required: trueThe creation timestamp of the application snapshot to delete. You can retrieve this value using or .
- On success, responds with
DeleteApplicationSnapshotOutput
- On failure, responds with
SdkError<DeleteApplicationSnapshotError>
source§impl Client
impl Client
sourcepub fn delete_application_vpc_configuration(
&self
) -> DeleteApplicationVpcConfigurationFluentBuilder
pub fn delete_application_vpc_configuration( &self ) -> DeleteApplicationVpcConfigurationFluentBuilder
Constructs a fluent builder for the DeleteApplicationVpcConfiguration
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: falseThe current application version ID. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You can retrieve the application version ID usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.vpc_configuration_id(impl Into<String>)
/set_vpc_configuration_id(Option<String>)
:
required: trueThe ID of the VPC configuration to delete.
conditional_token(impl Into<String>)
/set_conditional_token(Option<String>)
:
required: falseA value you use to implement strong concurrency for application updates. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You get the application’s currentConditionalToken
usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.
- On success, responds with
DeleteApplicationVpcConfigurationOutput
with field(s):application_arn(Option<String>)
:The ARN of the Managed Service for Apache Flink application.
application_version_id(Option<i64>)
:The updated version ID of the application.
- On failure, responds with
SdkError<DeleteApplicationVpcConfigurationError>
source§impl Client
impl Client
sourcepub fn describe_application(&self) -> DescribeApplicationFluentBuilder
pub fn describe_application(&self) -> DescribeApplicationFluentBuilder
Constructs a fluent builder for the DescribeApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application.
include_additional_details(bool)
/set_include_additional_details(Option<bool>)
:
required: falseDisplays verbose information about a Managed Service for Apache Flink application, including the application’s job plan.
- On success, responds with
DescribeApplicationOutput
with field(s):application_detail(Option<ApplicationDetail>)
:Provides a description of the application, such as the application’s Amazon Resource Name (ARN), status, and latest version.
- On failure, responds with
SdkError<DescribeApplicationError>
source§impl Client
impl Client
sourcepub fn describe_application_snapshot(
&self
) -> DescribeApplicationSnapshotFluentBuilder
pub fn describe_application_snapshot( &self ) -> DescribeApplicationSnapshotFluentBuilder
Constructs a fluent builder for the DescribeApplicationSnapshot
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: trueThe identifier of an application snapshot. You can retrieve this value using .
- On success, responds with
DescribeApplicationSnapshotOutput
with field(s):snapshot_details(Option<SnapshotDetails>)
:An object containing information about the application snapshot.
- On failure, responds with
SdkError<DescribeApplicationSnapshotError>
source§impl Client
impl Client
sourcepub fn describe_application_version(
&self
) -> DescribeApplicationVersionFluentBuilder
pub fn describe_application_version( &self ) -> DescribeApplicationVersionFluentBuilder
Constructs a fluent builder for the DescribeApplicationVersion
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application for which you want to get the version description.
application_version_id(i64)
/set_application_version_id(Option<i64>)
:
required: trueThe ID of the application version for which you want to get the description.
- On success, responds with
DescribeApplicationVersionOutput
with field(s):application_version_detail(Option<ApplicationDetail>)
:Describes the application, including the application Amazon Resource Name (ARN), status, latest version, and input and output configurations.
- On failure, responds with
SdkError<DescribeApplicationVersionError>
source§impl Client
impl Client
sourcepub fn discover_input_schema(&self) -> DiscoverInputSchemaFluentBuilder
pub fn discover_input_schema(&self) -> DiscoverInputSchemaFluentBuilder
Constructs a fluent builder for the DiscoverInputSchema
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: falseThe Amazon Resource Name (ARN) of the streaming source.
service_execution_role(impl Into<String>)
/set_service_execution_role(Option<String>)
:
required: trueThe ARN of the role that is used to access the streaming source.
input_starting_position_configuration(InputStartingPositionConfiguration)
/set_input_starting_position_configuration(Option<InputStartingPositionConfiguration>)
:
required: falseThe point at which you want Kinesis Data Analytics to start reading records from the specified streaming source for discovery purposes.
s3_configuration(S3Configuration)
/set_s3_configuration(Option<S3Configuration>)
:
required: falseSpecify this parameter to discover a schema from data in an Amazon S3 object.
input_processing_configuration(InputProcessingConfiguration)
/set_input_processing_configuration(Option<InputProcessingConfiguration>)
:
required: falseThe
InputProcessingConfiguration
to use to preprocess the records before discovering the schema of the records.
- On success, responds with
DiscoverInputSchemaOutput
with field(s):input_schema(Option<SourceSchema>)
:The schema inferred from the streaming source. It identifies the format of the data in the streaming source and how each data element maps to corresponding columns in the in-application stream that you can create.
parsed_input_records(Option<Vec::<Vec::<String>>>)
:An array of elements, where each element corresponds to a row in a stream record (a stream record can have more than one row).
processed_input_records(Option<Vec::<String>>)
:The stream data that was modified by the processor specified in the
InputProcessingConfiguration
parameter.raw_input_records(Option<Vec::<String>>)
:The raw stream data that was sampled to infer the schema.
- On failure, responds with
SdkError<DiscoverInputSchemaError>
source§impl Client
impl Client
sourcepub fn list_application_snapshots(
&self
) -> ListApplicationSnapshotsFluentBuilder
pub fn list_application_snapshots( &self ) -> ListApplicationSnapshotsFluentBuilder
Constructs a fluent builder for the ListApplicationSnapshots
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of an existing application.
limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of application snapshots to list.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseUse this parameter if you receive a
NextToken
response in a previous request that indicates that there is more output available. Set it to the value of the previous call’sNextToken
response to indicate where the output should continue from.
- On success, responds with
ListApplicationSnapshotsOutput
with field(s):snapshot_summaries(Option<Vec::<SnapshotDetails>>)
:A collection of objects containing information about the application snapshots.
next_token(Option<String>)
:The token for the next set of results, or
null
if there are no additional results.
- On failure, responds with
SdkError<ListApplicationSnapshotsError>
source§impl Client
impl Client
sourcepub fn list_application_versions(&self) -> ListApplicationVersionsFluentBuilder
pub fn list_application_versions(&self) -> ListApplicationVersionsFluentBuilder
Constructs a fluent builder for the ListApplicationVersions
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application for which you want to list all versions.
limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of versions to list in this invocation of the operation.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseIf a previous invocation of this operation returned a pagination token, pass it into this value to retrieve the next set of results. For more information about pagination, see Using the Amazon Command Line Interface’s Pagination Options.
- On success, responds with
ListApplicationVersionsOutput
with field(s):application_version_summaries(Option<Vec::<ApplicationVersionSummary>>)
:A list of the application versions and the associated configuration summaries. The list includes application versions that were rolled back.
To get the complete description of a specific application version, invoke the
DescribeApplicationVersion
operation.next_token(Option<String>)
:The pagination token for the next set of results, or
null
if there are no additional results. To retrieve the next set of items, pass this token into a subsequent invocation of this operation. For more information about pagination, see Using the Amazon Command Line Interface’s Pagination Options.
- On failure, responds with
SdkError<ListApplicationVersionsError>
source§impl Client
impl Client
sourcepub fn list_applications(&self) -> ListApplicationsFluentBuilder
pub fn list_applications(&self) -> ListApplicationsFluentBuilder
Constructs a fluent builder for the ListApplications
operation.
- The fluent builder is configurable:
limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of applications to list.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseIf a previous command returned a pagination token, pass it into this value to retrieve the next set of results. For more information about pagination, see Using the Amazon Command Line Interface’s Pagination Options.
- On success, responds with
ListApplicationsOutput
with field(s):application_summaries(Vec::<ApplicationSummary>)
:A list of
ApplicationSummary
objects.next_token(Option<String>)
:The pagination token for the next set of results, or
null
if there are no additional results. Pass this token into a subsequent command to retrieve the next set of items For more information about pagination, see Using the Amazon Command Line Interface’s Pagination Options.
- On failure, responds with
SdkError<ListApplicationsError>
source§impl Client
impl Client
Constructs a fluent builder for the ListTagsForResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe ARN of the application for which to retrieve tags.
- On success, responds with
ListTagsForResourceOutput
with field(s):tags(Option<Vec::<Tag>>)
:The key-value tags assigned to the application.
- On failure, responds with
SdkError<ListTagsForResourceError>
source§impl Client
impl Client
sourcepub fn rollback_application(&self) -> RollbackApplicationFluentBuilder
pub fn rollback_application(&self) -> RollbackApplicationFluentBuilder
Constructs a fluent builder for the RollbackApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: trueThe current application version ID. You can retrieve the application version ID using
DescribeApplication
.
- On success, responds with
RollbackApplicationOutput
with field(s):application_detail(Option<ApplicationDetail>)
:Describes the application, including the application Amazon Resource Name (ARN), status, latest version, and input and output configurations.
- On failure, responds with
SdkError<RollbackApplicationError>
source§impl Client
impl Client
sourcepub fn start_application(&self) -> StartApplicationFluentBuilder
pub fn start_application(&self) -> StartApplicationFluentBuilder
Constructs a fluent builder for the StartApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application.
run_configuration(RunConfiguration)
/set_run_configuration(Option<RunConfiguration>)
:
required: falseIdentifies the run configuration (start parameters) of a Managed Service for Apache Flink application.
- On success, responds with
StartApplicationOutput
- On failure, responds with
SdkError<StartApplicationError>
source§impl Client
impl Client
sourcepub fn stop_application(&self) -> StopApplicationFluentBuilder
pub fn stop_application(&self) -> StopApplicationFluentBuilder
Constructs a fluent builder for the StopApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the running application to stop.
force(bool)
/set_force(Option<bool>)
:
required: falseSet to
true
to force the application to stop. If you setForce
totrue
, Managed Service for Apache Flink stops the application without taking a snapshot.Force-stopping your application may lead to data loss or duplication. To prevent data loss or duplicate processing of data during application restarts, we recommend you to take frequent snapshots of your application.
You can only force stop a Managed Service for Apache Flink application. You can’t force stop a SQL-based Kinesis Data Analytics application.
The application must be in the
STARTING
,UPDATING
,STOPPING
,AUTOSCALING
, orRUNNING
status.
- On success, responds with
StopApplicationOutput
- On failure, responds with
SdkError<StopApplicationError>
source§impl Client
impl Client
sourcepub fn tag_resource(&self) -> TagResourceFluentBuilder
pub fn tag_resource(&self) -> TagResourceFluentBuilder
Constructs a fluent builder for the TagResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe ARN of the application to assign the tags.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: trueThe key-value tags to assign to the application.
- On success, responds with
TagResourceOutput
- On failure, responds with
SdkError<TagResourceError>
source§impl Client
impl Client
sourcepub fn untag_resource(&self) -> UntagResourceFluentBuilder
pub fn untag_resource(&self) -> UntagResourceFluentBuilder
Constructs a fluent builder for the UntagResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe ARN of the Managed Service for Apache Flink application from which to remove the tags.
tag_keys(impl Into<String>)
/set_tag_keys(Option<Vec::<String>>)
:
required: trueA list of keys of tags to remove from the specified application.
- On success, responds with
UntagResourceOutput
- On failure, responds with
SdkError<UntagResourceError>
source§impl Client
impl Client
sourcepub fn update_application(&self) -> UpdateApplicationFluentBuilder
pub fn update_application(&self) -> UpdateApplicationFluentBuilder
Constructs a fluent builder for the UpdateApplication
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application to update.
current_application_version_id(i64)
/set_current_application_version_id(Option<i64>)
:
required: falseThe current application version ID. You must provide the
CurrentApplicationVersionId
or theConditionalToken
.You can retrieve the application version ID usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.application_configuration_update(ApplicationConfigurationUpdate)
/set_application_configuration_update(Option<ApplicationConfigurationUpdate>)
:
required: falseDescribes application configuration updates.
service_execution_role_update(impl Into<String>)
/set_service_execution_role_update(Option<String>)
:
required: falseDescribes updates to the service execution role.
run_configuration_update(RunConfigurationUpdate)
/set_run_configuration_update(Option<RunConfigurationUpdate>)
:
required: falseDescribes updates to the application’s starting parameters.
cloud_watch_logging_option_updates(CloudWatchLoggingOptionUpdate)
/set_cloud_watch_logging_option_updates(Option<Vec::<CloudWatchLoggingOptionUpdate>>)
:
required: falseDescribes application Amazon CloudWatch logging option updates. You can only update existing CloudWatch logging options with this action. To add a new CloudWatch logging option, use
AddApplicationCloudWatchLoggingOption
.conditional_token(impl Into<String>)
/set_conditional_token(Option<String>)
:
required: falseA value you use to implement strong concurrency for application updates. You must provide the
CurrentApplicationVersionId
or theConditionalToken
. You get the application’s currentConditionalToken
usingDescribeApplication
. For better concurrency support, use theConditionalToken
parameter instead ofCurrentApplicationVersionId
.runtime_environment_update(RuntimeEnvironment)
/set_runtime_environment_update(Option<RuntimeEnvironment>)
:
required: falseUpdates the Managed Service for Apache Flink runtime environment used to run your code. To avoid issues you must:
-
Ensure your new jar and dependencies are compatible with the new runtime selected.
-
Ensure your new code’s state is compatible with the snapshot from which your application will start
-
- On success, responds with
UpdateApplicationOutput
with field(s):application_detail(Option<ApplicationDetail>)
:Describes application updates.
- On failure, responds with
SdkError<UpdateApplicationError>
source§impl Client
impl Client
sourcepub fn update_application_maintenance_configuration(
&self
) -> UpdateApplicationMaintenanceConfigurationFluentBuilder
pub fn update_application_maintenance_configuration( &self ) -> UpdateApplicationMaintenanceConfigurationFluentBuilder
Constructs a fluent builder for the UpdateApplicationMaintenanceConfiguration
operation.
- The fluent builder is configurable:
application_name(impl Into<String>)
/set_application_name(Option<String>)
:
required: trueThe name of the application for which you want to update the maintenance configuration.
application_maintenance_configuration_update(ApplicationMaintenanceConfigurationUpdate)
/set_application_maintenance_configuration_update(Option<ApplicationMaintenanceConfigurationUpdate>)
:
required: trueDescribes the application maintenance configuration update.
- On success, responds with
UpdateApplicationMaintenanceConfigurationOutput
with field(s):application_arn(Option<String>)
:The Amazon Resource Name (ARN) of the application.
application_maintenance_configuration_description(Option<ApplicationMaintenanceConfigurationDescription>)
:The application maintenance configuration description after the update.
- On failure, responds with
SdkError<UpdateApplicationMaintenanceConfigurationError>
source§impl Client
impl Client
sourcepub fn from_conf(conf: Config) -> Self
pub fn from_conf(conf: Config) -> Self
Creates a new client from the service Config
.
§Panics
This method will panic in the following cases:
- Retries or timeouts are enabled without a
sleep_impl
configured. - Identity caching is enabled without a
sleep_impl
andtime_source
configured. - No
behavior_version
is provided.
The panic message for each of these will have instructions on how to resolve them.
source§impl Client
impl Client
sourcepub fn new(sdk_config: &SdkConfig) -> Self
pub fn new(sdk_config: &SdkConfig) -> Self
Creates a new client from an SDK Config.
§Panics
- This method will panic if the
sdk_config
is missing an async sleep implementation. If you experience this panic, set thesleep_impl
on the Config passed into this function to fix it. - This method will panic if the
sdk_config
is missing an HTTP connector. If you experience this panic, set thehttp_connector
on the Config passed into this function to fix it. - This method will panic if no
BehaviorVersion
is provided. If you experience this panic, setbehavior_version
on the Config or enable thebehavior-version-latest
Cargo feature.
Trait Implementations§
Auto Trait Implementations§
impl Freeze for Client
impl !RefUnwindSafe for Client
impl Send for Client
impl Sync for Client
impl Unpin for Client
impl !UnwindSafe for Client
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more