/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.emrcontainers; import javax.annotation.Generated; import com.amazonaws.services.emrcontainers.model.*; /** * Interface for accessing Amazon EMR Containers asynchronously. Each asynchronous method will return a Java Future * object representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.emrcontainers.AbstractAmazonEMRContainersAsync} instead. *
**
* Amazon EMR on EKS provides a deployment option for Amazon EMR that allows you to run open-source big data frameworks * on Amazon Elastic Kubernetes Service (Amazon EKS). With this deployment option, you can focus on running analytics * workloads while Amazon EMR on EKS builds, configures, and manages containers for open-source applications. For more * information about Amazon EMR on EKS concepts and tasks, see What is shared * id="EMR-EKS"/>. *
*
* Amazon EMR containers is the API name for Amazon EMR on EKS. The emr-containers
prefix is used in
* the following scenarios:
*
* It is the prefix in the CLI commands for Amazon EMR on EKS. For example,
* aws emr-containers start-job-run
.
*
* It is the prefix before IAM policy actions for Amazon EMR on EKS. For example,
* "Action": [ "emr-containers:StartJobRun"]
. For more information, see Policy actions for Amazon EMR on EKS.
*
* It is the prefix used in Amazon EMR on EKS service endpoints. For example,
* emr-containers.us-east-2.amazonaws.com
. For more information, see Amazon EMR on EKSService Endpoints.
*
* Cancels a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you * submit to Amazon EMR on EKS. *
* * @param cancelJobRunRequest * @return A Java Future containing the result of the CancelJobRun operation returned by the service. * @sample AmazonEMRContainersAsync.CancelJobRun * @see AWS * API Documentation */ java.util.concurrent.Future* Cancels a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you * submit to Amazon EMR on EKS. *
* * @param cancelJobRunRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CancelJobRun operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.CancelJobRun * @see AWS * API Documentation */ java.util.concurrent.Future* Creates a job template. Job template stores values of StartJobRun API request in a template and can be used to * start a job run. Job template allows two use cases: avoid repeating recurring StartJobRun API request values, * enforcing certain values in StartJobRun API request. *
* * @param createJobTemplateRequest * @return A Java Future containing the result of the CreateJobTemplate operation returned by the service. * @sample AmazonEMRContainersAsync.CreateJobTemplate * @see AWS API Documentation */ java.util.concurrent.Future* Creates a job template. Job template stores values of StartJobRun API request in a template and can be used to * start a job run. Job template allows two use cases: avoid repeating recurring StartJobRun API request values, * enforcing certain values in StartJobRun API request. *
* * @param createJobTemplateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateJobTemplate operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.CreateJobTemplate * @see AWS API Documentation */ java.util.concurrent.Future* Creates a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on EKS * so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param createManagedEndpointRequest * @return A Java Future containing the result of the CreateManagedEndpoint operation returned by the service. * @sample AmazonEMRContainersAsync.CreateManagedEndpoint * @see AWS API Documentation */ java.util.concurrent.Future* Creates a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on EKS * so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param createManagedEndpointRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateManagedEndpoint operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.CreateManagedEndpoint * @see AWS API Documentation */ java.util.concurrent.Future* Creates a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, * list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual * cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same * way you model Kubernetes namespaces to meet your requirements. *
* * @param createVirtualClusterRequest * @return A Java Future containing the result of the CreateVirtualCluster operation returned by the service. * @sample AmazonEMRContainersAsync.CreateVirtualCluster * @see AWS API Documentation */ java.util.concurrent.Future* Creates a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, * list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual * cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same * way you model Kubernetes namespaces to meet your requirements. *
* * @param createVirtualClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateVirtualCluster operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.CreateVirtualCluster * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a job template. Job template stores values of StartJobRun API request in a template and can be used to * start a job run. Job template allows two use cases: avoid repeating recurring StartJobRun API request values, * enforcing certain values in StartJobRun API request. *
* * @param deleteJobTemplateRequest * @return A Java Future containing the result of the DeleteJobTemplate operation returned by the service. * @sample AmazonEMRContainersAsync.DeleteJobTemplate * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a job template. Job template stores values of StartJobRun API request in a template and can be used to * start a job run. Job template allows two use cases: avoid repeating recurring StartJobRun API request values, * enforcing certain values in StartJobRun API request. *
* * @param deleteJobTemplateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteJobTemplate operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DeleteJobTemplate * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on EKS * so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param deleteManagedEndpointRequest * @return A Java Future containing the result of the DeleteManagedEndpoint operation returned by the service. * @sample AmazonEMRContainersAsync.DeleteManagedEndpoint * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on EKS * so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param deleteManagedEndpointRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteManagedEndpoint operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DeleteManagedEndpoint * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, * list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual * cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same * way you model Kubernetes namespaces to meet your requirements. *
* * @param deleteVirtualClusterRequest * @return A Java Future containing the result of the DeleteVirtualCluster operation returned by the service. * @sample AmazonEMRContainersAsync.DeleteVirtualCluster * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create, describe, * list and delete virtual clusters. They do not consume any additional resource in your system. A single virtual * cluster maps to a single Kubernetes namespace. Given this relationship, you can model virtual clusters the same * way you model Kubernetes namespaces to meet your requirements. *
* * @param deleteVirtualClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteVirtualCluster operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DeleteVirtualCluster * @see AWS API Documentation */ java.util.concurrent.Future* Displays detailed information about a job run. A job run is a unit of work, such as a Spark jar, PySpark script, * or SparkSQL query, that you submit to Amazon EMR on EKS. *
* * @param describeJobRunRequest * @return A Java Future containing the result of the DescribeJobRun operation returned by the service. * @sample AmazonEMRContainersAsync.DescribeJobRun * @see AWS * API Documentation */ java.util.concurrent.Future* Displays detailed information about a job run. A job run is a unit of work, such as a Spark jar, PySpark script, * or SparkSQL query, that you submit to Amazon EMR on EKS. *
* * @param describeJobRunRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeJobRun operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DescribeJobRun * @see AWS * API Documentation */ java.util.concurrent.Future* Displays detailed information about a specified job template. Job template stores values of StartJobRun API * request in a template and can be used to start a job run. Job template allows two use cases: avoid repeating * recurring StartJobRun API request values, enforcing certain values in StartJobRun API request. *
* * @param describeJobTemplateRequest * @return A Java Future containing the result of the DescribeJobTemplate operation returned by the service. * @sample AmazonEMRContainersAsync.DescribeJobTemplate * @see AWS API Documentation */ java.util.concurrent.Future* Displays detailed information about a specified job template. Job template stores values of StartJobRun API * request in a template and can be used to start a job run. Job template allows two use cases: avoid repeating * recurring StartJobRun API request values, enforcing certain values in StartJobRun API request. *
* * @param describeJobTemplateRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeJobTemplate operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DescribeJobTemplate * @see AWS API Documentation */ java.util.concurrent.Future* Displays detailed information about a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR * Studio to Amazon EMR on EKS so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param describeManagedEndpointRequest * @return A Java Future containing the result of the DescribeManagedEndpoint operation returned by the service. * @sample AmazonEMRContainersAsync.DescribeManagedEndpoint * @see AWS API Documentation */ java.util.concurrent.Future* Displays detailed information about a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR * Studio to Amazon EMR on EKS so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param describeManagedEndpointRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeManagedEndpoint operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DescribeManagedEndpoint * @see AWS API Documentation */ java.util.concurrent.Future* Displays detailed information about a specified virtual cluster. Virtual cluster is a managed entity on Amazon * EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional * resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, * you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements. *
* * @param describeVirtualClusterRequest * @return A Java Future containing the result of the DescribeVirtualCluster operation returned by the service. * @sample AmazonEMRContainersAsync.DescribeVirtualCluster * @see AWS API Documentation */ java.util.concurrent.Future* Displays detailed information about a specified virtual cluster. Virtual cluster is a managed entity on Amazon * EMR on EKS. You can create, describe, list and delete virtual clusters. They do not consume any additional * resource in your system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, * you can model virtual clusters the same way you model Kubernetes namespaces to meet your requirements. *
* * @param describeVirtualClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeVirtualCluster operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.DescribeVirtualCluster * @see AWS API Documentation */ java.util.concurrent.Future* Generate a session token to connect to a managed endpoint. *
* * @param getManagedEndpointSessionCredentialsRequest * @return A Java Future containing the result of the GetManagedEndpointSessionCredentials operation returned by the * service. * @sample AmazonEMRContainersAsync.GetManagedEndpointSessionCredentials * @see AWS API Documentation */ java.util.concurrent.Future* Generate a session token to connect to a managed endpoint. *
* * @param getManagedEndpointSessionCredentialsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetManagedEndpointSessionCredentials operation returned by the * service. * @sample AmazonEMRContainersAsyncHandler.GetManagedEndpointSessionCredentials * @see AWS API Documentation */ java.util.concurrent.Future* Lists job runs based on a set of parameters. A job run is a unit of work, such as a Spark jar, PySpark script, or * SparkSQL query, that you submit to Amazon EMR on EKS. *
* * @param listJobRunsRequest * @return A Java Future containing the result of the ListJobRuns operation returned by the service. * @sample AmazonEMRContainersAsync.ListJobRuns * @see AWS API * Documentation */ java.util.concurrent.Future* Lists job runs based on a set of parameters. A job run is a unit of work, such as a Spark jar, PySpark script, or * SparkSQL query, that you submit to Amazon EMR on EKS. *
* * @param listJobRunsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListJobRuns operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.ListJobRuns * @see AWS API * Documentation */ java.util.concurrent.Future* Lists job templates based on a set of parameters. Job template stores values of StartJobRun API request in a * template and can be used to start a job run. Job template allows two use cases: avoid repeating recurring * StartJobRun API request values, enforcing certain values in StartJobRun API request. *
* * @param listJobTemplatesRequest * @return A Java Future containing the result of the ListJobTemplates operation returned by the service. * @sample AmazonEMRContainersAsync.ListJobTemplates * @see AWS API Documentation */ java.util.concurrent.Future* Lists job templates based on a set of parameters. Job template stores values of StartJobRun API request in a * template and can be used to start a job run. Job template allows two use cases: avoid repeating recurring * StartJobRun API request values, enforcing certain values in StartJobRun API request. *
* * @param listJobTemplatesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListJobTemplates operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.ListJobTemplates * @see AWS API Documentation */ java.util.concurrent.Future* Lists managed endpoints based on a set of parameters. A managed endpoint is a gateway that connects Amazon EMR * Studio to Amazon EMR on EKS so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param listManagedEndpointsRequest * @return A Java Future containing the result of the ListManagedEndpoints operation returned by the service. * @sample AmazonEMRContainersAsync.ListManagedEndpoints * @see AWS API Documentation */ java.util.concurrent.Future* Lists managed endpoints based on a set of parameters. A managed endpoint is a gateway that connects Amazon EMR * Studio to Amazon EMR on EKS so that Amazon EMR Studio can communicate with your virtual cluster. *
* * @param listManagedEndpointsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListManagedEndpoints operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.ListManagedEndpoints * @see AWS API Documentation */ java.util.concurrent.Future* Lists the tags assigned to the resources. *
* * @param listTagsForResourceRequest * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonEMRContainersAsync.ListTagsForResource * @see AWS API Documentation */ java.util.concurrent.Future* Lists the tags assigned to the resources. *
* * @param listTagsForResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.ListTagsForResource * @see AWS API Documentation */ java.util.concurrent.Future* Lists information about the specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. * You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your * system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model * virtual clusters the same way you model Kubernetes namespaces to meet your requirements. *
* * @param listVirtualClustersRequest * @return A Java Future containing the result of the ListVirtualClusters operation returned by the service. * @sample AmazonEMRContainersAsync.ListVirtualClusters * @see AWS API Documentation */ java.util.concurrent.Future* Lists information about the specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. * You can create, describe, list and delete virtual clusters. They do not consume any additional resource in your * system. A single virtual cluster maps to a single Kubernetes namespace. Given this relationship, you can model * virtual clusters the same way you model Kubernetes namespaces to meet your requirements. *
* * @param listVirtualClustersRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListVirtualClusters operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.ListVirtualClusters * @see AWS API Documentation */ java.util.concurrent.Future* Starts a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you * submit to Amazon EMR on EKS. *
* * @param startJobRunRequest * @return A Java Future containing the result of the StartJobRun operation returned by the service. * @sample AmazonEMRContainersAsync.StartJobRun * @see AWS API * Documentation */ java.util.concurrent.Future* Starts a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you * submit to Amazon EMR on EKS. *
* * @param startJobRunRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StartJobRun operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.StartJobRun * @see AWS API * Documentation */ java.util.concurrent.Future* Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists * of a key and an optional value, both of which you define. Tags enable you to categorize your Amazon Web Services * resources by attributes such as purpose, owner, or environment. When you have many resources of the same type, * you can quickly identify a specific resource based on the tags you've assigned to it. For example, you can define * a set of tags for your Amazon EMR on EKS clusters to help you track each cluster's owner and stack level. We * recommend that you devise a consistent set of tag keys for each resource type. You can then search and filter the * resources based on the tags that you add. *
* * @param tagResourceRequest * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonEMRContainersAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists * of a key and an optional value, both of which you define. Tags enable you to categorize your Amazon Web Services * resources by attributes such as purpose, owner, or environment. When you have many resources of the same type, * you can quickly identify a specific resource based on the tags you've assigned to it. For example, you can define * a set of tags for your Amazon EMR on EKS clusters to help you track each cluster's owner and stack level. We * recommend that you devise a consistent set of tag keys for each resource type. You can then search and filter the * resources based on the tags that you add. *
* * @param tagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Removes tags from resources. *
* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonEMRContainersAsync.UntagResource * @see AWS * API Documentation */ java.util.concurrent.Future* Removes tags from resources. *
* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonEMRContainersAsyncHandler.UntagResource * @see AWS * API Documentation */ java.util.concurrent.Future