com.amazonaws.services.elastictranscoder.AmazonElasticTranscoderClient Maven / Gradle / Ivy
Show all versions of aws-java-sdk Show documentation
/*
* Copyright 2010-2014 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.elastictranscoder;
import java.net.*;
import java.util.*;
import org.apache.commons.logging.*;
import com.amazonaws.*;
import com.amazonaws.regions.*;
import com.amazonaws.auth.*;
import com.amazonaws.handlers.*;
import com.amazonaws.http.*;
import com.amazonaws.regions.*;
import com.amazonaws.internal.*;
import com.amazonaws.metrics.*;
import com.amazonaws.transform.*;
import com.amazonaws.util.*;
import com.amazonaws.util.AWSRequestMetrics.Field;
import com.amazonaws.util.json.*;
import com.amazonaws.services.elastictranscoder.model.*;
import com.amazonaws.services.elastictranscoder.model.transform.*;
/**
* Client for accessing AmazonElasticTranscoder. All service calls made
* using this client are blocking, and will not return until the service call
* completes.
*
* AWS Elastic Transcoder Service
* The AWS Elastic Transcoder Service.
*
*/
public class AmazonElasticTranscoderClient extends AmazonWebServiceClient implements AmazonElasticTranscoder {
/** Provider for AWS credentials. */
private AWSCredentialsProvider awsCredentialsProvider;
private static final Log log = LogFactory.getLog(AmazonElasticTranscoder.class);
/**
* List of exception unmarshallers for all AmazonElasticTranscoder exceptions.
*/
protected List jsonErrorUnmarshallers;
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder. A credentials provider chain will be used
* that searches for credentials in this order:
*
* - Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
* - Java System Properties - aws.accessKeyId and aws.secretKey
* - Instance profile credentials delivered through the Amazon EC2 metadata service
*
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @see DefaultAWSCredentialsProviderChain
*/
public AmazonElasticTranscoderClient() {
this(new DefaultAWSCredentialsProviderChain(), new ClientConfiguration());
}
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder. A credentials provider chain will be used
* that searches for credentials in this order:
*
* - Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
* - Java System Properties - aws.accessKeyId and aws.secretKey
* - Instance profile credentials delivered through the Amazon EC2 metadata service
*
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @param clientConfiguration The client configuration options controlling how this
* client connects to AmazonElasticTranscoder
* (ex: proxy settings, retry counts, etc.).
*
* @see DefaultAWSCredentialsProviderChain
*/
public AmazonElasticTranscoderClient(ClientConfiguration clientConfiguration) {
this(new DefaultAWSCredentialsProviderChain(), clientConfiguration);
}
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder using the specified AWS account credentials.
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @param awsCredentials The AWS credentials (access key ID and secret key) to use
* when authenticating with AWS services.
*/
public AmazonElasticTranscoderClient(AWSCredentials awsCredentials) {
this(awsCredentials, new ClientConfiguration());
}
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder using the specified AWS account credentials
* and client configuration options.
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @param awsCredentials The AWS credentials (access key ID and secret key) to use
* when authenticating with AWS services.
* @param clientConfiguration The client configuration options controlling how this
* client connects to AmazonElasticTranscoder
* (ex: proxy settings, retry counts, etc.).
*/
public AmazonElasticTranscoderClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration) {
super(adjustClientConfiguration(clientConfiguration));
this.awsCredentialsProvider = new StaticCredentialsProvider(awsCredentials);
init();
}
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder using the specified AWS account credentials provider.
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @param awsCredentialsProvider
* The AWS credentials provider which will provide credentials
* to authenticate requests with AWS services.
*/
public AmazonElasticTranscoderClient(AWSCredentialsProvider awsCredentialsProvider) {
this(awsCredentialsProvider, new ClientConfiguration());
}
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder using the specified AWS account credentials
* provider and client configuration options.
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @param awsCredentialsProvider
* The AWS credentials provider which will provide credentials
* to authenticate requests with AWS services.
* @param clientConfiguration The client configuration options controlling how this
* client connects to AmazonElasticTranscoder
* (ex: proxy settings, retry counts, etc.).
*/
public AmazonElasticTranscoderClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration) {
this(awsCredentialsProvider, clientConfiguration, null);
}
/**
* Constructs a new client to invoke service methods on
* AmazonElasticTranscoder using the specified AWS account credentials
* provider, client configuration options and request metric collector.
*
*
* All service calls made using this new client object are blocking, and will not
* return until the service call completes.
*
* @param awsCredentialsProvider
* The AWS credentials provider which will provide credentials
* to authenticate requests with AWS services.
* @param clientConfiguration The client configuration options controlling how this
* client connects to AmazonElasticTranscoder
* (ex: proxy settings, retry counts, etc.).
* @param requestMetricCollector optional request metric collector
*/
public AmazonElasticTranscoderClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector) {
super(adjustClientConfiguration(clientConfiguration), requestMetricCollector);
this.awsCredentialsProvider = awsCredentialsProvider;
init();
}
private void init() {
jsonErrorUnmarshallers = new ArrayList();
jsonErrorUnmarshallers.add(new ResourceInUseExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new InternalServiceExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new ValidationExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new LimitExceededExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new IncompatibleVersionExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new AccessDeniedExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new ResourceNotFoundExceptionUnmarshaller());
jsonErrorUnmarshallers.add(new JsonErrorUnmarshaller());
// calling this.setEndPoint(...) will also modify the signer accordingly
this.setEndpoint("elastictranscoder.us-east-1.amazonaws.com/");
HandlerChainFactory chainFactory = new HandlerChainFactory();
requestHandler2s.addAll(chainFactory.newRequestHandlerChain(
"/com/amazonaws/services/elastictranscoder/request.handlers"));
requestHandler2s.addAll(chainFactory.newRequestHandler2Chain(
"/com/amazonaws/services/elastictranscoder/request.handler2s"));
}
private static ClientConfiguration adjustClientConfiguration(ClientConfiguration orig) {
ClientConfiguration config = orig;
return config;
}
/**
*
* The UpdatePipelineStatus operation pauses or reactivates a pipeline,
* so that the pipeline stops or restarts the processing of jobs.
*
*
* Changing the pipeline status is useful if you want to cancel one or
* more jobs. You can't cancel jobs after Elastic Transcoder has started
* processing them; if you pause the pipeline to which you submitted the
* jobs, you have more time to get the job IDs for the jobs that you want
* to cancel, and to send a CancelJob request.
*
*
* @param updatePipelineStatusRequest Container for the necessary
* parameters to execute the UpdatePipelineStatus service method on
* AmazonElasticTranscoder.
*
* @return The response from the UpdatePipelineStatus service method, as
* returned by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws ResourceInUseException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public UpdatePipelineStatusResult updatePipelineStatus(UpdatePipelineStatusRequest updatePipelineStatusRequest) {
ExecutionContext executionContext = createExecutionContext(updatePipelineStatusRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new UpdatePipelineStatusRequestMarshaller().marshall(updatePipelineStatusRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new UpdatePipelineStatusResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* With the UpdatePipelineNotifications operation, you can update Amazon
* Simple Notification Service (Amazon SNS) notifications for a pipeline.
*
*
* When you update notifications for a pipeline, Elastic Transcoder
* returns the values that you specified in the request.
*
*
* @param updatePipelineNotificationsRequest Container for the necessary
* parameters to execute the UpdatePipelineNotifications service method
* on AmazonElasticTranscoder.
*
* @return The response from the UpdatePipelineNotifications service
* method, as returned by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws ResourceInUseException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public UpdatePipelineNotificationsResult updatePipelineNotifications(UpdatePipelineNotificationsRequest updatePipelineNotificationsRequest) {
ExecutionContext executionContext = createExecutionContext(updatePipelineNotificationsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new UpdatePipelineNotificationsRequestMarshaller().marshall(updatePipelineNotificationsRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new UpdatePipelineNotificationsResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ReadJob operation returns detailed information about a job.
*
*
* @param readJobRequest Container for the necessary parameters to
* execute the ReadJob service method on AmazonElasticTranscoder.
*
* @return The response from the ReadJob service method, as returned by
* AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ReadJobResult readJob(ReadJobRequest readJobRequest) {
ExecutionContext executionContext = createExecutionContext(readJobRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ReadJobRequestMarshaller().marshall(readJobRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ReadJobResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ListJobsByStatus operation gets a list of jobs that have a
* specified status. The response body contains one element for each job
* that satisfies the search criteria.
*
*
* @param listJobsByStatusRequest Container for the necessary parameters
* to execute the ListJobsByStatus service method on
* AmazonElasticTranscoder.
*
* @return The response from the ListJobsByStatus service method, as
* returned by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ListJobsByStatusResult listJobsByStatus(ListJobsByStatusRequest listJobsByStatusRequest) {
ExecutionContext executionContext = createExecutionContext(listJobsByStatusRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListJobsByStatusRequestMarshaller().marshall(listJobsByStatusRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ListJobsByStatusResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ReadPreset operation gets detailed information about a preset.
*
*
* @param readPresetRequest Container for the necessary parameters to
* execute the ReadPreset service method on AmazonElasticTranscoder.
*
* @return The response from the ReadPreset service method, as returned
* by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ReadPresetResult readPreset(ReadPresetRequest readPresetRequest) {
ExecutionContext executionContext = createExecutionContext(readPresetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ReadPresetRequestMarshaller().marshall(readPresetRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ReadPresetResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The CreatePipeline operation creates a pipeline with settings that you
* specify.
*
*
* @param createPipelineRequest Container for the necessary parameters to
* execute the CreatePipeline service method on AmazonElasticTranscoder.
*
* @return The response from the CreatePipeline service method, as
* returned by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws ResourceNotFoundException
* @throws InternalServiceException
* @throws LimitExceededException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public CreatePipelineResult createPipeline(CreatePipelineRequest createPipelineRequest) {
ExecutionContext executionContext = createExecutionContext(createPipelineRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreatePipelineRequestMarshaller().marshall(createPipelineRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new CreatePipelineResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The CancelJob operation cancels an unfinished job.
*
*
* NOTE:You can only cancel a job that has a status of Submitted.
* To prevent a pipeline from starting to process a job while you're
* getting the job identifier, use UpdatePipelineStatus to temporarily
* pause the pipeline.
*
*
* @param cancelJobRequest Container for the necessary parameters to
* execute the CancelJob service method on AmazonElasticTranscoder.
*
* @return The response from the CancelJob service method, as returned by
* AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws ResourceInUseException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public CancelJobResult cancelJob(CancelJobRequest cancelJobRequest) {
ExecutionContext executionContext = createExecutionContext(cancelJobRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CancelJobRequestMarshaller().marshall(cancelJobRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new CancelJobResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* Use the UpdatePipeline operation to update settings for
* a pipeline.
* IMPORTANT:When you change pipeline settings, your changes take
* effect immediately. Jobs that you have already submitted and that
* Elastic Transcoder has not started to process are affected in addition
* to jobs that you submit after you change settings.
*
*
*
*
* @param updatePipelineRequest Container for the necessary parameters to
* execute the UpdatePipeline service method on AmazonElasticTranscoder.
*
* @return The response from the UpdatePipeline service method, as
* returned by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws ResourceNotFoundException
* @throws ResourceInUseException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public UpdatePipelineResult updatePipeline(UpdatePipelineRequest updatePipelineRequest) {
ExecutionContext executionContext = createExecutionContext(updatePipelineRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new UpdatePipelineRequestMarshaller().marshall(updatePipelineRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new UpdatePipelineResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ListPresets operation gets a list of the default presets included
* with Elastic Transcoder and the presets that you've added in an AWS
* region.
*
*
* @param listPresetsRequest Container for the necessary parameters to
* execute the ListPresets service method on AmazonElasticTranscoder.
*
* @return The response from the ListPresets service method, as returned
* by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ListPresetsResult listPresets(ListPresetsRequest listPresetsRequest) {
ExecutionContext executionContext = createExecutionContext(listPresetsRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListPresetsRequestMarshaller().marshall(listPresetsRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ListPresetsResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The DeletePipeline operation removes a pipeline.
*
*
* You can only delete a pipeline that has never been used or that is
* not currently in use (doesn't contain any active jobs). If the
* pipeline is currently in use, DeletePipeline returns an
* error.
*
*
* @param deletePipelineRequest Container for the necessary parameters to
* execute the DeletePipeline service method on AmazonElasticTranscoder.
*
* @return The response from the DeletePipeline service method, as
* returned by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws ResourceInUseException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public DeletePipelineResult deletePipeline(DeletePipelineRequest deletePipelineRequest) {
ExecutionContext executionContext = createExecutionContext(deletePipelineRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeletePipelineRequestMarshaller().marshall(deletePipelineRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new DeletePipelineResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The TestRole operation tests the IAM role used to create the pipeline.
*
*
* The TestRole action lets you determine whether the IAM
* role you are using has sufficient permissions to let Elastic
* Transcoder perform tasks associated with the transcoding process. The
* action attempts to assume the specified IAM role, checks read access
* to the input and output buckets, and tries to send a test notification
* to Amazon SNS topics that you specify.
*
*
* @param testRoleRequest Container for the necessary parameters to
* execute the TestRole service method on AmazonElasticTranscoder.
*
* @return The response from the TestRole service method, as returned by
* AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public TestRoleResult testRole(TestRoleRequest testRoleRequest) {
ExecutionContext executionContext = createExecutionContext(testRoleRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new TestRoleRequestMarshaller().marshall(testRoleRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new TestRoleResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ListPipelines operation gets a list of the pipelines associated
* with the current AWS account.
*
*
* @param listPipelinesRequest Container for the necessary parameters to
* execute the ListPipelines service method on AmazonElasticTranscoder.
*
* @return The response from the ListPipelines service method, as
* returned by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ListPipelinesResult listPipelines(ListPipelinesRequest listPipelinesRequest) {
ExecutionContext executionContext = createExecutionContext(listPipelinesRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListPipelinesRequestMarshaller().marshall(listPipelinesRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ListPipelinesResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ReadPipeline operation gets detailed information about a pipeline.
*
*
* @param readPipelineRequest Container for the necessary parameters to
* execute the ReadPipeline service method on AmazonElasticTranscoder.
*
* @return The response from the ReadPipeline service method, as returned
* by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ReadPipelineResult readPipeline(ReadPipelineRequest readPipelineRequest) {
ExecutionContext executionContext = createExecutionContext(readPipelineRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ReadPipelineRequestMarshaller().marshall(readPipelineRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ReadPipelineResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The CreatePreset operation creates a preset with settings that you
* specify.
*
*
* IMPORTANT:Elastic Transcoder checks the CreatePreset settings
* to ensure that they meet Elastic Transcoder requirements and to
* determine whether they comply with H.264 standards. If your settings
* are not valid for Elastic Transcoder, Elastic Transcoder returns an
* HTTP 400 response (ValidationException) and does not create the
* preset. If the settings are valid for Elastic Transcoder but aren't
* strictly compliant with the H.264 standard, Elastic Transcoder creates
* the preset and returns a warning message in the response. This helps
* you determine whether your settings comply with the H.264 standard
* while giving you greater flexibility with respect to the video that
* Elastic Transcoder produces.
*
*
* Elastic Transcoder uses the H.264 video-compression format. For more
* information, see the International Telecommunication Union publication
* Recommendation ITU-T H.264: Advanced video coding for generic
* audiovisual services .
*
*
* @param createPresetRequest Container for the necessary parameters to
* execute the CreatePreset service method on AmazonElasticTranscoder.
*
* @return The response from the CreatePreset service method, as returned
* by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws LimitExceededException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public CreatePresetResult createPreset(CreatePresetRequest createPresetRequest) {
ExecutionContext executionContext = createExecutionContext(createPresetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreatePresetRequestMarshaller().marshall(createPresetRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new CreatePresetResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The DeletePreset operation removes a preset that you've added in an
* AWS region.
*
*
* NOTE: You can't delete the default presets that are included
* with Elastic Transcoder.
*
*
* @param deletePresetRequest Container for the necessary parameters to
* execute the DeletePreset service method on AmazonElasticTranscoder.
*
* @return The response from the DeletePreset service method, as returned
* by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public DeletePresetResult deletePreset(DeletePresetRequest deletePresetRequest) {
ExecutionContext executionContext = createExecutionContext(deletePresetRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new DeletePresetRequestMarshaller().marshall(deletePresetRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new DeletePresetResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* When you create a job, Elastic Transcoder returns JSON data that
* includes the values that you specified plus information about the job
* that is created.
*
*
* If you have specified more than one output for your jobs (for example,
* one output for the Kindle Fire and another output for the Apple iPhone
* 4s), you currently must use the Elastic Transcoder API to list the
* jobs (as opposed to the AWS Console).
*
*
* @param createJobRequest Container for the necessary parameters to
* execute the CreateJob service method on AmazonElasticTranscoder.
*
* @return The response from the CreateJob service method, as returned by
* AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws LimitExceededException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public CreateJobResult createJob(CreateJobRequest createJobRequest) {
ExecutionContext executionContext = createExecutionContext(createJobRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new CreateJobRequestMarshaller().marshall(createJobRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new CreateJobResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ListJobsByPipeline operation gets a list of the jobs currently in
* a pipeline.
*
*
* Elastic Transcoder returns all of the jobs currently in the specified
* pipeline. The response body contains one element for each job that
* satisfies the search criteria.
*
*
* @param listJobsByPipelineRequest Container for the necessary
* parameters to execute the ListJobsByPipeline service method on
* AmazonElasticTranscoder.
*
* @return The response from the ListJobsByPipeline service method, as
* returned by AmazonElasticTranscoder.
*
* @throws ResourceNotFoundException
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ListJobsByPipelineResult listJobsByPipeline(ListJobsByPipelineRequest listJobsByPipelineRequest) {
ExecutionContext executionContext = createExecutionContext(listJobsByPipelineRequest);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
awsRequestMetrics.startEvent(Field.ClientExecuteTime);
Request request = null;
Response response = null;
try {
awsRequestMetrics.startEvent(Field.RequestMarshallTime);
try {
request = new ListJobsByPipelineRequestMarshaller().marshall(listJobsByPipelineRequest);
// Binds the request metrics to the current request.
request.setAWSRequestMetrics(awsRequestMetrics);
} finally {
awsRequestMetrics.endEvent(Field.RequestMarshallTime);
}
Unmarshaller unmarshaller = new ListJobsByPipelineResultJsonUnmarshaller();
JsonResponseHandler responseHandler = new JsonResponseHandler(unmarshaller);
response = invoke(request, responseHandler, executionContext);
return response.getAwsResponse();
} finally {
endClientExecution(awsRequestMetrics, request, response, LOGGING_AWS_REQUEST_METRIC);
}
}
/**
*
* The ListPresets operation gets a list of the default presets included
* with Elastic Transcoder and the presets that you've added in an AWS
* region.
*
*
* @return The response from the ListPresets service method, as returned
* by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ListPresetsResult listPresets() throws AmazonServiceException, AmazonClientException {
return listPresets(new ListPresetsRequest());
}
/**
*
* The ListPipelines operation gets a list of the pipelines associated
* with the current AWS account.
*
*
* @return The response from the ListPipelines service method, as
* returned by AmazonElasticTranscoder.
*
* @throws AccessDeniedException
* @throws InternalServiceException
* @throws ValidationException
* @throws IncompatibleVersionException
*
* @throws AmazonClientException
* If any internal errors are encountered inside the client while
* attempting to make the request or handle the response. For example
* if a network connection is not available.
* @throws AmazonServiceException
* If an error response is returned by AmazonElasticTranscoder indicating
* either a problem with the data in the request, or a server side issue.
*/
public ListPipelinesResult listPipelines() throws AmazonServiceException, AmazonClientException {
return listPipelines(new ListPipelinesRequest());
}
@Override
public void setEndpoint(String endpoint) {
super.setEndpoint(endpoint);
}
@Override
public void setEndpoint(String endpoint, String serviceName, String regionId) throws IllegalArgumentException {
super.setEndpoint(endpoint, serviceName, regionId);
}
/**
* Returns additional metadata for a previously executed successful, request, typically used for
* debugging issues where a service isn't acting as expected. This data isn't considered part
* of the result data returned by an operation, so it's available through this separate,
* diagnostic interface.
*
* Response metadata is only cached for a limited period of time, so if you need to access
* this extra diagnostic information for an executed request, you should use this method
* to retrieve it as soon as possible after executing the request.
*
* @param request
* The originally executed request
*
* @return The response metadata for the specified request, or null if none
* is available.
*/
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request) {
return client.getResponseMetadataForRequest(request);
}
private Response invoke(Request request,
HttpResponseHandler> responseHandler,
ExecutionContext executionContext) {
request.setEndpoint(endpoint);
request.setTimeOffset(timeOffset);
AWSRequestMetrics awsRequestMetrics = executionContext.getAwsRequestMetrics();
AWSCredentials credentials;
awsRequestMetrics.startEvent(Field.CredentialsRequestTime);
try {
credentials = awsCredentialsProvider.getCredentials();
} finally {
awsRequestMetrics.endEvent(Field.CredentialsRequestTime);
}
AmazonWebServiceRequest originalRequest = request.getOriginalRequest();
if (originalRequest != null && originalRequest.getRequestCredentials() != null) {
credentials = originalRequest.getRequestCredentials();
}
executionContext.setCredentials(credentials);
JsonErrorResponseHandler errorResponseHandler = new JsonErrorResponseHandler(jsonErrorUnmarshallers);
Response result = client.execute(request, responseHandler,
errorResponseHandler, executionContext);
return result;
}
}