aws_sdk_gamelift/operation/describe_game_session_placement/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::describe_game_session_placement::_describe_game_session_placement_output::DescribeGameSessionPlacementOutputBuilder;
3
4pub use crate::operation::describe_game_session_placement::_describe_game_session_placement_input::DescribeGameSessionPlacementInputBuilder;
5
6impl crate::operation::describe_game_session_placement::builders::DescribeGameSessionPlacementInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::describe_game_session_placement::DescribeGameSessionPlacementOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::describe_game_session_placement::DescribeGameSessionPlacementError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.describe_game_session_placement();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `DescribeGameSessionPlacement`.
24///
25/// <p>Retrieves information, including current status, about a game session placement request.</p>
26/// <p>To get game session placement details, specify the placement ID.</p>
27/// <p>This operation is not designed to be continually called to track game session status. This practice can cause you to exceed your API limit, which results in errors. Instead, you must configure an Amazon Simple Notification Service (SNS) topic to receive notifications from FlexMatch or queues. Continuously polling with <code>DescribeGameSessionPlacement</code> should only be used for games in development with low game session usage.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct DescribeGameSessionPlacementFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::describe_game_session_placement::builders::DescribeGameSessionPlacementInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::describe_game_session_placement::DescribeGameSessionPlacementOutput,
37        crate::operation::describe_game_session_placement::DescribeGameSessionPlacementError,
38    > for DescribeGameSessionPlacementFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::describe_game_session_placement::DescribeGameSessionPlacementOutput,
46            crate::operation::describe_game_session_placement::DescribeGameSessionPlacementError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl DescribeGameSessionPlacementFluentBuilder {
53    /// Creates a new `DescribeGameSessionPlacementFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the DescribeGameSessionPlacement as a reference.
62    pub fn as_input(&self) -> &crate::operation::describe_game_session_placement::builders::DescribeGameSessionPlacementInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::describe_game_session_placement::DescribeGameSessionPlacementOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::describe_game_session_placement::DescribeGameSessionPlacementError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::describe_game_session_placement::DescribeGameSessionPlacement::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::describe_game_session_placement::DescribeGameSessionPlacement::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::describe_game_session_placement::DescribeGameSessionPlacementOutput,
99        crate::operation::describe_game_session_placement::DescribeGameSessionPlacementError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    /// <p>A unique identifier for a game session placement to retrieve.</p>
114    pub fn placement_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
115        self.inner = self.inner.placement_id(input.into());
116        self
117    }
118    /// <p>A unique identifier for a game session placement to retrieve.</p>
119    pub fn set_placement_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
120        self.inner = self.inner.set_placement_id(input);
121        self
122    }
123    /// <p>A unique identifier for a game session placement to retrieve.</p>
124    pub fn get_placement_id(&self) -> &::std::option::Option<::std::string::String> {
125        self.inner.get_placement_id()
126    }
127}