@fluidframework/azure-client Package
Packages > @fluidframework/azure-client
A simple and powerful way to consume collaborative Fluid data with the Azure Fluid Relay.
Interfaces
Interface | Description |
---|---|
AzureClientProps | Props for initializing a new AzureClient instance |
AzureConnectionConfig | Parameters for establishing a connection with the Azure Fluid Relay. |
AzureContainerServices | AzureContainerServices is returned by the AzureClient alongside a FluidContainer. It holds the functionality specifically tied to the Azure Fluid Relay, and how the data stored in the FluidContainer is persisted in the backend and consumed by users. Any functionality regarding how the data is handled within the FluidContainer itself, i.e. which data objects or DDSes to use, will not be included here but rather on the FluidContainer class itself. |
AzureContainerVersion | Container version metadata. |
AzureGetVersionsOptions | Options for "Get Container Versions" API. |
AzureLocalConnectionConfig | Parameters for establishing a local connection with a local instance of the Azure Fluid Relay. |
AzureMember | Since Azure provides user names for all of its members, we extend the @fluidframework/protocol-definitions#IMember interface to include this service-specific value. It will be returned for all audience members connected to Azure. |
AzureRemoteConnectionConfig | Parameters for establishing a remote connection with the Azure Fluid Relay. |
AzureUser | Since Azure provides user names for all of its members, we extend the IUser interface to include this service-specific value. * |
ITokenClaims |
JSON Web Token (JWT) Claims |
ITokenProvider | Abstracts the token fetching mechanism for a hosting application. The hosting application is responsible for providing an implementation. |
ITokenResponse | |
IUser | Base user definition. It is valid to extend this interface when adding new details to the user object. |
Classes
Class | Alerts | Description |
---|---|---|
AzureAudience | Azure-specific ServiceAudience implementation. | |
AzureClient | 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. | |
AzureFunctionTokenProvider |
DEPRECATED
|
Token Provider implementation for connecting to an Azure Function endpoint for Azure Fluid Relay token resolution. |
Enumerations
Enum | Description |
---|---|
ContainerErrorType | Different error types the Container may report out to the Host |
ScopeType | Defines scope access for a Container/Document |
Types
TypeAlias | Description |
---|---|
AzureConnectionConfigType | The type of connection. - "local" for local connections to a Fluid relay instance running on the localhost - "remote" for client connections to the Azure Fluid Relay service |
IAzureAudience | Audience object for Azure Fluid Relay containers |
ICriticalContainerError | Represents errors raised on container. |
Enumeration Details
ContainerErrorType
Different error types the Container may report out to the Host
Signature
export declare enum ContainerErrorType
Flags
Flag | Description |
---|---|
clientSessionExpiredError | Error indicating an client session has expired. Currently this only happens when GC is allowed on a document and aids in safely deleting unused objects. |
dataCorruptionError | Data loss error detected by Container / DeltaManager. Likely points to storage issue. |
dataProcessingError | Error encountered when processing an operation. May correlate with data corruption. |
genericError | Some error, most likely an exception caught by runtime and propagated to container as critical error |
throttlingError | Throttling error from server. Server is busy and is asking not to reconnect for some time |
usageError | Error indicating an API is being used improperly resulting in an invalid operation. |
clientSessionExpiredError
Error indicating an client session has expired. Currently this only happens when GC is allowed on a document and aids in safely deleting unused objects.
Signature
clientSessionExpiredError = "clientSessionExpiredError"
dataCorruptionError
Data loss error detected by Container / DeltaManager. Likely points to storage issue.
Signature
dataCorruptionError = "dataCorruptionError"
dataProcessingError
Error encountered when processing an operation. May correlate with data corruption.
Signature
dataProcessingError = "dataProcessingError"
genericError
Some error, most likely an exception caught by runtime and propagated to container as critical error
Signature
genericError = "genericError"
throttlingError
Throttling error from server. Server is busy and is asking not to reconnect for some time
Signature
throttlingError = "throttlingError"
usageError
Error indicating an API is being used improperly resulting in an invalid operation.
Signature
usageError = "usageError"
ScopeType
Defines scope access for a Container/Document
Signature
export declare enum ScopeType
Flags
Flag | Description |
---|---|
DocRead | Read access is supported on the Container/Document |
DocWrite | Write access is supported on the Container/Document |
SummaryWrite | User can generate new summaries operations |
DocRead
Read access is supported on the Container/Document
Signature
DocRead = "doc:read"
DocWrite
Write access is supported on the Container/Document
Signature
DocWrite = "doc:write"
SummaryWrite
User can generate new summaries operations
Signature
SummaryWrite = "summary:write"
Type Details
AzureConnectionConfigType
The type of connection. - “local” for local connections to a Fluid relay instance running on the localhost - “remote” for client connections to the Azure Fluid Relay service
Signature
export declare type AzureConnectionConfigType = "local" | "remote";
IAzureAudience
Audience object for Azure Fluid Relay containers
Signature
export declare type IAzureAudience = IServiceAudience<AzureMember>;
ICriticalContainerError
Represents errors raised on container.
Signature
export declare type ICriticalContainerError = IErrorBase;