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
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_instrumentation_configuration::_create_instrumentation_configuration_input::CreateInstrumentationConfigurationInputBuilder;
pub use crate::operation::create_instrumentation_configuration::_create_instrumentation_configuration_output::CreateInstrumentationConfigurationOutputBuilder;
impl crate::operation::create_instrumentation_configuration::builders::CreateInstrumentationConfigurationInputBuilder {
/// Sends a request with this input using the given client.
pub async fn send_with(
self,
client: &crate::Client,
) -> ::std::result::Result<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let mut fluent_builder = client.create_instrumentation_configuration();
fluent_builder.inner = self;
fluent_builder.send().await
}
}
/// Fluent builder constructing a request to `CreateInstrumentationConfiguration`.
///
/// <p>Creates a dynamic instrumentation configuration for a specific code or endpoint location within a service and environment. Configurations are immutable after creation.</p>
/// <p>For <code>BREAKPOINT</code> type configurations, they expire after 24 hours unless a shorter expiration is provided. For <code>PROBE</code> type configurations, they persist until explicitly deleted; an expiration cannot be set for <code>PROBE</code> configurations.</p>
/// <p>If a configuration already exists for the same service, environment, signal type, and location, this operation returns a conflict instead of overwriting it. Use attribute filters and capture settings to control where the instrumentation runs and which data is collected.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct CreateInstrumentationConfigurationFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::create_instrumentation_configuration::builders::CreateInstrumentationConfigurationInputBuilder,
config_override: ::std::option::Option<crate::config::Builder>,
}
impl
crate::client::customize::internal::CustomizableSend<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationOutput,
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationError,
> for CreateInstrumentationConfigurationFluentBuilder
{
fn send(
self,
config_override: crate::config::Builder,
) -> crate::client::customize::internal::BoxFuture<
crate::client::customize::internal::SendResult<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationOutput,
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationError,
>,
> {
::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
}
}
impl CreateInstrumentationConfigurationFluentBuilder {
/// Creates a new `CreateInstrumentationConfigurationFluentBuilder`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
config_override: ::std::option::Option::None,
}
}
/// Access the CreateInstrumentationConfiguration as a reference.
pub fn as_input(&self) -> &crate::operation::create_instrumentation_configuration::builders::CreateInstrumentationConfigurationInputBuilder {
&self.inner
}
/// Sends the request and returns the response.
///
/// If an error occurs, an `SdkError` will be returned with additional details that
/// can be matched against.
///
/// By default, any retryable failures will be retried twice. Retry behavior
/// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> ::std::result::Result<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let input = self
.inner
.build()
.map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
let runtime_plugins = crate::operation::create_instrumentation_configuration::CreateInstrumentationConfiguration::operation_runtime_plugins(
self.handle.runtime_plugins.clone(),
&self.handle.conf,
self.config_override,
);
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfiguration::orchestrate(&runtime_plugins, input).await
}
/// Consumes this builder, creating a customizable operation that can be modified before being sent.
pub fn customize(
self,
) -> crate::client::customize::CustomizableOperation<
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationOutput,
crate::operation::create_instrumentation_configuration::CreateInstrumentationConfigurationError,
Self,
> {
crate::client::customize::CustomizableOperation::new(self)
}
pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
self.set_config_override(::std::option::Option::Some(config_override.into()));
self
}
pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
self.config_override = config_override;
self
}
/// Type of instrumentation: BREAKPOINT (temporary) or PROBE (permanent)
pub fn instrumentation_type(mut self, input: crate::types::InstrumentationType) -> Self {
self.inner = self.inner.instrumentation_type(input);
self
}
/// Type of instrumentation: BREAKPOINT (temporary) or PROBE (permanent)
pub fn set_instrumentation_type(mut self, input: ::std::option::Option<crate::types::InstrumentationType>) -> Self {
self.inner = self.inner.set_instrumentation_type(input);
self
}
/// Type of instrumentation: BREAKPOINT (temporary) or PROBE (permanent)
pub fn get_instrumentation_type(&self) -> &::std::option::Option<crate::types::InstrumentationType> {
self.inner.get_instrumentation_type()
}
/// <p>The name of the service to instrument. This should match the <code>service.name</code> resource attribute reported by the application.</p>
pub fn service(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.service(input.into());
self
}
/// <p>The name of the service to instrument. This should match the <code>service.name</code> resource attribute reported by the application.</p>
pub fn set_service(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_service(input);
self
}
/// <p>The name of the service to instrument. This should match the <code>service.name</code> resource attribute reported by the application.</p>
pub fn get_service(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_service()
}
/// <p>The environment that the service is running in, such as <code>eks:cluster-prod/namespace</code> or <code>ec2:production</code>.</p>
pub fn environment(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.environment(input.into());
self
}
/// <p>The environment that the service is running in, such as <code>eks:cluster-prod/namespace</code> or <code>ec2:production</code>.</p>
pub fn set_environment(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_environment(input);
self
}
/// <p>The environment that the service is running in, such as <code>eks:cluster-prod/namespace</code> or <code>ec2:production</code>.</p>
pub fn get_environment(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_environment()
}
/// <p>The telemetry signal type to emit for this instrumentation. The supported value is <code>SNAPSHOT</code>.</p>
pub fn signal_type(mut self, input: crate::types::DynamicInstrumentationSignalType) -> Self {
self.inner = self.inner.signal_type(input);
self
}
/// <p>The telemetry signal type to emit for this instrumentation. The supported value is <code>SNAPSHOT</code>.</p>
pub fn set_signal_type(mut self, input: ::std::option::Option<crate::types::DynamicInstrumentationSignalType>) -> Self {
self.inner = self.inner.set_signal_type(input);
self
}
/// <p>The telemetry signal type to emit for this instrumentation. The supported value is <code>SNAPSHOT</code>.</p>
pub fn get_signal_type(&self) -> &::std::option::Option<crate::types::DynamicInstrumentationSignalType> {
self.inner.get_signal_type()
}
/// <p>The location where instrumentation should be applied. Specify a <code>CodeLocation</code> for code-level instrumentation.</p>
pub fn location(mut self, input: crate::types::Location) -> Self {
self.inner = self.inner.location(input);
self
}
/// <p>The location where instrumentation should be applied. Specify a <code>CodeLocation</code> for code-level instrumentation.</p>
pub fn set_location(mut self, input: ::std::option::Option<crate::types::Location>) -> Self {
self.inner = self.inner.set_location(input);
self
}
/// <p>The location where instrumentation should be applied. Specify a <code>CodeLocation</code> for code-level instrumentation.</p>
pub fn get_location(&self) -> &::std::option::Option<crate::types::Location> {
self.inner.get_location()
}
/// <p>An optional short description (up to 50 characters) that explains the purpose of this instrumentation.</p>
pub fn description(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.description(input.into());
self
}
/// <p>An optional short description (up to 50 characters) that explains the purpose of this instrumentation.</p>
pub fn set_description(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_description(input);
self
}
/// <p>An optional short description (up to 50 characters) that explains the purpose of this instrumentation.</p>
pub fn get_description(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_description()
}
/// For BREAKPOINT: optional, defaults to 24 hours, must be between 5 min and 24 hours. For PROBE: not supported. PROBE configurations are permanent and persist until explicitly deleted.
pub fn expires_at(mut self, input: ::aws_smithy_types::DateTime) -> Self {
self.inner = self.inner.expires_at(input);
self
}
/// For BREAKPOINT: optional, defaults to 24 hours, must be between 5 min and 24 hours. For PROBE: not supported. PROBE configurations are permanent and persist until explicitly deleted.
pub fn set_expires_at(mut self, input: ::std::option::Option<::aws_smithy_types::DateTime>) -> Self {
self.inner = self.inner.set_expires_at(input);
self
}
/// For BREAKPOINT: optional, defaults to 24 hours, must be between 5 min and 24 hours. For PROBE: not supported. PROBE configurations are permanent and persist until explicitly deleted.
pub fn get_expires_at(&self) -> &::std::option::Option<::aws_smithy_types::DateTime> {
self.inner.get_expires_at()
}
///
/// Appends an item to `AttributeFilters`.
///
/// To override the contents of this collection use [`set_attribute_filters`](Self::set_attribute_filters).
///
/// <p>Client-side filters that target specific instances. Each object in the array is AND-matched on its keys, and multiple objects are OR-matched to decide where to apply the instrumentation.</p>
pub fn attribute_filters(mut self, input: ::std::collections::HashMap<::std::string::String, ::std::string::String>) -> Self {
self.inner = self.inner.attribute_filters(input);
self
}
/// <p>Client-side filters that target specific instances. Each object in the array is AND-matched on its keys, and multiple objects are OR-matched to decide where to apply the instrumentation.</p>
pub fn set_attribute_filters(
mut self,
input: ::std::option::Option<::std::vec::Vec<::std::collections::HashMap<::std::string::String, ::std::string::String>>>,
) -> Self {
self.inner = self.inner.set_attribute_filters(input);
self
}
/// <p>Client-side filters that target specific instances. Each object in the array is AND-matched on its keys, and multiple objects are OR-matched to decide where to apply the instrumentation.</p>
pub fn get_attribute_filters(
&self,
) -> &::std::option::Option<::std::vec::Vec<::std::collections::HashMap<::std::string::String, ::std::string::String>>> {
self.inner.get_attribute_filters()
}
/// <p>Specifies what to capture when the instrumentation point is hit. Specify <code>CodeCapture</code> for code-level capture settings.</p>
pub fn capture_configuration(mut self, input: crate::types::CaptureConfiguration) -> Self {
self.inner = self.inner.capture_configuration(input);
self
}
/// <p>Specifies what to capture when the instrumentation point is hit. Specify <code>CodeCapture</code> for code-level capture settings.</p>
pub fn set_capture_configuration(mut self, input: ::std::option::Option<crate::types::CaptureConfiguration>) -> Self {
self.inner = self.inner.set_capture_configuration(input);
self
}
/// <p>Specifies what to capture when the instrumentation point is hit. Specify <code>CodeCapture</code> for code-level capture settings.</p>
pub fn get_capture_configuration(&self) -> &::std::option::Option<crate::types::CaptureConfiguration> {
self.inner.get_capture_configuration()
}
///
/// Appends an item to `Tags`.
///
/// To override the contents of this collection use [`set_tags`](Self::set_tags).
///
/// <p>An optional list of key-value pairs to associate with the instrumentation configuration. Tags can help you organize and categorize your resources.</p>
pub fn tags(mut self, input: crate::types::Tag) -> Self {
self.inner = self.inner.tags(input);
self
}
/// <p>An optional list of key-value pairs to associate with the instrumentation configuration. Tags can help you organize and categorize your resources.</p>
pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
self.inner = self.inner.set_tags(input);
self
}
/// <p>An optional list of key-value pairs to associate with the instrumentation configuration. Tags can help you organize and categorize your resources.</p>
pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
self.inner.get_tags()
}
}