aws_sdk_xray/client/

create_sampling_rule.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateSamplingRule`](crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`sampling_rule(SamplingRule)`](crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder::sampling_rule) / [`set_sampling_rule(Option<SamplingRule>)`](crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder::set_sampling_rule):<br>required: **true**<br><p>The rule definition.</p><br>
    ///   - [`tags(Tag)`](crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder::tags) / [`set_tags(Option<Vec::<Tag>>)`](crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder::set_tags):<br>required: **false**<br><p>A map that contains one or more tag keys and tag values to attach to an X-Ray sampling rule. For more information about ways to use tags, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a> in the <i>Amazon Web Services General Reference</i>.</p> <p>The following restrictions apply to tags:</p> <ul>  <li>   <p>Maximum number of user-applied tags per resource: 50</p></li>  <li>   <p>Maximum tag key length: 128 Unicode characters</p></li>  <li>   <p>Maximum tag value length: 256 Unicode characters</p></li>  <li>   <p>Valid values for key and value: a-z, A-Z, 0-9, space, and the following characters: _ . : / = + - and @</p></li>  <li>   <p>Tag keys and values are case sensitive.</p></li>  <li>   <p>Don't use <code>aws:</code> as a prefix for keys; it's reserved for Amazon Web Services use.</p></li> </ul><br>
    /// - On success, responds with [`CreateSamplingRuleOutput`](crate::operation::create_sampling_rule::CreateSamplingRuleOutput) with field(s):
    ///   - [`sampling_rule_record(Option<SamplingRuleRecord>)`](crate::operation::create_sampling_rule::CreateSamplingRuleOutput::sampling_rule_record): <p>The saved rule definition and metadata.</p>
    /// - On failure, responds with [`SdkError<CreateSamplingRuleError>`](crate::operation::create_sampling_rule::CreateSamplingRuleError)
    pub fn create_sampling_rule(&self) -> crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder {
        crate::operation::create_sampling_rule::builders::CreateSamplingRuleFluentBuilder::new(self.handle.clone())
    }
}