All Products
Search
Document Center

ApsaraDB for OceanBase:DescribeAvailableMemResource

Last Updated:Apr 29, 2024

You can call this operation to query the available memory resource of an OceanBase Database tenant.

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
InstanceIdstringYes

The ID of the OceanBase cluster.

ob317v4uif****
TenantIdstringNo

The ID of the tenant.

ob2mr3oae0****
UnitNumlongYes

The number of resource distribution nodes in the tenant.
The number is determined by the deployment mode of the cluster. If the cluster is deployed in 2-2-2 mode, the maximum number of resource distribution nodes is 2.

2
CpuNumlongYes

The number of CPU cores.

14

Response parameters

ParameterTypeDescriptionExample
object

The return result of the request.

RequestIdstring

The ID of the request.

EE205C00-30E4-****-****-87E3A8A2AA0C
Dataobject

The available memory size.

MinMemlong

The minimum memory size required for each resource unit, in GB.

5
MaxMemlong

The maximum memory size for each resource unit, in GB.

10
UsedMemlong

The number of resource units in the tenant.

2
SafeMemstring

The maximum allowed memory usage, in GB.

10.0

Examples

Sample success responses

JSONformat

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": {
    "MinMem": 5,
    "MaxMem": 10,
    "UsedMem": 2,
    "SafeMem": "10.0"
  }
}

Error codes

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

Change history

Change timeSummary of changesOperation
2023-10-30The response structure of the API has changedsee changesets
Change itemChange content
Output ParametersThe response structure of the API has changed.
2021-08-19Add Operationsee changesets