@Generated(value="software.amazon.awssdk:codegen") @ThreadSafe public interface IotDeviceAdvisorClient extends AwsClient
builder() method.
Amazon Web Services 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 Amazon Web Services IoT Core before deploying devices to production. By using Device Advisor, you can confirm that your devices can connect to Amazon Web Services 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 Amazon Web Services Partner Network to get your device qualified for the Amazon Web Services Partner Device Catalog without the need to send your device in and wait for it to be tested.
| Modifier and Type | Field and Description |
|---|---|
static String |
SERVICE_METADATA_ID
Value for looking up the service's metadata from the
ServiceMetadataProvider. |
static String |
SERVICE_NAME |
| Modifier and Type | Method and Description |
|---|---|
static IotDeviceAdvisorClientBuilder |
builder()
Create a builder that can be used to configure and create a
IotDeviceAdvisorClient. |
static IotDeviceAdvisorClient |
create()
Create a
IotDeviceAdvisorClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider. |
default CreateSuiteDefinitionResponse |
createSuiteDefinition(Consumer<CreateSuiteDefinitionRequest.Builder> createSuiteDefinitionRequest)
Creates a Device Advisor test suite.
|
default CreateSuiteDefinitionResponse |
createSuiteDefinition(CreateSuiteDefinitionRequest createSuiteDefinitionRequest)
Creates a Device Advisor test suite.
|
default DeleteSuiteDefinitionResponse |
deleteSuiteDefinition(Consumer<DeleteSuiteDefinitionRequest.Builder> deleteSuiteDefinitionRequest)
Deletes a Device Advisor test suite.
|
default DeleteSuiteDefinitionResponse |
deleteSuiteDefinition(DeleteSuiteDefinitionRequest deleteSuiteDefinitionRequest)
Deletes a Device Advisor test suite.
|
default GetEndpointResponse |
getEndpoint(Consumer<GetEndpointRequest.Builder> getEndpointRequest)
Gets information about an Device Advisor endpoint.
|
default GetEndpointResponse |
getEndpoint(GetEndpointRequest getEndpointRequest)
Gets information about an Device Advisor endpoint.
|
default GetSuiteDefinitionResponse |
getSuiteDefinition(Consumer<GetSuiteDefinitionRequest.Builder> getSuiteDefinitionRequest)
Gets information about a Device Advisor test suite.
|
default GetSuiteDefinitionResponse |
getSuiteDefinition(GetSuiteDefinitionRequest getSuiteDefinitionRequest)
Gets information about a Device Advisor test suite.
|
default GetSuiteRunResponse |
getSuiteRun(Consumer<GetSuiteRunRequest.Builder> getSuiteRunRequest)
Gets information about a Device Advisor test suite run.
|
default GetSuiteRunResponse |
getSuiteRun(GetSuiteRunRequest getSuiteRunRequest)
Gets information about a Device Advisor test suite run.
|
default GetSuiteRunReportResponse |
getSuiteRunReport(Consumer<GetSuiteRunReportRequest.Builder> getSuiteRunReportRequest)
Gets a report download link for a successful Device Advisor qualifying test suite run.
|
default GetSuiteRunReportResponse |
getSuiteRunReport(GetSuiteRunReportRequest getSuiteRunReportRequest)
Gets a report download link for a successful Device Advisor qualifying test suite run.
|
default ListSuiteDefinitionsResponse |
listSuiteDefinitions(Consumer<ListSuiteDefinitionsRequest.Builder> listSuiteDefinitionsRequest)
Lists the Device Advisor test suites you have created.
|
default ListSuiteDefinitionsResponse |
listSuiteDefinitions(ListSuiteDefinitionsRequest listSuiteDefinitionsRequest)
Lists the Device Advisor test suites you have created.
|
default ListSuiteDefinitionsIterable |
listSuiteDefinitionsPaginator(Consumer<ListSuiteDefinitionsRequest.Builder> listSuiteDefinitionsRequest)
Lists the Device Advisor test suites you have created.
|
default ListSuiteDefinitionsIterable |
listSuiteDefinitionsPaginator(ListSuiteDefinitionsRequest listSuiteDefinitionsRequest)
Lists the Device Advisor test suites you have created.
|
default ListSuiteRunsResponse |
listSuiteRuns(Consumer<ListSuiteRunsRequest.Builder> listSuiteRunsRequest)
Lists runs of the specified Device Advisor test suite.
|
default ListSuiteRunsResponse |
listSuiteRuns(ListSuiteRunsRequest listSuiteRunsRequest)
Lists runs of the specified Device Advisor test suite.
|
default ListSuiteRunsIterable |
listSuiteRunsPaginator(Consumer<ListSuiteRunsRequest.Builder> listSuiteRunsRequest)
Lists runs of the specified Device Advisor test suite.
|
default ListSuiteRunsIterable |
listSuiteRunsPaginator(ListSuiteRunsRequest listSuiteRunsRequest)
Lists runs of the specified Device Advisor test suite.
|
default ListTagsForResourceResponse |
listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)
Lists the tags attached to an IoT Device Advisor resource.
|
default ListTagsForResourceResponse |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags attached to an IoT Device Advisor resource.
|
default IotDeviceAdvisorServiceClientConfiguration |
serviceClientConfiguration() |
static ServiceMetadata |
serviceMetadata() |
default StartSuiteRunResponse |
startSuiteRun(Consumer<StartSuiteRunRequest.Builder> startSuiteRunRequest)
Starts a Device Advisor test suite run.
|
default StartSuiteRunResponse |
startSuiteRun(StartSuiteRunRequest startSuiteRunRequest)
Starts a Device Advisor test suite run.
|
default StopSuiteRunResponse |
stopSuiteRun(Consumer<StopSuiteRunRequest.Builder> stopSuiteRunRequest)
Stops a Device Advisor test suite run that is currently running.
|
default StopSuiteRunResponse |
stopSuiteRun(StopSuiteRunRequest stopSuiteRunRequest)
Stops a Device Advisor test suite run that is currently running.
|
default TagResourceResponse |
tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)
Adds to and modifies existing tags of an IoT Device Advisor resource.
|
default TagResourceResponse |
tagResource(TagResourceRequest tagResourceRequest)
Adds to and modifies existing tags of an IoT Device Advisor resource.
|
default UntagResourceResponse |
untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)
Removes tags from an IoT Device Advisor resource.
|
default UntagResourceResponse |
untagResource(UntagResourceRequest untagResourceRequest)
Removes tags from an IoT Device Advisor resource.
|
default UpdateSuiteDefinitionResponse |
updateSuiteDefinition(Consumer<UpdateSuiteDefinitionRequest.Builder> updateSuiteDefinitionRequest)
Updates a Device Advisor test suite.
|
default UpdateSuiteDefinitionResponse |
updateSuiteDefinition(UpdateSuiteDefinitionRequest updateSuiteDefinitionRequest)
Updates a Device Advisor test suite.
|
serviceNameclosestatic final String SERVICE_NAME
static final String SERVICE_METADATA_ID
ServiceMetadataProvider.default CreateSuiteDefinitionResponse createSuiteDefinition(CreateSuiteDefinitionRequest createSuiteDefinitionRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Creates a Device Advisor test suite.
Requires permission to access the CreateSuiteDefinition action.
createSuiteDefinitionRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault CreateSuiteDefinitionResponse createSuiteDefinition(Consumer<CreateSuiteDefinitionRequest.Builder> createSuiteDefinitionRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Creates a Device Advisor test suite.
Requires permission to access the CreateSuiteDefinition action.
This is a convenience which creates an instance of the CreateSuiteDefinitionRequest.Builder avoiding the
need to create one manually via CreateSuiteDefinitionRequest.builder()
createSuiteDefinitionRequest - A Consumer that will call methods on CreateSuiteDefinitionRequest.Builder to create a
request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteSuiteDefinitionResponse deleteSuiteDefinition(DeleteSuiteDefinitionRequest deleteSuiteDefinitionRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Deletes a Device Advisor test suite.
Requires permission to access the DeleteSuiteDefinition action.
deleteSuiteDefinitionRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteSuiteDefinitionResponse deleteSuiteDefinition(Consumer<DeleteSuiteDefinitionRequest.Builder> deleteSuiteDefinitionRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Deletes a Device Advisor test suite.
Requires permission to access the DeleteSuiteDefinition action.
This is a convenience which creates an instance of the DeleteSuiteDefinitionRequest.Builder avoiding the
need to create one manually via DeleteSuiteDefinitionRequest.builder()
deleteSuiteDefinitionRequest - A Consumer that will call methods on DeleteSuiteDefinitionRequest.Builder to create a
request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetEndpointResponse getEndpoint(GetEndpointRequest getEndpointRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets information about an Device Advisor endpoint.
getEndpointRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetEndpointResponse getEndpoint(Consumer<GetEndpointRequest.Builder> getEndpointRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets information about an Device Advisor endpoint.
This is a convenience which creates an instance of the GetEndpointRequest.Builder avoiding the need to
create one manually via GetEndpointRequest.builder()
getEndpointRequest - A Consumer that will call methods on GetEndpointRequest.Builder to create a request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSuiteDefinitionResponse getSuiteDefinition(GetSuiteDefinitionRequest getSuiteDefinitionRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets information about a Device Advisor test suite.
Requires permission to access the GetSuiteDefinition action.
getSuiteDefinitionRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSuiteDefinitionResponse getSuiteDefinition(Consumer<GetSuiteDefinitionRequest.Builder> getSuiteDefinitionRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets information about a Device Advisor test suite.
Requires permission to access the GetSuiteDefinition action.
This is a convenience which creates an instance of the GetSuiteDefinitionRequest.Builder avoiding the
need to create one manually via GetSuiteDefinitionRequest.builder()
getSuiteDefinitionRequest - A Consumer that will call methods on GetSuiteDefinitionRequest.Builder to create a
request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSuiteRunResponse getSuiteRun(GetSuiteRunRequest getSuiteRunRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets information about a Device Advisor test suite run.
Requires permission to access the GetSuiteRun action.
getSuiteRunRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSuiteRunResponse getSuiteRun(Consumer<GetSuiteRunRequest.Builder> getSuiteRunRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets information about a Device Advisor test suite run.
Requires permission to access the GetSuiteRun action.
This is a convenience which creates an instance of the GetSuiteRunRequest.Builder avoiding the need to
create one manually via GetSuiteRunRequest.builder()
getSuiteRunRequest - A Consumer that will call methods on GetSuiteRunRequest.Builder to create a request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSuiteRunReportResponse getSuiteRunReport(GetSuiteRunReportRequest getSuiteRunReportRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets a report download link for a successful Device Advisor qualifying test suite run.
Requires permission to access the GetSuiteRunReport action.
getSuiteRunReportRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault GetSuiteRunReportResponse getSuiteRunReport(Consumer<GetSuiteRunReportRequest.Builder> getSuiteRunReportRequest) throws ValidationException, InternalServerException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Gets a report download link for a successful Device Advisor qualifying test suite run.
Requires permission to access the GetSuiteRunReport action.
This is a convenience which creates an instance of the GetSuiteRunReportRequest.Builder avoiding the need
to create one manually via GetSuiteRunReportRequest.builder()
getSuiteRunReportRequest - A Consumer that will call methods on GetSuiteRunReportRequest.Builder to create a request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteDefinitionsResponse listSuiteDefinitions(ListSuiteDefinitionsRequest listSuiteDefinitionsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists the Device Advisor test suites you have created.
Requires permission to access the ListSuiteDefinitions action.
listSuiteDefinitionsRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteDefinitionsResponse listSuiteDefinitions(Consumer<ListSuiteDefinitionsRequest.Builder> listSuiteDefinitionsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists the Device Advisor test suites you have created.
Requires permission to access the ListSuiteDefinitions action.
This is a convenience which creates an instance of the ListSuiteDefinitionsRequest.Builder avoiding the
need to create one manually via ListSuiteDefinitionsRequest.builder()
listSuiteDefinitionsRequest - A Consumer that will call methods on ListSuiteDefinitionsRequest.Builder to create a
request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteDefinitionsIterable listSuiteDefinitionsPaginator(ListSuiteDefinitionsRequest listSuiteDefinitionsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists the Device Advisor test suites you have created.
Requires permission to access the ListSuiteDefinitions action.
This is a variant of
listSuiteDefinitions(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteDefinitionsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteDefinitionsIterable responses = client.listSuiteDefinitionsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteDefinitionsIterable responses = client
.listSuiteDefinitionsPaginator(request);
for (software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteDefinitionsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteDefinitionsIterable responses = client.listSuiteDefinitionsPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSuiteDefinitions(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteDefinitionsRequest)
operation.
listSuiteDefinitionsRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteDefinitionsIterable listSuiteDefinitionsPaginator(Consumer<ListSuiteDefinitionsRequest.Builder> listSuiteDefinitionsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists the Device Advisor test suites you have created.
Requires permission to access the ListSuiteDefinitions action.
This is a variant of
listSuiteDefinitions(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteDefinitionsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteDefinitionsIterable responses = client.listSuiteDefinitionsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteDefinitionsIterable responses = client
.listSuiteDefinitionsPaginator(request);
for (software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteDefinitionsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteDefinitionsIterable responses = client.listSuiteDefinitionsPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSuiteDefinitions(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteDefinitionsRequest)
operation.
This is a convenience which creates an instance of the ListSuiteDefinitionsRequest.Builder avoiding the
need to create one manually via ListSuiteDefinitionsRequest.builder()
listSuiteDefinitionsRequest - A Consumer that will call methods on ListSuiteDefinitionsRequest.Builder to create a
request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteRunsResponse listSuiteRuns(ListSuiteRunsRequest listSuiteRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists 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.
Requires permission to access the ListSuiteRuns action.
listSuiteRunsRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteRunsResponse listSuiteRuns(Consumer<ListSuiteRunsRequest.Builder> listSuiteRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists 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.
Requires permission to access the ListSuiteRuns action.
This is a convenience which creates an instance of the ListSuiteRunsRequest.Builder avoiding the need to
create one manually via ListSuiteRunsRequest.builder()
listSuiteRunsRequest - A Consumer that will call methods on ListSuiteRunsRequest.Builder to create a request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteRunsIterable listSuiteRunsPaginator(ListSuiteRunsRequest listSuiteRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists 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.
Requires permission to access the ListSuiteRuns action.
This is a variant of
listSuiteRuns(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteRunsRequest) operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteRunsIterable responses = client.listSuiteRunsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteRunsIterable responses = client
.listSuiteRunsPaginator(request);
for (software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteRunsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteRunsIterable responses = client.listSuiteRunsPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSuiteRuns(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteRunsRequest)
operation.
listSuiteRunsRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListSuiteRunsIterable listSuiteRunsPaginator(Consumer<ListSuiteRunsRequest.Builder> listSuiteRunsRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists 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.
Requires permission to access the ListSuiteRuns action.
This is a variant of
listSuiteRuns(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteRunsRequest) operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteRunsIterable responses = client.listSuiteRunsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteRunsIterable responses = client
.listSuiteRunsPaginator(request);
for (software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteRunsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.iotdeviceadvisor.paginators.ListSuiteRunsIterable responses = client.listSuiteRunsPaginator(request);
responses.iterator().forEachRemaining(....);
Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listSuiteRuns(software.amazon.awssdk.services.iotdeviceadvisor.model.ListSuiteRunsRequest)
operation.
This is a convenience which creates an instance of the ListSuiteRunsRequest.Builder avoiding the need to
create one manually via ListSuiteRunsRequest.builder()
listSuiteRunsRequest - A Consumer that will call methods on ListSuiteRunsRequest.Builder to create a request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws InternalServerException, ValidationException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists the tags attached to an IoT Device Advisor resource.
Requires permission to access the ListTagsForResource action.
listTagsForResourceRequest - InternalServerException - Sends an Internal Failure exception.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InternalServerException, ValidationException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Lists the tags attached to an IoT Device Advisor resource.
Requires permission to access the ListTagsForResource action.
This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the
need to create one manually via ListTagsForResourceRequest.builder()
listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a
request.InternalServerException - Sends an Internal Failure exception.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StartSuiteRunResponse startSuiteRun(StartSuiteRunRequest startSuiteRunRequest) throws ValidationException, InternalServerException, ConflictException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Starts a Device Advisor test suite run.
Requires permission to access the StartSuiteRun action.
startSuiteRunRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ConflictException - Sends a Conflict Exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StartSuiteRunResponse startSuiteRun(Consumer<StartSuiteRunRequest.Builder> startSuiteRunRequest) throws ValidationException, InternalServerException, ConflictException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Starts a Device Advisor test suite run.
Requires permission to access the StartSuiteRun action.
This is a convenience which creates an instance of the StartSuiteRunRequest.Builder avoiding the need to
create one manually via StartSuiteRunRequest.builder()
startSuiteRunRequest - A Consumer that will call methods on StartSuiteRunRequest.Builder to create a request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.ConflictException - Sends a Conflict Exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StopSuiteRunResponse stopSuiteRun(StopSuiteRunRequest stopSuiteRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Stops a Device Advisor test suite run that is currently running.
Requires permission to access the StopSuiteRun action.
stopSuiteRunRequest - ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault StopSuiteRunResponse stopSuiteRun(Consumer<StopSuiteRunRequest.Builder> stopSuiteRunRequest) throws ValidationException, ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Stops a Device Advisor test suite run that is currently running.
Requires permission to access the StopSuiteRun action.
This is a convenience which creates an instance of the StopSuiteRunRequest.Builder avoiding the need to
create one manually via StopSuiteRunRequest.builder()
stopSuiteRunRequest - A Consumer that will call methods on StopSuiteRunRequest.Builder to create a request.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws InternalServerException, ValidationException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Adds to and modifies existing tags of an IoT Device Advisor resource.
Requires permission to access the TagResource action.
tagResourceRequest - InternalServerException - Sends an Internal Failure exception.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws InternalServerException, ValidationException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Adds to and modifies existing tags of an IoT Device Advisor resource.
Requires permission to access the TagResource action.
This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to
create one manually via TagResourceRequest.builder()
tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.InternalServerException - Sends an Internal Failure exception.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws InternalServerException, ValidationException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Removes tags from an IoT Device Advisor resource.
Requires permission to access the UntagResource action.
untagResourceRequest - InternalServerException - Sends an Internal Failure exception.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws InternalServerException, ValidationException, ResourceNotFoundException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Removes tags from an IoT Device Advisor resource.
Requires permission to access the UntagResource action.
This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to
create one manually via UntagResourceRequest.builder()
untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.InternalServerException - Sends an Internal Failure exception.ValidationException - Sends a validation exception.ResourceNotFoundException - Sends a Resource Not Found exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UpdateSuiteDefinitionResponse updateSuiteDefinition(UpdateSuiteDefinitionRequest updateSuiteDefinitionRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Updates a Device Advisor test suite.
Requires permission to access the UpdateSuiteDefinition action.
updateSuiteDefinitionRequest - ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UpdateSuiteDefinitionResponse updateSuiteDefinition(Consumer<UpdateSuiteDefinitionRequest.Builder> updateSuiteDefinitionRequest) throws ValidationException, InternalServerException, AwsServiceException, SdkClientException, IotDeviceAdvisorException
Updates a Device Advisor test suite.
Requires permission to access the UpdateSuiteDefinition action.
This is a convenience which creates an instance of the UpdateSuiteDefinitionRequest.Builder avoiding the
need to create one manually via UpdateSuiteDefinitionRequest.builder()
updateSuiteDefinitionRequest - A Consumer that will call methods on UpdateSuiteDefinitionRequest.Builder to create a
request.ValidationException - Sends a validation exception.InternalServerException - Sends an Internal Failure exception.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.IotDeviceAdvisorException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionstatic IotDeviceAdvisorClient create()
IotDeviceAdvisorClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider.static IotDeviceAdvisorClientBuilder builder()
IotDeviceAdvisorClient.static ServiceMetadata serviceMetadata()
default IotDeviceAdvisorServiceClientConfiguration serviceClientConfiguration()
serviceClientConfiguration in interface AwsClientserviceClientConfiguration in interface SdkClientCopyright © 2023. All rights reserved.