com.amazonaws.services.dataexchange

Class AWSDataExchangeClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.dataexchange.AWSDataExchangeClient

All Implemented Interfaces:

AWSDataExchange

Direct Known Subclasses:

AWSDataExchangeAsyncClient

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AWSDataExchangeClient
extends AmazonWebServiceClient
implements AWSDataExchange

Client for accessing AWS Data Exchange. All service calls made using this client are blocking, and will not return until the service call completes.

AWS Data Exchange is a service that makes it easy for AWS customers to exchange data in the cloud. You can use the AWS Data Exchange APIs to create, update, manage, and access file-based data set in the AWS Cloud.

As a subscriber, you can view and access the data sets that you have an entitlement to through a subscription. You can use the APIS to download or copy your entitled data sets to Amazon S3 for use across a variety of AWS analytics and machine learning services.

As a provider, you can create and manage your data sets that you would like to publish to a product. Being able to package and provide your data sets into products requires a few steps to determine eligibility. For more information, visit the AWS Data Exchange User Guide.

A data set is a collection of data that can be changed or updated over time. Data sets can be updated using revisions, which represent a new version or incremental change to a data set. A revision contains one or more assets. An asset in AWS Data Exchange is a piece of data that can be stored as an Amazon S3 object. The asset can be a structured data file, an image file, or some other data file. Jobs are asynchronous import or export operations used to create or copy assets.

Field Summary

Fields

Modifier and Type	Field and Description
protected static ClientConfigurationFactory	configFactory Client configuration factory providing ClientConfigurations tailored to this client

Fields inherited from class com.amazonaws.AmazonWebServiceClient

client, clientConfiguration, endpoint, isEndpointOverridden, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffset

Fields inherited from interface com.amazonaws.services.dataexchange.AWSDataExchange

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AWSDataExchangeClientBuilder	builder()
CancelJobResult	cancelJob(CancelJobRequest request) This operation cancels a job.
CreateDataSetResult	createDataSet(CreateDataSetRequest request) This operation creates a data set.
CreateJobResult	createJob(CreateJobRequest request) This operation creates a job.
CreateRevisionResult	createRevision(CreateRevisionRequest request) This operation creates a revision for a data set.
DeleteAssetResult	deleteAsset(DeleteAssetRequest request) This operation deletes an asset.
DeleteDataSetResult	deleteDataSet(DeleteDataSetRequest request) This operation deletes a data set.
DeleteRevisionResult	deleteRevision(DeleteRevisionRequest request) This operation deletes a revision.
GetAssetResult	getAsset(GetAssetRequest request) This operation returns information about an asset.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
GetDataSetResult	getDataSet(GetDataSetRequest request) This operation returns information about a data set.
GetJobResult	getJob(GetJobRequest request) This operation returns information about a job.
GetRevisionResult	getRevision(GetRevisionRequest request) This operation returns information about a revision.
ListDataSetRevisionsResult	listDataSetRevisions(ListDataSetRevisionsRequest request) This operation lists a data set's revisions sorted by CreatedAt in descending order.
ListDataSetsResult	listDataSets(ListDataSetsRequest request) This operation lists your data sets.
ListJobsResult	listJobs(ListJobsRequest request) This operation lists your jobs sorted by CreatedAt in descending order.
ListRevisionAssetsResult	listRevisionAssets(ListRevisionAssetsRequest request) This operation lists a revision's assets sorted alphabetically in descending order.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest request) This operation lists the tags on the resource.
StartJobResult	startJob(StartJobRequest request) This operation starts a job.
TagResourceResult	tagResource(TagResourceRequest request) This operation tags a resource.
UntagResourceResult	untagResource(UntagResourceRequest request) This operation removes one or more tags from a resource.
UpdateAssetResult	updateAsset(UpdateAssetRequest request) This operation updates an asset.
UpdateDataSetResult	updateDataSet(UpdateDataSetRequest request) This operation updates a data set.
UpdateRevisionResult	updateRevision(UpdateRevisionRequest request) This operation updates a revision.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, beforeClientExecution, beforeMarshalling, calculateCRC32FromCompressedData, checkMutability, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, createSignerProvider, endClientExecution, endClientExecution, getClientConfiguration, getClientId, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerOverride, getSignerProvider, getSignerRegionOverride, getSigningRegion, getTimeOffset, isCsmEnabled, isEndpointOverridden, isProfilingEnabled, isRequestMetricsEnabled, makeImmutable, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shouldGenerateClientSideMonitoringEvents, shutdown, useStrictHostNameVerification, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.dataexchange.AWSDataExchange

shutdown

Field Detail

configFactory

protected static final ClientConfigurationFactory configFactory

Client configuration factory providing ClientConfigurations tailored to this client

Method Detail

builder

public static AWSDataExchangeClientBuilder builder()

cancelJob

public CancelJobResult cancelJob(CancelJobRequest request)

This operation cancels a job. Jobs can be cancelled only when they are in the WAITING state.

Specified by:

cancelJob in interface AWSDataExchange

Parameters:

cancelJobRequest -

Returns:

Result of the CancelJob operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

ConflictException - 409 response

See Also:

AWS API Documentation

createDataSet

public CreateDataSetResult createDataSet(CreateDataSetRequest request)

This operation creates a data set.

Specified by:

createDataSet in interface AWSDataExchange

Parameters:

createDataSetRequest - The request body for CreateDataSet.

Returns:

Result of the CreateDataSet operation returned by the service.

Throws:

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

ServiceLimitExceededException - 402 response

AccessDeniedException - 403 response

See Also:

AWS API Documentation

createJob

public CreateJobResult createJob(CreateJobRequest request)

This operation creates a job.

Specified by:

createJob in interface AWSDataExchange

Parameters:

createJobRequest - The request body for CreateJob.

Returns:

Result of the CreateJob operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

See Also:

AWS API Documentation

createRevision

public CreateRevisionResult createRevision(CreateRevisionRequest request)

This operation creates a revision for a data set.

Specified by:

createRevision in interface AWSDataExchange

Parameters:

createRevisionRequest - The request body for CreateRevision.

Returns:

Result of the CreateRevision operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

See Also:

AWS API Documentation

deleteAsset

public DeleteAssetResult deleteAsset(DeleteAssetRequest request)

This operation deletes an asset.

Specified by:

deleteAsset in interface AWSDataExchange

Parameters:

deleteAssetRequest -

Returns:

Result of the DeleteAsset operation returned by the service.

Throws:

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ConflictException - 409 response

See Also:

AWS API Documentation

deleteDataSet

public DeleteDataSetResult deleteDataSet(DeleteDataSetRequest request)

This operation deletes a data set.

Specified by:

deleteDataSet in interface AWSDataExchange

Parameters:

deleteDataSetRequest -

Returns:

Result of the DeleteDataSet operation returned by the service.

Throws:

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ConflictException - 409 response

See Also:

AWS API Documentation

deleteRevision

public DeleteRevisionResult deleteRevision(DeleteRevisionRequest request)

This operation deletes a revision.

Specified by:

deleteRevision in interface AWSDataExchange

Parameters:

deleteRevisionRequest -

Returns:

Result of the DeleteRevision operation returned by the service.

Throws:

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ConflictException - 409 response

See Also:

AWS API Documentation

getAsset

public GetAssetResult getAsset(GetAssetRequest request)

This operation returns information about an asset.

Specified by:

getAsset in interface AWSDataExchange

Parameters:

getAssetRequest -

Returns:

Result of the GetAsset operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

getDataSet

public GetDataSetResult getDataSet(GetDataSetRequest request)

This operation returns information about a data set.

Specified by:

getDataSet in interface AWSDataExchange

Parameters:

getDataSetRequest -

Returns:

Result of the GetDataSet operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

getJob

public GetJobResult getJob(GetJobRequest request)

This operation returns information about a job.

Specified by:

getJob in interface AWSDataExchange

Parameters:

getJobRequest -

Returns:

Result of the GetJob operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

getRevision

public GetRevisionResult getRevision(GetRevisionRequest request)

This operation returns information about a revision.

Specified by:

getRevision in interface AWSDataExchange

Parameters:

getRevisionRequest -

Returns:

Result of the GetRevision operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

listDataSetRevisions

public ListDataSetRevisionsResult listDataSetRevisions(ListDataSetRevisionsRequest request)

This operation lists a data set's revisions sorted by CreatedAt in descending order.

Specified by:

listDataSetRevisions in interface AWSDataExchange

Parameters:

listDataSetRevisionsRequest -

Returns:

Result of the ListDataSetRevisions operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

listDataSets

public ListDataSetsResult listDataSets(ListDataSetsRequest request)

This operation lists your data sets. When listing by origin OWNED, results are sorted by CreatedAt in descending order. When listing by origin ENTITLED, there is no order and the maxResults parameter is ignored.

Specified by:

listDataSets in interface AWSDataExchange

Parameters:

listDataSetsRequest -

Returns:

Result of the ListDataSets operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

listJobs

public ListJobsResult listJobs(ListJobsRequest request)

This operation lists your jobs sorted by CreatedAt in descending order.

Specified by:

listJobs in interface AWSDataExchange

Parameters:

listJobsRequest -

Returns:

Result of the ListJobs operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

listRevisionAssets

public ListRevisionAssetsResult listRevisionAssets(ListRevisionAssetsRequest request)

This operation lists a revision's assets sorted alphabetically in descending order.

Specified by:

listRevisionAssets in interface AWSDataExchange

Parameters:

listRevisionAssetsRequest -

Returns:

Result of the ListRevisionAssets operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

See Also:

AWS API Documentation

listTagsForResource

public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)

This operation lists the tags on the resource.

Specified by:

listTagsForResource in interface AWSDataExchange

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

See Also:

AWS API Documentation

startJob

public StartJobResult startJob(StartJobRequest request)

This operation starts a job.

Specified by:

startJob in interface AWSDataExchange

Parameters:

startJobRequest -

Returns:

Result of the StartJob operation returned by the service.

Throws:

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ConflictException - 409 response

See Also:

AWS API Documentation

tagResource

public TagResourceResult tagResource(TagResourceRequest request)

This operation tags a resource.

Specified by:

tagResource in interface AWSDataExchange

Parameters:

tagResourceRequest - The request body for TagResource.

Returns:

Result of the TagResource operation returned by the service.

See Also:

AWS API Documentation

untagResource

public UntagResourceResult untagResource(UntagResourceRequest request)

This operation removes one or more tags from a resource.

Specified by:

untagResource in interface AWSDataExchange

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

See Also:

AWS API Documentation

updateAsset

public UpdateAssetResult updateAsset(UpdateAssetRequest request)

This operation updates an asset.

Specified by:

updateAsset in interface AWSDataExchange

Parameters:

updateAssetRequest - The request body for UpdateAsset.

Returns:

Result of the UpdateAsset operation returned by the service.

Throws:

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ConflictException - 409 response

See Also:

AWS API Documentation

updateDataSet

public UpdateDataSetResult updateDataSet(UpdateDataSetRequest request)

This operation updates a data set.

Specified by:

updateDataSet in interface AWSDataExchange

Parameters:

updateDataSetRequest - The request body for UpdateDataSet.

Returns:

Result of the UpdateDataSet operation returned by the service.

Throws:

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

See Also:

AWS API Documentation

updateRevision

public UpdateRevisionResult updateRevision(UpdateRevisionRequest request)

This operation updates a revision.

Specified by:

updateRevision in interface AWSDataExchange

Parameters:

updateRevisionRequest - The request body for UpdateRevision.

Returns:

Result of the UpdateRevision operation returned by the service.

Throws:

ValidationException - 400 response

InternalServerException - 500 response

AccessDeniedException - 403 response

ResourceNotFoundException - 404 response

ThrottlingException - 429 response

ConflictException - 409 response

See Also:

AWS API Documentation

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

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.

Specified by:

getCachedResponseMetadata in interface AWSDataExchange

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.