Skip to main content
Version: v1

HostStoragePolicy Interface

Signature​

export interface HostStoragePolicy

Properties​

PropertyAlertsModifiersTypeDescription
cacheCreateNewSummaryoptionalbooleanPolicy controlling if we will cache initial summary when we create a document
concurrentOpsBatchesoptionalnumber
concurrentSnapshotFetchoptionalbooleanIf set to true, tells driver to concurrently fetch snapshot from storage (SPO) and cache Container loads from whatever comes first in such case. Snapshot fetched from storage is pushed to cache in either case. If set to false, driver will first consult with cache. Only on cache miss (cache does not return snapshot), driver will fetch snapshot from storage (and push it to cache), otherwise it will load from cache and not reach out to storage. Passing true results in faster loads and keeping cache more current, but it increases bandwidth consumption.
enableRedeemFallbackDeprecatedoptionalboolean
enableShareLinkWithCreateoptionalbooleanEnable creation of sharing link along with the creation of file by setting this value to true. If the host provides a 'createLinkType' parameter in the request URL to the container.attach() method, we will request for send the request to ODSP with the same (if the flag is enabled) so that a sharing can be created with the creation of file to save number for round trips made to ODSP.
fetchBinarySnapshotFormatDeprecatedoptionalboolean
isolateSocketCacheoptionalbooleanIf set to true, socket cache are per OdspDocumentService instead of shared across all instances
opsBatchSizeoptionalnumber
opsCachingoptionalIOpsCachingPolicyPolicy controlling ops caching (leveraging IPersistedCache passed to driver factory)
sessionOptionsoptionalICollabSessionOptionsPolicy controlling how collaboration session is established
snapshotOptionsoptionalISnapshotOptions

Property Details​

cacheCreateNewSummary​

Policy controlling if we will cache initial summary when we create a document

Signature​

cacheCreateNewSummary?: boolean;

Type: boolean

concurrentOpsBatches​

Signature​

concurrentOpsBatches?: number;

Type: number

concurrentSnapshotFetch​

If set to true, tells driver to concurrently fetch snapshot from storage (SPO) and cache Container loads from whatever comes first in such case. Snapshot fetched from storage is pushed to cache in either case. If set to false, driver will first consult with cache. Only on cache miss (cache does not return snapshot), driver will fetch snapshot from storage (and push it to cache), otherwise it will load from cache and not reach out to storage. Passing true results in faster loads and keeping cache more current, but it increases bandwidth consumption.

Signature​

concurrentSnapshotFetch?: boolean;

Type: boolean

enableRedeemFallback​

This API is deprecated and will be removed in a future release.
  • This field will be always set to true after removal. True to have the sharing link redeem fallback in case the Trees Latest/Redeem 1RT call fails with redeem error. During fallback it will first redeem the sharing link and then make the Trees latest call.

Signature​

enableRedeemFallback?: boolean;

Type: boolean

enableShareLinkWithCreate​

Enable creation of sharing link along with the creation of file by setting this value to true. If the host provides a 'createLinkType' parameter in the request URL to the container.attach() method, we will request for send the request to ODSP with the same (if the flag is enabled) so that a sharing can be created with the creation of file to save number for round trips made to ODSP.

Signature​

enableShareLinkWithCreate?: boolean;

Type: boolean

fetchBinarySnapshotFormat​

This API is deprecated and will be removed in a future release.
  • This will be replaced with feature gate snapshotFormatFetchType. Policy controlling if we want to fetch binary format snapshot.

Signature​

fetchBinarySnapshotFormat?: boolean;

Type: boolean

isolateSocketCache​

If set to true, socket cache are per OdspDocumentService instead of shared across all instances

Signature​

isolateSocketCache?: boolean;

Type: boolean

opsBatchSize​

Signature​

opsBatchSize?: number;

Type: number

opsCaching​

Policy controlling ops caching (leveraging IPersistedCache passed to driver factory)

Signature​

opsCaching?: IOpsCachingPolicy;

Type: IOpsCachingPolicy

sessionOptions​

Policy controlling how collaboration session is established

Signature​

sessionOptions?: ICollabSessionOptions;

Type: ICollabSessionOptions

snapshotOptions​

Signature​

snapshotOptions?: ISnapshotOptions;

Type: ISnapshotOptions