aws_sdk_appmesh/types/
_tag_ref.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2
3/// <p>Optional metadata that you apply to a resource to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.</p>
4#[non_exhaustive]
5#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
6pub struct TagRef {
7    /// <p>One part of a key-value pair that make up a tag. A <code>key</code> is a general label that acts like a category for more specific tag values.</p>
8    pub key: ::std::string::String,
9    /// <p>The optional part of a key-value pair that make up a tag. A <code>value</code> acts as a descriptor within a tag category (key).</p>
10    pub value: ::std::string::String,
11}
12impl TagRef {
13    /// <p>One part of a key-value pair that make up a tag. A <code>key</code> is a general label that acts like a category for more specific tag values.</p>
14    pub fn key(&self) -> &str {
15        use std::ops::Deref;
16        self.key.deref()
17    }
18    /// <p>The optional part of a key-value pair that make up a tag. A <code>value</code> acts as a descriptor within a tag category (key).</p>
19    pub fn value(&self) -> &str {
20        use std::ops::Deref;
21        self.value.deref()
22    }
23}
24impl TagRef {
25    /// Creates a new builder-style object to manufacture [`TagRef`](crate::types::TagRef).
26    pub fn builder() -> crate::types::builders::TagRefBuilder {
27        crate::types::builders::TagRefBuilder::default()
28    }
29}
30
31/// A builder for [`TagRef`](crate::types::TagRef).
32#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
33#[non_exhaustive]
34pub struct TagRefBuilder {
35    pub(crate) key: ::std::option::Option<::std::string::String>,
36    pub(crate) value: ::std::option::Option<::std::string::String>,
37}
38impl TagRefBuilder {
39    /// <p>One part of a key-value pair that make up a tag. A <code>key</code> is a general label that acts like a category for more specific tag values.</p>
40    /// This field is required.
41    pub fn key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
42        self.key = ::std::option::Option::Some(input.into());
43        self
44    }
45    /// <p>One part of a key-value pair that make up a tag. A <code>key</code> is a general label that acts like a category for more specific tag values.</p>
46    pub fn set_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
47        self.key = input;
48        self
49    }
50    /// <p>One part of a key-value pair that make up a tag. A <code>key</code> is a general label that acts like a category for more specific tag values.</p>
51    pub fn get_key(&self) -> &::std::option::Option<::std::string::String> {
52        &self.key
53    }
54    /// <p>The optional part of a key-value pair that make up a tag. A <code>value</code> acts as a descriptor within a tag category (key).</p>
55    /// This field is required.
56    pub fn value(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
57        self.value = ::std::option::Option::Some(input.into());
58        self
59    }
60    /// <p>The optional part of a key-value pair that make up a tag. A <code>value</code> acts as a descriptor within a tag category (key).</p>
61    pub fn set_value(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
62        self.value = input;
63        self
64    }
65    /// <p>The optional part of a key-value pair that make up a tag. A <code>value</code> acts as a descriptor within a tag category (key).</p>
66    pub fn get_value(&self) -> &::std::option::Option<::std::string::String> {
67        &self.value
68    }
69    /// Consumes the builder and constructs a [`TagRef`](crate::types::TagRef).
70    /// This method will fail if any of the following fields are not set:
71    /// - [`key`](crate::types::builders::TagRefBuilder::key)
72    /// - [`value`](crate::types::builders::TagRefBuilder::value)
73    pub fn build(self) -> ::std::result::Result<crate::types::TagRef, ::aws_smithy_types::error::operation::BuildError> {
74        ::std::result::Result::Ok(crate::types::TagRef {
75            key: self.key.ok_or_else(|| {
76                ::aws_smithy_types::error::operation::BuildError::missing_field(
77                    "key",
78                    "key was not specified but it is required when building TagRef",
79                )
80            })?,
81            value: self.value.ok_or_else(|| {
82                ::aws_smithy_types::error::operation::BuildError::missing_field(
83                    "value",
84                    "value was not specified but it is required when building TagRef",
85                )
86            })?,
87        })
88    }
89}