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
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_studio_session_mapping::_create_studio_session_mapping_output::CreateStudioSessionMappingOutputBuilder;
pub use crate::operation::create_studio_session_mapping::_create_studio_session_mapping_input::CreateStudioSessionMappingInputBuilder;
/// Fluent builder constructing a request to `CreateStudioSessionMapping`.
///
/// <p>Maps a user or group to the Amazon EMR Studio specified by <code>StudioId</code>, and applies a session policy to refine Studio permissions for that user or group. Use <code>CreateStudioSessionMapping</code> to assign users to a Studio when you use IAM Identity Center authentication. For instructions on how to assign users to a Studio when you use IAM authentication, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-manage-users.html#emr-studio-assign-users-groups">Assign a user or group to your EMR Studio</a>.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct CreateStudioSessionMappingFluentBuilder {
handle: std::sync::Arc<crate::client::Handle>,
inner: crate::operation::create_studio_session_mapping::builders::CreateStudioSessionMappingInputBuilder
}
impl CreateStudioSessionMappingFluentBuilder {
/// Creates a new `CreateStudioSessionMapping`.
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::create_studio_session_mapping::CreateStudioSessionMapping,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<
crate::operation::create_studio_session_mapping::CreateStudioSessionMappingError,
>,
> {
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::create_studio_session_mapping::CreateStudioSessionMappingOutput,
aws_smithy_http::result::SdkError<
crate::operation::create_studio_session_mapping::CreateStudioSessionMappingError,
>,
> {
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 ID of the Amazon EMR Studio to which the user or group will be mapped.</p>
pub fn studio_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.studio_id(input.into());
self
}
/// <p>The ID of the Amazon EMR Studio to which the user or group will be mapped.</p>
pub fn set_studio_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_studio_id(input);
self
}
/// <p>The globally unique identifier (GUID) of the user or group from the IAM Identity Center Identity Store. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>IAM Identity Center Identity Store API Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must be specified, but not both.</p>
pub fn identity_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.identity_id(input.into());
self
}
/// <p>The globally unique identifier (GUID) of the user or group from the IAM Identity Center Identity Store. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>IAM Identity Center Identity Store API Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must be specified, but not both.</p>
pub fn set_identity_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_identity_id(input);
self
}
/// <p>The name of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>IAM Identity Center Identity Store API Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must be specified, but not both.</p>
pub fn identity_name(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.identity_name(input.into());
self
}
/// <p>The name of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>IAM Identity Center Identity Store API Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must be specified, but not both.</p>
pub fn set_identity_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_identity_name(input);
self
}
/// <p>Specifies whether the identity to map to the Amazon EMR Studio is a user or a group.</p>
pub fn identity_type(mut self, input: crate::types::IdentityType) -> Self {
self.inner = self.inner.identity_type(input);
self
}
/// <p>Specifies whether the identity to map to the Amazon EMR Studio is a user or a group.</p>
pub fn set_identity_type(
mut self,
input: std::option::Option<crate::types::IdentityType>,
) -> Self {
self.inner = self.inner.set_identity_type(input);
self
}
/// <p>The Amazon Resource Name (ARN) for the session policy that will be applied to the user or group. You should specify the ARN for the session policy that you want to apply, not the ARN of your user role. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-user-role.html">Create an EMR Studio User Role with Session Policies</a>.</p>
pub fn session_policy_arn(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.session_policy_arn(input.into());
self
}
/// <p>The Amazon Resource Name (ARN) for the session policy that will be applied to the user or group. You should specify the ARN for the session policy that you want to apply, not the ARN of your user role. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-user-role.html">Create an EMR Studio User Role with Session Policies</a>.</p>
pub fn set_session_policy_arn(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.inner = self.inner.set_session_policy_arn(input);
self
}
}