AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Implementation for accessing Braket

The Amazon Braket API Reference provides information about the operations and structures supported in Amazon Braket.

Additional Resources:

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonServiceClient
    Amazon.Braket.AmazonBraketClient

Namespace: Amazon.Braket
Assembly: AWSSDK.Braket.dll
Version: 3.x.y.z

Syntax

C#
public class AmazonBraketClient : AmazonServiceClient
         IAmazonBraket, IAmazonService, IDisposable

The AmazonBraketClient type exposes the following members

Constructors

NameDescription
Public Method AmazonBraketClient()

Constructs AmazonBraketClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="AWSProfileName" value="AWS Default"/>
    </appSettings>
</configuration>
             

Public Method AmazonBraketClient(RegionEndpoint)

Constructs AmazonBraketClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="AWSProfileName" value="AWS Default"/>
    </appSettings>
</configuration>
             

Public Method AmazonBraketClient(AmazonBraketConfig)

Constructs AmazonBraketClient with the credentials loaded from the application's default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. Example App.config with credentials set.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="AWSProfileName" value="AWS Default"/>
    </appSettings>
</configuration>
             

Public Method AmazonBraketClient(AWSCredentials)

Constructs AmazonBraketClient with AWS Credentials

Public Method AmazonBraketClient(AWSCredentials, RegionEndpoint)

Constructs AmazonBraketClient with AWS Credentials

Public Method AmazonBraketClient(AWSCredentials, AmazonBraketConfig)

Constructs AmazonBraketClient with AWS Credentials and an AmazonBraketClient Configuration object.

Public Method AmazonBraketClient(string, string)

Constructs AmazonBraketClient with AWS Access Key ID and AWS Secret Key

Public Method AmazonBraketClient(string, string, RegionEndpoint)

Constructs AmazonBraketClient with AWS Access Key ID and AWS Secret Key

Public Method AmazonBraketClient(string, string, AmazonBraketConfig)

Constructs AmazonBraketClient with AWS Access Key ID, AWS Secret Key and an AmazonBraketClient Configuration object.

Public Method AmazonBraketClient(string, string, string)

Constructs AmazonBraketClient with AWS Access Key ID and AWS Secret Key

Public Method AmazonBraketClient(string, string, string, RegionEndpoint)

Constructs AmazonBraketClient with AWS Access Key ID and AWS Secret Key

Public Method AmazonBraketClient(string, string, string, AmazonBraketConfig)

Constructs AmazonBraketClient with AWS Access Key ID, AWS Secret Key and an AmazonBraketClient Configuration object.

Properties

NameTypeDescription
Public Property Config Amazon.Runtime.IClientConfig Inherited from Amazon.Runtime.AmazonServiceClient.
Public Property Paginators Amazon.Braket.Model.IBraketPaginatorFactory

Paginators for the service

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

NameDescription
Public Method CancelJob(CancelJobRequest)

Cancels an Amazon Braket job.

Public Method CancelJobAsync(CancelJobRequest, CancellationToken)

Cancels an Amazon Braket job.

Public Method CancelQuantumTask(CancelQuantumTaskRequest)

Cancels the specified task.

Public Method CancelQuantumTaskAsync(CancelQuantumTaskRequest, CancellationToken)

Cancels the specified task.

Public Method CreateJob(CreateJobRequest)

Creates an Amazon Braket job.

Public Method CreateJobAsync(CreateJobRequest, CancellationToken)

Creates an Amazon Braket job.

Public Method CreateQuantumTask(CreateQuantumTaskRequest)

Creates a quantum task.

Public Method CreateQuantumTaskAsync(CreateQuantumTaskRequest, CancellationToken)

Creates a quantum task.

Public Method DetermineServiceOperationEndpoint(AmazonWebServiceRequest)

Returns the endpoint that will be used for a particular request.

Public Method Dispose() Inherited from Amazon.Runtime.AmazonServiceClient.
Public Method GetDevice(GetDeviceRequest)

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.

Public Method GetDeviceAsync(GetDeviceRequest, CancellationToken)

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.

Public Method GetJob(GetJobRequest)

Retrieves the specified Amazon Braket job.

Public Method GetJobAsync(GetJobRequest, CancellationToken)

Retrieves the specified Amazon Braket job.

Public Method GetQuantumTask(GetQuantumTaskRequest)

Retrieves the specified quantum task.

Public Method GetQuantumTaskAsync(GetQuantumTaskRequest, CancellationToken)

Retrieves the specified quantum task.

Public Method ListTagsForResource(ListTagsForResourceRequest)

Shows the tags associated with this resource.

Public Method ListTagsForResourceAsync(ListTagsForResourceRequest, CancellationToken)

Shows the tags associated with this resource.

Public Method SearchDevices(SearchDevicesRequest)

Searches for devices using the specified filters.

Public Method SearchDevicesAsync(SearchDevicesRequest, CancellationToken)

Searches for devices using the specified filters.

Public Method SearchJobs(SearchJobsRequest)

Searches for Amazon Braket jobs that match the specified filter values.

Public Method SearchJobsAsync(SearchJobsRequest, CancellationToken)

Searches for Amazon Braket jobs that match the specified filter values.

Public Method SearchQuantumTasks(SearchQuantumTasksRequest)

Searches for tasks that match the specified filter values.

Public Method SearchQuantumTasksAsync(SearchQuantumTasksRequest, CancellationToken)

Searches for tasks that match the specified filter values.

Public Method TagResource(TagResourceRequest)

Add a tag to the specified resource.

Public Method TagResourceAsync(TagResourceRequest, CancellationToken)

Add a tag to the specified resource.

Public Method UntagResource(UntagResourceRequest)

Remove tags from a resource.

Public Method UntagResourceAsync(UntagResourceRequest, CancellationToken)

Remove tags from a resource.

Events

NameDescription
Event AfterResponseEvent Inherited from Amazon.Runtime.AmazonServiceClient.
Event BeforeRequestEvent Inherited from Amazon.Runtime.AmazonServiceClient.
Event ExceptionEvent Inherited from Amazon.Runtime.AmazonServiceClient.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5, 4.0, 3.5