com.amazonaws.services.iotdeviceadvisor

Class AWSIoTDeviceAdvisorClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.iotdeviceadvisor.AWSIoTDeviceAdvisorClient

All Implemented Interfaces:

AWSIoTDeviceAdvisor

Direct Known Subclasses:

AWSIoTDeviceAdvisorAsyncClient

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

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

AWS IoT Core Device Advisor is a cloud-based, fully managed test capability for validating IoT devices during device software development. Device Advisor provides pre-built tests that you can use to validate IoT devices for reliable and secure connectivity with AWS IoT Core before deploying devices to production. By using Device Advisor, you can confirm that your devices can connect to AWS IoT Core, follow security best practices and, if applicable, receive software updates from IoT Device Management. You can also download signed qualification reports to submit to the AWS Partner Network to get your device qualified for the AWS Partner Device Catalog without the need to send your device in and wait for it to be tested.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.iotdeviceadvisor.AWSIoTDeviceAdvisor

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AWSIoTDeviceAdvisorClientBuilder	builder()
CreateSuiteDefinitionResult	createSuiteDefinition(CreateSuiteDefinitionRequest request) Creates a Device Advisor test suite.
DeleteSuiteDefinitionResult	deleteSuiteDefinition(DeleteSuiteDefinitionRequest request) Deletes a Device Advisor test suite.
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.
GetSuiteDefinitionResult	getSuiteDefinition(GetSuiteDefinitionRequest request) Gets information about a Device Advisor test suite.
GetSuiteRunResult	getSuiteRun(GetSuiteRunRequest request) Gets information about a Device Advisor test suite run.
GetSuiteRunReportResult	getSuiteRunReport(GetSuiteRunReportRequest request) Gets a report download link for a successful Device Advisor qualifying test suite run.
ListSuiteDefinitionsResult	listSuiteDefinitions(ListSuiteDefinitionsRequest request) Lists the Device Advisor test suites you have created.
ListSuiteRunsResult	listSuiteRuns(ListSuiteRunsRequest request) Lists the runs of the specified Device Advisor test suite.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest request) Lists the tags attached to an IoT Device Advisor resource.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
StartSuiteRunResult	startSuiteRun(StartSuiteRunRequest request) Starts a Device Advisor test suite run.
StopSuiteRunResult	stopSuiteRun(StopSuiteRunRequest request) Stops a Device Advisor test suite run that is currently running.
TagResourceResult	tagResource(TagResourceRequest request) Adds to and modifies existing tags of an IoT Device Advisor resource.
UntagResourceResult	untagResource(UntagResourceRequest request) Removes tags from an IoT Device Advisor resource.
UpdateSuiteDefinitionResult	updateSuiteDefinition(UpdateSuiteDefinitionRequest request) Updates a Device Advisor test suite.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static AWSIoTDeviceAdvisorClientBuilder builder()

createSuiteDefinition

public CreateSuiteDefinitionResult createSuiteDefinition(CreateSuiteDefinitionRequest request)

Creates a Device Advisor test suite.

Specified by:

createSuiteDefinition in interface AWSIoTDeviceAdvisor

Parameters:

createSuiteDefinitionRequest -

Returns:

Result of the CreateSuiteDefinition operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

See Also:

AWS API Documentation

deleteSuiteDefinition

public DeleteSuiteDefinitionResult deleteSuiteDefinition(DeleteSuiteDefinitionRequest request)

Deletes a Device Advisor test suite.

Specified by:

deleteSuiteDefinition in interface AWSIoTDeviceAdvisor

Parameters:

deleteSuiteDefinitionRequest -

Returns:

Result of the DeleteSuiteDefinition operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

See Also:

AWS API Documentation

getSuiteDefinition

public GetSuiteDefinitionResult getSuiteDefinition(GetSuiteDefinitionRequest request)

Gets information about a Device Advisor test suite.

Specified by:

getSuiteDefinition in interface AWSIoTDeviceAdvisor

Parameters:

getSuiteDefinitionRequest -

Returns:

Result of the GetSuiteDefinition operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

See Also:

AWS API Documentation

getSuiteRun

public GetSuiteRunResult getSuiteRun(GetSuiteRunRequest request)

Gets information about a Device Advisor test suite run.

Specified by:

getSuiteRun in interface AWSIoTDeviceAdvisor

Parameters:

getSuiteRunRequest -

Returns:

Result of the GetSuiteRun operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

See Also:

AWS API Documentation

getSuiteRunReport

public GetSuiteRunReportResult getSuiteRunReport(GetSuiteRunReportRequest request)

Gets a report download link for a successful Device Advisor qualifying test suite run.

Specified by:

getSuiteRunReport in interface AWSIoTDeviceAdvisor

Parameters:

getSuiteRunReportRequest -

Returns:

Result of the GetSuiteRunReport operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

See Also:

AWS API Documentation

listSuiteDefinitions

public ListSuiteDefinitionsResult listSuiteDefinitions(ListSuiteDefinitionsRequest request)

Lists the Device Advisor test suites you have created.

Specified by:

listSuiteDefinitions in interface AWSIoTDeviceAdvisor

Parameters:

listSuiteDefinitionsRequest -

Returns:

Result of the ListSuiteDefinitions operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

See Also:

AWS API Documentation

listSuiteRuns

public ListSuiteRunsResult listSuiteRuns(ListSuiteRunsRequest request)

Lists the runs of the specified Device Advisor test suite. You can list all runs of the test suite, or the runs of a specific version of the test suite.

Specified by:

listSuiteRuns in interface AWSIoTDeviceAdvisor

Parameters:

listSuiteRunsRequest -

Returns:

Result of the ListSuiteRuns operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

See Also:

AWS API Documentation

listTagsForResource

public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)

Lists the tags attached to an IoT Device Advisor resource.

Specified by:

listTagsForResource in interface AWSIoTDeviceAdvisor

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

Throws:

InternalServerException - Sends Internal Failure Exception.

ValidationException - Sends invalid request exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

See Also:

AWS API Documentation

startSuiteRun

public StartSuiteRunResult startSuiteRun(StartSuiteRunRequest request)

Starts a Device Advisor test suite run.

Specified by:

startSuiteRun in interface AWSIoTDeviceAdvisor

Parameters:

startSuiteRunRequest -

Returns:

Result of the StartSuiteRun operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

ConflictException - Sends Conflict Exception.

See Also:

AWS API Documentation

stopSuiteRun

public StopSuiteRunResult stopSuiteRun(StopSuiteRunRequest request)

Stops a Device Advisor test suite run that is currently running.

Specified by:

stopSuiteRun in interface AWSIoTDeviceAdvisor

Parameters:

stopSuiteRunRequest -

Returns:

Result of the StopSuiteRun operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

InternalServerException - Sends Internal Failure Exception.

See Also:

AWS API Documentation

tagResource

public TagResourceResult tagResource(TagResourceRequest request)

Adds to and modifies existing tags of an IoT Device Advisor resource.

Specified by:

tagResource in interface AWSIoTDeviceAdvisor

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

Throws:

InternalServerException - Sends Internal Failure Exception.

ValidationException - Sends invalid request exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

See Also:

AWS API Documentation

untagResource

public UntagResourceResult untagResource(UntagResourceRequest request)

Removes tags from an IoT Device Advisor resource.

Specified by:

untagResource in interface AWSIoTDeviceAdvisor

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

Throws:

InternalServerException - Sends Internal Failure Exception.

ValidationException - Sends invalid request exception.

ResourceNotFoundException - Sends Resource Not Found Exception.

See Also:

AWS API Documentation

updateSuiteDefinition

public UpdateSuiteDefinitionResult updateSuiteDefinition(UpdateSuiteDefinitionRequest request)

Updates a Device Advisor test suite.

Specified by:

updateSuiteDefinition in interface AWSIoTDeviceAdvisor

Parameters:

updateSuiteDefinitionRequest -

Returns:

Result of the UpdateSuiteDefinition operation returned by the service.

Throws:

ValidationException - Sends invalid request exception.

InternalServerException - Sends Internal Failure Exception.

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 AWSIoTDeviceAdvisor

Parameters:

request - The originally executed request

Returns:

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

shutdown

public void shutdown()

Description copied from class: AmazonWebServiceClient

Shuts down this client object, releasing any resources that might be held open. If this method is not invoked, resources may be leaked. Once a client has been shutdown, it should not be used to make any more requests.

Specified by:

shutdown in interface AWSIoTDeviceAdvisor

Overrides:

shutdown in class AmazonWebServiceClient