Packages > @fluidframework/azure-client > AzureClient

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

Constructor Description
(constructor)(props) Creates a new client instance using configuration parameters.

Methods

Method Return Type Description
copyContainer(id, containerSchema, version) Promise<{ container: IFluidContainer; services: AzureContainerServices; }> Creates new detached container out of specific version of another container.
createContainer(containerSchema) Promise<{ container: IFluidContainer; services: AzureContainerServices; }> Creates a new detached container instance in the Azure Fluid Relay.
getContainer(id, containerSchema) Promise<{ container: IFluidContainer; 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.

Constructor Details

(constructor)

Creates a new client instance using configuration parameters.

Signature

constructor(props: AzureClientProps);

Parameters

Parameter Type Description
props AzureClientProps Properties for initializing a new AzureClient instance

Method Details

copyContainer

Creates new detached container out of specific version of another container.

Signature

copyContainer(id: string, containerSchema: ContainerSchema, version?: AzureContainerVersion): Promise<{
        container: IFluidContainer;
        services: AzureContainerServices;
    }>;

Parameters

Parameter Modifiers Type Description
id string Unique ID of the source container in Azure Fluid Relay.
containerSchema ContainerSchema Container schema used to access data objects in the container.
version optional AzureContainerVersion Unique version of the source container in Azure Fluid Relay. It defaults to latest version if parameter not provided.

Returns

New detached container instance along with associated services.

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

createContainer

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

Signature

createContainer(containerSchema: ContainerSchema): Promise<{
        container: IFluidContainer;
        services: AzureContainerServices;
    }>;

Parameters

Parameter Type Description
containerSchema ContainerSchema Container schema for the new container.

Returns

New detached container instance along with associated services.

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

getContainer

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

Signature

getContainer(id: string, containerSchema: ContainerSchema): Promise<{
        container: IFluidContainer;
        services: AzureContainerServices;
    }>;

Parameters

Parameter Type Description
id string Unique ID of the container in Azure Fluid Relay.
containerSchema ContainerSchema Container schema used to access data objects in the container.

Returns

Existing container instance along with associated services.

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

getContainerVersions

Get the list of versions for specific container.

Signature

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

Parameters

Parameter Modifiers Type Description
id string Unique ID of the source container in Azure Fluid Relay.
options optional AzureGetVersionsOptions "Get" options. If options are not provided, API will assume maxCount of versions to retreive to be 5.

Returns

Array of available container versions.

Return type: Promise<AzureContainerVersion []>