ConnectionPolicy interface

Package:

@azure/cosmos

Represents the Connection policy associated with a CosmosClient in the Azure Cosmos DB database service.

Properties

connectionMode	Determines which mode to connect to Cosmos with. (Currently only supports Gateway option)
enableBackgroundEndpointRefreshing	Flag to enable/disable background refreshing of endpoints. Defaults to false. Endpoint discovery using enableEndpointsDiscovery will still work for failed requests.
enableEndpointDiscovery	Flag to enable/disable automatic redirecting of requests based on read/write operations. Default true. Required to call client.dispose() when this is set to true after destroying the CosmosClient inside another process or in the browser.
endpointRefreshRateInMs	Rate in milliseconds at which the client will refresh the endpoints list in the background
preferredLocations	List of azure regions to be used as preferred locations for read requests.
requestTimeout	Request timeout (time to wait for response from network peer). Represented in milliseconds.
retryOptions	RetryOptions object which defines several configurable properties used during retry.
useMultipleWriteLocations	The flag that enables writes on any locations (regions) for geo-replicated database accounts in the Azure Cosmos DB service. Default is false.

Property Details

connectionMode

Determines which mode to connect to Cosmos with. (Currently only supports Gateway option)

connectionMode?: Gateway

Property Value

Gateway

enableBackgroundEndpointRefreshing

Flag to enable/disable background refreshing of endpoints. Defaults to false. Endpoint discovery using enableEndpointsDiscovery will still work for failed requests.

enableBackgroundEndpointRefreshing?: boolean

Property Value

boolean

enableEndpointDiscovery

Flag to enable/disable automatic redirecting of requests based on read/write operations. Default true. Required to call client.dispose() when this is set to true after destroying the CosmosClient inside another process or in the browser.

enableEndpointDiscovery?: boolean

Property Value

boolean

endpointRefreshRateInMs

Rate in milliseconds at which the client will refresh the endpoints list in the background

endpointRefreshRateInMs?: number

Property Value

number

preferredLocations

List of azure regions to be used as preferred locations for read requests.

preferredLocations?: string[]

Property Value

string[]

requestTimeout

Request timeout (time to wait for response from network peer). Represented in milliseconds.

requestTimeout?: number

Property Value

number

retryOptions

RetryOptions object which defines several configurable properties used during retry.

retryOptions?: RetryOptions

Property Value

RetryOptions

useMultipleWriteLocations

The flag that enables writes on any locations (regions) for geo-replicated database accounts in the Azure Cosmos DB service. Default is false.

useMultipleWriteLocations?: boolean

Property Value

boolean