修改DTS訂閱任務 - Data Transmission Service

說明您可以根據需求在控制台進行相應的預配置，然後預覽對應配置的OpenAPI參數資訊，以協助您填寫請求參數。更多資訊，請參見預覽OpenAPI的請求參數。

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	ModifySubscription	系統規定參數。取值：ModifySubscription。
RegionId	String	否	cn-hangzhou	DTS執行個體所在地區，請參見支援的地區列表。
DtsInstanceId	String	是	dtsboss6pn1w******	訂閱執行個體ID，可以調用DescribeDtsJobs查詢。
DbList	String	是	{"dtstest":{"name":"dtstest","all":true}}	修改後的訂閱對象，格式為JSON串。詳細定義，請參見遷移、同步或訂閱對象說明。說明原DbList會被新傳入的DbList覆蓋，請確保新傳入的DbList資料中包含所有需要訂閱的對象，否則可能會導致訂閱對象丟失，請謹慎修改。原訂閱對象，可調用DescribeDtsJobDetail進行查詢。
DtsJobId	String	是	boss6pn1w******	訂閱任務ID，可以調用DescribeDtsJobs查詢。
SubscriptionDataTypeDDL	Boolean	是	true	修改後任務是否訂閱DDL類型的資料，取值： true：是。 false：否。
SubscriptionDataTypeDML	Boolean	是	true	修改後任務是否訂閱DML類型的資料，取值： true：是。 false：否。
ResourceGroupId	String	否	rg-acfmzawhxxc****	資源群組ID。

返回資料

名稱	類型	樣本值	描述
HttpStatusCode	String	200	狀態代碼。
RequestId	String	068FA72F-4800-4A54-90BB-94806068****	請求ID。
ErrCode	String	InternalError	調用出錯時返回的錯誤碼。
Success	String	true	請求是否成功。
ErrMessage	String	The request processing has failed due to some unknown error.	調用出錯時返回對應的錯誤資訊。

樣本

請求樣本

http(s)://dts.aliyuncs.com/?Action=ModifySubscription
&DbList={"dtstest":{"name":"dtstest","all":true}}
&DtsInstanceId=dtsboss6pn1w******
&DtsJobId=boss6pn1w******
&SubscriptionDataTypeDDL=true
&SubscriptionDataTypeDML=true

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifySubscriptionResponse>
    <RequestId>068FA72F-4800-4A54-90BB-94806068****</RequestId>
    <HttpStatusCode>200</HttpStatusCode>
    <Success>true</Success>
</ModifySubscriptionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "068FA72F-4800-4A54-90BB-94806068****",
  "HttpStatusCode" : 200,
  "Success" : true
}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	Throttling.User	Request was denied due to user flow control.	由於請求頻次達到閾值，請求被拒絕，請稍後重試。
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	由於服務端響應逾時或者不可用導致請求失敗，請重試，重試後仍失敗請聯絡支援人員。
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	簽名已經到期，請更新簽名

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