調用CreateQueue API建立隊列-輕量訊息佇列（原 MNS）-阿里雲 - Simple Message Queue (formerly MNS)

呼叫CreateQueue介面建立一個新的佇列。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mns:CreateQueue

create

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:EnableLogging

無

請求參數

名稱	類型	必填	描述	樣本值
QueueName	string	是	佇列名稱。	06273500-249F-5863-121D-74D51123****
MaximumMessageSize	integer	否	傳送到該 Queue 的訊息主體的最大長度。取值範圍：1024~65536，單位為 Byte。預設值：65536。	65536
MessageRetentionPeriod	integer	否	訊息在該 Queue 中最長的存活時間，從傳送到該佇列開始經過此參數指定的時間後，不論訊息是否被取出過都將被刪除。取值範圍：60~604800，單位為秒。預設值：345600。	345600
VisibilityTimeout	integer	否	訊息從該 Queue 中取出後從 Active 狀態變成 Inactive 狀態後的持續時間。取值範圍：1~43200，單位為秒。預設值：30。	60
PollingWaitSeconds	integer	否	當 Queue 中沒有訊息時，針對該 Queue 的 ReceiveMessage 請求最長的等待時間。取值範圍：0~30，單位為秒。預設值：0。	0
EnableLogging	boolean	否	是否開啟日誌管理功能。取值說明如下： true：啟用。 false：停用。預設值：false。	true
DelaySeconds	integer	否	傳送到該 Queue 的所有訊息的延遲時間，傳送到佇列的訊息經過此參數設定的延時時間後，才能被消費。取值範圍：0~604800，單位為秒。預設值：0。	0
Tag	array<object>	否	資源標籤清單。
	object	否	標籤鍵對應的標籤值。
Key	string	否	標籤的 key。	tag1
Value	string	否	標籤值。	test
DlqPolicy	object	否	死信策略。
DeadLetterTargetQueue	string	否	死信訊息投遞目標佇列。	deadLetterQueue
Enabled	boolean	否	是否開啟死信訊息投遞。	true
MaxReceiveCount	integer	否	訊息最大投遞次數。	3
QueueType	string	否	佇列類型。可取值如下： normal: 普通佇列 fifo: FIFO 佇列	normal
TenantRateLimitPolicy	object	否	限流策略。
Enabled	boolean	否	是否啟用限流。取值範圍： true false	false
MaxReceivesPerSecond	integer	否	每秒最大接收次數。	1000
EnableSSE	boolean	否
SseType	string	否
SseAlgorithm	string	否
KmsKeyId	string	否

返回參數

名稱	類型	描述	樣本值
	object
Code	integer	回應 code。	200
Data	object	回應資料。
Code	integer	回應 code。	200
Message	string	回應資訊。	無
Success	boolean	請求是否成功。	true
Message	string	回應資訊。	operation success
RequestId	string	請求的 ID。	06273500-249F-5863-121D-74D51123E62C
Status	string	回應的狀態。	Success
Success	boolean	請求是否成功。	true

樣本

正常返回樣本

JSON格式

{
  "Code": 200,
  "Data": {
    "Code": 200,
    "Message": "无",
    "Success": true
  },
  "Message": "operation success",
  "RequestId": "06273500-249F-5863-121D-74D51123E62C",
  "Status": "Success",
  "Success": true
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。