PageBlobClient.UpdateSequenceNumber Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The UpdateSequenceNumber(SequenceNumberAction, Nullable<Int64>, PageBlobRequestConditions, CancellationToken) operation changes the
sequence number action
and sequenceNumber
for this page blob.
For more information, see Set Blob Properties.
public virtual Azure.Response<Azure.Storage.Blobs.Models.PageBlobInfo> UpdateSequenceNumber (Azure.Storage.Blobs.Models.SequenceNumberAction action, long? sequenceNumber = default, Azure.Storage.Blobs.Models.PageBlobRequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member UpdateSequenceNumber : Azure.Storage.Blobs.Models.SequenceNumberAction * Nullable<int64> * Azure.Storage.Blobs.Models.PageBlobRequestConditions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.PageBlobInfo>
override this.UpdateSequenceNumber : Azure.Storage.Blobs.Models.SequenceNumberAction * Nullable<int64> * Azure.Storage.Blobs.Models.PageBlobRequestConditions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.PageBlobInfo>
Public Overridable Function UpdateSequenceNumber (action As SequenceNumberAction, Optional sequenceNumber As Nullable(Of Long) = Nothing, Optional conditions As PageBlobRequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of PageBlobInfo)
Parameters
- action
- SequenceNumberAction
Specifies how the service should modify the blob's sequence number.
Max sets the sequence number to
be the higher of the value included with the request and the value
currently stored for the blob. Update
sets the sequence number to the sequenceNumber
value. Increment increments
the value of the sequence number by 1. If specifying
Increment, do not include the
sequenceNumber
because that will throw a
RequestFailedException.
An updated sequence number of your choosing, if
action
is Max
or Update. The value should
not be provided if action
is
Increment. The sequence number
is a user-controlled property that you can use to track requests
and manage concurrency issues via PageBlobRequestConditions.
- conditions
- PageBlobRequestConditions
Optional PageBlobRequestConditions to add conditions on updating the sequence number of this page blob.
- cancellationToken
- CancellationToken
Optional CancellationToken to propagate notifications that the operation should be cancelled.
Returns
A Response<T> describing the updated page blob.
Remarks
A RequestFailedException will be thrown if a failure occurs.