All Products
Search
Document Center

Security Center:DescribeUniBackupDatabase

Last Updated:Jul 26, 2024

Queries the information about databases for which anti-ransomware policies are created.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceNamestringNo

The name of the Elastic Compute Service (ECS) instance.

test
DatabaseTypestringNo

The type of the database. Valid values:

  • MYSQL
  • MSSQL
  • Oracle
MYSQL
PageSizeintegerNo

The number of entries to return on each page. Default value: 20. If you leave this parameter empty, 20 entries are returned on each page.

Note We recommend that you do not leave this parameter empty.
20
CurrentPageintegerNo

The number of the page to return. Default value: 1.

1
QueryTypestringNo

The condition that is used to query the database. Valid values:

  • create: newly created
  • restore: restored
create
UniRegionIdstringNo

The region ID of the server that hosts the database.

cn-hongkong

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request, which is used to locate and troubleshoot issues.

09969D2C-4FAD-429E-BFBF-9A60DEF8****
PageInfoobject

The pagination information.

CurrentPageinteger

The page number of the returned page.

1
PageSizeinteger

The number of entries returned per page.

20
TotalCountinteger

The total number of entries returned.

25
Countinteger

The number of entries returned on the current page.

20
DatabaseListarray<object>

An array that consists of the information about the databases.

object

The information about the database.

Statusstring

The status of the ECS instance. Valid values:

  • Stopped
  • Running
Running
DatabaseTypestring

The type of the database. Valid values:

  • MYSQL
  • MSSQL
  • Oracle
MYSQL
DatabaseVersionstring

The version of the database engine.

12.0.4100.1
DatabaseNamestring

The name of the database.

apns_tt180
InstanceNamestring

The name of the instance to which the database belongs.

sql-test-001
InstanceUuidstring

The UUID of the Hybrid Backup Recovery (HBR) agent that is used to back up the data of the database.

85878b284df911ec800000163e19****
CreatedByProductstring

The service from which the database is created. Valid values:

  • HBR: HBR
  • AEGIS: Security Center
AEGIS
InstanceIdstring

The ID of the server.

i-bp15aho9hhftvmhw****
PolicyIdlong

The ID of the anti-ransomware policy.

123
AgentStatusstring

The status of the anti-ransomware agent. Valid values:

  • UNKNOWN: unknown
  • INSTALLED: installed
  • INSTALL_FAILED: installation failed
  • UNINSTALL_FAILED: uninstallation failed
INSTALLED

Examples

Sample success responses

JSONformat

{
  "RequestId": "09969D2C-4FAD-429E-BFBF-9A60DEF8****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 25,
    "Count": 20
  },
  "DatabaseList": [
    {
      "Status": "Running",
      "DatabaseType": "MYSQL",
      "DatabaseVersion": "12.0.4100.1",
      "DatabaseName": "apns_tt180",
      "InstanceName": "sql-test-001",
      "InstanceUuid": "85878b284df911ec800000163e19****",
      "CreatedByProduct": "AEGIS",
      "InstanceId": "i-bp15aho9hhftvmhw****",
      "PolicyId": 123,
      "AgentStatus": "INSTALLED"
    }
  ]
}

Error codes

HTTP status codeError codeError messageDescription
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.