Query hourly metering data using QueryUserOmsData - Object Storage Service

Use the QueryUserOmsData operation to retrieve hourly OSS metering data. Each record is grouped by bucket and storage class, and represents a one-hour billing snapshot.

Request parameters

Parameter	Type	Required	Example	Description
`Action`	String	Yes	`QueryUserOmsData`	Set to `QueryUserOmsData`.
`DataType`	String	Yes	`Hour`	Set to `Hour`.
`Table`	String	Yes	`OSS`	The metering table to query. Valid values: `OSS` \| `OssDataReplication` \| `OssSddpScan` \| `OssCache`
`StartTime`	String	Yes	`2022-12-01T09:12:43Z`	The start of the time range. Use UTC time.
`EndTime`	String	Yes	`2022-12-01T09:13:46Z`	The end of the time range. Use UTC time.
`Marker`	String	No	`test`	The position from which to start the query. Results are sorted alphabetically. Omit to start from the beginning. To retrieve the next page, set this to the `Marker` value returned in the previous response.
`PageSize`	Integer	No	`50`	The number of entries per page. Valid values: 1–200. Default: 100.

For common request parameters, see Common request parameters.

Metering tables

Table value	Description
`OSS`	Basic OSS metering table
`OssDataReplication`	Cross-region replication metering table
`OssSddpScan`	Sensitive data protection metering table
`OssCache`	Accelerator cache capacity metering table

Response parameters

OSS basic metering table

Each record represents one hour of metering data for a specific bucket and storage class combination.

Name	Type	Unit	Example	Description
`HostId`	String	—	`intl`	The site. Valid values: `cn` \| `intl`
`Marker`	String	—	`NextToken`	The cursor for the next page. Pass this value as the `Marker` request parameter to retrieve the next page. Empty when all data has been returned.
`ProviderId`	String	—	`26888`	The product provider code. Valid values: `26842` \| `26888`
`UserId`	String	—	`148562088256****`	The UID of the Alibaba Cloud account.
`Bucket`	String	—	`examplebucket`	The name of the bucket.
`StorageType`	String	—	`standard`	The storage class. Valid values: `standard` \| `IA` \| `archive` \| `coldarchive` \| `deepcoldarchive` \| `standard-zrs` \| `IA-zrs` \| `archive-zrs`. See Overview of storage classes.
`StartTime`	String	—	`2022-12-01T09:12:43Z`	The start of the billing period (UTC).
`EndTime`	String	—	`2022-12-01T09:13:46Z`	The end of the billing period (UTC).
`Storage`	Integer	Bytes	`2000`	The metered storage usage for the storage class. Note If you call `GetBucketInfo` from an endpoint in a different region than the bucket, this value may be 0. The minimum billable size for Infrequent Access (IA), Archive, Cold Archive, and Deep Cold Archive storage classes is 64 KB. Metered and billable storage usage may differ for these classes.
`NetworkIn`	Integer	Bytes	`2000`	Inbound Internet traffic: data transferred from a client to OSS over the Internet.
`NetworkOut`	Integer	Bytes	`2000`	Outbound Internet traffic: data transferred from OSS to a client over the Internet.
`PutRequest`	Integer	Count	`1000`	The number of PUT requests to OSS API operations.
`GetRequest`	Integer	Count	`2000`	The number of GET requests to OSS API operations.
`CdnIn`	Integer	Bytes	`500`	Upstream CDN traffic generated when CDN is enabled.
`CdnOut`	Integer	Bytes	`500`	Back-to-origin traffic generated when CDN is enabled.
`ProcessImgSize`	Integer	Bytes	`200`	The actual size of source images processed by Image Processing. Billed by source image size.
`AdvImageProcLow`	Integer	Count	`200`	The number of advanced compression operations with output resolution of 800 × 600 pixels or smaller.
`AdvImageProcMed`	Integer	Count	`200`	The number of advanced compression operations with output resolution of 1600 × 1200 pixels or smaller.
`ProcessI`	Integer	Count	`50`	The number of video snapshot captures.
`SelectScanSize`	Integer	Bytes	`300`	The actual size of the source object scanned by SelectObject.
`TagCount`	Integer	Count	`100`	The number of object tags in the bucket.
`ChargedDatasize`	Integer	Bytes	`200`	Billable storage usage for Infrequent Access (IA) LRS and Archive LRS objects.
`LessthanMonthDatasize`	Integer	Bytes	`180`	Billable storage for IA and Archive objects deleted or overwritten before the minimum storage duration. Charged for the remaining duration: IA LRS objects stored less than 30 days (720 hours) are charged for (720 hours − actual storage duration). Archive LRS objects stored less than 60 days (1440 hours) are charged for (1440 hours − actual storage duration).
`RetrievalData`	Integer	Bytes	`200`	Data retrieved from IA and Archive storage. For IA storage, fees apply when you access IA objects. For Archive storage, fees apply when you restore Archive objects. Billed by the volume of retrieved data.
`RetrievalDataArchiveDirect`	Integer	Bytes	`200`	Data retrieved from Archive storage using the direct read feature. Fees apply when you directly access Archive objects.
`StorageZRS`	Integer	Bytes	`100`	Billable storage usage for Standard ZRS objects.
`ChargedDatasizeZRS`	Integer	Bytes	`65536`	Billable storage usage for Infrequent Access ZRS objects. Minimum billable size is 64 KB; objects smaller than 64 KB are billed as 64 KB.
`LessthanMonthDatasizeZRS`	Integer	Bytes	`700`	Billable storage for Infrequent Access ZRS objects deleted or overwritten before the minimum duration. Charged for (720 hours − actual storage duration).
`ChargedDatasizeCA`	Integer	Bytes	`100`	Billable storage usage for Cold Archive LRS objects. Important Minimum billable size is 64 KB. Objects smaller than 64 KB are billed as 64 KB; larger objects are billed by actual size.
`EarlyDeletionCA`	Integer	Bytes	`100`	Billable storage for Cold Archive objects deleted or overwritten before the minimum duration. Cold Archive has a minimum storage duration of 180 days (4320 hours). Charged for (4320 hours − actual storage duration).
`CAStdRetrievalData`	Integer	Bytes	`65536`	Data retrieved when restoring Cold Archive objects using Standard priority (complete in 2–5 hours).
`CABulkRetrievalData`	Integer	Bytes	`65536`	Data retrieved when restoring Cold Archive objects using Bulk priority (complete in 5–12 hours).
`CAHighPriorRetrievalData`	Integer	Bytes	`65536`	Data retrieved when restoring Cold Archive objects using Expedited priority (complete in 1 hour).
`CAStdRetrievalRequest`	Integer	Count	`10000`	Requests to restore Cold Archive objects using Standard priority.
`CABulkRetrievalRequest`	Integer	Count	`10000`	Requests to restore Cold Archive objects using Bulk priority.
`CAHighPriorRetrievalRequest`	Integer	Count	`10000`	Requests to restore Cold Archive objects using Expedited priority.
`DeepCAStdRetrievalData`	Integer	Bytes	`65536`	Data retrieved when restoring Deep Cold Archive objects using Standard priority (complete in 48 hours).
`DeepCAHighPriorRetrievalData`	Integer	Bytes	`65536`	Data retrieved when restoring Deep Cold Archive objects using Expedited priority (complete in 12 hours).
`DeepCAStdRetrievalRequest`	Integer	Count	`10000`	Requests to restore Deep Cold Archive objects using Standard priority.
`DeepCAHighPriorRetrievalRequest`	Integer	Count	`10000`	Requests to restore Deep Cold Archive objects using Expedited priority.
`TempStorageCAStd`	Integer	Bytes	`500`	Storage of the temporary replica created during Cold Archive or Deep Cold Archive restoration. You are charged for the storage of the replica before the restoration is complete. The replica is automatically deleted after restoration.
`AccM2MIn`	Integer	Bytes	`500`	Accelerated upload traffic from the Chinese mainland to the Chinese mainland using an acceleration endpoint.
`AccM2MOut`	Integer	Bytes	`500`	Accelerated download traffic from the Chinese mainland to the Chinese mainland using an acceleration endpoint.
`AccM2OIn`	Integer	Bytes	`500`	Accelerated upload traffic from the Chinese mainland to a region outside the Chinese mainland using an acceleration endpoint.
`AccM2OOut`	Integer	Bytes	`500`	Accelerated download traffic from the Chinese mainland to a region outside the Chinese mainland using an acceleration endpoint.
`AccO2MIn`	Integer	Bytes	`500`	Accelerated upload traffic from a region outside the Chinese mainland to the Chinese mainland using an acceleration endpoint.
`AccO2MOut`	Integer	Bytes	`500`	Accelerated download traffic from a region outside the Chinese mainland to the Chinese mainland using an acceleration endpoint.
`AccO2OIn`	Integer	Bytes	`500`	Accelerated upload traffic from a region outside the Chinese mainland to another region outside the Chinese mainland using an acceleration endpoint.
`AccO2OOut`	Integer	Bytes	`500`	Accelerated download traffic from a region outside the Chinese mainland to another region outside the Chinese mainland using an acceleration endpoint.

OssDeepColdArchive metering table

Name	Type	Unit	Example	Description
`HostId`	String	—	`cn`	The site. Valid values: `cn` \| `intl`
`Marker`	String	—	`NextToken`	The cursor for the next page. Pass this value as the `Marker` request parameter to retrieve the next page. Empty when all data has been returned.
`ProviderId`	String	—	`26842`	The product provider code. Valid values: `26842` \| `26888`
`UserId`	String	—	`148562088256****`	The UID of the Alibaba Cloud account.
`ChargedDatasizeDeepCA`	Integer	Bytes	`100`	Billable storage usage for Deep Cold Archive LRS objects. Important Minimum billable size is 64 KB. Objects smaller than 64 KB are billed as 64 KB; larger objects are billed by actual size.
`EarlyDeletionDeepCA`	Integer	Bytes	`100`	Billable storage for Deep Cold Archive objects deleted or overwritten before the minimum duration of 180 days (4320 hours). Charged for (4320 hours − actual storage duration).
`StartTime`	String	—	`2022-12-01T09:12:43Z`	The start of the billing period (UTC).
`EndTime`	String	—	`2022-12-01T09:13:46Z`	The end of the billing period (UTC).

OssDataReplication metering table

Name	Type	Unit	Example	Description
`HostId`	String	—	`cn`	The site. Valid values: `cn` \| `intl`
`Marker`	String	—	`NextToken`	The cursor for the next page. Pass this value as the `Marker` request parameter to retrieve the next page. Empty when all data has been returned.
`ProviderId`	String	—	`26842`	The product provider code. Valid values: `26842` \| `26888`
`UserId`	String	—	`148562088256****`	The UID of the Alibaba Cloud account.
`SourceRegion`	String	—	`oss-cn-hangzhou`	The region of the source bucket for cross-region replication.
`DestRegion`	String	—	`oss-us-west-1`	The region of the destination bucket for cross-region replication.
`SourceBucket`	String	—	`srcbucket`	The name of the source bucket.
`DestBucket`	String	—	`destbucket`	The name of the destination bucket.
`ReplicationDatasize`	Integer	Bytes	`1000`	The volume of data replicated from the source bucket to the destination bucket.
`RtcDatasize`	Integer	Bytes	`1000`	Replication traffic for tasks with RTC enabled.
`StartTime`	String	—	`2022-12-01T09:12:43Z`	The start of the billing period (UTC).
`EndTime`	String	—	`2022-12-01T09:13:46Z`	The end of the billing period (UTC).

OssSec metering table

Name	Type	Unit	Example	Description
`HostId`	String	—	`cn`	The site. Valid values: `cn` \| `intl`
`Marker`	String	—	`NextToken`	The cursor for the next page. Pass this value as the `Marker` request parameter to retrieve the next page. Empty when all data has been returned.
`ProviderId`	String	—	`26842`	The product provider code. Valid values: `26842` \| `26888`
`UserId`	String	—	`148562088256****`	The UID of the Alibaba Cloud account.
`Bucket`	String	—	`examplebucket`	The name of the bucket with OSS Anti-DDoS protection configured.
`SecReserved`	Integer	Count	`5`	The number of Anti-DDoS instances and their usage duration. Billed by instance count and duration.
`SecEarlyReleased`	Integer	—	`100`	Resource reservation fee for Anti-DDoS instances released in less than 7 days. Charged for (7 days × 24 hours − actual usage duration).
`SecFlow`	Integer	Bytes	`2000`	Internet traffic (inbound and outbound) for all buckets attached to the Anti-DDoS instance. Billed based on the larger of inbound or outbound traffic.
`SecRequest`	Integer	Count	`10000`	The number of OSS API requests for all buckets attached to the Anti-DDoS instance. Billed by request count, regardless of whether requests succeed.
`StartTime`	String	—	`2022-12-01T09:12:43Z`	The start of the billing period (UTC).
`EndTime`	String	—	`2022-12-01T09:13:46Z`	The end of the billing period (UTC).

OssSddpScan metering table

Name	Type	Unit	Example	Description
`HostId`	String	—	`cn`	The site. Valid values: `cn` \| `intl`
`Marker`	String	—	`NextToken`	The cursor for the next page. Pass this value as the `Marker` request parameter to retrieve the next page. Empty when all data has been returned.
`ProviderId`	String	—	`26842`	The product provider code. Valid values: `26842` \| `26888`
`UserId`	String	—	`148562088256****`	The UID of the Alibaba Cloud account.
`Bucket`	String	—	`examplebucket`	The name of the bucket that stores sensitive data.
`SddpScanSize`	Integer	Bytes	`1000`	The volume of data authorized for a full or incremental scan.
`StartTime`	String	—	`2022-12-01T09:12:43Z`	The start of the billing period (UTC).
`EndTime`	String	—	`2022-12-01T09:13:46Z`	The end of the billing period (UTC).

Examples

Request

https://business.aliyuncs.com/?Action=QueryUserOmsData
&DataType=Hour
&StartTime=2022-12-01T09:12:43Z
&EndTime=2022-12-01T09:13:46Z
&Table=oss
&<Common request parameters>

Response

{
    "Data": {
        "Marker": "NextToken",
        "OmsData": [
            {
                "LessthanMonthDatasize": 180,
                "RetrievalData": 200,
                "RetrievalDataArchiveDirect": 200,
                "ChargedDatasize": 200,
                "Bucket": "examplebucket",
                "NetworkIn": 2000,
                "PutRequest": 1000,
                "NetworkOut": 2000,
                "GetRequest": 2000,
                "ProcessImgSize": 200,
                "Storage": 2000,
                "Region": "cn-hangzhou",
                "ProviderId": "26842",
                "CdnIn": 500,
                "EndTime": "2022-12-01T09:13:46Z",
                "StartTime": "2022-12-01T09:12:43Z",
                "StorageType": "standard",
                "ProcessI": 50,
                "CdnOut": 500
            }
        ],
        "HostId": "cn"
    },
    "Message": "Successful!",
    "RequestId": "4C489CA2-5036-4B06-95A9-34AF55FDE1B2",
    "Success": true,
    "Code": "Success"
}