// Code generated by smithy-go-codegen DO NOT EDIT. package eks import ( "context" "fmt" awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware" "github.com/aws/aws-sdk-go-v2/aws/signer/v4" "github.com/aws/aws-sdk-go-v2/service/eks/types" "github.com/aws/smithy-go/middleware" smithyhttp "github.com/aws/smithy-go/transport/http" ) // Creates an Amazon EKS control plane. The Amazon EKS control plane consists of // control plane instances that run the Kubernetes software, such as etcd and the // API server. The control plane runs in an account managed by Amazon Web Services, // and the Kubernetes API is exposed by the Amazon EKS API server endpoint. Each // Amazon EKS cluster control plane is single tenant and unique. It runs on its own // set of Amazon EC2 instances. The cluster control plane is provisioned across // multiple Availability Zones and fronted by an Elastic Load Balancing Network // Load Balancer. Amazon EKS also provisions elastic network interfaces in your VPC // subnets to provide connectivity from the control plane instances to the nodes // (for example, to support kubectl exec , logs , and proxy data flows). Amazon // EKS nodes run in your Amazon Web Services account and connect to your cluster's // control plane over the Kubernetes API server endpoint and a certificate file // that is created for your cluster. In most cases, it takes several minutes to // create a cluster. After you create an Amazon EKS cluster, you must configure // your Kubernetes tooling to communicate with the API server and launch nodes into // your cluster. For more information, see Managing Cluster Authentication (https://docs.aws.amazon.com/eks/latest/userguide/managing-auth.html) // and Launching Amazon EKS nodes (https://docs.aws.amazon.com/eks/latest/userguide/launch-workers.html) // in the Amazon EKS User Guide. func (c *Client) CreateCluster(ctx context.Context, params *CreateClusterInput, optFns ...func(*Options)) (*CreateClusterOutput, error) { if params == nil { params = &CreateClusterInput{} } result, metadata, err := c.invokeOperation(ctx, "CreateCluster", params, optFns, c.addOperationCreateClusterMiddlewares) if err != nil { return nil, err } out := result.(*CreateClusterOutput) out.ResultMetadata = metadata return out, nil } type CreateClusterInput struct { // The unique name to give to your cluster. // // This member is required. Name *string // The VPC configuration that's used by the cluster control plane. Amazon EKS VPC // resources have specific requirements to work properly with Kubernetes. For more // information, see Cluster VPC Considerations (https://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html) // and Cluster Security Group Considerations (https://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html) // in the Amazon EKS User Guide. You must specify at least two subnets. You can // specify up to five security groups. However, we recommend that you use a // dedicated security group for your cluster control plane. // // This member is required. ResourcesVpcConfig *types.VpcConfigRequest // The Amazon Resource Name (ARN) of the IAM role that provides permissions for // the Kubernetes control plane to make calls to Amazon Web Services API operations // on your behalf. For more information, see Amazon EKS Service IAM Role (https://docs.aws.amazon.com/eks/latest/userguide/service_IAM_role.html) // in the Amazon EKS User Guide . // // This member is required. RoleArn *string // Unique, case-sensitive identifier that you provide to ensure the idempotency of // the request. ClientRequestToken *string // The encryption configuration for the cluster. EncryptionConfig []types.EncryptionConfig // The Kubernetes network configuration for the cluster. KubernetesNetworkConfig *types.KubernetesNetworkConfigRequest // Enable or disable exporting the Kubernetes control plane logs for your cluster // to CloudWatch Logs. By default, cluster control plane logs aren't exported to // CloudWatch Logs. For more information, see Amazon EKS Cluster control plane logs (https://docs.aws.amazon.com/eks/latest/userguide/control-plane-logs.html) // in the Amazon EKS User Guide . CloudWatch Logs ingestion, archive storage, and // data scanning rates apply to exported control plane logs. For more information, // see CloudWatch Pricing (http://aws.amazon.com/cloudwatch/pricing/) . Logging *types.Logging // An object representing the configuration of your local Amazon EKS cluster on an // Amazon Web Services Outpost. Before creating a local cluster on an Outpost, // review Local clusters for Amazon EKS on Amazon Web Services Outposts (https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-local-cluster-overview.html) // in the Amazon EKS User Guide. This object isn't available for creating Amazon // EKS clusters on the Amazon Web Services cloud. OutpostConfig *types.OutpostConfigRequest // The metadata to apply to the cluster to assist with categorization and // organization. Each tag consists of a key and an optional value. You define both. Tags map[string]string // The desired Kubernetes version for your cluster. If you don't specify a value // here, the default version available in Amazon EKS is used. The default version // might not be the latest version available. Version *string noSmithyDocumentSerde } type CreateClusterOutput struct { // The full description of your new cluster. Cluster *types.Cluster // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata noSmithyDocumentSerde } func (c *Client) addOperationCreateClusterMiddlewares(stack *middleware.Stack, options Options) (err error) { err = stack.Serialize.Add(&awsRestjson1_serializeOpCreateCluster{}, middleware.After) if err != nil { return err } err = stack.Deserialize.Add(&awsRestjson1_deserializeOpCreateCluster{}, middleware.After) if err != nil { return err } if err = addSetLoggerMiddleware(stack, options); err != nil { return err } if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { return err } if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { return err } if err = addResolveEndpointMiddleware(stack, options); err != nil { return err } if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { return err } if err = addRetryMiddlewares(stack, options); err != nil { return err } if err = addHTTPSignerV4Middleware(stack, options); err != nil { return err } if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { return err } if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { return err } if err = addClientUserAgent(stack, options); err != nil { return err } if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { return err } if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { return err } if err = addIdempotencyToken_opCreateClusterMiddleware(stack, options); err != nil { return err } if err = addOpCreateClusterValidationMiddleware(stack); err != nil { return err } if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateCluster(options.Region), middleware.Before); err != nil { return err } if err = awsmiddleware.AddRecursionDetection(stack); err != nil { return err } if err = addRequestIDRetrieverMiddleware(stack); err != nil { return err } if err = addResponseErrorMiddleware(stack); err != nil { return err } if err = addRequestResponseLogging(stack, options); err != nil { return err } return nil } type idempotencyToken_initializeOpCreateCluster struct { tokenProvider IdempotencyTokenProvider } func (*idempotencyToken_initializeOpCreateCluster) ID() string { return "OperationIdempotencyTokenAutoFill" } func (m *idempotencyToken_initializeOpCreateCluster) HandleInitialize(ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler) ( out middleware.InitializeOutput, metadata middleware.Metadata, err error, ) { if m.tokenProvider == nil { return next.HandleInitialize(ctx, in) } input, ok := in.Parameters.(*CreateClusterInput) if !ok { return out, metadata, fmt.Errorf("expected middleware input to be of type *CreateClusterInput ") } if input.ClientRequestToken == nil { t, err := m.tokenProvider.GetIdempotencyToken() if err != nil { return out, metadata, err } input.ClientRequestToken = &t } return next.HandleInitialize(ctx, in) } func addIdempotencyToken_opCreateClusterMiddleware(stack *middleware.Stack, cfg Options) error { return stack.Initialize.Add(&idempotencyToken_initializeOpCreateCluster{tokenProvider: cfg.IdempotencyTokenProvider}, middleware.Before) } func newServiceMetadataMiddleware_opCreateCluster(region string) *awsmiddleware.RegisterServiceMetadata { return &awsmiddleware.RegisterServiceMetadata{ Region: region, ServiceID: ServiceID, SigningName: "eks", OperationName: "CreateCluster", } }