Skip to main content

AzureClient Class

AzureClient provides the ability to have a Fluid object backed by the Azure Fluid Relay or, when running with local tenantId, have it be backed by a local Azure Fluid Relay instance.

Signature

export declare class AzureClient

Constructors

ConstructorDescription
(constructor)(properties)Creates a new client instance using configuration parameters.

Methods

MethodReturn TypeDescription
createContainer(containerSchema, compatibilityMode)Promise<{ container: IFluidContainer<TContainerSchema>; services: AzureContainerServices; }>Creates a new detached container instance in the Azure Fluid Relay.
getContainer(id, containerSchema, compatibilityMode)Promise<{ container: IFluidContainer<TContainerSchema>; services: AzureContainerServices; }>Accesses the existing container given its unique ID in the Azure Fluid Relay.
getContainerVersions(id, options)Promise<AzureContainerVersion[]>Get the list of versions for specific container.
viewContainerVersion(id, containerSchema, version, compatibilityMode)Promise<{ container: IFluidContainer<TContainerSchema>; }>Load a specific version of a container for viewing only.

Constructor Details

(constructor)

Creates a new client instance using configuration parameters.

Signature

constructor(properties: AzureClientProps);

Parameters

ParameterTypeDescription
propertiesAzureClientPropsProperties for initializing a new AzureClient instance

Method Details

createContainer

Creates a new detached container instance in the Azure Fluid Relay.

Signature

createContainer<const TContainerSchema extends ContainerSchema>(containerSchema: TContainerSchema, compatibilityMode: CompatibilityMode): Promise<{
container: IFluidContainer<TContainerSchema>;
services: AzureContainerServices;
}>;
Type Parameters
ParameterConstraintDescription
TContainerSchemaContainerSchemaUsed to infer the the type of 'initialObjects' in the returned container. (normally not explicitly specified.)

Parameters

ParameterTypeDescription
containerSchemaTContainerSchemaContainer schema for the new container.
compatibilityModeCompatibilityModeCompatibility mode the container should run in.

Returns

New detached container instance along with associated services.

Return type: Promise<{ container: IFluidContainer<TContainerSchema>; services: AzureContainerServices; }>

getContainer

Accesses the existing container given its unique ID in the Azure Fluid Relay.

Signature

getContainer<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, compatibilityMode: CompatibilityMode): Promise<{
container: IFluidContainer<TContainerSchema>;
services: AzureContainerServices;
}>;
Type Parameters
ParameterConstraintDescription
TContainerSchemaContainerSchemaUsed to infer the the type of 'initialObjects' in the returned container. (normally not explicitly specified.)

Parameters

ParameterTypeDescription
idstringUnique ID of the container in Azure Fluid Relay.
containerSchemaTContainerSchemaContainer schema used to access data objects in the container.
compatibilityModeCompatibilityModeCompatibility mode the container should run in.

Returns

Existing container instance along with associated services.

Return type: Promise<{ container: IFluidContainer<TContainerSchema>; services: AzureContainerServices; }>

getContainerVersions

Get the list of versions for specific container.

Signature

getContainerVersions(id: string, options?: AzureGetVersionsOptions): Promise<AzureContainerVersion[]>;

Parameters

ParameterModifiersTypeDescription
idstringUnique ID of the source container in Azure Fluid Relay.
optionsoptionalAzureGetVersionsOptions"Get" options. If options are not provided, API will assume maxCount of versions to retrieve to be 5.

Returns

Array of available container versions.

Return type: Promise<AzureContainerVersion[]>

viewContainerVersion

Load a specific version of a container for viewing only.

Signature

viewContainerVersion<TContainerSchema extends ContainerSchema>(id: string, containerSchema: TContainerSchema, version: AzureContainerVersion, compatibilityMode: CompatibilityMode): Promise<{
container: IFluidContainer<TContainerSchema>;
}>;
Type Parameters
ParameterConstraintDescription
TContainerSchemaContainerSchemaUsed to infer the the type of 'initialObjects' in the returned container. (normally not explicitly specified.)

Parameters

ParameterTypeDescription
idstringUnique ID of the source container in Azure Fluid Relay.
containerSchemaTContainerSchemaContainer schema used to access data objects in the container.
versionAzureContainerVersionUnique version of the source container in Azure Fluid Relay.
compatibilityModeCompatibilityModeCompatibility mode the container should run in.

Returns

Loaded container instance at the specified version.

Return type: Promise<{ container: IFluidContainer<TContainerSchema>; }>