PushMeteringData
調用PushMeteringData推送計量數據。
- 目前不支持子賬號調用該接口。
- 請求參數全部需要URLEncode編碼。
- 云市場對每個InstanceId的請求限制為60秒一次,每次請求支持寫入的計量數據為100條。
- 不支持跨商品的InstanceId批量推送,批量推送時請確保所有InstanceId來自同一個商品。
-
按小時出賬的商品,截止出賬時間是下一個小時,計量數據必須按時推送過來。比如推送的計量數據是8:10-08:20, 則必須在9.59之前將計量數據推送過來,否則將不會出賬。按天出賬規則類似,即第二天必須要把前一天的數據推送過來,否則不會出賬。
-注意參數中Metering字段要嚴格按照文檔中的示例來提交,以往發現很多提交過來的不是一個JSON字段,再提交之前可以先用JSON格式化工具檢查一下,否則接口調用會失敗, 一定要仔細檢查。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | PushMeteringData | 系統規定參數。取值:PushMeteringData。 |
Metering | String | 否 | [{"InstanceId":"1000001","StartTime":"100000000","EndTime":"100000010","Entities":[{"Key":"PeriodMin","Value":"96","meteringAssit":"cmapi00060317-PeriodMin-4"}]}] | 示例中的參數說明如下:
說明:
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
Success | Boolean | true | 成功狀態標識 |
RequestId | String | 6EF60BEC-0242-43AF-BB20-270359FB54A7 | 請求ID |
示例
請求示例
http(s)://market.aliyuncs.com/?Action=PushMeteringData
&Metering=%5B%7B%22InstanceId%22%3A%221000001%22%2C%22StartTime%22%3A%22100000000%22%2C%22EndTime%22%3A%22100000010%22%2C%22Entities%22%3A%5B%7B%22Key%22%3A%22Frequency%22%2C%22Value%22%3A%2296%22%7D%5D%7D%5D
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<PushMeteringDataResponse>
<RequestId>6EF60BEC-0242-43AF-BB20-270359FB54A7</RequestId>
<Success>true</Success>
</PushMeteringDataResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "6EF60BEC-0242-43AF-BB20-270359FB54A7",
"Success" : "true"
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | Invalid.Parameter.Metering | meteringAssit is empty | meteringAssit 為空 |
500 | UnknownError | An error occurred while processing your request. | 未知錯誤。 |
500 | Service.Flow.Control | The rate throttling threshold has been exceeded. | 請求超過流控限制。 |
500 | Invalid.Parameter | The specified parameter is invalid. | 請求參數錯誤。 |
500 | Invalid.Parameter.Instance | The specified Instance parameter is invalid. | Instance參數請求錯誤。 |
500 | Invalid.Parameter.Metering | The specified Metering parameter is invalid. | Metering參數請求錯誤。 |
500 | Metering.Data.Exceeded | The number of metering entities must not exceed 100. | Metering entities不能超過100個。 |
500 | Permission.Denied | You are not authorized to call the API operation. Contact the API developer to add your account to the API user whitelist. | 沒有調用權限,請聯系接口負責人添加白名單。 |
500 | UnknownError | execute oms post error | 執行oms post相關接口出錯 |
訪問錯誤中心查看更多錯誤碼。