// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
use std::fmt::Write;
/// See [`DeleteSessionInput`](crate::input::DeleteSessionInput).
pub mod delete_session_input {
/// A builder for [`DeleteSessionInput`](crate::input::DeleteSessionInput).
#[derive(std::clone::Clone, std::cmp::PartialEq, std::default::Default, std::fmt::Debug)]
pub struct Builder {
pub(crate) bot_name: std::option::Option<std::string::String>,
pub(crate) bot_alias: std::option::Option<std::string::String>,
pub(crate) user_id: std::option::Option<std::string::String>,
}
impl Builder {
/// <p>The name of the bot that contains the session data.</p>
pub fn bot_name(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_name = Some(input.into());
self
}
/// <p>The name of the bot that contains the session data.</p>
pub fn set_bot_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_name = input;
self
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn bot_alias(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_alias = Some(input.into());
self
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn set_bot_alias(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_alias = input;
self
}
/// <p>The identifier of the user associated with the session data.</p>
pub fn user_id(mut self, input: impl Into<std::string::String>) -> Self {
self.user_id = Some(input.into());
self
}
/// <p>The identifier of the user associated with the session data.</p>
pub fn set_user_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.user_id = input;
self
}
/// Consumes the builder and constructs a [`DeleteSessionInput`](crate::input::DeleteSessionInput).
pub fn build(
self,
) -> Result<crate::input::DeleteSessionInput, aws_smithy_http::operation::error::BuildError>
{
Ok(crate::input::DeleteSessionInput {
bot_name: self.bot_name,
bot_alias: self.bot_alias,
user_id: self.user_id,
})
}
}
}
impl DeleteSessionInput {
/// Consumes the builder and constructs an Operation<[`DeleteSession`](crate::operation::DeleteSession)>
#[allow(unused_mut)]
#[allow(clippy::let_and_return)]
#[allow(clippy::needless_borrow)]
pub async fn make_operation(
&self,
_config: &crate::config::Config,
) -> std::result::Result<
aws_smithy_http::operation::Operation<
crate::operation::DeleteSession,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::operation::error::BuildError,
> {
let params_result = crate::endpoint::Params::builder()
.set_region(_config.region.as_ref().map(|r| r.as_ref().to_owned()))
.set_use_dual_stack(_config.use_dual_stack)
.set_use_fips(_config.use_fips)
.set_endpoint(_config.endpoint_url.clone())
.build()
.map_err(|err| {
aws_smithy_http::endpoint::ResolveEndpointError::from_source(
"could not construct endpoint parameters",
err,
)
});
let (endpoint_result, params) = match params_result {
Ok(params) => (
_config.endpoint_resolver.resolve_endpoint(¶ms),
Some(params),
),
Err(e) => (Err(e), None),
};
let mut request = {
fn uri_base(
_input: &crate::input::DeleteSessionInput,
output: &mut String,
) -> Result<(), aws_smithy_http::operation::error::BuildError> {
let input_1 = &_input.bot_name;
let input_1 = input_1.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
)
})?;
let bot_name = aws_smithy_http::label::fmt_string(
input_1,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_name.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
),
);
}
let input_2 = &_input.bot_alias;
let input_2 = input_2.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
)
})?;
let bot_alias = aws_smithy_http::label::fmt_string(
input_2,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_alias.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
),
);
}
let input_3 = &_input.user_id;
let input_3 = input_3.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
)
})?;
let user_id = aws_smithy_http::label::fmt_string(
input_3,
aws_smithy_http::label::EncodingStrategy::Default,
);
if user_id.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
),
);
}
write!(
output,
"/bot/{botName}/alias/{botAlias}/user/{userId}/session",
botName = bot_name,
botAlias = bot_alias,
userId = user_id
)
.expect("formatting should succeed");
Ok(())
}
#[allow(clippy::unnecessary_wraps)]
fn update_http_builder(
input: &crate::input::DeleteSessionInput,
builder: http::request::Builder,
) -> std::result::Result<
http::request::Builder,
aws_smithy_http::operation::error::BuildError,
> {
let mut uri = String::new();
uri_base(input, &mut uri)?;
Ok(builder.method("DELETE").uri(uri))
}
let mut builder = update_http_builder(&self, http::request::Builder::new())?;
builder
};
let mut properties = aws_smithy_http::property_bag::SharedPropertyBag::new();
#[allow(clippy::useless_conversion)]
let body = aws_smithy_http::body::SdkBody::from("");
let request = request.body(body).expect("should be valid request");
let mut request = aws_smithy_http::operation::Request::from_parts(request, properties);
request.properties_mut().insert(endpoint_result);
if let Some(params) = params {
request.properties_mut().insert(params);
}
request
.properties_mut()
.insert(aws_smithy_http::http_versions::DEFAULT_HTTP_VERSION_LIST.clone());
let mut user_agent = aws_http::user_agent::AwsUserAgent::new_from_environment(
aws_types::os_shim_internal::Env::real(),
crate::API_METADATA.clone(),
);
if let Some(app_name) = _config.app_name() {
user_agent = user_agent.with_app_name(app_name.clone());
}
request.properties_mut().insert(user_agent);
let mut signing_config = aws_sig_auth::signer::OperationSigningConfig::default_config();
request.properties_mut().insert(signing_config);
request
.properties_mut()
.insert(aws_types::SigningService::from_static(
_config.signing_service(),
));
if let Some(region) = &_config.region {
request
.properties_mut()
.insert(aws_types::region::SigningRegion::from(region.clone()));
}
if let Some(region) = &_config.region {
request.properties_mut().insert(region.clone());
}
aws_http::auth::set_credentials_cache(
&mut request.properties_mut(),
_config.credentials_cache.clone(),
);
let op = aws_smithy_http::operation::Operation::new(
request,
crate::operation::DeleteSession::new(),
)
.with_metadata(aws_smithy_http::operation::Metadata::new(
"DeleteSession",
"lexruntimeservice",
));
let op = op.with_retry_classifier(aws_http::retry::AwsResponseRetryClassifier::new());
Ok(op)
}
/// Creates a new builder-style object to manufacture [`DeleteSessionInput`](crate::input::DeleteSessionInput).
pub fn builder() -> crate::input::delete_session_input::Builder {
crate::input::delete_session_input::Builder::default()
}
}
/// See [`GetSessionInput`](crate::input::GetSessionInput).
pub mod get_session_input {
/// A builder for [`GetSessionInput`](crate::input::GetSessionInput).
#[derive(std::clone::Clone, std::cmp::PartialEq, std::default::Default, std::fmt::Debug)]
pub struct Builder {
pub(crate) bot_name: std::option::Option<std::string::String>,
pub(crate) bot_alias: std::option::Option<std::string::String>,
pub(crate) user_id: std::option::Option<std::string::String>,
pub(crate) checkpoint_label_filter: std::option::Option<std::string::String>,
}
impl Builder {
/// <p>The name of the bot that contains the session data.</p>
pub fn bot_name(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_name = Some(input.into());
self
}
/// <p>The name of the bot that contains the session data.</p>
pub fn set_bot_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_name = input;
self
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn bot_alias(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_alias = Some(input.into());
self
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn set_bot_alias(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_alias = input;
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
pub fn user_id(mut self, input: impl Into<std::string::String>) -> Self {
self.user_id = Some(input.into());
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
pub fn set_user_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.user_id = input;
self
}
/// <p>A string used to filter the intents returned in the <code>recentIntentSummaryView</code> structure. </p>
/// <p>When you specify a filter, only intents with their <code>checkpointLabel</code> field set to that string are returned.</p>
pub fn checkpoint_label_filter(mut self, input: impl Into<std::string::String>) -> Self {
self.checkpoint_label_filter = Some(input.into());
self
}
/// <p>A string used to filter the intents returned in the <code>recentIntentSummaryView</code> structure. </p>
/// <p>When you specify a filter, only intents with their <code>checkpointLabel</code> field set to that string are returned.</p>
pub fn set_checkpoint_label_filter(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.checkpoint_label_filter = input;
self
}
/// Consumes the builder and constructs a [`GetSessionInput`](crate::input::GetSessionInput).
pub fn build(
self,
) -> Result<crate::input::GetSessionInput, aws_smithy_http::operation::error::BuildError>
{
Ok(crate::input::GetSessionInput {
bot_name: self.bot_name,
bot_alias: self.bot_alias,
user_id: self.user_id,
checkpoint_label_filter: self.checkpoint_label_filter,
})
}
}
}
impl GetSessionInput {
/// Consumes the builder and constructs an Operation<[`GetSession`](crate::operation::GetSession)>
#[allow(unused_mut)]
#[allow(clippy::let_and_return)]
#[allow(clippy::needless_borrow)]
pub async fn make_operation(
&self,
_config: &crate::config::Config,
) -> std::result::Result<
aws_smithy_http::operation::Operation<
crate::operation::GetSession,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::operation::error::BuildError,
> {
let params_result = crate::endpoint::Params::builder()
.set_region(_config.region.as_ref().map(|r| r.as_ref().to_owned()))
.set_use_dual_stack(_config.use_dual_stack)
.set_use_fips(_config.use_fips)
.set_endpoint(_config.endpoint_url.clone())
.build()
.map_err(|err| {
aws_smithy_http::endpoint::ResolveEndpointError::from_source(
"could not construct endpoint parameters",
err,
)
});
let (endpoint_result, params) = match params_result {
Ok(params) => (
_config.endpoint_resolver.resolve_endpoint(¶ms),
Some(params),
),
Err(e) => (Err(e), None),
};
let mut request = {
fn uri_base(
_input: &crate::input::GetSessionInput,
output: &mut String,
) -> Result<(), aws_smithy_http::operation::error::BuildError> {
let input_4 = &_input.bot_name;
let input_4 = input_4.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
)
})?;
let bot_name = aws_smithy_http::label::fmt_string(
input_4,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_name.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
),
);
}
let input_5 = &_input.bot_alias;
let input_5 = input_5.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
)
})?;
let bot_alias = aws_smithy_http::label::fmt_string(
input_5,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_alias.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
),
);
}
let input_6 = &_input.user_id;
let input_6 = input_6.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
)
})?;
let user_id = aws_smithy_http::label::fmt_string(
input_6,
aws_smithy_http::label::EncodingStrategy::Default,
);
if user_id.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
),
);
}
write!(
output,
"/bot/{botName}/alias/{botAlias}/user/{userId}/session",
botName = bot_name,
botAlias = bot_alias,
userId = user_id
)
.expect("formatting should succeed");
Ok(())
}
fn uri_query(
_input: &crate::input::GetSessionInput,
mut output: &mut String,
) -> Result<(), aws_smithy_http::operation::error::BuildError> {
let mut query = aws_smithy_http::query::Writer::new(&mut output);
if let Some(inner_7) = &_input.checkpoint_label_filter {
{
query.push_kv(
"checkpointLabelFilter",
&aws_smithy_http::query::fmt_string(&inner_7),
);
}
}
Ok(())
}
#[allow(clippy::unnecessary_wraps)]
fn update_http_builder(
input: &crate::input::GetSessionInput,
builder: http::request::Builder,
) -> std::result::Result<
http::request::Builder,
aws_smithy_http::operation::error::BuildError,
> {
let mut uri = String::new();
uri_base(input, &mut uri)?;
uri_query(input, &mut uri)?;
Ok(builder.method("GET").uri(uri))
}
let mut builder = update_http_builder(&self, http::request::Builder::new())?;
builder
};
let mut properties = aws_smithy_http::property_bag::SharedPropertyBag::new();
#[allow(clippy::useless_conversion)]
let body = aws_smithy_http::body::SdkBody::from("");
let request = request.body(body).expect("should be valid request");
let mut request = aws_smithy_http::operation::Request::from_parts(request, properties);
request.properties_mut().insert(endpoint_result);
if let Some(params) = params {
request.properties_mut().insert(params);
}
request
.properties_mut()
.insert(aws_smithy_http::http_versions::DEFAULT_HTTP_VERSION_LIST.clone());
let mut user_agent = aws_http::user_agent::AwsUserAgent::new_from_environment(
aws_types::os_shim_internal::Env::real(),
crate::API_METADATA.clone(),
);
if let Some(app_name) = _config.app_name() {
user_agent = user_agent.with_app_name(app_name.clone());
}
request.properties_mut().insert(user_agent);
let mut signing_config = aws_sig_auth::signer::OperationSigningConfig::default_config();
request.properties_mut().insert(signing_config);
request
.properties_mut()
.insert(aws_types::SigningService::from_static(
_config.signing_service(),
));
if let Some(region) = &_config.region {
request
.properties_mut()
.insert(aws_types::region::SigningRegion::from(region.clone()));
}
if let Some(region) = &_config.region {
request.properties_mut().insert(region.clone());
}
aws_http::auth::set_credentials_cache(
&mut request.properties_mut(),
_config.credentials_cache.clone(),
);
let op = aws_smithy_http::operation::Operation::new(
request,
crate::operation::GetSession::new(),
)
.with_metadata(aws_smithy_http::operation::Metadata::new(
"GetSession",
"lexruntimeservice",
));
let op = op.with_retry_classifier(aws_http::retry::AwsResponseRetryClassifier::new());
Ok(op)
}
/// Creates a new builder-style object to manufacture [`GetSessionInput`](crate::input::GetSessionInput).
pub fn builder() -> crate::input::get_session_input::Builder {
crate::input::get_session_input::Builder::default()
}
}
/// See [`PostContentInput`](crate::input::PostContentInput).
pub mod post_content_input {
/// A builder for [`PostContentInput`](crate::input::PostContentInput).
#[derive(std::default::Default)]
pub struct Builder {
pub(crate) bot_name: std::option::Option<std::string::String>,
pub(crate) bot_alias: std::option::Option<std::string::String>,
pub(crate) user_id: std::option::Option<std::string::String>,
pub(crate) session_attributes: std::option::Option<std::string::String>,
pub(crate) request_attributes: std::option::Option<std::string::String>,
pub(crate) content_type: std::option::Option<std::string::String>,
pub(crate) accept: std::option::Option<std::string::String>,
pub(crate) input_stream: std::option::Option<aws_smithy_http::byte_stream::ByteStream>,
pub(crate) active_contexts: std::option::Option<std::string::String>,
}
impl Builder {
/// <p>Name of the Amazon Lex bot.</p>
pub fn bot_name(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_name = Some(input.into());
self
}
/// <p>Name of the Amazon Lex bot.</p>
pub fn set_bot_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_name = input;
self
}
/// <p>Alias of the Amazon Lex bot.</p>
pub fn bot_alias(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_alias = Some(input.into());
self
}
/// <p>Alias of the Amazon Lex bot.</p>
pub fn set_bot_alias(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_alias = input;
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
pub fn user_id(mut self, input: impl Into<std::string::String>) -> Self {
self.user_id = Some(input.into());
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
pub fn set_user_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.user_id = input;
self
}
/// <p>You pass this value as the <code>x-amz-lex-session-attributes</code> HTTP header.</p>
/// <p>Application-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>sessionAttributes</code> and <code>requestAttributes</code> headers is limited to 12 KB.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
pub fn session_attributes(mut self, input: impl Into<std::string::String>) -> Self {
self.session_attributes = Some(input.into());
self
}
/// <p>You pass this value as the <code>x-amz-lex-session-attributes</code> HTTP header.</p>
/// <p>Application-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>sessionAttributes</code> and <code>requestAttributes</code> headers is limited to 12 KB.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
pub fn set_session_attributes(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.session_attributes = input;
self
}
/// <p>You pass this value as the <code>x-amz-lex-request-attributes</code> HTTP header.</p>
/// <p>Request-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>requestAttributes</code> and <code>sessionAttributes</code> headers is limited to 12 KB.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
pub fn request_attributes(mut self, input: impl Into<std::string::String>) -> Self {
self.request_attributes = Some(input.into());
self
}
/// <p>You pass this value as the <code>x-amz-lex-request-attributes</code> HTTP header.</p>
/// <p>Request-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>requestAttributes</code> and <code>sessionAttributes</code> headers is limited to 12 KB.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
pub fn set_request_attributes(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.request_attributes = input;
self
}
/// <p> You pass this value as the <code>Content-Type</code> HTTP header. </p>
/// <p> Indicates the audio format or text. The header value must start with one of the following prefixes: </p>
/// <ul>
/// <li> <p>PCM format, audio data must be in little-endian byte order.</p>
/// <ul>
/// <li> <p>audio/l16; rate=16000; channels=1</p> </li>
/// <li> <p>audio/x-l16; sample-rate=16000; channel-count=1</p> </li>
/// <li> <p>audio/lpcm; sample-rate=8000; sample-size-bits=16; channel-count=1; is-big-endian=false </p> </li>
/// </ul> </li>
/// <li> <p>Opus format</p>
/// <ul>
/// <li> <p>audio/x-cbr-opus-with-preamble; preamble-size=0; bit-rate=256000; frame-size-milliseconds=4</p> </li>
/// </ul> </li>
/// <li> <p>Text format</p>
/// <ul>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// </ul> </li>
/// </ul>
pub fn content_type(mut self, input: impl Into<std::string::String>) -> Self {
self.content_type = Some(input.into());
self
}
/// <p> You pass this value as the <code>Content-Type</code> HTTP header. </p>
/// <p> Indicates the audio format or text. The header value must start with one of the following prefixes: </p>
/// <ul>
/// <li> <p>PCM format, audio data must be in little-endian byte order.</p>
/// <ul>
/// <li> <p>audio/l16; rate=16000; channels=1</p> </li>
/// <li> <p>audio/x-l16; sample-rate=16000; channel-count=1</p> </li>
/// <li> <p>audio/lpcm; sample-rate=8000; sample-size-bits=16; channel-count=1; is-big-endian=false </p> </li>
/// </ul> </li>
/// <li> <p>Opus format</p>
/// <ul>
/// <li> <p>audio/x-cbr-opus-with-preamble; preamble-size=0; bit-rate=256000; frame-size-milliseconds=4</p> </li>
/// </ul> </li>
/// <li> <p>Text format</p>
/// <ul>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// </ul> </li>
/// </ul>
pub fn set_content_type(mut self, input: std::option::Option<std::string::String>) -> Self {
self.content_type = input;
self
}
/// <p> You pass this value as the <code>Accept</code> HTTP header. </p>
/// <p> The message Amazon Lex returns in the response can be either text or speech based on the <code>Accept</code> HTTP header value in the request. </p>
/// <ul>
/// <li> <p> If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response. </p> </li>
/// <li> <p> If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech (using the configuration you specified in the <code>Accept</code> header). For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech returned is <code>audio/pcm</code> in 16-bit, little endian format. </p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p>audio/mpeg</p> </li>
/// <li> <p>audio/ogg</p> </li>
/// <li> <p>audio/pcm</p> </li>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// <li> <p>audio/* (defaults to mpeg)</p> </li>
/// </ul> </li>
/// </ul>
pub fn accept(mut self, input: impl Into<std::string::String>) -> Self {
self.accept = Some(input.into());
self
}
/// <p> You pass this value as the <code>Accept</code> HTTP header. </p>
/// <p> The message Amazon Lex returns in the response can be either text or speech based on the <code>Accept</code> HTTP header value in the request. </p>
/// <ul>
/// <li> <p> If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response. </p> </li>
/// <li> <p> If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech (using the configuration you specified in the <code>Accept</code> header). For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech returned is <code>audio/pcm</code> in 16-bit, little endian format. </p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p>audio/mpeg</p> </li>
/// <li> <p>audio/ogg</p> </li>
/// <li> <p>audio/pcm</p> </li>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// <li> <p>audio/* (defaults to mpeg)</p> </li>
/// </ul> </li>
/// </ul>
pub fn set_accept(mut self, input: std::option::Option<std::string::String>) -> Self {
self.accept = input;
self
}
/// <p> User input in PCM or Opus audio format or text format as described in the <code>Content-Type</code> HTTP header. </p>
/// <p>You can stream audio data to Amazon Lex or you can create a local buffer that captures all of the audio data before sending. In general, you get better performance if you stream audio data rather than buffering the data locally.</p>
pub fn input_stream(mut self, input: aws_smithy_http::byte_stream::ByteStream) -> Self {
self.input_stream = Some(input);
self
}
/// <p> User input in PCM or Opus audio format or text format as described in the <code>Content-Type</code> HTTP header. </p>
/// <p>You can stream audio data to Amazon Lex or you can create a local buffer that captures all of the audio data before sending. In general, you get better performance if you stream audio data rather than buffering the data locally.</p>
pub fn set_input_stream(
mut self,
input: std::option::Option<aws_smithy_http::byte_stream::ByteStream>,
) -> Self {
self.input_stream = input;
self
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn active_contexts(mut self, input: impl Into<std::string::String>) -> Self {
self.active_contexts = Some(input.into());
self
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn set_active_contexts(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.active_contexts = input;
self
}
/// Consumes the builder and constructs a [`PostContentInput`](crate::input::PostContentInput).
pub fn build(
self,
) -> Result<crate::input::PostContentInput, aws_smithy_http::operation::error::BuildError>
{
Ok(crate::input::PostContentInput {
bot_name: self.bot_name,
bot_alias: self.bot_alias,
user_id: self.user_id,
session_attributes: self.session_attributes,
request_attributes: self.request_attributes,
content_type: self.content_type,
accept: self.accept,
input_stream: self.input_stream.unwrap_or_default(),
active_contexts: self.active_contexts,
})
}
}
impl std::fmt::Debug for Builder {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
let mut formatter = f.debug_struct("Builder");
formatter.field("bot_name", &self.bot_name);
formatter.field("bot_alias", &self.bot_alias);
formatter.field("user_id", &self.user_id);
formatter.field("session_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("request_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("content_type", &self.content_type);
formatter.field("accept", &self.accept);
formatter.field("input_stream", &self.input_stream);
formatter.field("active_contexts", &"*** Sensitive Data Redacted ***");
formatter.finish()
}
}
}
impl PostContentInput {
/// Consumes the builder and constructs an Operation<[`PostContent`](crate::operation::PostContent)>
#[allow(unused_mut)]
#[allow(clippy::let_and_return)]
#[allow(clippy::needless_borrow)]
pub async fn make_operation(
self,
_config: &crate::config::Config,
) -> std::result::Result<
aws_smithy_http::operation::Operation<
crate::operation::PostContent,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::operation::error::BuildError,
> {
let params_result = crate::endpoint::Params::builder()
.set_region(_config.region.as_ref().map(|r| r.as_ref().to_owned()))
.set_use_dual_stack(_config.use_dual_stack)
.set_use_fips(_config.use_fips)
.set_endpoint(_config.endpoint_url.clone())
.build()
.map_err(|err| {
aws_smithy_http::endpoint::ResolveEndpointError::from_source(
"could not construct endpoint parameters",
err,
)
});
let (endpoint_result, params) = match params_result {
Ok(params) => (
_config.endpoint_resolver.resolve_endpoint(¶ms),
Some(params),
),
Err(e) => (Err(e), None),
};
let mut request = {
fn uri_base(
_input: &crate::input::PostContentInput,
output: &mut String,
) -> Result<(), aws_smithy_http::operation::error::BuildError> {
let input_8 = &_input.bot_name;
let input_8 = input_8.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
)
})?;
let bot_name = aws_smithy_http::label::fmt_string(
input_8,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_name.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
),
);
}
let input_9 = &_input.bot_alias;
let input_9 = input_9.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
)
})?;
let bot_alias = aws_smithy_http::label::fmt_string(
input_9,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_alias.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
),
);
}
let input_10 = &_input.user_id;
let input_10 = input_10.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
)
})?;
let user_id = aws_smithy_http::label::fmt_string(
input_10,
aws_smithy_http::label::EncodingStrategy::Default,
);
if user_id.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
),
);
}
write!(
output,
"/bot/{botName}/alias/{botAlias}/user/{userId}/content",
botName = bot_name,
botAlias = bot_alias,
userId = user_id
)
.expect("formatting should succeed");
Ok(())
}
#[allow(clippy::unnecessary_wraps)]
fn update_http_builder(
input: &crate::input::PostContentInput,
builder: http::request::Builder,
) -> std::result::Result<
http::request::Builder,
aws_smithy_http::operation::error::BuildError,
> {
let mut uri = String::new();
uri_base(input, &mut uri)?;
let builder = crate::http_serde::add_headers_post_content(input, builder)?;
Ok(builder.method("POST").uri(uri))
}
let mut builder = update_http_builder(&self, http::request::Builder::new())?;
builder = aws_smithy_http::header::set_request_header_if_absent(
builder,
http::header::CONTENT_TYPE,
"application/octet-stream",
);
builder
};
let mut properties = aws_smithy_http::property_bag::SharedPropertyBag::new();
#[allow(clippy::useless_conversion)]
let body = aws_smithy_http::body::SdkBody::from(
crate::operation_ser::serialize_payload_post_content_input(self.input_stream)?
.into_inner(),
);
if let Some(content_length) = body.content_length() {
request = aws_smithy_http::header::set_request_header_if_absent(
request,
http::header::CONTENT_LENGTH,
content_length,
);
}
let request = request.body(body).expect("should be valid request");
let mut request = aws_smithy_http::operation::Request::from_parts(request, properties);
request.properties_mut().insert(endpoint_result);
if let Some(params) = params {
request.properties_mut().insert(params);
}
request
.properties_mut()
.insert(aws_smithy_http::http_versions::DEFAULT_HTTP_VERSION_LIST.clone());
let mut user_agent = aws_http::user_agent::AwsUserAgent::new_from_environment(
aws_types::os_shim_internal::Env::real(),
crate::API_METADATA.clone(),
);
if let Some(app_name) = _config.app_name() {
user_agent = user_agent.with_app_name(app_name.clone());
}
request.properties_mut().insert(user_agent);
let mut signing_config = aws_sig_auth::signer::OperationSigningConfig::default_config();
signing_config.signing_options.content_sha256_header = true;
request
.properties_mut()
.insert(aws_sig_auth::signer::SignableBody::UnsignedPayload);
request.properties_mut().insert(signing_config);
request
.properties_mut()
.insert(aws_types::SigningService::from_static(
_config.signing_service(),
));
if let Some(region) = &_config.region {
request
.properties_mut()
.insert(aws_types::region::SigningRegion::from(region.clone()));
}
if let Some(region) = &_config.region {
request.properties_mut().insert(region.clone());
}
aws_http::auth::set_credentials_cache(
&mut request.properties_mut(),
_config.credentials_cache.clone(),
);
let op = aws_smithy_http::operation::Operation::new(
request,
crate::operation::PostContent::new(),
)
.with_metadata(aws_smithy_http::operation::Metadata::new(
"PostContent",
"lexruntimeservice",
));
let op = op.with_retry_classifier(aws_http::retry::AwsResponseRetryClassifier::new());
Ok(op)
}
/// Creates a new builder-style object to manufacture [`PostContentInput`](crate::input::PostContentInput).
pub fn builder() -> crate::input::post_content_input::Builder {
crate::input::post_content_input::Builder::default()
}
}
/// See [`PostTextInput`](crate::input::PostTextInput).
pub mod post_text_input {
/// A builder for [`PostTextInput`](crate::input::PostTextInput).
#[derive(std::clone::Clone, std::cmp::PartialEq, std::default::Default)]
pub struct Builder {
pub(crate) bot_name: std::option::Option<std::string::String>,
pub(crate) bot_alias: std::option::Option<std::string::String>,
pub(crate) user_id: std::option::Option<std::string::String>,
pub(crate) session_attributes: std::option::Option<
std::collections::HashMap<std::string::String, std::string::String>,
>,
pub(crate) request_attributes: std::option::Option<
std::collections::HashMap<std::string::String, std::string::String>,
>,
pub(crate) input_text: std::option::Option<std::string::String>,
pub(crate) active_contexts: std::option::Option<std::vec::Vec<crate::model::ActiveContext>>,
}
impl Builder {
/// <p>The name of the Amazon Lex bot.</p>
pub fn bot_name(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_name = Some(input.into());
self
}
/// <p>The name of the Amazon Lex bot.</p>
pub fn set_bot_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_name = input;
self
}
/// <p>The alias of the Amazon Lex bot.</p>
pub fn bot_alias(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_alias = Some(input.into());
self
}
/// <p>The alias of the Amazon Lex bot.</p>
pub fn set_bot_alias(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_alias = input;
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
pub fn user_id(mut self, input: impl Into<std::string::String>) -> Self {
self.user_id = Some(input.into());
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
pub fn set_user_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.user_id = input;
self
}
/// Adds a key-value pair to `session_attributes`.
///
/// To override the contents of this collection use [`set_session_attributes`](Self::set_session_attributes).
///
/// <p>Application-specific information passed between Amazon Lex and a client application.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
pub fn session_attributes(
mut self,
k: impl Into<std::string::String>,
v: impl Into<std::string::String>,
) -> Self {
let mut hash_map = self.session_attributes.unwrap_or_default();
hash_map.insert(k.into(), v.into());
self.session_attributes = Some(hash_map);
self
}
/// <p>Application-specific information passed between Amazon Lex and a client application.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
pub fn set_session_attributes(
mut self,
input: std::option::Option<
std::collections::HashMap<std::string::String, std::string::String>,
>,
) -> Self {
self.session_attributes = input;
self
}
/// Adds a key-value pair to `request_attributes`.
///
/// To override the contents of this collection use [`set_request_attributes`](Self::set_request_attributes).
///
/// <p>Request-specific information passed between Amazon Lex and a client application.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
pub fn request_attributes(
mut self,
k: impl Into<std::string::String>,
v: impl Into<std::string::String>,
) -> Self {
let mut hash_map = self.request_attributes.unwrap_or_default();
hash_map.insert(k.into(), v.into());
self.request_attributes = Some(hash_map);
self
}
/// <p>Request-specific information passed between Amazon Lex and a client application.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
pub fn set_request_attributes(
mut self,
input: std::option::Option<
std::collections::HashMap<std::string::String, std::string::String>,
>,
) -> Self {
self.request_attributes = input;
self
}
/// <p>The text that the user entered (Amazon Lex interprets this text).</p>
pub fn input_text(mut self, input: impl Into<std::string::String>) -> Self {
self.input_text = Some(input.into());
self
}
/// <p>The text that the user entered (Amazon Lex interprets this text).</p>
pub fn set_input_text(mut self, input: std::option::Option<std::string::String>) -> Self {
self.input_text = input;
self
}
/// Appends an item to `active_contexts`.
///
/// To override the contents of this collection use [`set_active_contexts`](Self::set_active_contexts).
///
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn active_contexts(mut self, input: crate::model::ActiveContext) -> Self {
let mut v = self.active_contexts.unwrap_or_default();
v.push(input);
self.active_contexts = Some(v);
self
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn set_active_contexts(
mut self,
input: std::option::Option<std::vec::Vec<crate::model::ActiveContext>>,
) -> Self {
self.active_contexts = input;
self
}
/// Consumes the builder and constructs a [`PostTextInput`](crate::input::PostTextInput).
pub fn build(
self,
) -> Result<crate::input::PostTextInput, aws_smithy_http::operation::error::BuildError>
{
Ok(crate::input::PostTextInput {
bot_name: self.bot_name,
bot_alias: self.bot_alias,
user_id: self.user_id,
session_attributes: self.session_attributes,
request_attributes: self.request_attributes,
input_text: self.input_text,
active_contexts: self.active_contexts,
})
}
}
impl std::fmt::Debug for Builder {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
let mut formatter = f.debug_struct("Builder");
formatter.field("bot_name", &self.bot_name);
formatter.field("bot_alias", &self.bot_alias);
formatter.field("user_id", &self.user_id);
formatter.field("session_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("request_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("input_text", &"*** Sensitive Data Redacted ***");
formatter.field("active_contexts", &"*** Sensitive Data Redacted ***");
formatter.finish()
}
}
}
impl PostTextInput {
/// Consumes the builder and constructs an Operation<[`PostText`](crate::operation::PostText)>
#[allow(unused_mut)]
#[allow(clippy::let_and_return)]
#[allow(clippy::needless_borrow)]
pub async fn make_operation(
&self,
_config: &crate::config::Config,
) -> std::result::Result<
aws_smithy_http::operation::Operation<
crate::operation::PostText,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::operation::error::BuildError,
> {
let params_result = crate::endpoint::Params::builder()
.set_region(_config.region.as_ref().map(|r| r.as_ref().to_owned()))
.set_use_dual_stack(_config.use_dual_stack)
.set_use_fips(_config.use_fips)
.set_endpoint(_config.endpoint_url.clone())
.build()
.map_err(|err| {
aws_smithy_http::endpoint::ResolveEndpointError::from_source(
"could not construct endpoint parameters",
err,
)
});
let (endpoint_result, params) = match params_result {
Ok(params) => (
_config.endpoint_resolver.resolve_endpoint(¶ms),
Some(params),
),
Err(e) => (Err(e), None),
};
let mut request = {
fn uri_base(
_input: &crate::input::PostTextInput,
output: &mut String,
) -> Result<(), aws_smithy_http::operation::error::BuildError> {
let input_11 = &_input.bot_name;
let input_11 = input_11.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
)
})?;
let bot_name = aws_smithy_http::label::fmt_string(
input_11,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_name.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
),
);
}
let input_12 = &_input.bot_alias;
let input_12 = input_12.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
)
})?;
let bot_alias = aws_smithy_http::label::fmt_string(
input_12,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_alias.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
),
);
}
let input_13 = &_input.user_id;
let input_13 = input_13.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
)
})?;
let user_id = aws_smithy_http::label::fmt_string(
input_13,
aws_smithy_http::label::EncodingStrategy::Default,
);
if user_id.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
),
);
}
write!(
output,
"/bot/{botName}/alias/{botAlias}/user/{userId}/text",
botName = bot_name,
botAlias = bot_alias,
userId = user_id
)
.expect("formatting should succeed");
Ok(())
}
#[allow(clippy::unnecessary_wraps)]
fn update_http_builder(
input: &crate::input::PostTextInput,
builder: http::request::Builder,
) -> std::result::Result<
http::request::Builder,
aws_smithy_http::operation::error::BuildError,
> {
let mut uri = String::new();
uri_base(input, &mut uri)?;
Ok(builder.method("POST").uri(uri))
}
let mut builder = update_http_builder(&self, http::request::Builder::new())?;
builder = aws_smithy_http::header::set_request_header_if_absent(
builder,
http::header::CONTENT_TYPE,
"application/json",
);
builder
};
let mut properties = aws_smithy_http::property_bag::SharedPropertyBag::new();
#[allow(clippy::useless_conversion)]
let body = aws_smithy_http::body::SdkBody::from(
crate::operation_ser::serialize_operation_crate_operation_post_text(&self)?,
);
if let Some(content_length) = body.content_length() {
request = aws_smithy_http::header::set_request_header_if_absent(
request,
http::header::CONTENT_LENGTH,
content_length,
);
}
let request = request.body(body).expect("should be valid request");
let mut request = aws_smithy_http::operation::Request::from_parts(request, properties);
request.properties_mut().insert(endpoint_result);
if let Some(params) = params {
request.properties_mut().insert(params);
}
request
.properties_mut()
.insert(aws_smithy_http::http_versions::DEFAULT_HTTP_VERSION_LIST.clone());
let mut user_agent = aws_http::user_agent::AwsUserAgent::new_from_environment(
aws_types::os_shim_internal::Env::real(),
crate::API_METADATA.clone(),
);
if let Some(app_name) = _config.app_name() {
user_agent = user_agent.with_app_name(app_name.clone());
}
request.properties_mut().insert(user_agent);
let mut signing_config = aws_sig_auth::signer::OperationSigningConfig::default_config();
request.properties_mut().insert(signing_config);
request
.properties_mut()
.insert(aws_types::SigningService::from_static(
_config.signing_service(),
));
if let Some(region) = &_config.region {
request
.properties_mut()
.insert(aws_types::region::SigningRegion::from(region.clone()));
}
if let Some(region) = &_config.region {
request.properties_mut().insert(region.clone());
}
aws_http::auth::set_credentials_cache(
&mut request.properties_mut(),
_config.credentials_cache.clone(),
);
let op =
aws_smithy_http::operation::Operation::new(request, crate::operation::PostText::new())
.with_metadata(aws_smithy_http::operation::Metadata::new(
"PostText",
"lexruntimeservice",
));
let op = op.with_retry_classifier(aws_http::retry::AwsResponseRetryClassifier::new());
Ok(op)
}
/// Creates a new builder-style object to manufacture [`PostTextInput`](crate::input::PostTextInput).
pub fn builder() -> crate::input::post_text_input::Builder {
crate::input::post_text_input::Builder::default()
}
}
/// See [`PutSessionInput`](crate::input::PutSessionInput).
pub mod put_session_input {
/// A builder for [`PutSessionInput`](crate::input::PutSessionInput).
#[derive(std::clone::Clone, std::cmp::PartialEq, std::default::Default)]
pub struct Builder {
pub(crate) bot_name: std::option::Option<std::string::String>,
pub(crate) bot_alias: std::option::Option<std::string::String>,
pub(crate) user_id: std::option::Option<std::string::String>,
pub(crate) session_attributes: std::option::Option<
std::collections::HashMap<std::string::String, std::string::String>,
>,
pub(crate) dialog_action: std::option::Option<crate::model::DialogAction>,
pub(crate) recent_intent_summary_view:
std::option::Option<std::vec::Vec<crate::model::IntentSummary>>,
pub(crate) accept: std::option::Option<std::string::String>,
pub(crate) active_contexts: std::option::Option<std::vec::Vec<crate::model::ActiveContext>>,
}
impl Builder {
/// <p>The name of the bot that contains the session data.</p>
pub fn bot_name(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_name = Some(input.into());
self
}
/// <p>The name of the bot that contains the session data.</p>
pub fn set_bot_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_name = input;
self
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn bot_alias(mut self, input: impl Into<std::string::String>) -> Self {
self.bot_alias = Some(input.into());
self
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn set_bot_alias(mut self, input: std::option::Option<std::string::String>) -> Self {
self.bot_alias = input;
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
pub fn user_id(mut self, input: impl Into<std::string::String>) -> Self {
self.user_id = Some(input.into());
self
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
pub fn set_user_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.user_id = input;
self
}
/// Adds a key-value pair to `session_attributes`.
///
/// To override the contents of this collection use [`set_session_attributes`](Self::set_session_attributes).
///
/// <p>Map of key/value pairs representing the session-specific context information. It contains application information passed between Amazon Lex and a client application.</p>
pub fn session_attributes(
mut self,
k: impl Into<std::string::String>,
v: impl Into<std::string::String>,
) -> Self {
let mut hash_map = self.session_attributes.unwrap_or_default();
hash_map.insert(k.into(), v.into());
self.session_attributes = Some(hash_map);
self
}
/// <p>Map of key/value pairs representing the session-specific context information. It contains application information passed between Amazon Lex and a client application.</p>
pub fn set_session_attributes(
mut self,
input: std::option::Option<
std::collections::HashMap<std::string::String, std::string::String>,
>,
) -> Self {
self.session_attributes = input;
self
}
/// <p>Sets the next action that the bot should take to fulfill the conversation.</p>
pub fn dialog_action(mut self, input: crate::model::DialogAction) -> Self {
self.dialog_action = Some(input);
self
}
/// <p>Sets the next action that the bot should take to fulfill the conversation.</p>
pub fn set_dialog_action(
mut self,
input: std::option::Option<crate::model::DialogAction>,
) -> Self {
self.dialog_action = input;
self
}
/// Appends an item to `recent_intent_summary_view`.
///
/// To override the contents of this collection use [`set_recent_intent_summary_view`](Self::set_recent_intent_summary_view).
///
/// <p>A summary of the recent intents for the bot. You can use the intent summary view to set a checkpoint label on an intent and modify attributes of intents. You can also use it to remove or add intent summary objects to the list.</p>
/// <p>An intent that you modify or add to the list must make sense for the bot. For example, the intent name must be valid for the bot. You must provide valid values for:</p>
/// <ul>
/// <li> <p> <code>intentName</code> </p> </li>
/// <li> <p>slot names</p> </li>
/// <li> <p> <code>slotToElict</code> </p> </li>
/// </ul>
/// <p>If you send the <code>recentIntentSummaryView</code> parameter in a <code>PutSession</code> request, the contents of the new summary view replaces the old summary view. For example, if a <code>GetSession</code> request returns three intents in the summary view and you call <code>PutSession</code> with one intent in the summary view, the next call to <code>GetSession</code> will only return one intent.</p>
pub fn recent_intent_summary_view(mut self, input: crate::model::IntentSummary) -> Self {
let mut v = self.recent_intent_summary_view.unwrap_or_default();
v.push(input);
self.recent_intent_summary_view = Some(v);
self
}
/// <p>A summary of the recent intents for the bot. You can use the intent summary view to set a checkpoint label on an intent and modify attributes of intents. You can also use it to remove or add intent summary objects to the list.</p>
/// <p>An intent that you modify or add to the list must make sense for the bot. For example, the intent name must be valid for the bot. You must provide valid values for:</p>
/// <ul>
/// <li> <p> <code>intentName</code> </p> </li>
/// <li> <p>slot names</p> </li>
/// <li> <p> <code>slotToElict</code> </p> </li>
/// </ul>
/// <p>If you send the <code>recentIntentSummaryView</code> parameter in a <code>PutSession</code> request, the contents of the new summary view replaces the old summary view. For example, if a <code>GetSession</code> request returns three intents in the summary view and you call <code>PutSession</code> with one intent in the summary view, the next call to <code>GetSession</code> will only return one intent.</p>
pub fn set_recent_intent_summary_view(
mut self,
input: std::option::Option<std::vec::Vec<crate::model::IntentSummary>>,
) -> Self {
self.recent_intent_summary_view = input;
self
}
/// <p>The message that Amazon Lex returns in the response can be either text or speech based depending on the value of this field.</p>
/// <ul>
/// <li> <p>If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response.</p> </li>
/// <li> <p>If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech in the configuration that you specify. For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech is returned as <code>audio/pcm</code> in 16-bit, little endian format.</p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p> <code>audio/mpeg</code> </p> </li>
/// <li> <p> <code>audio/ogg</code> </p> </li>
/// <li> <p> <code>audio/pcm</code> </p> </li>
/// <li> <p> <code>audio/*</code> (defaults to mpeg)</p> </li>
/// <li> <p> <code>text/plain; charset=utf-8</code> </p> </li>
/// </ul> </li>
/// </ul>
pub fn accept(mut self, input: impl Into<std::string::String>) -> Self {
self.accept = Some(input.into());
self
}
/// <p>The message that Amazon Lex returns in the response can be either text or speech based depending on the value of this field.</p>
/// <ul>
/// <li> <p>If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response.</p> </li>
/// <li> <p>If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech in the configuration that you specify. For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech is returned as <code>audio/pcm</code> in 16-bit, little endian format.</p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p> <code>audio/mpeg</code> </p> </li>
/// <li> <p> <code>audio/ogg</code> </p> </li>
/// <li> <p> <code>audio/pcm</code> </p> </li>
/// <li> <p> <code>audio/*</code> (defaults to mpeg)</p> </li>
/// <li> <p> <code>text/plain; charset=utf-8</code> </p> </li>
/// </ul> </li>
/// </ul>
pub fn set_accept(mut self, input: std::option::Option<std::string::String>) -> Self {
self.accept = input;
self
}
/// Appends an item to `active_contexts`.
///
/// To override the contents of this collection use [`set_active_contexts`](Self::set_active_contexts).
///
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn active_contexts(mut self, input: crate::model::ActiveContext) -> Self {
let mut v = self.active_contexts.unwrap_or_default();
v.push(input);
self.active_contexts = Some(v);
self
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn set_active_contexts(
mut self,
input: std::option::Option<std::vec::Vec<crate::model::ActiveContext>>,
) -> Self {
self.active_contexts = input;
self
}
/// Consumes the builder and constructs a [`PutSessionInput`](crate::input::PutSessionInput).
pub fn build(
self,
) -> Result<crate::input::PutSessionInput, aws_smithy_http::operation::error::BuildError>
{
Ok(crate::input::PutSessionInput {
bot_name: self.bot_name,
bot_alias: self.bot_alias,
user_id: self.user_id,
session_attributes: self.session_attributes,
dialog_action: self.dialog_action,
recent_intent_summary_view: self.recent_intent_summary_view,
accept: self.accept,
active_contexts: self.active_contexts,
})
}
}
impl std::fmt::Debug for Builder {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
let mut formatter = f.debug_struct("Builder");
formatter.field("bot_name", &self.bot_name);
formatter.field("bot_alias", &self.bot_alias);
formatter.field("user_id", &self.user_id);
formatter.field("session_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("dialog_action", &self.dialog_action);
formatter.field(
"recent_intent_summary_view",
&self.recent_intent_summary_view,
);
formatter.field("accept", &self.accept);
formatter.field("active_contexts", &"*** Sensitive Data Redacted ***");
formatter.finish()
}
}
}
impl PutSessionInput {
/// Consumes the builder and constructs an Operation<[`PutSession`](crate::operation::PutSession)>
#[allow(unused_mut)]
#[allow(clippy::let_and_return)]
#[allow(clippy::needless_borrow)]
pub async fn make_operation(
&self,
_config: &crate::config::Config,
) -> std::result::Result<
aws_smithy_http::operation::Operation<
crate::operation::PutSession,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::operation::error::BuildError,
> {
let params_result = crate::endpoint::Params::builder()
.set_region(_config.region.as_ref().map(|r| r.as_ref().to_owned()))
.set_use_dual_stack(_config.use_dual_stack)
.set_use_fips(_config.use_fips)
.set_endpoint(_config.endpoint_url.clone())
.build()
.map_err(|err| {
aws_smithy_http::endpoint::ResolveEndpointError::from_source(
"could not construct endpoint parameters",
err,
)
});
let (endpoint_result, params) = match params_result {
Ok(params) => (
_config.endpoint_resolver.resolve_endpoint(¶ms),
Some(params),
),
Err(e) => (Err(e), None),
};
let mut request = {
fn uri_base(
_input: &crate::input::PutSessionInput,
output: &mut String,
) -> Result<(), aws_smithy_http::operation::error::BuildError> {
let input_14 = &_input.bot_name;
let input_14 = input_14.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
)
})?;
let bot_name = aws_smithy_http::label::fmt_string(
input_14,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_name.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_name",
"cannot be empty or unset",
),
);
}
let input_15 = &_input.bot_alias;
let input_15 = input_15.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
)
})?;
let bot_alias = aws_smithy_http::label::fmt_string(
input_15,
aws_smithy_http::label::EncodingStrategy::Default,
);
if bot_alias.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"bot_alias",
"cannot be empty or unset",
),
);
}
let input_16 = &_input.user_id;
let input_16 = input_16.as_ref().ok_or_else(|| {
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
)
})?;
let user_id = aws_smithy_http::label::fmt_string(
input_16,
aws_smithy_http::label::EncodingStrategy::Default,
);
if user_id.is_empty() {
return Err(
aws_smithy_http::operation::error::BuildError::missing_field(
"user_id",
"cannot be empty or unset",
),
);
}
write!(
output,
"/bot/{botName}/alias/{botAlias}/user/{userId}/session",
botName = bot_name,
botAlias = bot_alias,
userId = user_id
)
.expect("formatting should succeed");
Ok(())
}
#[allow(clippy::unnecessary_wraps)]
fn update_http_builder(
input: &crate::input::PutSessionInput,
builder: http::request::Builder,
) -> std::result::Result<
http::request::Builder,
aws_smithy_http::operation::error::BuildError,
> {
let mut uri = String::new();
uri_base(input, &mut uri)?;
let builder = crate::http_serde::add_headers_put_session(input, builder)?;
Ok(builder.method("POST").uri(uri))
}
let mut builder = update_http_builder(&self, http::request::Builder::new())?;
builder = aws_smithy_http::header::set_request_header_if_absent(
builder,
http::header::CONTENT_TYPE,
"application/json",
);
builder
};
let mut properties = aws_smithy_http::property_bag::SharedPropertyBag::new();
#[allow(clippy::useless_conversion)]
let body = aws_smithy_http::body::SdkBody::from(
crate::operation_ser::serialize_operation_crate_operation_put_session(&self)?,
);
if let Some(content_length) = body.content_length() {
request = aws_smithy_http::header::set_request_header_if_absent(
request,
http::header::CONTENT_LENGTH,
content_length,
);
}
let request = request.body(body).expect("should be valid request");
let mut request = aws_smithy_http::operation::Request::from_parts(request, properties);
request.properties_mut().insert(endpoint_result);
if let Some(params) = params {
request.properties_mut().insert(params);
}
request
.properties_mut()
.insert(aws_smithy_http::http_versions::DEFAULT_HTTP_VERSION_LIST.clone());
let mut user_agent = aws_http::user_agent::AwsUserAgent::new_from_environment(
aws_types::os_shim_internal::Env::real(),
crate::API_METADATA.clone(),
);
if let Some(app_name) = _config.app_name() {
user_agent = user_agent.with_app_name(app_name.clone());
}
request.properties_mut().insert(user_agent);
let mut signing_config = aws_sig_auth::signer::OperationSigningConfig::default_config();
request.properties_mut().insert(signing_config);
request
.properties_mut()
.insert(aws_types::SigningService::from_static(
_config.signing_service(),
));
if let Some(region) = &_config.region {
request
.properties_mut()
.insert(aws_types::region::SigningRegion::from(region.clone()));
}
if let Some(region) = &_config.region {
request.properties_mut().insert(region.clone());
}
aws_http::auth::set_credentials_cache(
&mut request.properties_mut(),
_config.credentials_cache.clone(),
);
let op = aws_smithy_http::operation::Operation::new(
request,
crate::operation::PutSession::new(),
)
.with_metadata(aws_smithy_http::operation::Metadata::new(
"PutSession",
"lexruntimeservice",
));
let op = op.with_retry_classifier(aws_http::retry::AwsResponseRetryClassifier::new());
Ok(op)
}
/// Creates a new builder-style object to manufacture [`PutSessionInput`](crate::input::PutSessionInput).
pub fn builder() -> crate::input::put_session_input::Builder {
crate::input::put_session_input::Builder::default()
}
}
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
#[derive(std::clone::Clone, std::cmp::PartialEq)]
pub struct PutSessionInput {
/// <p>The name of the bot that contains the session data.</p>
#[doc(hidden)]
pub bot_name: std::option::Option<std::string::String>,
/// <p>The alias in use for the bot that contains the session data.</p>
#[doc(hidden)]
pub bot_alias: std::option::Option<std::string::String>,
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
#[doc(hidden)]
pub user_id: std::option::Option<std::string::String>,
/// <p>Map of key/value pairs representing the session-specific context information. It contains application information passed between Amazon Lex and a client application.</p>
#[doc(hidden)]
pub session_attributes:
std::option::Option<std::collections::HashMap<std::string::String, std::string::String>>,
/// <p>Sets the next action that the bot should take to fulfill the conversation.</p>
#[doc(hidden)]
pub dialog_action: std::option::Option<crate::model::DialogAction>,
/// <p>A summary of the recent intents for the bot. You can use the intent summary view to set a checkpoint label on an intent and modify attributes of intents. You can also use it to remove or add intent summary objects to the list.</p>
/// <p>An intent that you modify or add to the list must make sense for the bot. For example, the intent name must be valid for the bot. You must provide valid values for:</p>
/// <ul>
/// <li> <p> <code>intentName</code> </p> </li>
/// <li> <p>slot names</p> </li>
/// <li> <p> <code>slotToElict</code> </p> </li>
/// </ul>
/// <p>If you send the <code>recentIntentSummaryView</code> parameter in a <code>PutSession</code> request, the contents of the new summary view replaces the old summary view. For example, if a <code>GetSession</code> request returns three intents in the summary view and you call <code>PutSession</code> with one intent in the summary view, the next call to <code>GetSession</code> will only return one intent.</p>
#[doc(hidden)]
pub recent_intent_summary_view: std::option::Option<std::vec::Vec<crate::model::IntentSummary>>,
/// <p>The message that Amazon Lex returns in the response can be either text or speech based depending on the value of this field.</p>
/// <ul>
/// <li> <p>If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response.</p> </li>
/// <li> <p>If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech in the configuration that you specify. For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech is returned as <code>audio/pcm</code> in 16-bit, little endian format.</p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p> <code>audio/mpeg</code> </p> </li>
/// <li> <p> <code>audio/ogg</code> </p> </li>
/// <li> <p> <code>audio/pcm</code> </p> </li>
/// <li> <p> <code>audio/*</code> (defaults to mpeg)</p> </li>
/// <li> <p> <code>text/plain; charset=utf-8</code> </p> </li>
/// </ul> </li>
/// </ul>
#[doc(hidden)]
pub accept: std::option::Option<std::string::String>,
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
#[doc(hidden)]
pub active_contexts: std::option::Option<std::vec::Vec<crate::model::ActiveContext>>,
}
impl PutSessionInput {
/// <p>The name of the bot that contains the session data.</p>
pub fn bot_name(&self) -> std::option::Option<&str> {
self.bot_name.as_deref()
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn bot_alias(&self) -> std::option::Option<&str> {
self.bot_alias.as_deref()
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
pub fn user_id(&self) -> std::option::Option<&str> {
self.user_id.as_deref()
}
/// <p>Map of key/value pairs representing the session-specific context information. It contains application information passed between Amazon Lex and a client application.</p>
pub fn session_attributes(
&self,
) -> std::option::Option<&std::collections::HashMap<std::string::String, std::string::String>>
{
self.session_attributes.as_ref()
}
/// <p>Sets the next action that the bot should take to fulfill the conversation.</p>
pub fn dialog_action(&self) -> std::option::Option<&crate::model::DialogAction> {
self.dialog_action.as_ref()
}
/// <p>A summary of the recent intents for the bot. You can use the intent summary view to set a checkpoint label on an intent and modify attributes of intents. You can also use it to remove or add intent summary objects to the list.</p>
/// <p>An intent that you modify or add to the list must make sense for the bot. For example, the intent name must be valid for the bot. You must provide valid values for:</p>
/// <ul>
/// <li> <p> <code>intentName</code> </p> </li>
/// <li> <p>slot names</p> </li>
/// <li> <p> <code>slotToElict</code> </p> </li>
/// </ul>
/// <p>If you send the <code>recentIntentSummaryView</code> parameter in a <code>PutSession</code> request, the contents of the new summary view replaces the old summary view. For example, if a <code>GetSession</code> request returns three intents in the summary view and you call <code>PutSession</code> with one intent in the summary view, the next call to <code>GetSession</code> will only return one intent.</p>
pub fn recent_intent_summary_view(
&self,
) -> std::option::Option<&[crate::model::IntentSummary]> {
self.recent_intent_summary_view.as_deref()
}
/// <p>The message that Amazon Lex returns in the response can be either text or speech based depending on the value of this field.</p>
/// <ul>
/// <li> <p>If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response.</p> </li>
/// <li> <p>If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech in the configuration that you specify. For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech is returned as <code>audio/pcm</code> in 16-bit, little endian format.</p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p> <code>audio/mpeg</code> </p> </li>
/// <li> <p> <code>audio/ogg</code> </p> </li>
/// <li> <p> <code>audio/pcm</code> </p> </li>
/// <li> <p> <code>audio/*</code> (defaults to mpeg)</p> </li>
/// <li> <p> <code>text/plain; charset=utf-8</code> </p> </li>
/// </ul> </li>
/// </ul>
pub fn accept(&self) -> std::option::Option<&str> {
self.accept.as_deref()
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn active_contexts(&self) -> std::option::Option<&[crate::model::ActiveContext]> {
self.active_contexts.as_deref()
}
}
impl std::fmt::Debug for PutSessionInput {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
let mut formatter = f.debug_struct("PutSessionInput");
formatter.field("bot_name", &self.bot_name);
formatter.field("bot_alias", &self.bot_alias);
formatter.field("user_id", &self.user_id);
formatter.field("session_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("dialog_action", &self.dialog_action);
formatter.field(
"recent_intent_summary_view",
&self.recent_intent_summary_view,
);
formatter.field("accept", &self.accept);
formatter.field("active_contexts", &"*** Sensitive Data Redacted ***");
formatter.finish()
}
}
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
#[derive(std::clone::Clone, std::cmp::PartialEq)]
pub struct PostTextInput {
/// <p>The name of the Amazon Lex bot.</p>
#[doc(hidden)]
pub bot_name: std::option::Option<std::string::String>,
/// <p>The alias of the Amazon Lex bot.</p>
#[doc(hidden)]
pub bot_alias: std::option::Option<std::string::String>,
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
#[doc(hidden)]
pub user_id: std::option::Option<std::string::String>,
/// <p>Application-specific information passed between Amazon Lex and a client application.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
#[doc(hidden)]
pub session_attributes:
std::option::Option<std::collections::HashMap<std::string::String, std::string::String>>,
/// <p>Request-specific information passed between Amazon Lex and a client application.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
#[doc(hidden)]
pub request_attributes:
std::option::Option<std::collections::HashMap<std::string::String, std::string::String>>,
/// <p>The text that the user entered (Amazon Lex interprets this text).</p>
#[doc(hidden)]
pub input_text: std::option::Option<std::string::String>,
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
#[doc(hidden)]
pub active_contexts: std::option::Option<std::vec::Vec<crate::model::ActiveContext>>,
}
impl PostTextInput {
/// <p>The name of the Amazon Lex bot.</p>
pub fn bot_name(&self) -> std::option::Option<&str> {
self.bot_name.as_deref()
}
/// <p>The alias of the Amazon Lex bot.</p>
pub fn bot_alias(&self) -> std::option::Option<&str> {
self.bot_alias.as_deref()
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
pub fn user_id(&self) -> std::option::Option<&str> {
self.user_id.as_deref()
}
/// <p>Application-specific information passed between Amazon Lex and a client application.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
pub fn session_attributes(
&self,
) -> std::option::Option<&std::collections::HashMap<std::string::String, std::string::String>>
{
self.session_attributes.as_ref()
}
/// <p>Request-specific information passed between Amazon Lex and a client application.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
pub fn request_attributes(
&self,
) -> std::option::Option<&std::collections::HashMap<std::string::String, std::string::String>>
{
self.request_attributes.as_ref()
}
/// <p>The text that the user entered (Amazon Lex interprets this text).</p>
pub fn input_text(&self) -> std::option::Option<&str> {
self.input_text.as_deref()
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn active_contexts(&self) -> std::option::Option<&[crate::model::ActiveContext]> {
self.active_contexts.as_deref()
}
}
impl std::fmt::Debug for PostTextInput {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
let mut formatter = f.debug_struct("PostTextInput");
formatter.field("bot_name", &self.bot_name);
formatter.field("bot_alias", &self.bot_alias);
formatter.field("user_id", &self.user_id);
formatter.field("session_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("request_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("input_text", &"*** Sensitive Data Redacted ***");
formatter.field("active_contexts", &"*** Sensitive Data Redacted ***");
formatter.finish()
}
}
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
pub struct PostContentInput {
/// <p>Name of the Amazon Lex bot.</p>
#[doc(hidden)]
pub bot_name: std::option::Option<std::string::String>,
/// <p>Alias of the Amazon Lex bot.</p>
#[doc(hidden)]
pub bot_alias: std::option::Option<std::string::String>,
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
#[doc(hidden)]
pub user_id: std::option::Option<std::string::String>,
/// <p>You pass this value as the <code>x-amz-lex-session-attributes</code> HTTP header.</p>
/// <p>Application-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>sessionAttributes</code> and <code>requestAttributes</code> headers is limited to 12 KB.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
#[doc(hidden)]
pub session_attributes: std::option::Option<std::string::String>,
/// <p>You pass this value as the <code>x-amz-lex-request-attributes</code> HTTP header.</p>
/// <p>Request-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>requestAttributes</code> and <code>sessionAttributes</code> headers is limited to 12 KB.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
#[doc(hidden)]
pub request_attributes: std::option::Option<std::string::String>,
/// <p> You pass this value as the <code>Content-Type</code> HTTP header. </p>
/// <p> Indicates the audio format or text. The header value must start with one of the following prefixes: </p>
/// <ul>
/// <li> <p>PCM format, audio data must be in little-endian byte order.</p>
/// <ul>
/// <li> <p>audio/l16; rate=16000; channels=1</p> </li>
/// <li> <p>audio/x-l16; sample-rate=16000; channel-count=1</p> </li>
/// <li> <p>audio/lpcm; sample-rate=8000; sample-size-bits=16; channel-count=1; is-big-endian=false </p> </li>
/// </ul> </li>
/// <li> <p>Opus format</p>
/// <ul>
/// <li> <p>audio/x-cbr-opus-with-preamble; preamble-size=0; bit-rate=256000; frame-size-milliseconds=4</p> </li>
/// </ul> </li>
/// <li> <p>Text format</p>
/// <ul>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// </ul> </li>
/// </ul>
#[doc(hidden)]
pub content_type: std::option::Option<std::string::String>,
/// <p> You pass this value as the <code>Accept</code> HTTP header. </p>
/// <p> The message Amazon Lex returns in the response can be either text or speech based on the <code>Accept</code> HTTP header value in the request. </p>
/// <ul>
/// <li> <p> If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response. </p> </li>
/// <li> <p> If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech (using the configuration you specified in the <code>Accept</code> header). For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech returned is <code>audio/pcm</code> in 16-bit, little endian format. </p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p>audio/mpeg</p> </li>
/// <li> <p>audio/ogg</p> </li>
/// <li> <p>audio/pcm</p> </li>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// <li> <p>audio/* (defaults to mpeg)</p> </li>
/// </ul> </li>
/// </ul>
#[doc(hidden)]
pub accept: std::option::Option<std::string::String>,
/// <p> User input in PCM or Opus audio format or text format as described in the <code>Content-Type</code> HTTP header. </p>
/// <p>You can stream audio data to Amazon Lex or you can create a local buffer that captures all of the audio data before sending. In general, you get better performance if you stream audio data rather than buffering the data locally.</p>
pub input_stream: aws_smithy_http::byte_stream::ByteStream,
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
#[doc(hidden)]
pub active_contexts: std::option::Option<std::string::String>,
}
impl PostContentInput {
/// <p>Name of the Amazon Lex bot.</p>
pub fn bot_name(&self) -> std::option::Option<&str> {
self.bot_name.as_deref()
}
/// <p>Alias of the Amazon Lex bot.</p>
pub fn bot_alias(&self) -> std::option::Option<&str> {
self.bot_alias.as_deref()
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. At runtime, each request must contain the <code>userID</code> field.</p>
/// <p>To decide the user ID to use for your application, consider the following factors.</p>
/// <ul>
/// <li> <p>The <code>userID</code> field must not contain any personally identifiable information of the user, for example, name, personal identification numbers, or other end user personal information.</p> </li>
/// <li> <p>If you want a user to start a conversation on one device and continue on another device, use a user-specific identifier.</p> </li>
/// <li> <p>If you want the same user to be able to have two independent conversations on two different devices, choose a device-specific identifier.</p> </li>
/// <li> <p>A user can't have two independent conversations with two different versions of the same bot. For example, a user can't have a conversation with the PROD and BETA versions of the same bot. If you anticipate that a user will need to have conversation with two different versions, for example, while testing, include the bot alias in the user ID to separate the two conversations.</p> </li>
/// </ul>
pub fn user_id(&self) -> std::option::Option<&str> {
self.user_id.as_deref()
}
/// <p>You pass this value as the <code>x-amz-lex-session-attributes</code> HTTP header.</p>
/// <p>Application-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>sessionAttributes</code> and <code>requestAttributes</code> headers is limited to 12 KB.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs">Setting Session Attributes</a>.</p>
pub fn session_attributes(&self) -> std::option::Option<&str> {
self.session_attributes.as_deref()
}
/// <p>You pass this value as the <code>x-amz-lex-request-attributes</code> HTTP header.</p>
/// <p>Request-specific information passed between Amazon Lex and a client application. The value must be a JSON serialized and base64 encoded map with string keys and values. The total size of the <code>requestAttributes</code> and <code>sessionAttributes</code> headers is limited to 12 KB.</p>
/// <p>The namespace <code>x-amz-lex:</code> is reserved for special attributes. Don't create any request attributes with the prefix <code>x-amz-lex:</code>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs">Setting Request Attributes</a>.</p>
pub fn request_attributes(&self) -> std::option::Option<&str> {
self.request_attributes.as_deref()
}
/// <p> You pass this value as the <code>Content-Type</code> HTTP header. </p>
/// <p> Indicates the audio format or text. The header value must start with one of the following prefixes: </p>
/// <ul>
/// <li> <p>PCM format, audio data must be in little-endian byte order.</p>
/// <ul>
/// <li> <p>audio/l16; rate=16000; channels=1</p> </li>
/// <li> <p>audio/x-l16; sample-rate=16000; channel-count=1</p> </li>
/// <li> <p>audio/lpcm; sample-rate=8000; sample-size-bits=16; channel-count=1; is-big-endian=false </p> </li>
/// </ul> </li>
/// <li> <p>Opus format</p>
/// <ul>
/// <li> <p>audio/x-cbr-opus-with-preamble; preamble-size=0; bit-rate=256000; frame-size-milliseconds=4</p> </li>
/// </ul> </li>
/// <li> <p>Text format</p>
/// <ul>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// </ul> </li>
/// </ul>
pub fn content_type(&self) -> std::option::Option<&str> {
self.content_type.as_deref()
}
/// <p> You pass this value as the <code>Accept</code> HTTP header. </p>
/// <p> The message Amazon Lex returns in the response can be either text or speech based on the <code>Accept</code> HTTP header value in the request. </p>
/// <ul>
/// <li> <p> If the value is <code>text/plain; charset=utf-8</code>, Amazon Lex returns text in the response. </p> </li>
/// <li> <p> If the value begins with <code>audio/</code>, Amazon Lex returns speech in the response. Amazon Lex uses Amazon Polly to generate the speech (using the configuration you specified in the <code>Accept</code> header). For example, if you specify <code>audio/mpeg</code> as the value, Amazon Lex returns speech in the MPEG format.</p> </li>
/// <li> <p>If the value is <code>audio/pcm</code>, the speech returned is <code>audio/pcm</code> in 16-bit, little endian format. </p> </li>
/// <li> <p>The following are the accepted values:</p>
/// <ul>
/// <li> <p>audio/mpeg</p> </li>
/// <li> <p>audio/ogg</p> </li>
/// <li> <p>audio/pcm</p> </li>
/// <li> <p>text/plain; charset=utf-8</p> </li>
/// <li> <p>audio/* (defaults to mpeg)</p> </li>
/// </ul> </li>
/// </ul>
pub fn accept(&self) -> std::option::Option<&str> {
self.accept.as_deref()
}
/// <p> User input in PCM or Opus audio format or text format as described in the <code>Content-Type</code> HTTP header. </p>
/// <p>You can stream audio data to Amazon Lex or you can create a local buffer that captures all of the audio data before sending. In general, you get better performance if you stream audio data rather than buffering the data locally.</p>
pub fn input_stream(&self) -> &aws_smithy_http::byte_stream::ByteStream {
&self.input_stream
}
/// <p>A list of contexts active for the request. A context can be activated when a previous intent is fulfilled, or by including the context in the request,</p>
/// <p>If you don't specify a list of contexts, Amazon Lex will use the current list of contexts for the session. If you specify an empty list, all contexts for the session are cleared.</p>
pub fn active_contexts(&self) -> std::option::Option<&str> {
self.active_contexts.as_deref()
}
}
impl std::fmt::Debug for PostContentInput {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
let mut formatter = f.debug_struct("PostContentInput");
formatter.field("bot_name", &self.bot_name);
formatter.field("bot_alias", &self.bot_alias);
formatter.field("user_id", &self.user_id);
formatter.field("session_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("request_attributes", &"*** Sensitive Data Redacted ***");
formatter.field("content_type", &self.content_type);
formatter.field("accept", &self.accept);
formatter.field("input_stream", &self.input_stream);
formatter.field("active_contexts", &"*** Sensitive Data Redacted ***");
formatter.finish()
}
}
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
#[derive(std::clone::Clone, std::cmp::PartialEq, std::fmt::Debug)]
pub struct GetSessionInput {
/// <p>The name of the bot that contains the session data.</p>
#[doc(hidden)]
pub bot_name: std::option::Option<std::string::String>,
/// <p>The alias in use for the bot that contains the session data.</p>
#[doc(hidden)]
pub bot_alias: std::option::Option<std::string::String>,
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
#[doc(hidden)]
pub user_id: std::option::Option<std::string::String>,
/// <p>A string used to filter the intents returned in the <code>recentIntentSummaryView</code> structure. </p>
/// <p>When you specify a filter, only intents with their <code>checkpointLabel</code> field set to that string are returned.</p>
#[doc(hidden)]
pub checkpoint_label_filter: std::option::Option<std::string::String>,
}
impl GetSessionInput {
/// <p>The name of the bot that contains the session data.</p>
pub fn bot_name(&self) -> std::option::Option<&str> {
self.bot_name.as_deref()
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn bot_alias(&self) -> std::option::Option<&str> {
self.bot_alias.as_deref()
}
/// <p>The ID of the client application user. Amazon Lex uses this to identify a user's conversation with your bot. </p>
pub fn user_id(&self) -> std::option::Option<&str> {
self.user_id.as_deref()
}
/// <p>A string used to filter the intents returned in the <code>recentIntentSummaryView</code> structure. </p>
/// <p>When you specify a filter, only intents with their <code>checkpointLabel</code> field set to that string are returned.</p>
pub fn checkpoint_label_filter(&self) -> std::option::Option<&str> {
self.checkpoint_label_filter.as_deref()
}
}
#[allow(missing_docs)] // documentation missing in model
#[non_exhaustive]
#[derive(std::clone::Clone, std::cmp::PartialEq, std::fmt::Debug)]
pub struct DeleteSessionInput {
/// <p>The name of the bot that contains the session data.</p>
#[doc(hidden)]
pub bot_name: std::option::Option<std::string::String>,
/// <p>The alias in use for the bot that contains the session data.</p>
#[doc(hidden)]
pub bot_alias: std::option::Option<std::string::String>,
/// <p>The identifier of the user associated with the session data.</p>
#[doc(hidden)]
pub user_id: std::option::Option<std::string::String>,
}
impl DeleteSessionInput {
/// <p>The name of the bot that contains the session data.</p>
pub fn bot_name(&self) -> std::option::Option<&str> {
self.bot_name.as_deref()
}
/// <p>The alias in use for the bot that contains the session data.</p>
pub fn bot_alias(&self) -> std::option::Option<&str> {
self.bot_alias.as_deref()
}
/// <p>The identifier of the user associated with the session data.</p>
pub fn user_id(&self) -> std::option::Option<&str> {
self.user_id.as_deref()
}
}