Share via


FabricClient.TestManagementClient.StartPartitionDataLossAsync Method

Definition

Overloads

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode, TimeSpan, CancellationToken)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode, TimeSpan)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode, CancellationToken)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode, TimeSpan, CancellationToken)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

public System.Threading.Tasks.Task StartPartitionDataLossAsync (Guid operationId, System.Fabric.PartitionSelector partitionSelector, System.Fabric.DataLossMode dataLossMode, TimeSpan operationTimeout, System.Threading.CancellationToken cancellationToken);
member this.StartPartitionDataLossAsync : Guid * System.Fabric.PartitionSelector * System.Fabric.DataLossMode * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function StartPartitionDataLossAsync (operationId As Guid, partitionSelector As PartitionSelector, dataLossMode As DataLossMode, operationTimeout As TimeSpan, cancellationToken As CancellationToken) As Task

Parameters

operationId
Guid

A GUID that identifies a call of this API; this is passed into the corresponding GetProgress API

partitionSelector
PartitionSelector

The PartitionSelector to specify which partition data loss needs to be induced for.

dataLossMode
DataLossMode

Specifies the DataLossMode i.e. the options for inducing data loss.

operationTimeout
TimeSpan

The overall timeout for the operation

cancellationToken
CancellationToken

This token can be signalled to abort this operation before it finishes

Returns

A task.

Exceptions

Action took more than its allocated time.

Any of the required arguments are null.

If the API is called for a partition belonging to a stateless service.

These are the fabric failures FabricErrorCode.PartitionNotFound - if the specified partition selected does not exist.

Remarks

Actual data loss will depend on the specified DataLossMode PartialDataLoss - PartialDataLoss - Only a quorum of replicas are removed and OnDataLoss is triggered for the partition but actual data loss depends on presence of in-flight replication. FullDataLoss - All replicas are removed hence all data is lost and OnDataLoss is triggered.

This API should only be called with a stateful service as the target.

Calling this API with a system service as the target is not advised.

The FaultAnalysisService must be enabled to use this API.

Note: Once this API has been called, it cannot be reversed. Calling CancelTestCommandAsync() will only stop execution and clean up internal system state. It will not restore data if the command has progressed far enough to cause data loss.

Applies to

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode, TimeSpan)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

public System.Threading.Tasks.Task StartPartitionDataLossAsync (Guid operationId, System.Fabric.PartitionSelector partitionSelector, System.Fabric.DataLossMode dataLossMode, TimeSpan operationTimeout);
member this.StartPartitionDataLossAsync : Guid * System.Fabric.PartitionSelector * System.Fabric.DataLossMode * TimeSpan -> System.Threading.Tasks.Task
Public Function StartPartitionDataLossAsync (operationId As Guid, partitionSelector As PartitionSelector, dataLossMode As DataLossMode, operationTimeout As TimeSpan) As Task

Parameters

operationId
Guid

A GUID that identifies a call of this API; this is passed into the corresponding GetProgress API

partitionSelector
PartitionSelector

The PartitionSelector to specify which partition data loss needs to be induced for.

dataLossMode
DataLossMode

Specifies the DataLossMode i.e. the options for inducing data loss.

operationTimeout
TimeSpan

The overall timeout for the operation

Returns

A task.

Exceptions

Action took more than its allocated time.

Any of the required arguments are null.

If the API is called for a partition belonging to a stateless service.

These are the fabric failures FabricErrorCode.PartitionNotFound - if the specified partition selected does not exist.

Remarks

Actual data loss will depend on the specified DataLossMode PartialDataLoss - PartialDataLoss - Only a quorum of replicas are removed and OnDataLoss is triggered for the partition but actual data loss depends on presence of in-flight replication. FullDataLoss - All replicas are removed hence all data is lost and OnDataLoss is triggered.

This API should only be called with a stateful service as the target.

Calling this API with a system service as the target is not advised.

The FaultAnalysisService must be enabled to use this API.

Note: Once this API has been called, it cannot be reversed. Calling CancelTestCommandAsync() will only stop execution and clean up internal system state. It will not restore data if the command has progressed far enough to cause data loss.

Applies to

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

public System.Threading.Tasks.Task StartPartitionDataLossAsync (Guid operationId, System.Fabric.PartitionSelector partitionSelector, System.Fabric.DataLossMode dataLossMode);
member this.StartPartitionDataLossAsync : Guid * System.Fabric.PartitionSelector * System.Fabric.DataLossMode -> System.Threading.Tasks.Task
Public Function StartPartitionDataLossAsync (operationId As Guid, partitionSelector As PartitionSelector, dataLossMode As DataLossMode) As Task

Parameters

operationId
Guid

A GUID that identifies a call of this API; this is passed into the corresponding GetProgress API.

partitionSelector
PartitionSelector

The PartitionSelector to specify which partition data loss needs to be induced.

dataLossMode
DataLossMode

Specifies the DataLossMode i.e. the options for inducing data loss.

Returns

A task.

Exceptions

Action took more than its allocated time.

Any of the required arguments are null.

If the API is called for a partition belonging to a stateless service.

These are the fabric failures. FabricErrorCode.PartitionNotFound - If the specified partition selected does not exist.

Remarks

Actual data loss will depend on the specified DataLossMode. PartialDataLoss - Only a quorum of replicas are removed and OnDataLoss is triggered for the partition but actual data loss depends on presence of in-flight replication. FullDataLoss - All replicas are removed hence all data is lost and OnDataLoss is triggered.

This API should only be called with a stateful service as the target.

Calling this API with a system service as the target is not advised.

Note: Once this API has been called, it cannot be reversed. Calling CancelTestCommandAsync() will only stop execution and clean up internal system state. It will not restore data if the command has progressed far enough to cause data loss.

The FaultAnalysisService must be enabled to use this API.

Applies to

StartPartitionDataLossAsync(Guid, PartitionSelector, DataLossMode, CancellationToken)

This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.

public System.Threading.Tasks.Task StartPartitionDataLossAsync (Guid operationId, System.Fabric.PartitionSelector partitionSelector, System.Fabric.DataLossMode dataLossMode, System.Threading.CancellationToken cancellationToken);
member this.StartPartitionDataLossAsync : Guid * System.Fabric.PartitionSelector * System.Fabric.DataLossMode * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function StartPartitionDataLossAsync (operationId As Guid, partitionSelector As PartitionSelector, dataLossMode As DataLossMode, cancellationToken As CancellationToken) As Task

Parameters

operationId
Guid

A GUID that identifies a call of this API; this is passed into the corresponding GetProgress API

partitionSelector
PartitionSelector

The PartitionSelector to specify which partition data loss needs to be induced for.

dataLossMode
DataLossMode

Specifies the DataLossMode i.e. the options for inducing data loss.

cancellationToken
CancellationToken

This token can be signalled to abort this operation before it finishes

Returns

A task.

Exceptions

Action took more than its allocated time.

Any of the required arguments are null.

If the API is called for a partition belonging to a stateless service.

These are the fabric failures FabricErrorCode.PartitionNotFound - if the specified partition selected does not exist.

Remarks

Actual data loss will depend on the specified DataLossMode PartialDataLoss - PartialDataLoss - Only a quorum of replicas are removed and OnDataLoss is triggered for the partition but actual data loss depends on presence of inflight replication. FullDataLoss - All replicas are removed hence all data is lost and OnDataLoss is triggered.

This API should only be called with a stateful service as the target.

Calling this API with a system service as the target is not advised.

The FaultAnalysisService must be enabled to use this API.

Note: Once this API has been called, it cannot be reversed. Calling CancelTestCommandAsync() will only stop execution and clean up internal system state. It will not restore data if the command has progressed far enough to cause data loss.

Applies to