HDInsightClient Class

 

Note

This version of the HDInsight .NET SDK is deprecated and will be removed by January 1, 2017. You are encouraged to use the newer ARM-based version of HDInsight .NET SDK going forward. For instructions on how to use the new HDInsight .NET SDK to create a cluster, see Create HDInsight Linux clusters using .NET SDK. For instructions on how to submit jobs using the new .NET SDK and other approaches, see Submit jobs to an HDInsight cluster. The HDInsight SDK reference for the newer version is available at HDInsight .NET SDK Reference.

Defines the HDInsight client interface for the management of cluster deployments on the Azure HDInsight Service.

Namespace:   Microsoft.WindowsAzure.Management.HDInsight
Assembly:  Microsoft.WindowsAzure.Management.HDInsight (in Microsoft.WindowsAzure.Management.HDInsight.dll)

Inheritance Hierarchy

System.Object
  Microsoft.WindowsAzure.Management.HDInsight.Framework.Core.DisposableObject
    Microsoft.Hadoop.Client.ClientBase
      Microsoft.WindowsAzure.Management.HDInsight.HDInsightClient

Syntax

[SuppressMessageAttribute("Microsoft.Design", "CA1063:ImplementIDisposableCorrectly", 
    Justification = "DisposableObject implements IDisposable correctly, the implementation of IDisposable in the interfaces is necessary for the design.")]
[SuppressMessageAttribute("Microsoft.Maintainability", "CA1506:AvoidExcessiveClassCoupling", 
    Justification = "This complexity is needed to handle all the operations.")]
public sealed class HDInsightClient : ClientBase, IHDInsightClient, 
    IHDInsightAsyncClient, IHDInsightSyncClient, IHDInsightClientBase, 
    IJobSubmissionClientBase, IHadoopClientBase, IDisposable, ILogProvider
[SuppressMessageAttribute("Microsoft.Design", "CA1063:ImplementIDisposableCorrectly", 
    Justification = "DisposableObject implements IDisposable correctly, the implementation of IDisposable in the interfaces is necessary for the design.")]
[SuppressMessageAttribute("Microsoft.Maintainability", "CA1506:AvoidExcessiveClassCoupling", 
    Justification = "This complexity is needed to handle all the operations.")]
public ref class HDInsightClient sealed : ClientBase, IHDInsightClient, 
    IHDInsightAsyncClient, IHDInsightSyncClient, IHDInsightClientBase, 
    IJobSubmissionClientBase, IHadoopClientBase, IDisposable, ILogProvider
[<Sealed>]
[<SuppressMessageAttribute("Microsoft.Design", "CA1063:ImplementIDisposableCorrectly",
    Justification = "DisposableObject implements IDisposable correctly, the implementation of IDisposable in the interfaces is necessary for the design.")>]
[<SuppressMessageAttribute("Microsoft.Maintainability", "CA1506:AvoidExcessiveClassCoupling",
    Justification = "This complexity is needed to handle all the operations.")>]
type HDInsightClient = 
    class
        inherit ClientBase
        interface IHDInsightClient
        interface IHDInsightAsyncClient
        interface IHDInsightSyncClient
        interface IHDInsightClientBase
        interface IJobSubmissionClientBase
        interface IHadoopClientBase
        interface IDisposable
        interface ILogProvider
    end
<SuppressMessageAttribute("Microsoft.Design", "CA1063:ImplementIDisposableCorrectly",
    Justification := "DisposableObject implements IDisposable correctly, the implementation of IDisposable in the interfaces is necessary for the design.")>
<SuppressMessageAttribute("Microsoft.Maintainability", "CA1506:AvoidExcessiveClassCoupling",
    Justification := "This complexity is needed to handle all the operations.")>
Public NotInheritable Class HDInsightClient
    Inherits ClientBase
    Implements IHDInsightClient, IHDInsightAsyncClient, IHDInsightSyncClient,
    IHDInsightClientBase, IJobSubmissionClientBase, IHadoopClientBase,
    IDisposable, ILogProvider

Properties

Name Description
System_CAPS_pubproperty CancellationSource

Gets or sets the cancellation token source that is used to signal to a cancellation token that it should be canceled.(Inherited from ClientBase.)

System_CAPS_pubproperty CancellationToken

Gets the cancellation token that propagates notification that operations should be canceled.(Inherited from ClientBase.)

System_CAPS_pubproperty Credentials

Gets the connection credentials.

System_CAPS_pubproperty HttpOperationTimeout

Gets or sets the HTTP operation timeout.(Inherited from ClientBase.)

System_CAPS_pubproperty IgnoreSslErrors

(Inherited from ClientBase.)

System_CAPS_pubproperty Logger

Gets the logger used to log messages.(Inherited from ClientBase.)

System_CAPS_pubproperty PollingInterval

Gets or sets the polling interval for the CreateCluster/DeleteCluster operations.

System_CAPS_pubproperty RetryPolicy

Gets or sets the retry policy.(Inherited from ClientBase.)

Methods

Name Description
System_CAPS_pubmethod AddLogWriter(ILogWriter)

Adds a log writer to the client.(Inherited from ClientBase.)

System_CAPS_pubmethod Cancel()

Cancels a pending operation.(Inherited from ClientBase.)

System_CAPS_pubmethod ChangeClusterSize(String, String, Int32)

System_CAPS_pubmethod ChangeClusterSize(String, String, Int32, TimeSpan)

System_CAPS_pubmethod ChangeClusterSizeAsync(String, String, Int32)

System_CAPS_pubmethod ChangeClusterSizeAsync(String, String, Int32, TimeSpan)

System_CAPS_pubmethodSystem_CAPS_static Connect(IHDInsightSubscriptionCredentials)

Connects to an HDInsight subscription with a new client.

System_CAPS_pubmethodSystem_CAPS_static Connect(IHDInsightSubscriptionCredentials, TimeSpan, IRetryPolicy)

Connects the specified credentials.

System_CAPS_pubmethod CreateCluster(ClusterCreateParameters)

Submits a request synchronously to create an HDInsight cluster and waits for it to complete.

System_CAPS_pubmethod CreateCluster(ClusterCreateParameters, TimeSpan)

Submits a request synchronously to create an HDInsight cluster and waits a specified interval of time for it to complete.

System_CAPS_pubmethod CreateCluster(ClusterCreateParametersV2)

System_CAPS_pubmethod CreateCluster(ClusterCreateParametersV2, TimeSpan)

System_CAPS_pubmethod CreateClusterAsync(ClusterCreateParameters)

Submits a request to create an HDInsight cluster asynchronously.

System_CAPS_pubmethod CreateClusterAsync(ClusterCreateParametersV2)

System_CAPS_pubmethod DeleteCluster(String)

Submits a request synchronously to delete an HDInsight cluster and waits for it to complete.

System_CAPS_pubmethod DeleteCluster(String, String)

System_CAPS_pubmethod DeleteCluster(String, String, TimeSpan)

System_CAPS_pubmethod DeleteCluster(String, TimeSpan)

Submits a request synchronously to delete an HDInsight cluster and waits for it to complete.

System_CAPS_pubmethod DeleteClusterAsync(String)

Submits a request asynchronously to delete an HDInsight cluster.

System_CAPS_pubmethod DeleteClusterAsync(String, String)

System_CAPS_pubmethod DisableHttp(String, String)

Disables HTTP connectivity on the HDInsight cluster synchronously.

System_CAPS_pubmethod DisableHttpAsync(String, String)

Disables HTTP connectivity on the HDInsight cluster asychronously.

System_CAPS_pubmethod DisableRdp(String, String)

System_CAPS_pubmethod DisableRdpAsync(String, String)

System_CAPS_pubmethod Dispose()

(Inherited from DisposableObject.)

System_CAPS_pubmethod EnableHttp(String, String, String, String)

Enables HTTP connectivity on the HDInsight cluster synchronously.

System_CAPS_pubmethod EnableHttpAsync(String, String, String, String)

Enables HTTP connectivity on the HDInsight cluster asynchro nously.

System_CAPS_pubmethod EnableRdp(String, String, String, String, DateTime)

System_CAPS_pubmethod EnableRdpAsync(String, String, String, String, DateTime)

System_CAPS_pubmethodSystem_CAPS_static EncryptAsBase64String(X509Certificate2, String)

Encrypt payload string into a base 64-encoded string using the certificate. This is suitable for encrypting storage account keys for later use as a job argument.

System_CAPS_pubmethod Equals(Object)

(Inherited from Object.)

System_CAPS_pubmethod GetCluster(String)

Queries for a specific HDInsight Cluster registered in the subscription synchronously.

System_CAPS_pubmethod GetCluster(String, String)

System_CAPS_pubmethod GetClusterAsync(String)

Queries for a specified HDInsight Cluster asynchronously.

System_CAPS_pubmethod GetClusterAsync(String, String)

System_CAPS_pubmethod GetHashCode()

(Inherited from Object.)

System_CAPS_pubmethod GetType()

(Inherited from Object.)

System_CAPS_pubmethod HandleClusterWaitNotifyEvent(ClusterDetails)

Handles the notification events during waiting.

System_CAPS_pubmethod IsDisposed()

(Inherited from DisposableObject.)

System_CAPS_pubmethod ListAvailableLocations()

Queries sychronouslyfor the Azure region locations where the HDInsight service is available to the current subscription.

System_CAPS_pubmethod ListAvailableLocations(OSType)

System_CAPS_pubmethod ListAvailableLocationsAsync()

Queries asychronouslyfor the Azure region locations where the HDInsight service is available to the current subscription.

System_CAPS_pubmethod ListAvailableLocationsAsync(OSType)

System_CAPS_pubmethod ListAvailableVersions()

Queries sychronously the versions of HDInsight that are available to the subscription.

System_CAPS_pubmethod ListAvailableVersionsAsync()

Queries asychronously the versions of HDInsight that are available to the subscription.

System_CAPS_pubmethod ListClusters()

Queries for the HDInsight clusters registered in the current subscription synchronously.

System_CAPS_pubmethod ListClustersAsync()

Queries for the HDInsight clusters registered in the subscription asynchronously.

System_CAPS_pubmethod ListResourceProviderProperties()

Queries for the HDInsight resources providers of the HDInsight Service and their properties.

System_CAPS_pubmethod ListResourceProviderPropertiesAsync()

Asynchronously queries for the HDInsight resources providers of the HDInsight Service and their properties.

System_CAPS_pubmethod RaiseClusterProvisioningEvent(Object, ClusterProvisioningStatusEventArgs)

Raises the cluster provisioning event.

System_CAPS_pubmethod RemoveLogWriter(ILogWriter)

(Inherited from ClientBase.)

System_CAPS_pubmethod SetCancellationSource(CancellationTokenSource)

Allows a user to set a custom cancellation source.(Inherited from ClientBase.)

System_CAPS_pubmethod ToString()

(Inherited from Object.)

Events

Name Description
System_CAPS_pubevent ClusterProvisioning

Event that occurs when the client provisions a cluster.

Remarks

Provides implementation for the IHDInsightClient interface.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Microsoft.WindowsAzure.Management.HDInsight Namespace

Return to top