1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
#[derive(Debug)]
pub(crate) struct Handle {
    pub(crate) conf: crate::Config,
    #[allow(dead_code)] // unused when a service does not provide any operations
    pub(crate) runtime_plugins: ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins,
}

/// Client for AWS Proton
///
/// Client for invoking operations on AWS Proton. Each operation on AWS Proton is a method on this
/// this struct. `.send()` MUST be invoked on the generated operations to dispatch the request to the service.
/// ## Constructing a `Client`
///
/// A [`Config`] is required to construct a client. For most use cases, the [`aws-config`]
/// crate should be used to automatically resolve this config using
/// [`aws_config::load_from_env()`], since this will resolve an [`SdkConfig`] which can be shared
/// across multiple different AWS SDK clients. This config resolution process can be customized
/// by calling [`aws_config::from_env()`] instead, which returns a [`ConfigLoader`] that uses
/// the [builder pattern] to customize the default config.
///
/// In the simplest case, creating a client looks as follows:
/// ```rust,no_run
/// # async fn wrapper() {
/// let config = aws_config::load_from_env().await;
/// let client = aws_sdk_proton::Client::new(&config);
/// # }
/// ```
///
/// Occasionally, SDKs may have additional service-specific values that can be set on the [`Config`] that
/// is absent from [`SdkConfig`], or slightly different settings for a specific client may be desired.
/// The [`Builder`] struct implements `From<&SdkConfig>`, so setting these specific settings can be
/// done as follows:
///
/// ```rust,no_run
/// # async fn wrapper() {
/// let sdk_config = ::aws_config::load_from_env().await;
/// let config = aws_sdk_proton::config::Builder::from(&sdk_config)
/// # /*
///     .some_service_specific_setting("value")
/// # */
///     .build();
/// # }
/// ```
///
/// See the [`aws-config` docs] and [`Config`] for more information on customizing configuration.
///
/// _Note:_ Client construction is expensive due to connection thread pool initialization, and should
/// be done once at application start-up.
///
/// [`Config`]: crate::Config
/// [`ConfigLoader`]: https://docs.rs/aws-config/*/aws_config/struct.ConfigLoader.html
/// [`SdkConfig`]: https://docs.rs/aws-config/*/aws_config/struct.SdkConfig.html
/// [`aws-config` docs]: https://docs.rs/aws-config/*
/// [`aws-config`]: https://crates.io/crates/aws-config
/// [`aws_config::from_env()`]: https://docs.rs/aws-config/*/aws_config/fn.from_env.html
/// [`aws_config::load_from_env()`]: https://docs.rs/aws-config/*/aws_config/fn.load_from_env.html
/// [builder pattern]: https://rust-lang.github.io/api-guidelines/type-safety.html#builders-enable-construction-of-complex-values-c-builder
/// # Using the `Client`
///
/// A client has a function for every operation that can be performed by the service.
/// For example, the [`CancelComponentDeployment`](crate::operation::cancel_component_deployment) operation has
/// a [`Client::cancel_component_deployment`], function which returns a builder for that operation.
/// The fluent builder ultimately has a `send()` function that returns an async future that
/// returns a result, as illustrated below:
///
/// ```rust,ignore
/// let result = client.cancel_component_deployment()
///     .component_name("example")
///     .send()
///     .await;
/// ```
///
/// The underlying HTTP requests that get made by this can be modified with the `customize_operation`
/// function on the fluent builder. See the [`customize`](crate::client::customize) module for more
/// information.
/// # Waiters
///
/// This client provides `wait_until` methods behind the [`Waiters`](crate::client::Waiters) trait.
/// To use them, simply import the trait, and then call one of the `wait_until` methods. This will
/// return a waiter fluent builder that takes various parameters, which are documented on the builder
/// type. Once parameters have been provided, the `wait` method can be called to initiate waiting.
///
/// For example, if there was a `wait_until_thing` method, it could look like:
/// ```rust,ignore
/// let result = client.wait_until_thing()
///     .thing_id("someId")
///     .wait(Duration::from_secs(120))
///     .await;
/// ```
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct Client {
    handle: ::std::sync::Arc<Handle>,
}

impl Client {
    /// Creates a new client from the service [`Config`](crate::Config).
    ///
    /// # Panics
    ///
    /// This method will panic in the following cases:
    ///
    /// - Retries or timeouts are enabled without a `sleep_impl` configured.
    /// - Identity caching is enabled without a `sleep_impl` and `time_source` configured.
    /// - No `behavior_version` is provided.
    ///
    /// The panic message for each of these will have instructions on how to resolve them.
    #[track_caller]
    pub fn from_conf(conf: crate::Config) -> Self {
        let handle = Handle {
            conf: conf.clone(),
            runtime_plugins: crate::config::base_client_runtime_plugins(conf),
        };
        if let Err(err) = Self::validate_config(&handle) {
            panic!("Invalid client configuration: {err}");
        }
        Self {
            handle: ::std::sync::Arc::new(handle),
        }
    }

    /// Returns the client's configuration.
    pub fn config(&self) -> &crate::Config {
        &self.handle.conf
    }

    fn validate_config(handle: &Handle) -> Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
        let mut cfg = ::aws_smithy_types::config_bag::ConfigBag::base();
        handle
            .runtime_plugins
            .apply_client_configuration(&mut cfg)?
            .validate_base_client_config(&cfg)?;
        Ok(())
    }
}

///
/// Waiter functions for the client.
///
/// Import this trait to get `wait_until` methods on the client.
///
pub trait Waiters {
    /// Wait until a Component is deployed. Use this after invoking CreateComponent or UpdateComponent
    fn wait_until_component_deployed(&self) -> crate::waiters::component_deployed::ComponentDeployedFluentBuilder;
    /// Wait until a Component is deleted. Use this after invoking DeleteComponent
    fn wait_until_component_deleted(&self) -> crate::waiters::component_deleted::ComponentDeletedFluentBuilder;
    /// Wait until an Environment is deployed. Use this after invoking CreateEnvironment or UpdateEnvironment
    fn wait_until_environment_deployed(&self) -> crate::waiters::environment_deployed::EnvironmentDeployedFluentBuilder;
    /// Wait until an EnvironmentTemplateVersion is registered. Use this after invoking CreateEnvironmentTemplateVersion
    fn wait_until_environment_template_version_registered(
        &self,
    ) -> crate::waiters::environment_template_version_registered::EnvironmentTemplateVersionRegisteredFluentBuilder;
    /// Wait until an Service has deployed its instances and possibly pipeline. Use this after invoking CreateService
    fn wait_until_service_created(&self) -> crate::waiters::service_created::ServiceCreatedFluentBuilder;
    /// Wait until a Service, its instances, and possibly pipeline have been deployed after UpdateService is invoked
    fn wait_until_service_updated(&self) -> crate::waiters::service_updated::ServiceUpdatedFluentBuilder;
    /// Wait until a Service, its instances, and possibly pipeline have been deleted after DeleteService is invoked
    fn wait_until_service_deleted(&self) -> crate::waiters::service_deleted::ServiceDeletedFluentBuilder;
    /// Wait until an ServicePipeline is deployed. Use this after invoking CreateService or UpdateServicePipeline
    fn wait_until_service_pipeline_deployed(&self) -> crate::waiters::service_pipeline_deployed::ServicePipelineDeployedFluentBuilder;
    /// Wait until a ServiceInstance is deployed. Use this after invoking CreateService or UpdateServiceInstance
    fn wait_until_service_instance_deployed(&self) -> crate::waiters::service_instance_deployed::ServiceInstanceDeployedFluentBuilder;
    /// Wait until a ServiceTemplateVersion is registered. Use this after invoking CreateServiceTemplateVersion
    fn wait_until_service_template_version_registered(
        &self,
    ) -> crate::waiters::service_template_version_registered::ServiceTemplateVersionRegisteredFluentBuilder;
}
impl Waiters for Client {
    fn wait_until_component_deployed(&self) -> crate::waiters::component_deployed::ComponentDeployedFluentBuilder {
        crate::waiters::component_deployed::ComponentDeployedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_component_deleted(&self) -> crate::waiters::component_deleted::ComponentDeletedFluentBuilder {
        crate::waiters::component_deleted::ComponentDeletedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_environment_deployed(&self) -> crate::waiters::environment_deployed::EnvironmentDeployedFluentBuilder {
        crate::waiters::environment_deployed::EnvironmentDeployedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_environment_template_version_registered(
        &self,
    ) -> crate::waiters::environment_template_version_registered::EnvironmentTemplateVersionRegisteredFluentBuilder {
        crate::waiters::environment_template_version_registered::EnvironmentTemplateVersionRegisteredFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_service_created(&self) -> crate::waiters::service_created::ServiceCreatedFluentBuilder {
        crate::waiters::service_created::ServiceCreatedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_service_updated(&self) -> crate::waiters::service_updated::ServiceUpdatedFluentBuilder {
        crate::waiters::service_updated::ServiceUpdatedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_service_deleted(&self) -> crate::waiters::service_deleted::ServiceDeletedFluentBuilder {
        crate::waiters::service_deleted::ServiceDeletedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_service_pipeline_deployed(&self) -> crate::waiters::service_pipeline_deployed::ServicePipelineDeployedFluentBuilder {
        crate::waiters::service_pipeline_deployed::ServicePipelineDeployedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_service_instance_deployed(&self) -> crate::waiters::service_instance_deployed::ServiceInstanceDeployedFluentBuilder {
        crate::waiters::service_instance_deployed::ServiceInstanceDeployedFluentBuilder::new(self.handle.clone())
    }
    fn wait_until_service_template_version_registered(
        &self,
    ) -> crate::waiters::service_template_version_registered::ServiceTemplateVersionRegisteredFluentBuilder {
        crate::waiters::service_template_version_registered::ServiceTemplateVersionRegisteredFluentBuilder::new(self.handle.clone())
    }
}

impl Client {
    /// Creates a new client from an [SDK Config](::aws_types::sdk_config::SdkConfig).
    ///
    /// # Panics
    ///
    /// - This method will panic if the `sdk_config` is missing an async sleep implementation. If you experience this panic, set
    ///     the `sleep_impl` on the Config passed into this function to fix it.
    /// - This method will panic if the `sdk_config` is missing an HTTP connector. If you experience this panic, set the
    ///     `http_connector` on the Config passed into this function to fix it.
    /// - This method will panic if no `BehaviorVersion` is provided. If you experience this panic, set `behavior_version` on the Config or enable the `behavior-version-latest` Cargo feature.
    #[track_caller]
    pub fn new(sdk_config: &::aws_types::sdk_config::SdkConfig) -> Self {
        Self::from_conf(sdk_config.into())
    }
}

mod accept_environment_account_connection;

mod cancel_component_deployment;

mod cancel_environment_deployment;

mod cancel_service_instance_deployment;

mod cancel_service_pipeline_deployment;

mod create_component;

mod create_environment;

mod create_environment_account_connection;

mod create_environment_template;

mod create_environment_template_version;

mod create_repository;

mod create_service;

mod create_service_instance;

mod create_service_sync_config;

mod create_service_template;

mod create_service_template_version;

mod create_template_sync_config;

/// Operation customization and supporting types.
///
/// The underlying HTTP requests made during an operation can be customized
/// by calling the `customize()` method on the builder returned from a client
/// operation call. For example, this can be used to add an additional HTTP header:
///
/// ```ignore
/// # async fn wrapper() -> ::std::result::Result<(), aws_sdk_proton::Error> {
/// # let client: aws_sdk_proton::Client = unimplemented!();
/// use ::http::header::{HeaderName, HeaderValue};
///
/// let result = client.cancel_component_deployment()
///     .customize()
///     .mutate_request(|req| {
///         // Add `x-example-header` with value
///         req.headers_mut()
///             .insert(
///                 HeaderName::from_static("x-example-header"),
///                 HeaderValue::from_static("1"),
///             );
///     })
///     .send()
///     .await;
/// # }
/// ```
pub mod customize;

mod delete_component;

mod delete_deployment;

mod delete_environment;

mod delete_environment_account_connection;

mod delete_environment_template;

mod delete_environment_template_version;

mod delete_repository;

mod delete_service;

mod delete_service_sync_config;

mod delete_service_template;

mod delete_service_template_version;

mod delete_template_sync_config;

mod get_account_settings;

mod get_component;

mod get_deployment;

mod get_environment;

mod get_environment_account_connection;

mod get_environment_template;

mod get_environment_template_version;

mod get_repository;

mod get_repository_sync_status;

mod get_resources_summary;

mod get_service;

mod get_service_instance;

mod get_service_instance_sync_status;

mod get_service_sync_blocker_summary;

mod get_service_sync_config;

mod get_service_template;

mod get_service_template_version;

mod get_template_sync_config;

mod get_template_sync_status;

mod list_component_outputs;

mod list_component_provisioned_resources;

mod list_components;

mod list_deployments;

mod list_environment_account_connections;

mod list_environment_outputs;

mod list_environment_provisioned_resources;

mod list_environment_template_versions;

mod list_environment_templates;

mod list_environments;

mod list_repositories;

mod list_repository_sync_definitions;

mod list_service_instance_outputs;

mod list_service_instance_provisioned_resources;

mod list_service_instances;

mod list_service_pipeline_outputs;

mod list_service_pipeline_provisioned_resources;

mod list_service_template_versions;

mod list_service_templates;

mod list_services;

mod list_tags_for_resource;

mod notify_resource_deployment_status_change;

mod reject_environment_account_connection;

mod tag_resource;

mod untag_resource;

mod update_account_settings;

mod update_component;

mod update_environment;

mod update_environment_account_connection;

mod update_environment_template;

mod update_environment_template_version;

mod update_service;

mod update_service_instance;

mod update_service_pipeline;

mod update_service_sync_blocker;

mod update_service_sync_config;

mod update_service_template;

mod update_service_template_version;

mod update_template_sync_config;