使用OnsTopicCreate建立Topic-雲訊息佇列 RocketMQ 版-阿里雲

介面說明

重要阿里雲提供的 OpenAPI 屬於管控類 API，用於管理和查詢阿里雲服務的相關資源。僅推薦在管控鏈路整合，訊息收發的核心資料鏈路中嚴禁依賴 OpenAPI 實現，否則可能會導致鏈路產生風險。

本介面一般是在發布新應用或業務擴充等需要建立新的 Topic 資源時使用。

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

mq:CreateTopic

*Topic

acs:mq:{#regionId}:{#accountId}:{#TopicName}

*Topic

acs:mq:{#regionId}:{#accountId}:{#InstanceId}%{#TopicName}

無

名稱	類型	必填	描述	樣本值
Topic	string	是	需建立的 Topic 的名稱，取值說明如下：長度限制為 3~64 個字元，只能包含字母、數字、短劃線（-）和底線（_）。 “CID”和“GID”是 Group ID 的保留欄位，Topic 名稱不能以“CID”和“GID”開頭。如果建立的 Topic 所在的執行個體有命名空間，則 Topic 的名稱需要保證執行個體內唯一，不能和本執行個體下已有的 Topic 名稱或 Group ID 重複；跨執行個體之間可以重名，例如執行個體 A 的 Topic 名稱可以和執行個體 B 的 Topic 名稱重複，也可以和執行個體 B 的 Group ID 重複。如果建立的 Topic 所在的執行個體無命名空間，則 Topic 的名稱需要保證跨執行個體和跨地區全域唯一，全域範圍內不能和已有的 Topic 名稱或 Group ID 重複。說明執行個體是否有命名空間，可以在雲訊息佇列 RocketMQ 版控制台執行個體詳情頁面的基礎資訊地區查看。	test
MessageType	integer	是	訊息類型。取值說明如下： 0：普通訊息 1：分區順序訊息 4：事務訊息 5：定時/延時訊息各類型訊息的詳細說明，請參見訊息類型列表。	0
Remark	string	否	需建立的 Topic 的描述資訊。	測試
InstanceId	string	否	需建立的 Topic 所對應的執行個體 ID。	MQ_INST_188077086902****_BXSuW61e

名稱	類型	描述	樣本值
	object	返回的資料結構。
RequestId	string	公用參數，每個請求的 ID 都是唯一的，可用於排查和定位問題。	B6949B58-223E-4B75-B4FE-7797C15E****

正常返回樣本

JSON格式

{
  "RequestId": "B6949B58-223E-4B75-B4FE-7797C15E****"
}

HTTP status code	錯誤碼	錯誤資訊	描述
400	%s	%s, please check and retry later

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

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