com.amazonaws.services.iotdeviceadvisor

Interface AWSIoTDeviceAdvisor

All Known Subinterfaces:

AWSIoTDeviceAdvisorAsync

All Known Implementing Classes:

AbstractAWSIoTDeviceAdvisor, AbstractAWSIoTDeviceAdvisorAsync, AWSIoTDeviceAdvisorAsyncClient, AWSIoTDeviceAdvisorClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AWSIoTDeviceAdvisor

Interface for accessing AWSIoTDeviceAdvisor.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAWSIoTDeviceAdvisor instead.

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

Modifier and Type	Field and Description
static String	ENDPOINT_PREFIX The region metadata service name for computing region endpoints.

Method Summary

Modifier and Type	Method and Description
CreateSuiteDefinitionResult	createSuiteDefinition(CreateSuiteDefinitionRequest createSuiteDefinitionRequest) Creates a Device Advisor test suite.
DeleteSuiteDefinitionResult	deleteSuiteDefinition(DeleteSuiteDefinitionRequest deleteSuiteDefinitionRequest) 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 getSuiteDefinitionRequest) Gets information about a Device Advisor test suite.
GetSuiteRunResult	getSuiteRun(GetSuiteRunRequest getSuiteRunRequest) Gets information about a Device Advisor test suite run.
GetSuiteRunReportResult	getSuiteRunReport(GetSuiteRunReportRequest getSuiteRunReportRequest) Gets a report download link for a successful Device Advisor qualifying test suite run.
ListSuiteDefinitionsResult	listSuiteDefinitions(ListSuiteDefinitionsRequest listSuiteDefinitionsRequest) Lists the Device Advisor test suites you have created.
ListSuiteRunsResult	listSuiteRuns(ListSuiteRunsRequest listSuiteRunsRequest) Lists the runs of the specified Device Advisor test suite.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) 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 startSuiteRunRequest) Starts a Device Advisor test suite run.
StopSuiteRunResult	stopSuiteRun(StopSuiteRunRequest stopSuiteRunRequest) Stops a Device Advisor test suite run that is currently running.
TagResourceResult	tagResource(TagResourceRequest tagResourceRequest) Adds to and modifies existing tags of an IoT Device Advisor resource.
UntagResourceResult	untagResource(UntagResourceRequest untagResourceRequest) Removes tags from an IoT Device Advisor resource.
UpdateSuiteDefinitionResult	updateSuiteDefinition(UpdateSuiteDefinitionRequest updateSuiteDefinitionRequest) Updates a Device Advisor test suite.

Field Detail

ENDPOINT_PREFIX

static final String ENDPOINT_PREFIX

The region metadata service name for computing region endpoints. You can use this value to retrieve metadata (such as supported regions) of the service.

See Also:

RegionUtils.getRegionsForService(String), Constant Field Values

Method Detail

createSuiteDefinition

CreateSuiteDefinitionResult createSuiteDefinition(CreateSuiteDefinitionRequest createSuiteDefinitionRequest)

Creates a Device Advisor test suite.

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

DeleteSuiteDefinitionResult deleteSuiteDefinition(DeleteSuiteDefinitionRequest deleteSuiteDefinitionRequest)

Deletes a Device Advisor test suite.

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

GetSuiteDefinitionResult getSuiteDefinition(GetSuiteDefinitionRequest getSuiteDefinitionRequest)

Gets information about a Device Advisor test suite.

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

GetSuiteRunResult getSuiteRun(GetSuiteRunRequest getSuiteRunRequest)

Gets information about a Device Advisor test suite run.

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

GetSuiteRunReportResult getSuiteRunReport(GetSuiteRunReportRequest getSuiteRunReportRequest)

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

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

ListSuiteDefinitionsResult listSuiteDefinitions(ListSuiteDefinitionsRequest listSuiteDefinitionsRequest)

Lists the Device Advisor test suites you have created.

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

ListSuiteRunsResult listSuiteRuns(ListSuiteRunsRequest listSuiteRunsRequest)

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.

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

ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

Lists the tags attached to an IoT Device Advisor resource.

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

StartSuiteRunResult startSuiteRun(StartSuiteRunRequest startSuiteRunRequest)

Starts a Device Advisor test suite run.

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

StopSuiteRunResult stopSuiteRun(StopSuiteRunRequest stopSuiteRunRequest)

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

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

TagResourceResult tagResource(TagResourceRequest tagResourceRequest)

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

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

UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)

Removes tags from an IoT Device Advisor resource.

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

UpdateSuiteDefinitionResult updateSuiteDefinition(UpdateSuiteDefinitionRequest updateSuiteDefinitionRequest)

Updates a Device Advisor test suite.

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

shutdown

void shutdown()

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

getCachedResponseMetadata

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 a request.

Parameters:

request - The originally executed request.

Returns:

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