private IotHubServiceClient(IotHubSasCredential credential, IotHubServiceClientOptions options)
{
options ??= new IotHubServiceClientOptions();
_clientDiagnostics = new ClientDiagnostics(options);
options.AddPolicy(new SasTokenAuthenticationPolicy(credential), HttpPipelinePosition.PerCall);
_httpPipeline = HttpPipelineBuilder.Build(options);
_devicesRestClient = new DevicesRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
_modulesRestClient = new ModulesRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
_queryRestClient = new QueryRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
_statisticsRestClient = new StatisticsRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
_configurationRestClient = new ConfigurationRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
_jobsRestClient = new JobsRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
_bulkRegistryRestClient = new BulkRegistryRestClient(_clientDiagnostics, _httpPipeline, credential.Endpoint, options.GetVersionString());
// Note that the devices and modules subclient take a reference to the Query convenience layer client. This
// is because they each expose a helper function that uses the query client for listing twins. By passing in
// the convenience layer query client rather than the protocol layer query client, we minimize rewriting the
// same pagination logic that now exists only in the query convenience layer client.
Query = new QueryClient(_queryRestClient);
Devices = new DevicesClient(_devicesRestClient, Query, _bulkRegistryRestClient);
Modules = new ModulesClient(_devicesRestClient, _modulesRestClient, Query, _bulkRegistryRestClient);
Statistics = new StatisticsClient(_statisticsRestClient);
Configurations = new ConfigurationsClient(_configurationRestClient);
Messages = new CloudToDeviceMessagesClient();
Files = new FilesClient();
Jobs = new JobsClient(_jobsRestClient);
}
/// <summary>
/// Initializes a new instance of the <see cref="IotHubServiceClient"/> class.
/// </summary>
/// <param name="endpoint">
/// The IoT Hub service instance endpoint to connect to.
/// </param>
/// <param name="credential">
/// The IoT Hub credentials, to be used for authenticating against an IoT Hub instance via SAS tokens.
/// </param>
/// <param name="options">
/// (optional) Options that allow configuration of requests sent to the IoT Hub service.
/// </param>
/// <code snippet="Snippet:IotHubServiceClientInitializeWithIotHubSasCredential" language="csharp">
/// // Create an IotHubSasCredential type to use sas tokens to authenticate against your IoT Hub instance.
/// // The default lifespan of the sas token is 30 minutes, and it is set to be renewed when at 15% or less of its lifespan.
/// var credential = new IotHubSasCredential(options.IotHubSharedAccessPolicy, options.IotHubSharedAccessKey);
///
/// IotHubServiceClient hubClient = new IotHubServiceClient(options.Endpoint, credential);
/// </code>
public IotHubServiceClient(Uri endpoint, IotHubSasCredential credential, IotHubServiceClientOptions options = default)
: this(SetEndpointToIotHubSasCredential(endpoint, credential), options)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="IotHubServiceClient"/> class.
/// </summary>
/// <param name="connectionString">
/// The IoT Hub connection string, with either "iothubowner", "service", "registryRead" or "registryReadWrite" policy, as applicable.
/// For more information, see <see href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-security#access-control-and-permissions"/>.
/// </param>
/// <param name="options">
/// Options that allow configuration of requests sent to the IoT Hub service.
/// </param>
/// <seealso cref="IotHubServiceClient(Uri, IotHubSasCredential, IotHubServiceClientOptions)">
/// This other constructor provides an opportunity to override default behavior, including setting the sas token time to live, specifying the service API version,
/// overriding <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/Pipeline.md">transport</see>,
/// enabling <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/Diagnostics.md">diagnostics</see>,
/// and controlling <see href="https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/core/Azure.Core/samples/Configuration.md">retry strategy</see>.
/// </seealso>
public IotHubServiceClient(string connectionString, IotHubServiceClientOptions options)
: this(new IotHubSasCredential(connectionString), options)
{
}
