All Products
Search
Document Center

OpenSearch:GetClusterRunTimeInfo

Last Updated:Jul 16, 2024

Queries the runtime information about a specified cluster.

Operation description

Method

GET

URI

/openapi/ha3/instances/{instanceId}/cluster-run-time-info

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 syntax

GET /openapi/ha3/instances/{instanceId}/cluster-run-time-info

Request parameters

ParameterTypeRequiredDescriptionExample
instanceIdstringYes

The instance ID.

ha-cn-2r42ncw4102

Sample requests

GET /openapi/ha3/instances/ose-test1/cluster-run-time-info

Response parameters

ParameterTypeDescriptionExample
object

The results returned.

requestIdstring

The request ID.

E45380E8-994A-5402-9806-F114B3295FCF
resultarray<object>

The result.

object

The runtime information of the cluster.

clusterNamestring

The cluster name.

vpc_hz_domain_1
queryNodeobject

The information about the Query Result Searcher (QRS) workers.

serviceStatusobject

The service status of the QRS worker.

namestring

The cluster name.

ha-cn-c4d2rq7nt04_qrs
totalSizeinteger

The total number of QRS workers in the cluster.

100
doneSizeinteger

The number of processed QRS workers in the cluster.

100
donePercentinteger

The process progress of QRS workers in the cluster. Unit: percentage.

100
configStatusListarray<object>

The configuration status.

object
configUpdateTimestring

The time when the configuration was last updated.

" "
namestring

The cluster name.

ha-cn-zvp2qr1sk01_qrs
totalSizeinteger

The total number of QRS workers in the cluster.

6
doneSizeinteger

The number of processed QRS workers in the cluster.

100
donePercentinteger

The process progress of QRS workers in the cluster. Unit: percentage.

100
dataNodesarray<object>

The information about the Searcher workers.

object

The information about the cluster node.

dataStatusListarray<object>

The data of the Searcher worker.

object
docSizeinteger

The storage capacity. Unit: GB.

2
fullVersionlong

The time when the full index version was generated.

123423
incVersionlong

The time when the incremental index version was generated.

123423
incUpdateTimestring

The time when incremental data in the index was last updated.

""
fullUpdateTimestring

The time when full data in the index was last updated.

" "
indexConfigInfoobject

The information about the index configuration.

configMetaNamestring

The name of the index configuration.

index_meta_name
versionlong

The version of the index template.

1.0.0
advanceConfigInfoobject

The information about the advanced configuration.

configMetaNamestring

The name of the index configuration.

index_meta_name
versionlong

The version number.

1.0
lackMemWorkerarray

The name of the worker that failed due to insufficient memory.

string

The name of the failed worker.

""
deployFailedWorkerarray

The name of the worker that failed due to a deployment failure.

string

The name of the failed worker.

""
lackDiskWorkerarray

The name of the worker that failed due to insufficient disks.

string

The name of the failed worker.

""
errorMsgstring

The error message.

0A3B1C48006A6C0905F6375F4821EB50
indexSizelong

The index size.

100
namestring

The name of the QRS worker.

ha-cn-c4d2rq7nt04_qrs
totalSizeinteger

The total number of QRS workers in the cluster.

1
doneSizeinteger

The number of processed QRS workers in the cluster.

100
donePercentinteger

The configuration progress. Unit: percentage.

100
serviceStatusobject

The service status of the QRS worker.

namestring

The name of the QRS worker.

ha-cn-0ju2s170b03_qrs
totalSizeinteger

The total number of QRS workers in the cluster.

100
doneSizeinteger

The number of processed QRS workers in the cluster.

100
donePercentinteger

The process progress of QRS workers in the cluster. Unit: percentage.

100
configStatusListarray<object>

The configuration status.

object

The response body.

configUpdateTimestring

The time when the configuration was last updated.

""
namestring

The cluster name.

test_0704
totalSizeinteger

The total number of Searcher workers in the cluster.

0
doneSizeinteger

The number of processed Searcher workers in the cluster.

1
donePercentinteger

The configuration progress. Unit: percentage.

100

Examples

Sample success responses

JSONformat

{
  "requestId": "E45380E8-994A-5402-9806-F114B3295FCF",
  "result": [
    {
      "clusterName": "vpc_hz_domain_1",
      "queryNode": {
        "serviceStatus": {
          "name": "ha-cn-c4d2rq7nt04_qrs",
          "totalSize": 100,
          "doneSize": 100,
          "donePercent": 100
        },
        "configStatusList": [
          {
            "configUpdateTime": "\" \"",
            "name": "ha-cn-zvp2qr1sk01_qrs",
            "totalSize": 6,
            "doneSize": 100,
            "donePercent": 100
          }
        ]
      },
      "dataNodes": [
        {
          "dataStatusList": [
            {
              "docSize": 2,
              "fullVersion": 123423,
              "incVersion": 123423,
              "incUpdateTime": "\"\"",
              "fullUpdateTime": "\" \"",
              "indexConfigInfo": {
                "configMetaName": "index_meta_name",
                "version": 0
              },
              "advanceConfigInfo": {
                "configMetaName": "index_meta_name",
                "version": 1
              },
              "lackMemWorker": [
                "\"\""
              ],
              "deployFailedWorker": [
                "\"\""
              ],
              "lackDiskWorker": [
                "\"\""
              ],
              "errorMsg": "0A3B1C48006A6C0905F6375F4821EB50",
              "indexSize": 100,
              "name": "ha-cn-c4d2rq7nt04_qrs",
              "totalSize": 1,
              "doneSize": 100,
              "donePercent": 100
            }
          ],
          "serviceStatus": {
            "name": "ha-cn-0ju2s170b03_qrs",
            "totalSize": 100,
            "doneSize": 100,
            "donePercent": 100
          },
          "configStatusList": [
            {
              "configUpdateTime": "\"\"",
              "name": "test_0704",
              "totalSize": 0,
              "doneSize": 1,
              "donePercent": 100
            }
          ]
        }
      ]
    }
  ]
}

Error codes

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

Change history

Change timeSummary of changesOperation
2022-01-12Add OperationView Change Details