Language

ConfidentialLedgerClientOptions Class

Definition

Client options for ConfidentialLedger library clients.

public class ConfidentialLedgerClientOptions : Azure.Core.ClientOptions
type ConfidentialLedgerClientOptions = class
    inherit ClientOptions
Public Class ConfidentialLedgerClientOptions
Inherits ClientOptions
Inheritance
ConfidentialLedgerClientOptions

Constructors

Name Description
ConfidentialLedgerClientOptions(ConfidentialLedgerClientOptions+ServiceVersion)

Initializes new instance of ConfidentialLedgerClientOptions.

Properties

Name Description
CertificateEndpoint

The Identity Service URL. If not provided, the default endpoint "https://identity.confidential-ledger.core.azure.com" will be used.

Diagnostics

Gets the client diagnostic options.

(Inherited from ClientOptions)
EnableArchivedCollectionFallback

Controls whether a current-entry read transparently falls back to ledger history when a collection's live entry has been archived by collection pruning. Defaults to false.

Failover

Controls the order in which a read request is retried against the ledger's failover endpoints when the primary ledger returns a transient failure. Defaults to Ordered, which preserves the order reported by the identity service. Use Random to shuffle the candidate endpoints and spread load across failover ledgers.

FailoverNetworkTimeout

Optional per-attempt network timeout applied to each failover request. When set, every failover attempt is granted this network timeout, so that time already spent on the failed primary attempt does not consume the failover budget. When null the normal NetworkTimeout applies. Defaults to null.

MaxApplicationIdLength

Gets or sets the maximum allowed length for ApplicationId.

(Inherited from ClientOptions)
Retry

Gets the client retry options.

(Inherited from ClientOptions)
RetryPolicy

Gets or sets the policy to use for retries. If a policy is specified, it will be used in place of the Retry property. The RetryPolicy type can be derived from to modify the default behavior without needing to fully implement the retry logic. If Process(HttpMessage, ReadOnlyMemory<HttpPipelinePolicy>) is overridden or a custom HttpPipelinePolicy is specified, it is the implementer's responsibility to update the ProcessingContext values.

(Inherited from ClientOptions)
Transport

The HttpPipelineTransport to be used for this client. Defaults to an instance of HttpClientTransport.

(Inherited from ClientOptions)
UseLedgerGateway

Set to true when targeting the Confidential Ledger Gateway. When enabled, the client skips the CCF identity-service TLS bootstrap (using standard Azure PKI for TLS validation) and disables primary-node caching in the redirect policy (the gateway may redirect to any healthy host, not a sticky primary). Authentication via client certificate (mTLS) is not supported in this mode; only bearer-token authentication is accepted by the gateway.

VerifyConnection

Boolean determining whether certificate validation will be performed to verify the ledger identity TLS certificate is valid.

Methods

Name Description
AddPolicy(HttpPipelinePolicy, HttpPipelinePosition)

Adds an HttpPipeline policy into the client pipeline. The position of policy in the pipeline is controlled by the position parameter. If you want the policy to execute once per client request use PerCall otherwise use PerRetry to run the policy for every retry. Note that the same instance of policy would be added to all pipelines of client constructed using this ClientOptions object.

(Inherited from ClientOptions)

Applies to