All Products
Search
Document Center

Cloud Backup:GetBasicStatistics

Last Updated:Mar 20, 2026

Retrieves basic statistics for Backup.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

SourceType

string

Yes

The data source type. The valid value is:

  • ECS_FILE: ECS File Backup.

ECS_FILE

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The Request ID.

EB526A5D-1FE2-51C1-B790-1732C1DBA969

Code

string

The HTTP status code. A value of 200 indicates that the request was successful.

200

Message

string

The response message. If the request is successful, successful is returned. If the request fails, an error message is returned.

successful

Success

boolean

Indicates whether the request was successful.

  • true: The request was successful.

  • false: The request failed.

true

RegionStatistics

array<object>

The Backup statistics for each region.

object

The Backup statistics for each region.

RegionId

string

The Region ID.

cn-shenzhen

ProtectedDataSize

integer

The backed-up data size, in bytes.

  • When SourceType is set to ECS_FILE, this parameter represents the total capacity of backed-up Cloud Disks.

42949672960

ProtectedResourceCount

integer

The number of backed-up resources.

  • When SourceType is set to ECS_FILE, this parameter represents the number of backed-up ECS instances.

5

SourceType

string

The data source type. The valid value is:

  • ECS_FILE: ECS File Backup.

ECS_FILE

GlobalStatistics

object

The Backup statistics for all regions.

ProtectedDataSize

integer

The backed-up data size, in bytes.

  • When SourceType is set to ECS_FILE, this parameter represents the total capacity of backed-up Cloud Disks.

42949672960

ProtectedResourceCount

integer

The number of backed-up resources.

  • When SourceType is set to ECS_FILE, this parameter represents the number of backed-up ECS instances.

5

Examples

Success response

JSON format

{
  "RequestId": "EB526A5D-1FE2-51C1-B790-1732C1DBA969",
  "Code": "200",
  "Message": "successful",
  "Success": true,
  "RegionStatistics": [
    {
      "RegionId": "cn-shenzhen",
      "ProtectedDataSize": 42949672960,
      "ProtectedResourceCount": 5
    }
  ],
  "SourceType": "ECS_FILE",
  "GlobalStatistics": {
    "ProtectedDataSize": 42949672960,
    "ProtectedResourceCount": 5
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.