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
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_workforce::_create_workforce_output::CreateWorkforceOutputBuilder;
pub use crate::operation::create_workforce::_create_workforce_input::CreateWorkforceInputBuilder;
/// Fluent builder constructing a request to `CreateWorkforce`.
///
/// <p>Use this operation to create a workforce. This operation will return an error if a workforce already exists in the Amazon Web Services Region that you specify. You can only create one workforce in each Amazon Web Services Region per Amazon Web Services account.</p>
/// <p>If you want to create a new workforce in an Amazon Web Services Region where a workforce already exists, use the <a href="https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteWorkforce.html">DeleteWorkforce</a> API operation to delete the existing workforce and then use <code>CreateWorkforce</code> to create a new workforce.</p>
/// <p>To create a private workforce using Amazon Cognito, you must specify a Cognito user pool in <code>CognitoConfig</code>. You can also create an Amazon Cognito workforce using the Amazon SageMaker console. For more information, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/sms-workforce-create-private.html"> Create a Private Workforce (Amazon Cognito)</a>.</p>
/// <p>To create a private workforce using your own OIDC Identity Provider (IdP), specify your IdP configuration in <code>OidcConfig</code>. Your OIDC IdP must support <i>groups</i> because groups are used by Ground Truth and Amazon A2I to create work teams. For more information, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/sms-workforce-create-private-oidc.html"> Create a Private Workforce (OIDC IdP)</a>.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct CreateWorkforceFluentBuilder {
handle: std::sync::Arc<crate::client::Handle>,
inner: crate::operation::create_workforce::builders::CreateWorkforceInputBuilder,
}
impl CreateWorkforceFluentBuilder {
/// Creates a new `CreateWorkforce`.
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_workforce::CreateWorkforce,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<crate::operation::create_workforce::CreateWorkforceError>,
> {
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_workforce::CreateWorkforceOutput,
aws_smithy_http::result::SdkError<crate::operation::create_workforce::CreateWorkforceError>,
> {
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>Use this parameter to configure an Amazon Cognito private workforce. A single Cognito workforce is created using and corresponds to a single <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools.html"> Amazon Cognito user pool</a>.</p>
/// <p>Do not use <code>OidcConfig</code> if you specify values for <code>CognitoConfig</code>.</p>
pub fn cognito_config(mut self, input: crate::types::CognitoConfig) -> Self {
self.inner = self.inner.cognito_config(input);
self
}
/// <p>Use this parameter to configure an Amazon Cognito private workforce. A single Cognito workforce is created using and corresponds to a single <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools.html"> Amazon Cognito user pool</a>.</p>
/// <p>Do not use <code>OidcConfig</code> if you specify values for <code>CognitoConfig</code>.</p>
pub fn set_cognito_config(
mut self,
input: std::option::Option<crate::types::CognitoConfig>,
) -> Self {
self.inner = self.inner.set_cognito_config(input);
self
}
/// <p>Use this parameter to configure a private workforce using your own OIDC Identity Provider.</p>
/// <p>Do not use <code>CognitoConfig</code> if you specify values for <code>OidcConfig</code>.</p>
pub fn oidc_config(mut self, input: crate::types::OidcConfig) -> Self {
self.inner = self.inner.oidc_config(input);
self
}
/// <p>Use this parameter to configure a private workforce using your own OIDC Identity Provider.</p>
/// <p>Do not use <code>CognitoConfig</code> if you specify values for <code>OidcConfig</code>.</p>
pub fn set_oidc_config(mut self, input: std::option::Option<crate::types::OidcConfig>) -> Self {
self.inner = self.inner.set_oidc_config(input);
self
}
/// <p>A list of IP address ranges (<a href="https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html">CIDRs</a>). Used to create an allow list of IP addresses for a private workforce. Workers will only be able to login to their worker portal from an IP address within this range. By default, a workforce isn't restricted to specific IP addresses.</p>
pub fn source_ip_config(mut self, input: crate::types::SourceIpConfig) -> Self {
self.inner = self.inner.source_ip_config(input);
self
}
/// <p>A list of IP address ranges (<a href="https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html">CIDRs</a>). Used to create an allow list of IP addresses for a private workforce. Workers will only be able to login to their worker portal from an IP address within this range. By default, a workforce isn't restricted to specific IP addresses.</p>
pub fn set_source_ip_config(
mut self,
input: std::option::Option<crate::types::SourceIpConfig>,
) -> Self {
self.inner = self.inner.set_source_ip_config(input);
self
}
/// <p>The name of the private workforce.</p>
pub fn workforce_name(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.workforce_name(input.into());
self
}
/// <p>The name of the private workforce.</p>
pub fn set_workforce_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_workforce_name(input);
self
}
/// Appends an item to `Tags`.
///
/// To override the contents of this collection use [`set_tags`](Self::set_tags).
///
/// <p>An array of key-value pairs that contain metadata to help you categorize and organize our workforce. Each tag consists of a key and a value, both of which you define.</p>
pub fn tags(mut self, input: crate::types::Tag) -> Self {
self.inner = self.inner.tags(input);
self
}
/// <p>An array of key-value pairs that contain metadata to help you categorize and organize our workforce. Each tag consists of a key and a value, both of which you define.</p>
pub fn set_tags(
mut self,
input: std::option::Option<std::vec::Vec<crate::types::Tag>>,
) -> Self {
self.inner = self.inner.set_tags(input);
self
}
/// <p>Use this parameter to configure a workforce using VPC.</p>
pub fn workforce_vpc_config(mut self, input: crate::types::WorkforceVpcConfigRequest) -> Self {
self.inner = self.inner.workforce_vpc_config(input);
self
}
/// <p>Use this parameter to configure a workforce using VPC.</p>
pub fn set_workforce_vpc_config(
mut self,
input: std::option::Option<crate::types::WorkforceVpcConfigRequest>,
) -> Self {
self.inner = self.inner.set_workforce_vpc_config(input);
self
}
}