Interface EmrServerlessClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.
Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running analytics applications using the latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize, secure, or operate clusters to run applications with these frameworks.
The API reference to Amazon EMR Serverless is emr-serverless. The emr-serverless prefix is
used in the following scenarios:
-
It is the prefix in the CLI commands for Amazon EMR Serverless. For example,
aws emr-serverless start-job-run. -
It is the prefix before IAM policy actions for Amazon EMR Serverless. For example,
"Action": ["emr-serverless:StartJobRun"]. For more information, see Policy actions for Amazon EMR Serverless. -
It is the prefix used in Amazon EMR Serverless service endpoints. For example,
emr-serverless.us-east-2.amazonaws.com.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionstatic EmrServerlessClientBuilderbuilder()Create a builder that can be used to configure and create aEmrServerlessClient.default CancelJobRunResponsecancelJobRun(Consumer<CancelJobRunRequest.Builder> cancelJobRunRequest) Cancels a job run.default CancelJobRunResponsecancelJobRun(CancelJobRunRequest cancelJobRunRequest) Cancels a job run.static EmrServerlessClientcreate()Create aEmrServerlessClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreateApplicationResponsecreateApplication(Consumer<CreateApplicationRequest.Builder> createApplicationRequest) Creates an application.default CreateApplicationResponsecreateApplication(CreateApplicationRequest createApplicationRequest) Creates an application.default DeleteApplicationResponsedeleteApplication(Consumer<DeleteApplicationRequest.Builder> deleteApplicationRequest) Deletes an application.default DeleteApplicationResponsedeleteApplication(DeleteApplicationRequest deleteApplicationRequest) Deletes an application.default GetApplicationResponsegetApplication(Consumer<GetApplicationRequest.Builder> getApplicationRequest) Displays detailed information about a specified application.default GetApplicationResponsegetApplication(GetApplicationRequest getApplicationRequest) Displays detailed information about a specified application.default GetDashboardForJobRunResponsegetDashboardForJobRun(Consumer<GetDashboardForJobRunRequest.Builder> getDashboardForJobRunRequest) Creates and returns a URL that you can use to access the application UIs for a job run.default GetDashboardForJobRunResponsegetDashboardForJobRun(GetDashboardForJobRunRequest getDashboardForJobRunRequest) Creates and returns a URL that you can use to access the application UIs for a job run.default GetJobRunResponsegetJobRun(Consumer<GetJobRunRequest.Builder> getJobRunRequest) Displays detailed information about a job run.default GetJobRunResponsegetJobRun(GetJobRunRequest getJobRunRequest) Displays detailed information about a job run.default ListApplicationsResponselistApplications(Consumer<ListApplicationsRequest.Builder> listApplicationsRequest) Lists applications based on a set of parameters.default ListApplicationsResponselistApplications(ListApplicationsRequest listApplicationsRequest) Lists applications based on a set of parameters.default ListApplicationsIterablelistApplicationsPaginator(Consumer<ListApplicationsRequest.Builder> listApplicationsRequest) This is a variant oflistApplications(software.amazon.awssdk.services.emrserverless.model.ListApplicationsRequest)operation.default ListApplicationsIterablelistApplicationsPaginator(ListApplicationsRequest listApplicationsRequest) This is a variant oflistApplications(software.amazon.awssdk.services.emrserverless.model.ListApplicationsRequest)operation.default ListJobRunAttemptsResponselistJobRunAttempts(Consumer<ListJobRunAttemptsRequest.Builder> listJobRunAttemptsRequest) Lists all attempt of a job run.default ListJobRunAttemptsResponselistJobRunAttempts(ListJobRunAttemptsRequest listJobRunAttemptsRequest) Lists all attempt of a job run.default ListJobRunAttemptsIterablelistJobRunAttemptsPaginator(Consumer<ListJobRunAttemptsRequest.Builder> listJobRunAttemptsRequest) This is a variant oflistJobRunAttempts(software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsRequest)operation.default ListJobRunAttemptsIterablelistJobRunAttemptsPaginator(ListJobRunAttemptsRequest listJobRunAttemptsRequest) This is a variant oflistJobRunAttempts(software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsRequest)operation.default ListJobRunsResponselistJobRuns(Consumer<ListJobRunsRequest.Builder> listJobRunsRequest) Lists job runs based on a set of parameters.default ListJobRunsResponselistJobRuns(ListJobRunsRequest listJobRunsRequest) Lists job runs based on a set of parameters.default ListJobRunsIterablelistJobRunsPaginator(Consumer<ListJobRunsRequest.Builder> listJobRunsRequest) This is a variant oflistJobRuns(software.amazon.awssdk.services.emrserverless.model.ListJobRunsRequest)operation.default ListJobRunsIterablelistJobRunsPaginator(ListJobRunsRequest listJobRunsRequest) This is a variant oflistJobRuns(software.amazon.awssdk.services.emrserverless.model.ListJobRunsRequest)operation.default ListTagsForResourceResponselistTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags assigned to the resources.default ListTagsForResourceResponselistTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags assigned to the resources.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadatadefault StartApplicationResponsestartApplication(Consumer<StartApplicationRequest.Builder> startApplicationRequest) Starts a specified application and initializes initial capacity if configured.default StartApplicationResponsestartApplication(StartApplicationRequest startApplicationRequest) Starts a specified application and initializes initial capacity if configured.default StartJobRunResponsestartJobRun(Consumer<StartJobRunRequest.Builder> startJobRunRequest) Starts a job run.default StartJobRunResponsestartJobRun(StartJobRunRequest startJobRunRequest) Starts a job run.default StopApplicationResponsestopApplication(Consumer<StopApplicationRequest.Builder> stopApplicationRequest) Stops a specified application and releases initial capacity if configured.default StopApplicationResponsestopApplication(StopApplicationRequest stopApplicationRequest) Stops a specified application and releases initial capacity if configured.default TagResourceResponsetagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Assigns tags to resources.default TagResourceResponsetagResource(TagResourceRequest tagResourceRequest) Assigns tags to resources.default UntagResourceResponseuntagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes tags from resources.default UntagResourceResponseuntagResource(UntagResourceRequest untagResourceRequest) Removes tags from resources.default UpdateApplicationResponseupdateApplication(Consumer<UpdateApplicationRequest.Builder> updateApplicationRequest) Updates a specified application.default UpdateApplicationResponseupdateApplication(UpdateApplicationRequest updateApplicationRequest) Updates a specified application.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
cancelJobRun
default CancelJobRunResponse cancelJobRun(CancelJobRunRequest cancelJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Cancels a job run.
- Parameters:
cancelJobRunRequest-- Returns:
- Result of the CancelJobRun operation returned by the service.
- See Also:
-
cancelJobRun
default CancelJobRunResponse cancelJobRun(Consumer<CancelJobRunRequest.Builder> cancelJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Cancels a job run.
This is a convenience which creates an instance of the
CancelJobRunRequest.Builderavoiding the need to create one manually viaCancelJobRunRequest.builder()- Parameters:
cancelJobRunRequest- AConsumerthat will call methods onCancelJobRunRequest.Builderto create a request.- Returns:
- Result of the CancelJobRun operation returned by the service.
- See Also:
-
createApplication
default CreateApplicationResponse createApplication(CreateApplicationRequest createApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, ConflictException, AwsServiceException, SdkClientException, EmrServerlessException Creates an application.
- Parameters:
createApplicationRequest-- Returns:
- Result of the CreateApplication operation returned by the service.
- See Also:
-
createApplication
default CreateApplicationResponse createApplication(Consumer<CreateApplicationRequest.Builder> createApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, ConflictException, AwsServiceException, SdkClientException, EmrServerlessException Creates an application.
This is a convenience which creates an instance of the
CreateApplicationRequest.Builderavoiding the need to create one manually viaCreateApplicationRequest.builder()- Parameters:
createApplicationRequest- AConsumerthat will call methods onCreateApplicationRequest.Builderto create a request.- Returns:
- Result of the CreateApplication operation returned by the service.
- See Also:
-
deleteApplication
default DeleteApplicationResponse deleteApplication(DeleteApplicationRequest deleteApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Deletes an application. An application has to be in a stopped or created state in order to be deleted.
- Parameters:
deleteApplicationRequest-- Returns:
- Result of the DeleteApplication operation returned by the service.
- See Also:
-
deleteApplication
default DeleteApplicationResponse deleteApplication(Consumer<DeleteApplicationRequest.Builder> deleteApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Deletes an application. An application has to be in a stopped or created state in order to be deleted.
This is a convenience which creates an instance of the
DeleteApplicationRequest.Builderavoiding the need to create one manually viaDeleteApplicationRequest.builder()- Parameters:
deleteApplicationRequest- AConsumerthat will call methods onDeleteApplicationRequest.Builderto create a request.- Returns:
- Result of the DeleteApplication operation returned by the service.
- See Also:
-
getApplication
default GetApplicationResponse getApplication(GetApplicationRequest getApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Displays detailed information about a specified application.
- Parameters:
getApplicationRequest-- Returns:
- Result of the GetApplication operation returned by the service.
- See Also:
-
getApplication
default GetApplicationResponse getApplication(Consumer<GetApplicationRequest.Builder> getApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Displays detailed information about a specified application.
This is a convenience which creates an instance of the
GetApplicationRequest.Builderavoiding the need to create one manually viaGetApplicationRequest.builder()- Parameters:
getApplicationRequest- AConsumerthat will call methods onGetApplicationRequest.Builderto create a request.- Returns:
- Result of the GetApplication operation returned by the service.
- See Also:
-
getDashboardForJobRun
default GetDashboardForJobRunResponse getDashboardForJobRun(GetDashboardForJobRunRequest getDashboardForJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Creates and returns a URL that you can use to access the application UIs for a job run.
For jobs in a running state, the application UI is a live user interface such as the Spark or Tez web UI. For completed jobs, the application UI is a persistent application user interface such as the Spark History Server or persistent Tez UI.
The URL is valid for one hour after you generate it. To access the application UI after that hour elapses, you must invoke the API again to generate a new URL.
- Parameters:
getDashboardForJobRunRequest-- Returns:
- Result of the GetDashboardForJobRun operation returned by the service.
- See Also:
-
getDashboardForJobRun
default GetDashboardForJobRunResponse getDashboardForJobRun(Consumer<GetDashboardForJobRunRequest.Builder> getDashboardForJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Creates and returns a URL that you can use to access the application UIs for a job run.
For jobs in a running state, the application UI is a live user interface such as the Spark or Tez web UI. For completed jobs, the application UI is a persistent application user interface such as the Spark History Server or persistent Tez UI.
The URL is valid for one hour after you generate it. To access the application UI after that hour elapses, you must invoke the API again to generate a new URL.
This is a convenience which creates an instance of the
GetDashboardForJobRunRequest.Builderavoiding the need to create one manually viaGetDashboardForJobRunRequest.builder()- Parameters:
getDashboardForJobRunRequest- AConsumerthat will call methods onGetDashboardForJobRunRequest.Builderto create a request.- Returns:
- Result of the GetDashboardForJobRun operation returned by the service.
- See Also:
-
getJobRun
default GetJobRunResponse getJobRun(GetJobRunRequest getJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Displays detailed information about a job run.
- Parameters:
getJobRunRequest-- Returns:
- Result of the GetJobRun operation returned by the service.
- See Also:
-
getJobRun
default GetJobRunResponse getJobRun(Consumer<GetJobRunRequest.Builder> getJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Displays detailed information about a job run.
This is a convenience which creates an instance of the
GetJobRunRequest.Builderavoiding the need to create one manually viaGetJobRunRequest.builder()- Parameters:
getJobRunRequest- AConsumerthat will call methods onGetJobRunRequest.Builderto create a request.- Returns:
- Result of the GetJobRun operation returned by the service.
- See Also:
-
listApplications
default ListApplicationsResponse listApplications(ListApplicationsRequest listApplicationsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists applications based on a set of parameters.
- Parameters:
listApplicationsRequest-- Returns:
- Result of the ListApplications operation returned by the service.
- See Also:
-
listApplications
default ListApplicationsResponse listApplications(Consumer<ListApplicationsRequest.Builder> listApplicationsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists applications based on a set of parameters.
This is a convenience which creates an instance of the
ListApplicationsRequest.Builderavoiding the need to create one manually viaListApplicationsRequest.builder()- Parameters:
listApplicationsRequest- AConsumerthat will call methods onListApplicationsRequest.Builderto create a request.- Returns:
- Result of the ListApplications operation returned by the service.
- See Also:
-
listApplicationsPaginator
default ListApplicationsIterable listApplicationsPaginator(ListApplicationsRequest listApplicationsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException This is a variant of
listApplications(software.amazon.awssdk.services.emrserverless.model.ListApplicationsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.emrserverless.paginators.ListApplicationsIterable responses = client.listApplicationsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.emrserverless.paginators.ListApplicationsIterable responses = client .listApplicationsPaginator(request); for (software.amazon.awssdk.services.emrserverless.model.ListApplicationsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.emrserverless.paginators.ListApplicationsIterable responses = client.listApplicationsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listApplications(software.amazon.awssdk.services.emrserverless.model.ListApplicationsRequest)operation.- Parameters:
listApplicationsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listApplicationsPaginator
default ListApplicationsIterable listApplicationsPaginator(Consumer<ListApplicationsRequest.Builder> listApplicationsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException This is a variant of
listApplications(software.amazon.awssdk.services.emrserverless.model.ListApplicationsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.emrserverless.paginators.ListApplicationsIterable responses = client.listApplicationsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.emrserverless.paginators.ListApplicationsIterable responses = client .listApplicationsPaginator(request); for (software.amazon.awssdk.services.emrserverless.model.ListApplicationsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.emrserverless.paginators.ListApplicationsIterable responses = client.listApplicationsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listApplications(software.amazon.awssdk.services.emrserverless.model.ListApplicationsRequest)operation.
This is a convenience which creates an instance of the
ListApplicationsRequest.Builderavoiding the need to create one manually viaListApplicationsRequest.builder()- Parameters:
listApplicationsRequest- AConsumerthat will call methods onListApplicationsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listJobRunAttempts
default ListJobRunAttemptsResponse listJobRunAttempts(ListJobRunAttemptsRequest listJobRunAttemptsRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists all attempt of a job run.
- Parameters:
listJobRunAttemptsRequest-- Returns:
- Result of the ListJobRunAttempts operation returned by the service.
- See Also:
-
listJobRunAttempts
default ListJobRunAttemptsResponse listJobRunAttempts(Consumer<ListJobRunAttemptsRequest.Builder> listJobRunAttemptsRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists all attempt of a job run.
This is a convenience which creates an instance of the
ListJobRunAttemptsRequest.Builderavoiding the need to create one manually viaListJobRunAttemptsRequest.builder()- Parameters:
listJobRunAttemptsRequest- AConsumerthat will call methods onListJobRunAttemptsRequest.Builderto create a request.- Returns:
- Result of the ListJobRunAttempts operation returned by the service.
- See Also:
-
listJobRunAttemptsPaginator
default ListJobRunAttemptsIterable listJobRunAttemptsPaginator(ListJobRunAttemptsRequest listJobRunAttemptsRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException This is a variant of
listJobRunAttempts(software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunAttemptsIterable responses = client.listJobRunAttemptsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.emrserverless.paginators.ListJobRunAttemptsIterable responses = client .listJobRunAttemptsPaginator(request); for (software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunAttemptsIterable responses = client.listJobRunAttemptsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobRunAttempts(software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsRequest)operation.- Parameters:
listJobRunAttemptsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listJobRunAttemptsPaginator
default ListJobRunAttemptsIterable listJobRunAttemptsPaginator(Consumer<ListJobRunAttemptsRequest.Builder> listJobRunAttemptsRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException This is a variant of
listJobRunAttempts(software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunAttemptsIterable responses = client.listJobRunAttemptsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.emrserverless.paginators.ListJobRunAttemptsIterable responses = client .listJobRunAttemptsPaginator(request); for (software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunAttemptsIterable responses = client.listJobRunAttemptsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobRunAttempts(software.amazon.awssdk.services.emrserverless.model.ListJobRunAttemptsRequest)operation.
This is a convenience which creates an instance of the
ListJobRunAttemptsRequest.Builderavoiding the need to create one manually viaListJobRunAttemptsRequest.builder()- Parameters:
listJobRunAttemptsRequest- AConsumerthat will call methods onListJobRunAttemptsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listJobRuns
default ListJobRunsResponse listJobRuns(ListJobRunsRequest listJobRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists job runs based on a set of parameters.
- Parameters:
listJobRunsRequest-- Returns:
- Result of the ListJobRuns operation returned by the service.
- See Also:
-
listJobRuns
default ListJobRunsResponse listJobRuns(Consumer<ListJobRunsRequest.Builder> listJobRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists job runs based on a set of parameters.
This is a convenience which creates an instance of the
ListJobRunsRequest.Builderavoiding the need to create one manually viaListJobRunsRequest.builder()- Parameters:
listJobRunsRequest- AConsumerthat will call methods onListJobRunsRequest.Builderto create a request.- Returns:
- Result of the ListJobRuns operation returned by the service.
- See Also:
-
listJobRunsPaginator
default ListJobRunsIterable listJobRunsPaginator(ListJobRunsRequest listJobRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException This is a variant of
listJobRuns(software.amazon.awssdk.services.emrserverless.model.ListJobRunsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunsIterable responses = client.listJobRunsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.emrserverless.paginators.ListJobRunsIterable responses = client.listJobRunsPaginator(request); for (software.amazon.awssdk.services.emrserverless.model.ListJobRunsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunsIterable responses = client.listJobRunsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobRuns(software.amazon.awssdk.services.emrserverless.model.ListJobRunsRequest)operation.- Parameters:
listJobRunsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listJobRunsPaginator
default ListJobRunsIterable listJobRunsPaginator(Consumer<ListJobRunsRequest.Builder> listJobRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException This is a variant of
listJobRuns(software.amazon.awssdk.services.emrserverless.model.ListJobRunsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunsIterable responses = client.listJobRunsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.emrserverless.paginators.ListJobRunsIterable responses = client.listJobRunsPaginator(request); for (software.amazon.awssdk.services.emrserverless.model.ListJobRunsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.emrserverless.paginators.ListJobRunsIterable responses = client.listJobRunsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listJobRuns(software.amazon.awssdk.services.emrserverless.model.ListJobRunsRequest)operation.
This is a convenience which creates an instance of the
ListJobRunsRequest.Builderavoiding the need to create one manually viaListJobRunsRequest.builder()- Parameters:
listJobRunsRequest- AConsumerthat will call methods onListJobRunsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists the tags assigned to the resources.
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Lists the tags assigned to the resources.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
startApplication
default StartApplicationResponse startApplication(StartApplicationRequest startApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, EmrServerlessException Starts a specified application and initializes initial capacity if configured.
- Parameters:
startApplicationRequest-- Returns:
- Result of the StartApplication operation returned by the service.
- See Also:
-
startApplication
default StartApplicationResponse startApplication(Consumer<StartApplicationRequest.Builder> startApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, ServiceQuotaExceededException, AwsServiceException, SdkClientException, EmrServerlessException Starts a specified application and initializes initial capacity if configured.
This is a convenience which creates an instance of the
StartApplicationRequest.Builderavoiding the need to create one manually viaStartApplicationRequest.builder()- Parameters:
startApplicationRequest- AConsumerthat will call methods onStartApplicationRequest.Builderto create a request.- Returns:
- Result of the StartApplication operation returned by the service.
- See Also:
-
startJobRun
default StartJobRunResponse startJobRun(StartJobRunRequest startJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, ConflictException, AwsServiceException, SdkClientException, EmrServerlessException Starts a job run.
- Parameters:
startJobRunRequest-- Returns:
- Result of the StartJobRun operation returned by the service.
- See Also:
-
startJobRun
default StartJobRunResponse startJobRun(Consumer<StartJobRunRequest.Builder> startJobRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, ConflictException, AwsServiceException, SdkClientException, EmrServerlessException Starts a job run.
This is a convenience which creates an instance of the
StartJobRunRequest.Builderavoiding the need to create one manually viaStartJobRunRequest.builder()- Parameters:
startJobRunRequest- AConsumerthat will call methods onStartJobRunRequest.Builderto create a request.- Returns:
- Result of the StartJobRun operation returned by the service.
- See Also:
-
stopApplication
default StopApplicationResponse stopApplication(StopApplicationRequest stopApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Stops a specified application and releases initial capacity if configured. All scheduled and running jobs must be completed or cancelled before stopping an application.
- Parameters:
stopApplicationRequest-- Returns:
- Result of the StopApplication operation returned by the service.
- See Also:
-
stopApplication
default StopApplicationResponse stopApplication(Consumer<StopApplicationRequest.Builder> stopApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Stops a specified application and releases initial capacity if configured. All scheduled and running jobs must be completed or cancelled before stopping an application.
This is a convenience which creates an instance of the
StopApplicationRequest.Builderavoiding the need to create one manually viaStopApplicationRequest.builder()- Parameters:
stopApplicationRequest- AConsumerthat will call methods onStopApplicationRequest.Builderto create a request.- Returns:
- Result of the StopApplication operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException 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.
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException 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.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Removes tags from resources.
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Removes tags from resources.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
updateApplication
default UpdateApplicationResponse updateApplication(UpdateApplicationRequest updateApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Updates a specified application. An application has to be in a stopped or created state in order to be updated.
- Parameters:
updateApplicationRequest-- Returns:
- Result of the UpdateApplication operation returned by the service.
- See Also:
-
updateApplication
default UpdateApplicationResponse updateApplication(Consumer<UpdateApplicationRequest.Builder> updateApplicationRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, EmrServerlessException Updates a specified application. An application has to be in a stopped or created state in order to be updated.
This is a convenience which creates an instance of the
UpdateApplicationRequest.Builderavoiding the need to create one manually viaUpdateApplicationRequest.builder()- Parameters:
updateApplicationRequest- AConsumerthat will call methods onUpdateApplicationRequest.Builderto create a request.- Returns:
- Result of the UpdateApplication operation returned by the service.
- See Also:
-
create
Create aEmrServerlessClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aEmrServerlessClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-