Interface BraketClient
-
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface BraketClient extends AwsClient
Service client for accessing Braket. This can be created using the staticbuilder()method.The Amazon Braket API Reference provides information about the operations and structures supported in Amazon Braket.
Additional Resources:
-
-
Field Summary
Fields Modifier and Type Field Description static StringSERVICE_METADATA_IDValue for looking up the service's metadata from theServiceMetadataProvider.static StringSERVICE_NAME
-
Method Summary
-
Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
-
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
-
-
-
Field Detail
-
SERVICE_NAME
static final String SERVICE_NAME
- See Also:
- Constant Field Values
-
SERVICE_METADATA_ID
static final String SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
- Constant Field Values
-
-
Method Detail
-
cancelJob
default CancelJobResponse cancelJob(CancelJobRequest cancelJobRequest) throws ResourceNotFoundException, AccessDeniedException, ConflictException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Cancels an Amazon Braket job.
- Parameters:
cancelJobRequest-- Returns:
- Result of the CancelJob operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ConflictException- An error occurred due to a conflict.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
cancelJob
default CancelJobResponse cancelJob(Consumer<CancelJobRequest.Builder> cancelJobRequest) throws ResourceNotFoundException, AccessDeniedException, ConflictException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Cancels an Amazon Braket job.
This is a convenience which creates an instance of the
CancelJobRequest.Builderavoiding the need to create one manually viaCancelJobRequest.builder()- Parameters:
cancelJobRequest- AConsumerthat will call methods onCancelJobRequest.Builderto create a request.- Returns:
- Result of the CancelJob operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ConflictException- An error occurred due to a conflict.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
cancelQuantumTask
default CancelQuantumTaskResponse cancelQuantumTask(CancelQuantumTaskRequest cancelQuantumTaskRequest) throws ResourceNotFoundException, AccessDeniedException, ConflictException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Cancels the specified task.
- Parameters:
cancelQuantumTaskRequest-- Returns:
- Result of the CancelQuantumTask operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ConflictException- An error occurred due to a conflict.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
cancelQuantumTask
default CancelQuantumTaskResponse cancelQuantumTask(Consumer<CancelQuantumTaskRequest.Builder> cancelQuantumTaskRequest) throws ResourceNotFoundException, AccessDeniedException, ConflictException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Cancels the specified task.
This is a convenience which creates an instance of the
CancelQuantumTaskRequest.Builderavoiding the need to create one manually viaCancelQuantumTaskRequest.builder()- Parameters:
cancelQuantumTaskRequest- AConsumerthat will call methods onCancelQuantumTaskRequest.Builderto create a request.- Returns:
- Result of the CancelQuantumTask operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ConflictException- An error occurred due to a conflict.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
createJob
default CreateJobResponse createJob(CreateJobRequest createJobRequest) throws ConflictException, AccessDeniedException, ThrottlingException, DeviceOfflineException, DeviceRetiredException, InternalServiceException, ServiceQuotaExceededException, ValidationException, AwsServiceException, SdkClientException, BraketException
Creates an Amazon Braket job.
- Parameters:
createJobRequest-- Returns:
- Result of the CreateJob operation returned by the service.
- Throws:
ConflictException- An error occurred due to a conflict.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.DeviceOfflineException- The specified device is currently offline.DeviceRetiredException- The specified device has been retired.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ServiceQuotaExceededException- The request failed because a service quota is exceeded.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
createJob
default CreateJobResponse createJob(Consumer<CreateJobRequest.Builder> createJobRequest) throws ConflictException, AccessDeniedException, ThrottlingException, DeviceOfflineException, DeviceRetiredException, InternalServiceException, ServiceQuotaExceededException, ValidationException, AwsServiceException, SdkClientException, BraketException
Creates an Amazon Braket job.
This is a convenience which creates an instance of the
CreateJobRequest.Builderavoiding the need to create one manually viaCreateJobRequest.builder()- Parameters:
createJobRequest- AConsumerthat will call methods onCreateJobRequest.Builderto create a request.- Returns:
- Result of the CreateJob operation returned by the service.
- Throws:
ConflictException- An error occurred due to a conflict.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.DeviceOfflineException- The specified device is currently offline.DeviceRetiredException- The specified device has been retired.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ServiceQuotaExceededException- The request failed because a service quota is exceeded.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
createQuantumTask
default CreateQuantumTaskResponse createQuantumTask(CreateQuantumTaskRequest createQuantumTaskRequest) throws AccessDeniedException, ThrottlingException, DeviceOfflineException, DeviceRetiredException, InternalServiceException, ServiceQuotaExceededException, ValidationException, AwsServiceException, SdkClientException, BraketException
Creates a quantum task.
- Parameters:
createQuantumTaskRequest-- Returns:
- Result of the CreateQuantumTask operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.DeviceOfflineException- The specified device is currently offline.DeviceRetiredException- The specified device has been retired.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ServiceQuotaExceededException- The request failed because a service quota is exceeded.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
createQuantumTask
default CreateQuantumTaskResponse createQuantumTask(Consumer<CreateQuantumTaskRequest.Builder> createQuantumTaskRequest) throws AccessDeniedException, ThrottlingException, DeviceOfflineException, DeviceRetiredException, InternalServiceException, ServiceQuotaExceededException, ValidationException, AwsServiceException, SdkClientException, BraketException
Creates a quantum task.
This is a convenience which creates an instance of the
CreateQuantumTaskRequest.Builderavoiding the need to create one manually viaCreateQuantumTaskRequest.builder()- Parameters:
createQuantumTaskRequest- AConsumerthat will call methods onCreateQuantumTaskRequest.Builderto create a request.- Returns:
- Result of the CreateQuantumTask operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.DeviceOfflineException- The specified device is currently offline.DeviceRetiredException- The specified device has been retired.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ServiceQuotaExceededException- The request failed because a service quota is exceeded.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
getDevice
default GetDeviceResponse getDevice(GetDeviceRequest getDeviceRequest) throws ResourceNotFoundException, AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Retrieves the devices available in Amazon Braket.
For backwards compatibility with older versions of BraketSchemas, OpenQASM information is omitted from GetDevice API calls. To get this information the user-agent needs to present a recent version of the BraketSchemas (1.8.0 or later). The Braket SDK automatically reports this for you. If you do not see OpenQASM results in the GetDevice response when using a Braket SDK, you may need to set AWS_EXECUTION_ENV environment variable to configure user-agent. See the code examples provided below for how to do this for the AWS CLI, Boto3, and the Go, Java, and JavaScript/TypeScript SDKs.
- Parameters:
getDeviceRequest-- Returns:
- Result of the GetDevice operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
getDevice
default GetDeviceResponse getDevice(Consumer<GetDeviceRequest.Builder> getDeviceRequest) throws ResourceNotFoundException, AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Retrieves the devices available in Amazon Braket.
For backwards compatibility with older versions of BraketSchemas, OpenQASM information is omitted from GetDevice API calls. To get this information the user-agent needs to present a recent version of the BraketSchemas (1.8.0 or later). The Braket SDK automatically reports this for you. If you do not see OpenQASM results in the GetDevice response when using a Braket SDK, you may need to set AWS_EXECUTION_ENV environment variable to configure user-agent. See the code examples provided below for how to do this for the AWS CLI, Boto3, and the Go, Java, and JavaScript/TypeScript SDKs.
This is a convenience which creates an instance of the
GetDeviceRequest.Builderavoiding the need to create one manually viaGetDeviceRequest.builder()- Parameters:
getDeviceRequest- AConsumerthat will call methods onGetDeviceRequest.Builderto create a request.- Returns:
- Result of the GetDevice operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
getJob
default GetJobResponse getJob(GetJobRequest getJobRequest) throws ResourceNotFoundException, AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Retrieves the specified Amazon Braket job.
- Parameters:
getJobRequest-- Returns:
- Result of the GetJob operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
getJob
default GetJobResponse getJob(Consumer<GetJobRequest.Builder> getJobRequest) throws ResourceNotFoundException, AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Retrieves the specified Amazon Braket job.
This is a convenience which creates an instance of the
GetJobRequest.Builderavoiding the need to create one manually viaGetJobRequest.builder()- Parameters:
getJobRequest- AConsumerthat will call methods onGetJobRequest.Builderto create a request.- Returns:
- Result of the GetJob operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
getQuantumTask
default GetQuantumTaskResponse getQuantumTask(GetQuantumTaskRequest getQuantumTaskRequest) throws ResourceNotFoundException, AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Retrieves the specified quantum task.
- Parameters:
getQuantumTaskRequest-- Returns:
- Result of the GetQuantumTask operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
getQuantumTask
default GetQuantumTaskResponse getQuantumTask(Consumer<GetQuantumTaskRequest.Builder> getQuantumTaskRequest) throws ResourceNotFoundException, AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Retrieves the specified quantum task.
This is a convenience which creates an instance of the
GetQuantumTaskRequest.Builderavoiding the need to create one manually viaGetQuantumTaskRequest.builder()- Parameters:
getQuantumTaskRequest- AConsumerthat will call methods onGetQuantumTaskRequest.Builderto create a request.- Returns:
- Result of the GetQuantumTask operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ResourceNotFoundException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Shows the tags associated with this resource.
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ResourceNotFoundException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Shows the tags associated with this resource.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchDevices
default SearchDevicesResponse searchDevices(SearchDevicesRequest searchDevicesRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Searches for devices using the specified filters.
- Parameters:
searchDevicesRequest-- Returns:
- Result of the SearchDevices operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchDevices
default SearchDevicesResponse searchDevices(Consumer<SearchDevicesRequest.Builder> searchDevicesRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Searches for devices using the specified filters.
This is a convenience which creates an instance of the
SearchDevicesRequest.Builderavoiding the need to create one manually viaSearchDevicesRequest.builder()- Parameters:
searchDevicesRequest- AConsumerthat will call methods onSearchDevicesRequest.Builderto create a request.- Returns:
- Result of the SearchDevices operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchDevicesPaginator
default SearchDevicesIterable searchDevicesPaginator(SearchDevicesRequest searchDevicesRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
This is a variant of
searchDevices(software.amazon.awssdk.services.braket.model.SearchDevicesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.braket.paginators.SearchDevicesIterable responses = client.searchDevicesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.braket.paginators.SearchDevicesIterable responses = client.searchDevicesPaginator(request); for (software.amazon.awssdk.services.braket.model.SearchDevicesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.braket.paginators.SearchDevicesIterable responses = client.searchDevicesPaginator(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
searchDevices(software.amazon.awssdk.services.braket.model.SearchDevicesRequest)operation.- Parameters:
searchDevicesRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchDevicesPaginator
default SearchDevicesIterable searchDevicesPaginator(Consumer<SearchDevicesRequest.Builder> searchDevicesRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
This is a variant of
searchDevices(software.amazon.awssdk.services.braket.model.SearchDevicesRequest)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
2) Using For loopsoftware.amazon.awssdk.services.braket.paginators.SearchDevicesIterable responses = client.searchDevicesPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.braket.paginators.SearchDevicesIterable responses = client.searchDevicesPaginator(request); for (software.amazon.awssdk.services.braket.model.SearchDevicesResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.braket.paginators.SearchDevicesIterable responses = client.searchDevicesPaginator(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
searchDevices(software.amazon.awssdk.services.braket.model.SearchDevicesRequest)operation.
This is a convenience which creates an instance of the
SearchDevicesRequest.Builderavoiding the need to create one manually viaSearchDevicesRequest.builder()- Parameters:
searchDevicesRequest- AConsumerthat will call methods onSearchDevicesRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchJobs
default SearchJobsResponse searchJobs(SearchJobsRequest searchJobsRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Searches for Amazon Braket jobs that match the specified filter values.
- Parameters:
searchJobsRequest-- Returns:
- Result of the SearchJobs operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchJobs
default SearchJobsResponse searchJobs(Consumer<SearchJobsRequest.Builder> searchJobsRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Searches for Amazon Braket jobs that match the specified filter values.
This is a convenience which creates an instance of the
SearchJobsRequest.Builderavoiding the need to create one manually viaSearchJobsRequest.builder()- Parameters:
searchJobsRequest- AConsumerthat will call methods onSearchJobsRequest.Builderto create a request.- Returns:
- Result of the SearchJobs operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchJobsPaginator
default SearchJobsIterable searchJobsPaginator(SearchJobsRequest searchJobsRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
This is a variant of
searchJobs(software.amazon.awssdk.services.braket.model.SearchJobsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.braket.paginators.SearchJobsIterable responses = client.searchJobsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.braket.paginators.SearchJobsIterable responses = client.searchJobsPaginator(request); for (software.amazon.awssdk.services.braket.model.SearchJobsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.braket.paginators.SearchJobsIterable responses = client.searchJobsPaginator(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
searchJobs(software.amazon.awssdk.services.braket.model.SearchJobsRequest)operation.- Parameters:
searchJobsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchJobsPaginator
default SearchJobsIterable searchJobsPaginator(Consumer<SearchJobsRequest.Builder> searchJobsRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
This is a variant of
searchJobs(software.amazon.awssdk.services.braket.model.SearchJobsRequest)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
2) Using For loopsoftware.amazon.awssdk.services.braket.paginators.SearchJobsIterable responses = client.searchJobsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.braket.paginators.SearchJobsIterable responses = client.searchJobsPaginator(request); for (software.amazon.awssdk.services.braket.model.SearchJobsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.braket.paginators.SearchJobsIterable responses = client.searchJobsPaginator(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
searchJobs(software.amazon.awssdk.services.braket.model.SearchJobsRequest)operation.
This is a convenience which creates an instance of the
SearchJobsRequest.Builderavoiding the need to create one manually viaSearchJobsRequest.builder()- Parameters:
searchJobsRequest- AConsumerthat will call methods onSearchJobsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchQuantumTasks
default SearchQuantumTasksResponse searchQuantumTasks(SearchQuantumTasksRequest searchQuantumTasksRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Searches for tasks that match the specified filter values.
- Parameters:
searchQuantumTasksRequest-- Returns:
- Result of the SearchQuantumTasks operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchQuantumTasks
default SearchQuantumTasksResponse searchQuantumTasks(Consumer<SearchQuantumTasksRequest.Builder> searchQuantumTasksRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Searches for tasks that match the specified filter values.
This is a convenience which creates an instance of the
SearchQuantumTasksRequest.Builderavoiding the need to create one manually viaSearchQuantumTasksRequest.builder()- Parameters:
searchQuantumTasksRequest- AConsumerthat will call methods onSearchQuantumTasksRequest.Builderto create a request.- Returns:
- Result of the SearchQuantumTasks operation returned by the service.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchQuantumTasksPaginator
default SearchQuantumTasksIterable searchQuantumTasksPaginator(SearchQuantumTasksRequest searchQuantumTasksRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
This is a variant of
searchQuantumTasks(software.amazon.awssdk.services.braket.model.SearchQuantumTasksRequest)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
2) Using For loopsoftware.amazon.awssdk.services.braket.paginators.SearchQuantumTasksIterable responses = client.searchQuantumTasksPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.braket.paginators.SearchQuantumTasksIterable responses = client .searchQuantumTasksPaginator(request); for (software.amazon.awssdk.services.braket.model.SearchQuantumTasksResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.braket.paginators.SearchQuantumTasksIterable responses = client.searchQuantumTasksPaginator(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
searchQuantumTasks(software.amazon.awssdk.services.braket.model.SearchQuantumTasksRequest)operation.- Parameters:
searchQuantumTasksRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
searchQuantumTasksPaginator
default SearchQuantumTasksIterable searchQuantumTasksPaginator(Consumer<SearchQuantumTasksRequest.Builder> searchQuantumTasksRequest) throws AccessDeniedException, ThrottlingException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
This is a variant of
searchQuantumTasks(software.amazon.awssdk.services.braket.model.SearchQuantumTasksRequest)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
2) Using For loopsoftware.amazon.awssdk.services.braket.paginators.SearchQuantumTasksIterable responses = client.searchQuantumTasksPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.braket.paginators.SearchQuantumTasksIterable responses = client .searchQuantumTasksPaginator(request); for (software.amazon.awssdk.services.braket.model.SearchQuantumTasksResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.braket.paginators.SearchQuantumTasksIterable responses = client.searchQuantumTasksPaginator(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
searchQuantumTasks(software.amazon.awssdk.services.braket.model.SearchQuantumTasksRequest)operation.
This is a convenience which creates an instance of the
SearchQuantumTasksRequest.Builderavoiding the need to create one manually viaSearchQuantumTasksRequest.builder()- Parameters:
searchQuantumTasksRequest- AConsumerthat will call methods onSearchQuantumTasksRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- Throws:
AccessDeniedException- You do not have sufficient access to perform this action.ThrottlingException- The throttling rate limit is met.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Add a tag to the specified resource.
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ResourceNotFoundException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Add a tag to the specified resource.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- Result of the TagResource operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ResourceNotFoundException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Remove tags from a resource.
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ResourceNotFoundException, InternalServiceException, ValidationException, AwsServiceException, SdkClientException, BraketException
Remove tags from a resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- Throws:
ResourceNotFoundException- The specified resource was not found.InternalServiceException- The request processing has failed because of an unknown error, exception, or failure.ValidationException- The input fails to satisfy the constraints specified by an AWS service.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.BraketException- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException- See Also:
- AWS API Documentation
-
create
static BraketClient create()
Create aBraketClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.
-
builder
static BraketClientBuilder builder()
Create a builder that can be used to configure and create aBraketClient.
-
serviceMetadata
static ServiceMetadata serviceMetadata()
-
serviceClientConfiguration
default BraketServiceClientConfiguration serviceClientConfiguration()
- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient
-
-