修改付費方式或執行個體規格 - Data Transmission Service

請確保在使用該介面前，已充分瞭解雲資料庫DTS產品的收費方式和價格。

訂用帳戶的執行個體無法轉換為隨用隨付的執行個體，為避免您的資源浪費，在執行個體轉換付費方式操作前確認要進行轉換操作。
資料移轉任務只支援隨用隨付，無需轉換。
隨用隨付轉訂用帳戶只是進行付費方式的切換，對於底層運行鏈路不會有任何影響。

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	TransferPayType	系統規定參數。取值：TransferPayType。
DtsJobId	String	是	o4nh3g7jg56****	遷移、同步或訂閱任務ID，可調用DescribeDtsJobs查詢。
ChargeType	String	是	PostPaid	修改後的付費方式，取值： PrePaid：預付費，即訂用帳戶。 PostPaid：後付費，即隨用隨付。說明訂用帳戶執行個體無法轉換為隨用隨付執行個體，為避免您的資源浪費，在執行個體轉換付費方式前，請確認要進行的轉換操作。如無需修改付費方式，則傳入當前付費方式即可。
Period	String	否	Year	預付費執行個體的計費方式，取值： Year：包年。 Month：包月。說明當ChargeType為PrePaid（預付費）時，該參數才有效且必須傳入。
BuyCount	String	否	5	預付費執行個體購買時間長度。當Period為Year（包年）時，取值範圍為1~5。當Period為Month（包月）時，取值範圍為1~60。說明當ChargeType為Prepaid（預付費）時，該參數才有效且必須傳入。
RegionId	String	否	cn-hangzhou	執行個體所屬的地區，請參見支援的地區列表。

返回資料

名稱	類型	樣本值	描述
EndTime	String	1614916318	預付費執行個體到期時間，格式為Unix時間戳記。說明如修改後的執行個體為後付費執行個體，則該值為空白值。 Unix時間戳記轉換工具可用搜尋引擎擷取。
HttpStatusCode	Integer	200	狀態代碼。
RequestId	String	601B6F25-21E7-4484-99D5-3EF2625C****	請求ID。
DtsJobId	String	o4nh3g7jg56****	任務ID。
ErrCode	String	InternalError	調用錯誤時返回的錯誤碼。
Success	Boolean	true	請求是否成功，傳回值： true：請求成功。 false：請求失敗。
ChargeType	String	PostPaid	修改後的付費方式，傳回值： PrePaid：預付費。 PostPaid：後付費。
ErrMessage	String	The Value of Input Parameter %s is not valid.	調用錯誤時返回的錯誤資訊。
Code	String	200	錯誤碼，本參數即將下線。
DynamicMessage	String	DtsJobId	動態錯誤資訊，用於替換返回參數ErrMessage錯誤資訊中的%s。說明如果ErrMessage返回The Value of Input Parameter %s is not valid，且DynamicMessage返回DtsJobId，則代表所傳入的請求參數DtsJobId不合法。
InstanceId	String	dtso4nh3g7jg56****	執行個體ID。

樣本

請求樣本

http(s)://dts.aliyuncs.com/?Action=TransferPayType
&ChargeType=PostPaid
&DtsJobId=o4nh3g7jg56****
&<公用請求參數>

正常返回樣本

XML格式

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

<TransferPayTypeResponse>
    <DtsJobId>o4nh3g7jg56****</DtsJobId>
    <RequestId>601B6F25-21E7-4484-99D5-3EF2625C****</RequestId>
    <InstanceId>dtso4nh3g7jg56****</InstanceId>
    <ChargeType>PostPaid</ChargeType>
    <HttpStatusCode>200</HttpStatusCode>
    <Success>true</Success>
</TransferPayTypeResponse>

JSON格式

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

{
  "DtsJobId" : "o4nh3g7jg56****",
  "RequestId" : "601B6F25-21E7-4484-99D5-3EF2625C****",
  "InstanceId" : "dtso4nh3g7jg56****",
  "ChargeType" : "PostPaid",
  "HttpStatusCode" : 200,
  "Success" : true
}

錯誤碼

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

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