Subscribe - 為主題建立Subscription - Simple Message Queue (formerly MNS)

調用Subscribe介面，為主題建立Subscription。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

mns:Subscribe

update

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:PushType

無

請求參數

名稱	類型	必填	描述	樣本值
TopicName	string	是	主題的名稱。	topic****1
SubscriptionName	string	是	訂閱名稱。	testSubscription
PushType	string	是	終端類型。 http：HTTP 推送類型。 queue：隊列推送類型。 mpush：Alibaba Cloud Mobile Push類型。 alisms：阿里簡訊推送類型。 email：郵箱推送類型。	queue
Endpoint	string	是	此次訂閱中接收訊息的終端地址，不同終端類型的格式如下： HTTP 格式為： `http(s)://{實際 url 地址}` 隊列格式為： `{QueueName}` Alibaba Cloud Mobile Push格式為： `{AppKey}` 阿里簡訊格式為： `{phoneNumber}` 郵箱格式為： `{emailAddress}`	http://*****.com/uri1/xxx
NotifyStrategy	string	否	向 Endpoint 推送訊息錯誤時的重試策略。取值說明如下： BACKOFF_RETRY：退避重試。 EXPONENTIAL_DECAY_RETRY：指數衰減重試。	BACKOFF_RETRY
NotifyContentFormat	string	否	用於定義向 Endpoint 推送的訊息格式。取值說明如下： XML JSON SIMPLIFIED	XML
MessageTag	string	否	該訂閱中訊息過濾的標籤（標籤一致的訊息才會被推送）。取值範圍：不超過 16 個字元的字串。預設不進行訊息過濾。	important
DlqPolicy	object	否	無效信件佇列策略。
Enabled	boolean	否	是否開啟死信訊息投遞。	true
DeadLetterTargetQueue	string	否	死信訊息投遞目標隊列。	deadLetterTargetQueue
TenantRateLimitPolicy	object	否
Enabled	boolean	否
MaxReceivesPerSecond	integer	否
StsRoleArn	string	否
DmAttributes	object	否
AccountName	string	否
Subject	string	否
DysmsAttributes	object	否
TemplateCode	string	否
SignName	string	否
KafkaAttributes	object	否
BusinessMode	string	否

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求的 ID。	06273500-249F-5863-121D-74D51123****
Code	integer	響應 code。	200
Status	string	響應的狀態。	Success
Message	string	響應資訊。	operation success
Success	boolean	請求是否成功。	true
Data	string	響應資料。	{'Code': 200, 'Success': True}

樣本

正常返回樣本

JSON格式

{
  "RequestId": "06273500-249F-5863-121D-74D51123****",
  "Code": 200,
  "Status": "Success",
  "Message": "operation success",
  "Success": true,
  "Data": "{'Code': 200, 'Success': True}"
}

錯誤碼

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

變更歷史

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