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
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::modify_snapshot_attribute::_modify_snapshot_attribute_output::ModifySnapshotAttributeOutputBuilder;
pub use crate::operation::modify_snapshot_attribute::_modify_snapshot_attribute_input::ModifySnapshotAttributeInputBuilder;
/// Fluent builder constructing a request to `ModifySnapshotAttribute`.
///
/// <p>Adds or removes permission settings for the specified snapshot. You may add or remove specified Amazon Web Services account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single operation. If you need to both add and remove account IDs for a snapshot, you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation.</p>
/// <p>Encrypted snapshots and snapshots with Amazon Web Services Marketplace product codes cannot be made public. Snapshots encrypted with your default KMS key cannot be shared with other accounts.</p>
/// <p>For more information about modifying snapshot permissions, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modifying-snapshot-permissions.html">Share a snapshot</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct ModifySnapshotAttributeFluentBuilder {
handle: std::sync::Arc<crate::client::Handle>,
inner:
crate::operation::modify_snapshot_attribute::builders::ModifySnapshotAttributeInputBuilder,
}
impl ModifySnapshotAttributeFluentBuilder {
/// Creates a new `ModifySnapshotAttribute`.
pub(crate) fn new(handle: std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: Default::default(),
}
}
/// Consume this builder, creating a customizable operation that can be modified before being
/// sent. The operation's inner [http::Request] can be modified as well.
pub async fn customize(
self,
) -> std::result::Result<
crate::client::customize::CustomizableOperation<
crate::operation::modify_snapshot_attribute::ModifySnapshotAttribute,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<
crate::operation::modify_snapshot_attribute::ModifySnapshotAttributeError,
>,
> {
let handle = self.handle.clone();
let operation = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
Ok(crate::client::customize::CustomizableOperation { handle, operation })
}
/// 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::modify_snapshot_attribute::ModifySnapshotAttributeOutput,
aws_smithy_http::result::SdkError<
crate::operation::modify_snapshot_attribute::ModifySnapshotAttributeError,
>,
> {
let op = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&self.handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
self.handle.client.call(op).await
}
/// <p>The snapshot attribute to modify. Only volume creation permissions can be modified.</p>
pub fn attribute(mut self, input: crate::types::SnapshotAttributeName) -> Self {
self.inner = self.inner.attribute(input);
self
}
/// <p>The snapshot attribute to modify. Only volume creation permissions can be modified.</p>
pub fn set_attribute(
mut self,
input: std::option::Option<crate::types::SnapshotAttributeName>,
) -> Self {
self.inner = self.inner.set_attribute(input);
self
}
/// <p>A JSON representation of the snapshot attribute modification.</p>
pub fn create_volume_permission(
mut self,
input: crate::types::CreateVolumePermissionModifications,
) -> Self {
self.inner = self.inner.create_volume_permission(input);
self
}
/// <p>A JSON representation of the snapshot attribute modification.</p>
pub fn set_create_volume_permission(
mut self,
input: std::option::Option<crate::types::CreateVolumePermissionModifications>,
) -> Self {
self.inner = self.inner.set_create_volume_permission(input);
self
}
/// Appends an item to `GroupNames`.
///
/// To override the contents of this collection use [`set_group_names`](Self::set_group_names).
///
/// <p>The group to modify for the snapshot.</p>
pub fn group_names(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.group_names(input.into());
self
}
/// <p>The group to modify for the snapshot.</p>
pub fn set_group_names(
mut self,
input: std::option::Option<std::vec::Vec<std::string::String>>,
) -> Self {
self.inner = self.inner.set_group_names(input);
self
}
/// <p>The type of operation to perform to the attribute.</p>
pub fn operation_type(mut self, input: crate::types::OperationType) -> Self {
self.inner = self.inner.operation_type(input);
self
}
/// <p>The type of operation to perform to the attribute.</p>
pub fn set_operation_type(
mut self,
input: std::option::Option<crate::types::OperationType>,
) -> Self {
self.inner = self.inner.set_operation_type(input);
self
}
/// <p>The ID of the snapshot.</p>
pub fn snapshot_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.snapshot_id(input.into());
self
}
/// <p>The ID of the snapshot.</p>
pub fn set_snapshot_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_snapshot_id(input);
self
}
/// Appends an item to `UserIds`.
///
/// To override the contents of this collection use [`set_user_ids`](Self::set_user_ids).
///
/// <p>The account ID to modify for the snapshot.</p>
pub fn user_ids(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.user_ids(input.into());
self
}
/// <p>The account ID to modify for the snapshot.</p>
pub fn set_user_ids(
mut self,
input: std::option::Option<std::vec::Vec<std::string::String>>,
) -> Self {
self.inner = self.inner.set_user_ids(input);
self
}
/// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
pub fn dry_run(mut self, input: bool) -> Self {
self.inner = self.inner.dry_run(input);
self
}
/// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
pub fn set_dry_run(mut self, input: std::option::Option<bool>) -> Self {
self.inner = self.inner.set_dry_run(input);
self
}
}