Queue是指消息隊(duì)列,云消息隊(duì)列 RabbitMQ 版的消息都會(huì)被發(fā)送至指定的Exchange,再由Exchange路由至綁定的Queue中。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語(yǔ)句的Action
元素中使用,用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別:是指每個(gè)操作的訪問級(jí)別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
amqp:CreateQueue | create | *Queue acs:amqp:{#regionId}:{#accountId}:/instances/{#instanceId}/vhosts/{#vhostName}/queues/* |
| 無(wú) |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 待創(chuàng)建 Queue 所屬的云消息隊(duì)列 RabbitMQ 版實(shí)例 ID。 | amqp-cn-v0h1kb9nu*** |
VirtualHost | string | 是 | 待創(chuàng)建 Queue 所屬的 Vhost 名稱。 只能包含字?、數(shù)字、短劃線(-)、下劃線(_)、半角句號(hào)(.)、井號(hào)(#)、正斜線(/)、at 符號(hào)(@),?度限制 1~255 字符。 | test |
QueueName | string | 是 | 待創(chuàng)建的 Queue 的名稱。
| DemoQueue |
AutoDeleteState | boolean | 否 | 是否自動(dòng)刪除。取值:
| false |
ExclusiveState | boolean | 否 | 是否為排他性 Exchange。取值:
| false |
MessageTTL | long | 否 | 消息在 Queue 中的有效期。
| 1000 |
AutoExpireState | long | 否 | Queue 的自動(dòng)過期時(shí)間。如果 Queue 在指定時(shí)間內(nèi)沒有被訪問,則會(huì)被自動(dòng)刪除。 單位為毫秒。 說(shuō)明
該參數(shù)對(duì)應(yīng)的功能需要開通后才能使用。如需使用,請(qǐng)提交工單開通。
| 10000 |
MaxLength | long | 否 | 當(dāng)前版本不支持該參數(shù)。 Queue 中消息的最大數(shù)量。如果超出該數(shù)量,則先到達(dá)該 Queue 的消息將會(huì)被刪除。 | 1000 |
DeadLetterExchange | string | 否 | 死信 Exchange。該類 Exchange 是用來(lái)接收被拒絕的消息。 如果消費(fèi)端拒絕一個(gè)不重新發(fā)送的消息,那么消息隊(duì)列 RabbitMQ 版將會(huì)把消息路由到指定的死信 Exchange,該 Exchange 再將消息路由到綁定的 Queue 進(jìn)行存儲(chǔ)。 | DLExchange |
DeadLetterRoutingKey | string | 否 | 死信 Routing Key。 只能包含字?、數(shù)字、短劃線(-)、下劃線(_)、半角句號(hào)(.)、井號(hào)(#)、正斜線(/)、at 符號(hào)(@),?度限制 1~255 字符。 | test.dl |
MaximumPriority | integer | 否 | 不支持優(yōu)先級(jí)功能。取值不影響調(diào)用和返回結(jié)果。 | 10 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "59B52E2C-0B8E-44EC-A314-D0314A50***"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|