Message and Queue Attributes
Table of Contents
The message structure is flexible and straight-forward. Messages can be variable in size and can contain almost any text or data format.
|Token||OAuth2 access token|
|Message body||ASCII text|
The basic message handling operation is put-get-delete. Messages are put on the queue by senders. The messages can have delays associated with them. If included, the message is not made available on the queue until the delay is up (default is 0 or no delay).
Receivers get one or more messages (up to 100). Once the receiver is done processing a message, it deletes it. If a message is not deleted prior to the timeout (default 60 sec), it is put back on the queue. Messages on the queue will expire after a certain amount of time (default is 7 days).
|Message Size||dependent on plan||64KB, 256KB||Includes the entire request (delay, timeout, expiration). Limit will vary depending on current plan. Please view plan comparision page here. If message size limits higher than 256KB are needed, please contact email@example.com.|
|Delay||0sec||604,800sec||Message is made available on queue after the delay expires.|
|Timeout||60sec||86,400sec||Message goes back on queue after timeout unless deleted.|
|Expiration||604,800sec||2,592,000sec||Equates to 7 days and 30 days, respectively.|
|Messages per Get||1||100||One or more messages can be handled at a time.|
Queues have their own set of attributes. To get the information about a queue, use the Info API call. The following is a list of all the queue attributes:
|Name of the queue. (Names with spaces should URL encode/use "%20".)|
|Unique queue's ID.|
|Current queue size. It's usually 0 for Push Queues.|
|Number of messages which were posted to the queue.|
|ID of the project that owns the queue.|
Attributes Related to Push Queues
|Push queue type. Either |
|Maximum number of times messages will be sent to each HTTP endpoint. Messages will not be resent after a call receives an HTTP response with a status code of 200. Default is 3 seconds. Maximum is 100 seconds.|
|Delay between retries in seconds. Default is 60 seconds. Minimum is 3 and maximum is 86400 seconds.|
|List of subscribers, format is |
||Enable error queue |
Security Groups and IP Ranges
Iron.io provides an AWS security group for IronMQ, generally used in the case of push queues, in the event users want to isolate AWS EC2, RDS, or other services to these groups/ranges.
|EC2 Security Group||Account ID||Security Group String|