/*
* Copyright 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.
*/
/*
* Do not modify this file. This file is generated from the emr-serverless-2021-07-13.normal.json service model.
*/
using System;
using System.Threading;
using System.Threading.Tasks;
using System.Collections.Generic;
using Amazon.Runtime;
using Amazon.EMRServerless.Model;
namespace Amazon.EMRServerless
{
///
/// Interface for accessing EMRServerless
///
/// 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
.
///
///
///
public partial interface IAmazonEMRServerless : IAmazonService, IDisposable
{
///
/// Paginators for the service
///
IEMRServerlessPaginatorFactory Paginators { get; }
#region CancelJobRun
///
/// Cancels a job run.
///
/// Container for the necessary parameters to execute the CancelJobRun service method.
///
/// The response from the CancelJobRun service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for CancelJobRun Operation
CancelJobRunResponse CancelJobRun(CancelJobRunRequest request);
///
/// Cancels a job run.
///
/// Container for the necessary parameters to execute the CancelJobRun service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the CancelJobRun service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for CancelJobRun Operation
Task CancelJobRunAsync(CancelJobRunRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region CreateApplication
///
/// Creates an application.
///
/// Container for the necessary parameters to execute the CreateApplication service method.
///
/// The response from the CreateApplication service method, as returned by EMRServerless.
///
/// The request could not be processed because of conflict in the current state of the
/// resource.
///
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for CreateApplication Operation
CreateApplicationResponse CreateApplication(CreateApplicationRequest request);
///
/// Creates an application.
///
/// Container for the necessary parameters to execute the CreateApplication service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the CreateApplication service method, as returned by EMRServerless.
///
/// The request could not be processed because of conflict in the current state of the
/// resource.
///
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for CreateApplication Operation
Task CreateApplicationAsync(CreateApplicationRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region DeleteApplication
///
/// Deletes an application. An application has to be in a stopped or created state in
/// order to be deleted.
///
/// Container for the necessary parameters to execute the DeleteApplication service method.
///
/// The response from the DeleteApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for DeleteApplication Operation
DeleteApplicationResponse DeleteApplication(DeleteApplicationRequest request);
///
/// Deletes an application. An application has to be in a stopped or created state in
/// order to be deleted.
///
/// Container for the necessary parameters to execute the DeleteApplication service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the DeleteApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for DeleteApplication Operation
Task DeleteApplicationAsync(DeleteApplicationRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region GetApplication
///
/// Displays detailed information about a specified application.
///
/// Container for the necessary parameters to execute the GetApplication service method.
///
/// The response from the GetApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for GetApplication Operation
GetApplicationResponse GetApplication(GetApplicationRequest request);
///
/// Displays detailed information about a specified application.
///
/// Container for the necessary parameters to execute the GetApplication service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the GetApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for GetApplication Operation
Task GetApplicationAsync(GetApplicationRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region GetDashboardForJobRun
///
/// 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.
///
///
///
/// Container for the necessary parameters to execute the GetDashboardForJobRun service method.
///
/// The response from the GetDashboardForJobRun service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for GetDashboardForJobRun Operation
GetDashboardForJobRunResponse GetDashboardForJobRun(GetDashboardForJobRunRequest request);
///
/// 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.
///
///
///
/// Container for the necessary parameters to execute the GetDashboardForJobRun service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the GetDashboardForJobRun service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for GetDashboardForJobRun Operation
Task GetDashboardForJobRunAsync(GetDashboardForJobRunRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region GetJobRun
///
/// Displays detailed information about a job run.
///
/// Container for the necessary parameters to execute the GetJobRun service method.
///
/// The response from the GetJobRun service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for GetJobRun Operation
GetJobRunResponse GetJobRun(GetJobRunRequest request);
///
/// Displays detailed information about a job run.
///
/// Container for the necessary parameters to execute the GetJobRun service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the GetJobRun service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for GetJobRun Operation
Task GetJobRunAsync(GetJobRunRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region ListApplications
///
/// Lists applications based on a set of parameters.
///
/// Container for the necessary parameters to execute the ListApplications service method.
///
/// The response from the ListApplications service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for ListApplications Operation
ListApplicationsResponse ListApplications(ListApplicationsRequest request);
///
/// Lists applications based on a set of parameters.
///
/// Container for the necessary parameters to execute the ListApplications service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the ListApplications service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for ListApplications Operation
Task ListApplicationsAsync(ListApplicationsRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region ListJobRuns
///
/// Lists job runs based on a set of parameters.
///
/// Container for the necessary parameters to execute the ListJobRuns service method.
///
/// The response from the ListJobRuns service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for ListJobRuns Operation
ListJobRunsResponse ListJobRuns(ListJobRunsRequest request);
///
/// Lists job runs based on a set of parameters.
///
/// Container for the necessary parameters to execute the ListJobRuns service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the ListJobRuns service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for ListJobRuns Operation
Task ListJobRunsAsync(ListJobRunsRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region ListTagsForResource
///
/// Lists the tags assigned to the resources.
///
/// Container for the necessary parameters to execute the ListTagsForResource service method.
///
/// The response from the ListTagsForResource service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for ListTagsForResource Operation
ListTagsForResourceResponse ListTagsForResource(ListTagsForResourceRequest request);
///
/// Lists the tags assigned to the resources.
///
/// Container for the necessary parameters to execute the ListTagsForResource service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the ListTagsForResource service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for ListTagsForResource Operation
Task ListTagsForResourceAsync(ListTagsForResourceRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StartApplication
///
/// Starts a specified application and initializes initial capacity if configured.
///
/// Container for the necessary parameters to execute the StartApplication service method.
///
/// The response from the StartApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The maximum number of resources per account has been reached.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for StartApplication Operation
StartApplicationResponse StartApplication(StartApplicationRequest request);
///
/// Starts a specified application and initializes initial capacity if configured.
///
/// Container for the necessary parameters to execute the StartApplication service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StartApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The maximum number of resources per account has been reached.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for StartApplication Operation
Task StartApplicationAsync(StartApplicationRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StartJobRun
///
/// Starts a job run.
///
/// Container for the necessary parameters to execute the StartJobRun service method.
///
/// The response from the StartJobRun service method, as returned by EMRServerless.
///
/// The request could not be processed because of conflict in the current state of the
/// resource.
///
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for StartJobRun Operation
StartJobRunResponse StartJobRun(StartJobRunRequest request);
///
/// Starts a job run.
///
/// Container for the necessary parameters to execute the StartJobRun service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StartJobRun service method, as returned by EMRServerless.
///
/// The request could not be processed because of conflict in the current state of the
/// resource.
///
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for StartJobRun Operation
Task StartJobRunAsync(StartJobRunRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region StopApplication
///
/// Stops a specified application and releases initial capacity if configured. All scheduled
/// and running jobs must be completed or cancelled before stopping an application.
///
/// Container for the necessary parameters to execute the StopApplication service method.
///
/// The response from the StopApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for StopApplication Operation
StopApplicationResponse StopApplication(StopApplicationRequest request);
///
/// Stops a specified application and releases initial capacity if configured. All scheduled
/// and running jobs must be completed or cancelled before stopping an application.
///
/// Container for the necessary parameters to execute the StopApplication service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the StopApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for StopApplication Operation
Task StopApplicationAsync(StopApplicationRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region TagResource
///
/// 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.
///
/// Container for the necessary parameters to execute the TagResource service method.
///
/// The response from the TagResource service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for TagResource Operation
TagResourceResponse TagResource(TagResourceRequest request);
///
/// 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.
///
/// Container for the necessary parameters to execute the TagResource service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the TagResource service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for TagResource Operation
Task TagResourceAsync(TagResourceRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region UntagResource
///
/// Removes tags from resources.
///
/// Container for the necessary parameters to execute the UntagResource service method.
///
/// The response from the UntagResource service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for UntagResource Operation
UntagResourceResponse UntagResource(UntagResourceRequest request);
///
/// Removes tags from resources.
///
/// Container for the necessary parameters to execute the UntagResource service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the UntagResource service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for UntagResource Operation
Task UntagResourceAsync(UntagResourceRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
#region UpdateApplication
///
/// Updates a specified application. An application has to be in a stopped or created
/// state in order to be updated.
///
/// Container for the necessary parameters to execute the UpdateApplication service method.
///
/// The response from the UpdateApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for UpdateApplication Operation
UpdateApplicationResponse UpdateApplication(UpdateApplicationRequest request);
///
/// Updates a specified application. An application has to be in a stopped or created
/// state in order to be updated.
///
/// Container for the necessary parameters to execute the UpdateApplication service method.
///
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
///
///
/// The response from the UpdateApplication service method, as returned by EMRServerless.
///
/// Request processing failed because of an error or failure with the service.
///
///
/// The specified resource was not found.
///
///
/// The input fails to satisfy the constraints specified by an Amazon Web Services service.
///
/// REST API Reference for UpdateApplication Operation
Task UpdateApplicationAsync(UpdateApplicationRequest request, CancellationToken cancellationToken = default(CancellationToken));
#endregion
}
}