「シンプルMQ β」は、ソフトウェア同士を非同期に連携するために、ソフトウェアコンポーネント間でのデータの送受信ができる、マネージド型のメッセージキューサービスです。
シンプルMQを使うには、さくらのクラウド コントロールパネルでシンプルMQのキューを作成します。
キューを作成するとAPIキーが発行されます。
APIリクエストは、そのキーを Auhorization header の Bearer token に使用します。
APIエンドポイント：https://simplemq.tk1b.api.sacloud.jp
キューに対するメッセージのsend (enqueue)
| queueName required | string (QueueName) [ 5 .. 64 ] characters ^[0-9a-zA-Z]+(-[0-9a-zA-Z]+)*$ Example: my-own-queue-00 キュー名 |
| content required | string (MessageContent) <= 256000 characters ^[0-9a-zA-Z+/=]*$ メッセージ本文 |
{- "content": "string"
}{- "result": "success",
- "message": {
- "id": "0193b878-1b25-7775-87f5-9c698206a7e7",
- "content": "string",
- "created_at": 0,
- "updated_at": 0,
- "expires_at": 0
}
}キューに対するメッセージのreceive (dequeue)
| queueName required | string (QueueName) [ 5 .. 64 ] characters ^[0-9a-zA-Z]+(-[0-9a-zA-Z]+)*$ Example: my-own-queue-00 キュー名 |
{- "result": "success",
- "messages": [
- {
- "id": "0193b878-1b25-7775-87f5-9c698206a7e7",
- "content": "string",
- "created_at": 0,
- "updated_at": 0,
- "expires_at": 0,
- "acquired_at": 0,
- "visibility_timeout_at": 0
}
]
}メッセージのタイムアウトをキューの設定値で延長
| queueName required | string (QueueName) [ 5 .. 64 ] characters ^[0-9a-zA-Z]+(-[0-9a-zA-Z]+)*$ Example: my-own-queue-00 キュー名 |
| messageId required | string (MessageId) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 0193b878-1b25-7775-87f5-9c698206a7e7 メッセージID |
{- "result": "success"
}読み取り済みのメッセージを削除 (ack)
| queueName required | string (QueueName) [ 5 .. 64 ] characters ^[0-9a-zA-Z]+(-[0-9a-zA-Z]+)*$ Example: my-own-queue-00 キュー名 |
| messageId required | string (MessageId) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]... Example: 0193b878-1b25-7775-87f5-9c698206a7e7 メッセージID |
{- "result": "success"
}