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}