All Products
Search
Document Center

Elasticsearch:ListInstance

Last Updated:Jun 04, 2024

You can call this operation to obtain the list of Elasticsearch instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

The UpdateInstance operation does not have operation-specific request headers and uses only common request headers. For more information, see the "Common request parameters" section of the "Common parameters" topic.

Request syntax

GET /openapi/instances HTTP/1.1

Request parameters

Parameter

Type

Position

Required

Example

Description

page Integer Query No. 1

The page number.

Start value: 1. Default value: 1.

size Integer Query No. 10

The number of entries to return on each page. Maximum value: 100. Default value: 10.

description String Query No. aliyunes_test1

The name of the instance. You can specify a keyword to match multiple instances. For example, if you search for all instances of a abc, you might return all instances of abc, abcde, xyabc, and xabcy.

instanceId String Query No. es-cn-v641a0ta3000g****

The ID of the instance

esVersion String Query No. 6.7_with_X-Pack

The version of the instance.

resourceGroupId String Query No. rg-aekzvowej3i****

The ID of the resource group to which the new ECS instance belongs.

tags String Query No. [{"tagKey":"key1","tagValue":"value1"}]

The tags that are added to the instance.

vpcId String Query No. vpc-bp16k1dvzxtmagcva****

The ID of the Virtual Private Cloud to which the instance belongs.

zoneId String Query No. cn-hangzhou-i

The zone ID of the instance.

paymentType String Query No. postpaid

The billing method of the instance. Valid values:

  • postpaid: pay-as-you-go
  • prepaid: subscription
instanceCategory String Query No. advanced

The version type of the instance. Valid values:

  • x-pack: Standard Edition
  • advanced/IS: Enhanced Edition
  • community: Basic Edition

Response parameters

Parameter

Type

Sample value

Description

RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

The request ID.

Headers Object

The header of the response.

X-Total-Count Integer 10

The number of entries returned per page.

Result Array of Instance

The response parameters.

advancedDedicateMaster Boolean false

Whether the dedicated master node is included. Valid values:

  • true: The directory contains files stored in the IA storage class.
  • false: The directory does not contain files stored in the IA storage class.
nodeAmount Integer 2

The number of data nodes.

createdAt String 2018-07-13T03:58:07.253Z

The time when the instance was created.

status String active

The status of the instance. Valid values:

  • active: The cluster is normal.
  • activating: The cluster is being activated.
  • Inactive: The cluster is frozen.
  • invalid: The cluster is valid.
dedicateMaster Boolean false

Indicate whether dedicated master nodes are included. The dedicated master nodes are deprecated. Valid values:

  • true: The directory contains files stored in the IA storage class.
  • false: The directory does not contain files stored in the IA storage class.
serviceVpc Boolean true

Whether it is a service VPC.

paymentType String postpaid

The billing method of the cluster. Valid values:

  • prepaid: subscription
  • postpaid: pay-as-you-go
resourceGroupId String rg-aekzvowej3i****

The ID of the resource group.

postpaidServiceStatus String active

The status of the pay-as-you-go service for the subscription cluster. Valid values:

  • active: Normal
  • closed: Off
  • indebt: Overdue payments are frozen
description String es-cn-abc

The instance name.

esVersion String 6.7_with_X-Pack

The version of the instance.

isNewDeployment String true

Indicates whether the cluster is deployed in the new architecture.

updatedAt String 2018-07-18T10:10:04.484Z

The time when the instance was last updated.

instanceId String es-cn-v641a0ta3000g****

The ID of the instance

tags Array of Tag

The tags of the instance. Each tag is a key-value pair.

tagKey String env

The tag key.

tagValue String dev

The tag value.

extendConfigs Array of Object [{ "configType": "aliVersion", "aliVersion": "ali1.3.0" }]

The configuration of the cluster extension parameters.

clientNodeConfiguration Object

The configurations of client nodes.

spec String elasticsearch.sn2ne.large

The specification category. For more information, see Product specifications.

amount Integer 3

The number of nodes.

disk Integer 20

The storage capacity of the node. Unit: GB.

diskType String cloud_efficiency

The storage type of the node. Only ultra disks (cloud_efficiency) are supported.

specInfo String 1C 2G

The description of the node specifications.

elasticDataNodeConfiguration Object

The configurations of elastic nodes.

spec String elasticsearch.sn2ne.large

The specification category. For more information, see Product specifications.

amount Integer 3

The number of nodes.

disk Integer 20

The storage capacity of the node. Unit: GB.

diskEncryption Boolean true

Indicates whether disk encryption is enabled. Valid values:

  • true: enables the feature.
  • false: disables the feature.
diskType String cloud_ssd

The storage type. Valid values:

  • cloud_ssd: SSD
  • cloud_essd: enhanced SSD (ESSD)
  • cloud_efficiency: ultra disk
specInfo String 1C 2G

node specifications Description

kibanaConfiguration Object

The configurations of Kibana nodes.

spec String elasticsearch.n4.small

The specification category. For more information, see Product specifications.

amount Integer 1

The number of nodes.

disk Integer 20

The storage capacity of the node. Unit: GB.

diskType String cloud_ssd

The storage type.

specInfo String 1C 2G

node specifications Description

masterConfiguration Object

The configurations of dedicated master nodes.

spec String elasticsearch.sn2ne.large

The specification category. For more information, see Product specifications.

amount Integer 3

The number of nodes.

disk Integer 20

The storage capacity of the node. Unit: GB.

diskType String cloud_ssd

The storage type. Only cloud_ssd is supported.

specInfo String 1C 2G

node specifications Description

networkConfig Object

The network configurations.

vpcId String vpc-abc

The ID of the virtual private cloud (VPC).

vsArea String cn-hangzhou-e

The zone where the cluster resides.

type String vpc

The network type. Only the VPC is supported.

vswitchId String vsw-def

The ID of the vSwitch.

whiteIpGroupList Array of whiteIpGroupList

The whitelist of the public and private networks of the cluster.

groupName String default

The name of the IP whitelist.

whiteIpType String PUBLIC_KIBANA

The network type. PRIVATE_ES: the Elasticsearch instance. PUBLIC_KIBANA. Kibana over the Internet. PUBLIC_ES,ES public network. PRIVATE_KIBANA: the private network of Kibana.

ips Array of String ["0.0.0.0", "127.0.XX.XX"]

The network whitelist.

nodeSpec Object

The configurations of data nodes.

spec String elasticsearch.n4.small

The specification category. For more information, see Product specifications.

disk Integer 50

The storage capacity of the node. Unit: GB.

diskEncryption Boolean false

Whether to use disk encryption. Valid values:

  • true: The native format mode is used.
  • false: The native format mode is not used.
diskType String cloud_ssd

The storage type. Valid values:

  • cloud_ssd: standard SSD.
  • cloud_efficiency: ultra disk
performanceLevel String PL1

The performance level (PL) of the disk. This parameter is valid only if the category of the disk is ESSD. This parameter is returned if the value of diskType is cloud_essd. Valid values: PL1, PL2, and PL3.

specInfo String 1C 2G

node specifications Description

vpcInstanceId String vpc-bp1uag5jj38c****

The ID of the virtual private cloud (VPC).

kibanaIPWhitelist Array of String "0.0.0.0/0"

The public IP address whitelist of Kibana nodes in the cluster.

kibanaPrivateIPWhitelist Array of String ["192.168.XX.XX"]

The private IP address whitelist of Kibana nodes in the cluster.

publicIpWhitelist Array of String [ "0.0.0.0/0" ]

Elasticsearch the public network whitelist of the cluster.

privateNetworkIpWhiteList Array of String ["192.168.XX.XX/25"]

Elasticsearch the private network access whitelist of the cluster.

endTime Long 1715826092044

The time when the instance expires. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

archType String public

Deployment mode, architecture type:

exclusive: basic management

public: cloud-native new control

Note The following response example contains most of the parameters in the response. The actual response takes precedence. We recommend that you do not forcibly obtain the parameters in the program.

Examples

Sample requests

GET /openapi/instances?esVersion=6.7_with_X-Pack&resourceGroupId=rg-aekzvowej3i****&tags=[{"tagKey":"key1","tagValue":"value1"}]&vpcId=vpc-bp16k1dvzxtmagcva****&zoneId=cn-hangzhou-i HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

Sample success responses

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : [ {
    "instanceId" : "es-cn-v641a0ta3000g****",
    "description" : "aliyunes_test1",
    "nodeAmount" : 3,
    "paymentType" : "postpaid",
    "status" : "active",
    "esVersion" : "6.7.0_with_X-Pack",
    "esConfig" : { },
    "esIPWhitelist" : [ ],
    "esIPBlacklist" : [ ],
    "privateNetworkIpWhiteList" : [ ],
    "kibanaIPWhitelist" : [ ],
    "publicIpWhitelist" : [ ],
    "serviceVpc" : true,
    "enablePublic" : false,
    "haveKibana" : true,
    "nodeSpec" : {
      "spec" : "elasticsearch.sn1ne.large",
      "disk" : 20,
      "diskType" : "cloud_ssd",
      "diskEncryption" : true
    },
    "networkConfig" : {
      "vpcId" : "vpc-bp1xk0naij7jx4ph1****",
      "vswitchId" : "vsw-bp1ogpdintii5qvyx****",
      "vsArea" : "cn-hangzhou-g",
      "type" : "vpc"
    },
    "createdAt" : "2019-08-26T08:18:06.652Z",
    "updatedAt" : "2019-08-26T08:19:49.448Z",
    "inited" : true,
    "tags" : [ {
      "tagKey" : "key1",
      "tagValue" : "value1"
    } ],
    "dedicateMaster" : false,
    "advancedDedicateMaster" : true,
    "masterConfiguration" : {
      "spec" : "elasticsearch.ic5.large",
      "amount" : 3,
      "diskType" : "cloud_ssd",
      "disk" : 20
    },
    "haveClientNode" : true,
    "warmNode" : true,
    "warmNodeConfiguration" : {
      "spec" : "elasticsearch.ic5.large",
      "amount" : 2,
      "diskType" : "cloud_efficiency",
      "disk" : 500,
      "diskEncryption" : true
    },
    "clientNodeConfiguration" : {
      "spec" : "elasticsearch.ic5.large",
      "amount" : 2,
      "diskType" : "cloud_efficiency",
      "disk" : 20
    },
    "kibanaConfiguration" : {
      "spec" : "elasticsearch.n4.small",
      "amount" : 1,
      "disk" : 0
    },
    "commodityCode" : "elasticsearch",
    "endTime" : 4722508800000,
    "dictList" : [ ],
    "synonymsDicts" : [ ],
    "ikHotDicts" : [ ],
    "aliwsDicts" : [ ],
    "clusterTasks" : [ ],
    "resourceGroupId" : "rg-acfmwriiikz****",
    "zoneCount" : 1,
    "protocol" : "HTTP",
    "haveGrafana" : false,
    "haveCerebro" : false,
    "zoneInfos" : [ {
      "zoneId" : "cn-hangzhou-g",
      "status" : "NORMAL"
    } ],
    "enableKibanaPublicNetwork" : false,
    "advancedSetting" : {
      "gcName" : "CMS"
    }
  }, {
    "instanceId" : "es-cn-v641920bh0006****",
    "description" : "aliyunes_test2",
    "nodeAmount" : 2,
    "paymentType" : "postpaid",
    "status" : "active",
    "esVersion" : "6.7.0_with_X-Pack",
    "archType" : "exclusive",
    "esConfig" : { },
    "esIPWhitelist" : [ ],
    "esIPBlacklist" : [ ],
    "privateNetworkIpWhiteList" : [ ],
    "kibanaIPWhitelist" : [ ],
    "publicIpWhitelist" : [ ],
    "enablePublic" : false,
    "haveKibana" : true,
    "nodeSpec" : {
      "spec" : "elasticsearch.sn2ne.2xlarge",
      "disk" : 20,
      "diskType" : "cloud_ssd",
      "diskEncryption" : false
    },
    "networkConfig" : {
      "vpcId" : "vpc-bp1op7luys63go2x5****",
      "vswitchId" : "vsw-bp1rusvg785q97ucp****",
      "vsArea" : "cn-hangzhou-i",
      "type" : "vpc"
    },
    "createdAt" : "2019-08-07T13:14:07.974Z",
    "updatedAt" : "2019-08-12T03:04:27.215Z",
    "inited" : true,
    "tags" : [ ],
    "dedicateMaster" : false,
    "advancedDedicateMaster" : false,
    "masterConfiguration" : { },
    "haveClientNode" : false,
    "warmNode" : false,
    "warmNodeConfiguration" : { },
    "clientNodeConfiguration" : { },
    "kibanaConfiguration" : {
      "spec" : "elasticsearch.n4.small",
      "amount" : 1,
      "disk" : 0
    },
    "commodityCode" : "elasticsearch",
    "endTime" : 4720867200000,
    "dictList" : [ ],
    "synonymsDicts" : [ ],
    "ikHotDicts" : [ ],
    "aliwsDicts" : [ ],
    "clusterTasks" : [ ],
    "resourceGroupId" : "rg-acfmwriiikz****",
    "zoneCount" : 1,
    "protocol" : "HTTP",
    "haveGrafana" : false,
    "haveCerebro" : false,
    "zoneInfos" : [ {
      "zoneId" : "cn-hangzhou-i",
      "status" : "NORMAL"
    } ],
    "enableKibanaPublicNetwork" : false,
    "advancedSetting" : {
      "gcName" : "CMS"
    }
  } ]
}

Error codes

For a list of error codes, see Service error codes.