調用ModifyConsumptionTimestamp介面修改資料訂閱執行個體的消費時間點。
說明
- 本介面僅適用於舊版訂閱通道。在調用ConfigureSubscriptionInstance介面配置資料訂閱通道時,如果不傳入了SubscriptionInstanceNetworkType參數,則訂閱通道被定義為舊版;如果傳入則訂閱通道被定義為新版。
- 如果訂閱通道為新版,您需要在用戶端自訂消費時間點。
- 調用本介面時,需要停止消費的用戶端,並且資料訂閱通道需處於正常狀態。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | ModifyConsumptionTimestamp | 系統規定參數,取值:ModifyConsumptionTimestamp。 |
| ConsumptionTimestamp | String | 是 | 2019-10-15T17:20:03Z | 消費時間點,格式為yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
| SubscriptionInstanceId | String | 是 | dtsg2m10r1x15a**** | 資料訂閱執行個體ID,可以通過調用DescribeSubscriptionInstances介面查詢。 |
| RegionId | String | 否 | cn-hangzhou | 地區ID,傳入本參數來指定執行個體所在地區,詳情請參見支援的地區列表。 |
| AccountId | String | 否 | 12323344**** | 阿里雲主帳號ID,無需設定,該參數即將下線。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| ErrCode | String | InternalError | 調用出錯時返回的錯誤碼。 |
| ErrMessage | String | The request processing has failed due to some unknown error. | 調用出錯時返回的錯誤資訊。 |
| RequestId | String | ABBACEFC-CBA9-4F80-A337-42F202F5**** | 請求ID。 |
| Success | String | true | 請求是否成功。 |
樣本
請求樣本
http(s)://dts.aliyuncs.com/?Action=ModifyConsumptionTimestamp
&ConsumptionTimestamp=2019-10-15T17:20:03Z
&SubscriptionInstanceId=dtsg2m10r1x15a****
&<公用請求參數>
正常返回樣本
XML格式
<ModifyConsumptionTimestampResponse>
<RequestId>ABBACEFC-CBA9-4F80-A337-42F202F5****</RequestId>
<Success>true</Success>
</ModifyConsumptionTimestampResponse>
JSON格式
{
"RequestId": "ABBACEFC-CBA9-4F80-A337-42F202F5****",
"Success": true
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。