队列和消息标识符

最近更新时间:2018-11-26 17:50:56

使用腾讯云 CMQ 时,用户首先需要熟悉以下三个标识符:队列名称、消息 ID 和接收句柄。

1. 队列名称

创建新队列时,用户必须提供在此地域范围内唯一的队列名称,不同地域间队列名称可以重复。腾讯云 CMQ 使用地域和队列名称唯一标识一个队列,每当用户要对队列执行操作时,都需要提供这两个参数。

2. 消息 ID

每条消息都会收到一个由腾讯云系统分配的消息 ID,该 ID 可由 SendMessage 接口请求中返回给用户。此标识符用于识别消息。需要注意的是,删除消息时用户需要消息的接收句柄,而不是消息 ID。消息 ID 有形如“Msg-XXXXXXXX”的样式。

3. 接收句柄

每当收到来自队列的消息时,用户都会收到该消息的接收句柄。消息句柄始终与接收消息的操作相关联,与消息本身无关。要删除消息或更改消息属性,用户则必须提供接收句柄,而不是消息 ID。这意味着,必须始终先接收消息,然后才能删除/更改它。

注:如果多次接收某条消息,则每次接收该消息时,用户都会获得不同的接收句柄。在请求删除该消息时,您必须提供最近收到的接收句柄,否则可能无法删除该消息。