tencent cloud

Elasticsearch Service

User Guide
Release Notes and Announcements
Release Notes
Product Announcements
Security Announcement
Product Introduction
Overview
Elasticsearch Version Support Notes
Features
Elastic Stack (X-Pack)
Strengths
Scenarios
Capabilities and Restrictions
Related Concepts
Purchase Guide
Billing Overview
Pricing
Elasticsearch Service Serverless Pricing
Notes on Arrears
ES Kernel Enhancement
Kernel Release Notes
Targeted Routing Optimization
Compression Algorithm Optimization
FST Off-Heap Memory Optimization
Getting Started
Evaluation of Cluster Specification and Capacity Configuration
Creating Clusters
Accessing Clusters
ES Serverless Guide
Service Overview
Basic Concepts
5-Minute Quick Experience
Quick Start
Access Control
Writing Data
Data Query
Index Management
Alarm Management
ES API References
Related Issues
Data Application Guide
Data Application Overview
Data Management
Elasticsearch Guide
Managing Clusters
Access Control
Multi-AZ Cluster Deployment
Cluster Scaling
Cluster Configuration
Plugin Configuration
Monitoring and Alarming
Log Query
Data Backup
Upgrade
Practical Tutorial
Data Migration and Sync
Use Case Construction
Index Configuration
SQL Support
Receiving Watcher Alerts via WeCom Bot
API Documentation
History
Introduction
API Category
Instance APIs
Making API Requests
Data Types
Error Codes
FAQs
Product
ES Cluster
Service Level Agreement
Glossary
New Version Introduction
Elasticsearch Service July 2020 Release
Elasticsearch Service February 2020 Release
Elasticsearch Service December 2019 Release
DokumentasiElasticsearch ServiceAPI DocumentationInstance APIsDescribeIndexMeta

DescribeIndexMeta

PDF
Mode fokus
Ukuran font
Terakhir diperbarui: 2025-11-13 20:48:25

1. API Description

Domain name for API request: es.intl.tencentcloudapi.com.

This API is used to obtain index metadata.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: DescribeIndexMeta.
Version Yes String Common Params. The value used for this API: 2018-04-16.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
InstanceId Yes String ES cluster ID
IndexType Yes String Index type. auto: Automated; normal: General.
IndexName Yes String Index name. null indicates that all indexes are requested.
Username No String Username for cluster access
Password No String Password for cluster access

3. Output Parameters

Parameter Name Type Description
IndexMetaField IndexMetaField Index metadata field
Note: This field may return null, indicating that no valid value can be obtained.
RequestId String The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Example

Example1 Obtaining index metadata

Input Example

POST / HTTP/1.1
Host: es.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeIndexMeta
<Common request parameters>

{
    "InstanceId": "xx",
    "Username": "xx",
    "Password": "xx",
    "IndexName": "xx",
    "IndexType": "xx"
}

Output Example

{
    "Response": {
        "RequestId": "xx",
        "IndexMetaField": {
            "BackingIndices": [
                {
                    "IndexPhrase": "xx",
                    "IndexStatus": "xx",
                    "IndexStorage": 0,
                    "IndexName": "xx",
                    "IndexCreateTime": "xx"
                }
            ],
            "IndexOptionsField": {
                "WriteMode": "xx",
                "RolloverMaxAge": "xx",
                "ExpireMaxAge": "xx",
                "RolloverDynamic": "xx",
                "ExpireMaxSize": "xx",
                "ShardNumDynamic": "xx",
                "TimestampField": "xx"
            },
            "IndexName": "xx",
            "IndexType": "xx",
            "IndexPolicyField": {
                "WarmEnable": "xx",
                "WarmMinAge": "xx",
                "ColdMinAge": "xx",
                "FrozenEnable": "xx",
                "FrozenMinAge": "xx",
                "ColdEnable": "xx"
            },
            "ClusterName": "xx",
            "IndexStatus": "xx",
            "ClusterId": "xx",
            "IndexCreateTime": "xx",
            "ClusterVersion": "xx",
            "IndexStorage": 0,
            "IndexSettingsField": {
                "NumberOfShards": "xx",
                "NumberOfReplicas": "xx",
                "RefreshInterval": "xx"
            }
        }
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
AuthFailure CAM signature/authentication error
AuthFailure.UnAuthorizedOperation Unauthorized operation.
FailedOperation Operation failed.
FailedOperation.ErrorClusterState Incorrect cluster status
FailedOperation.ErrorClusterStateUnhealth The cluster is unhealthy.
InternalError Internal error.
InvalidParameter Invalid parameter.
InvalidParameterValue Incorrect parameter value.
MissingParameter Missing parameter.
RequestLimitExceeded The number of requests exceeds the frequency limit.
ResourceInUse Resource is in use.
UnauthorizedOperation Unauthorized operation.
UnknownParameter Unknown parameter error.
UnsupportedOperation Unsupported operation.
Topik sebelumnya: UpdateIndexTopik selanjutnya: DescribeIndexList

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan