Click or drag to resize
IQueueingServiceClaimMessageAsync Method
This API is preliminary and subject to change.
Claim messages from a queue.

Namespace: net.openstack.Core.Providers
Assembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax
Task<Claim> ClaimMessageAsync(
	QueueName queueName,
	Nullable<int> limit,
	TimeSpan timeToLive,
	TimeSpan gracePeriod,
	CancellationToken cancellationToken
)

Parameters

queueName
Type: net.openstack.Core.Domain.QueuesQueueName
The queue name.
limit
Type: SystemNullableInt32
The maximum number of messages to claim. If this value is , a provider-specific default value is used.
timeToLive
Type: SystemTimeSpan
The time to wait before the server automatically releases the claim.
gracePeriod
Type: SystemTimeSpan
The time to wait, after the time-to-live for the claim expires, before the server allows the claimed messages to be deleted due to the individual message's time-to-live expiring.
cancellationToken
Type: System.ThreadingCancellationToken
The CancellationToken that the task will observe.

Return Value

Type: TaskClaim
A Task object representing the asynchronous operation. When the task completes successfully, the Result property will contain Claim object representing the claim.
Exceptions
ExceptionCondition
ArgumentNullExceptionIf queueName is .
ArgumentOutOfRangeException If limit is less than or equal to 0.

-or-

If timeToLive is negative or Zero.

-or-

If gracePeriod is negative.

WebExceptionIf the REST request does not return successfully.
Remarks

When the claim is no longer required, the code should call DisposeAsync(CancellationToken) or Dispose to ensure the following actions are taken.

  • Messages which are part of this claim which were not processed are made available to other nodes.
  • The claim resource is cleaned up without waiting for the time-to-live to expire.

Messages which are not deleted before the claim is released will be eligible for reclaiming by another process.

Version Information

.NET Framework

Supported in: 4.5

openstack.net

Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also