GetRegionConfiguration - Elasticsearch - Alibaba Cloud Documentation Center

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

This operation uses only common request headers. For more information, see Common request headers.

Request syntax

GET /openapi/region HTTP/1.1

Request parameters

Parameter	Type	Position	Required	Example	Description
zoneId	String	Query	No.	cn-hangzhou-f	The ID of the current zone.

Response parameters

Parameter	Type	Example	Description
RequestId	String	5FFD9ED4-C2EC-4E89-B22B-1ACB6F******	The request ID.
Result	Object		The configuration information returned.
env	String	production	The environment type.
regionId	String	cn-hangzhou	The region ID.
createUrl	String	https://common-buy.aliyun.com/?commodityCode=elasticsearch&orderType=BUY#/buy	The address of the buy page.
dataDiskList	Array of dataDiskList		The disk configurations allowed for data nodes.
scaleLimit	Integer	2048	The maximum disk size if continuous disk sizes are allowed.
minSize	Integer	20	The minimum value allowed for the disk. Unit: GB.
maxSize	Integer	5120	The allowed maximum disk size.
diskType	String	cloud_ssd	The storage type of the disk.
valueLimitSet	Array of String	[2560,3072,3584,4096,4608,5120]	Discrete value allowed on disk.
esVersionsLatestList	Array of esVersionsLatestList		The list of supported Elasticsearch versions.
key	String	5.5_with_X-Pack	The supported major version.
value	String	5.5.3_with_X-Pack	The supported minor version.
nodeSpecList	Array of nodeSpecList		The list of data node specifications.
memorySize	Integer	64	The memory size per node.
cpuCount	Integer	16	The number of vCPUs that are supported by the specification category.
diskType	String	local_efficiency	The storage type of the disk.
spec	String	elasticsearch.sn2ne.large	The unit of the specification.
disk	Integer	44000	The disk size that is supported by the specification category.
specGroupType	String	local_efficiency	The storage type. Valid values: common: cloud disk local_efficiency: local SATA disk local_ssd: local SSD
enable	Boolean	true	Indicates whether purchase is supported. Valid values: true: The job can be rerun. false: The job cannot be rerun.
clientNodeDiskList	Array of disk		The disk configurations allowed for client nodes.
scaleLimit	Integer	18	The maximum disk size if continuous disk sizes are allowed.
minSize	Integer	20	The allowed minimum disk size.
maxSize	Integer	20	The allowed maximum disk size.
diskType	String	cloud_efficiency	The storage type of the disk.
masterDiskList	Array of disk		The disk configurations allowed for dedicated master nodes.
scaleLimit	Integer	20	The maximum disk size if continuous disk sizes are allowed.
minSize	Integer	20	The allowed minimum disk size.
maxSize	Integer	20	The allowed maximum disk size.
diskType	String	cloud_ssd	The storage type of the disk. The following three types are returned: common: cloud disk local_efficiency: local SATA disk local_ssd: local SSD
supportVersions	Array of CategoryEntity		The supported versions.
instanceCategory	String	x-pack	The edition. Valid values: advanced: Advanced Edition x-pack: Standard Edition
supportVersionList	Array of VersionEntity		The information about the supported Elasticsearch versions.
key	String	5.5	The version supported on the buy page.
value	String	5.5.3	The detailed version number.
masterSpec	Array of String	["elasticsearch.sn2ne.large","elasticsearch.sn2ne.xlarge","elasticsearch.sn2ne.2xlarge","elasticsearch.sn2ne.4xlarge","elasticsearch.sn1ne.4xlarge","elasticsearch.r5.large","elasticsearch.r5.xlarge","elasticsearch.r5.2xlarge" ]	The specifications of dedicated master nodes.
clientNodeSpec	Array of String	["elasticsearch.sn2ne.large","elasticsearch.sn2ne.xlarge","elasticsearch.sn2ne.2xlarge","elasticsearch.sn2ne.4xlarge","elasticsearch.sn1ne.4xlarge","elasticsearch.ic5.xlarge","elasticsearch.ic5.2xlarge","elasticsearch.ic5.3xlarge","elasticsearch.ic5.4xlarge","elasticsearch.r5.large","elasticsearch.r5.xlarge","elasticsearch.r5.2xlarge"]	Coordinated node specifications.
zones	Array of String	["cn-hangzhou-b","cn-hangzhou-f"]	The supported zones.
instanceSupportNodes	Array of String	[ "WORKER", "WORKER_WARM", "COORDINATING", "KIBANA", "MASTER", "ELASTIC_WORKER" ]	The type of the instance node that is available in the region.
esVersions	Array of String	[ "5.5.3_with_X-Pack"]	A list of Elasticsearch versions that are allowed to be created.
node	Object		The configurations of nodes.
maxAmount	Integer	50	The allowed maximum number of data nodes.
minAmount	Integer	2	The allowed minimum number of data nodes.
jvmConfine	Object		The JVM-related configurations.
memory	Integer	32	The minimum memory size required for garbage collection (GC).
supportEsVersions	Array of String	["6.7.0_with_X-Pack","6.7.0_with_A-Pack","7.4.0_with_X-Pack"]	Information about the Elasticsearch versions supported by JVM reclaim.
supportGcs	Array of String	["CMS","G1"]	The list of JVM collectors that can be set.
clientNodeAmountRange	Object		The range of the number of client nodes.
maxAmount	Integer	25	The maximum number of client nodes.
minAmount	Integer	2	The minimum number of client nodes.
warmNodeProperties	Object		The configurations of warm nodes.
diskList	Array of disk		The list of disk configurations.
scaleLimit	Integer	2048	The maximum disk size if continuous disk sizes are allowed.
minSize	Integer	500	The allowed minimum disk size.
diskEncryption	Boolean	true	Indicates whether disk encryption is enabled. Valid values: true: The job can be rerun. false: The job cannot be rerun.
maxSize	Integer	5120	The allowed maximum disk size.
diskType	String	cloud_efficiency	The storage type of the disk.
valueLimitSet	Array of String	[2560,3072,3584,4096,4608,5120]	Discrete value allowed on disk.
spec	Array of String	["elasticsearch.sn2ne.large","elasticsearch.sn2ne.xlarge","elasticsearch.sn2ne.2xlarge","elasticsearch.sn2ne.4xlarge","elasticsearch.sn1ne.8xlarge","elasticsearch.ic5.large","elasticsearch.ic5.xlarge","elasticsearch.ic5.2xlarge","elasticsearch.ic5.3xlarge","elasticsearch.ic5.4xlarge","elasticsearch.r5.large","elasticsearch.r5.xlarge","elasticsearch.r5.2xlarge"]	The specifications supported by the cold node.
amountRange	Object		The range of the number of nodes.
maxAmount	Integer	50	The maximum number of nodes.
minAmount	Integer	2	The minimum number of nodes.
kibanaNodeProperties	Object		The configurations of Kibana nodes.
spec	Array of String	["elasticsearch.n4.small","elasticsearch.sn2ne.large","elasticsearch.sn2ne.xlarge","elasticsearch.sn2ne.2xlarge","elasticsearch.sn1ne.large"]	The list of specifications that can be set.
amountRange	Object		The allowed range of the number of nodes.
maxAmount	Integer	20	The maximum number of nodes.
minAmount	Integer	1	The minimum number of nodes.
elasticNodeProperties	Object		The configurations of elastic nodes.
diskList	Array of disk		The list of disk configurations.
scaleLimit	Integer	2048	The maximum disk size if continuous disk sizes are allowed.
minSize	Integer	500	The allowed minimum disk size.
diskEncryption	Boolean	true	Indicates whether disk encryption is enabled. Valid values: true: The job can be rerun. false: The job cannot be rerun.
maxSize	Integer	5120	The allowed maximum disk size.
diskType	String	cloud_ssd	The storage type of the disk.
valueLimitSet	Array of String	[2560,3072,3584,4096,4608,5120]	Discrete value allowed on disk.
spec	Array of String	["elasticsearch.sn2ne.large","elasticsearch.sn2ne.xlarge","elasticsearch.sn2ne.2xlarge","elasticsearch.sn2ne.4xlarge","elasticsearch.sn1ne.8xlarge","elasticsearch.ic5.large","elasticsearch.ic5.xlarge","elasticsearch.ic5.2xlarge","elasticsearch.ic5.3xlarge","elasticsearch.ic5.4xlarge","elasticsearch.r5.large","elasticsearch.r5.xlarge","elasticsearch.r5.2xlarge"]	The specification of the node.
amountRange	Object		The range of the number of warm nodes.
maxAmount	Integer	25	The maximum number of nodes.
minAmount	Integer	2	The minimum number of nodes.

Note The preceding sample values are for reference only and are subject to the actual return values of the API operation.

Examples

Sample requests

GET /openapi/region?zoneId=cn-hangzhou-f 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

{
  "RequestId" : "5FFD9ED4-C2EC-4E89-B22B-1ACB6F******",
  "Result" : {
    "regionId" : "cn-hangzhou",
    "createUrl" : "https://common-buy.aliyun.com/?commodityCode=elasticsearch&amp;orderType=BUY#/buy",
    "env" : "production",
    "dataDiskList" : {
      "scaleLimit" : 2048,
      "maxSize" : 5120,
      "minSize" : 20,
      "diskType" : "cloud_ssd",
      "valueLimitSet" : "[2560,3072,3584,4096,4608,5120]"
    },
    "supportVersions" : {
      "instanceCategory" : "x-pack",
      "supportVersionList" : {
        "value" : "5.5.3",
        "key" : 5.5
      }
    },
    "nodeSpecList" : {
      "disk" : 44000,
      "memorySize" : 64,
      "enable" : true,
      "diskType" : "local_efficiency",
      "specGroupType" : "local_efficiency",
      "spec" : "elasticsearch.sn2ne.large",
      "cpuCount" : 16
    },
    "clientNodeDiskList" : {
      "scaleLimit" : 18,
      "maxSize" : 20,
      "minSize" : 20,
      "diskType" : "cloud_efficiency"
    },
    "esVersionsLatestList" : {
      "value" : "5.5.3_with_X-Pack",
      "key" : "5.5_with_X-Pack"
    },
    "masterDiskList" : {
      "scaleLimit" : 20,
      "maxSize" : 20,
      "minSize" : 20,
      "diskType" : "cloud_ssd"
    },
    "zones" : "[\"cn-hangzhou-b\",\"cn-hangzhou-f\"]",
    "esVersions" : "[ \"5.5.3_with_X-Pack\"]",
    "masterSpec" : "[\"elasticsearch.sn2ne.large\",\"elasticsearch.sn2ne.xlarge\",\"elasticsearch.sn2ne.2xlarge\",\"elasticsearch.sn2ne.4xlarge\",\"elasticsearch.sn1ne.4xlarge\",\"elasticsearch.r5.large\",\"elasticsearch.r5.xlarge\",\"elasticsearch.r5.2xlarge\" ]",
    "clientNodeSpec" : "[\"elasticsearch.sn2ne.large\",\"elasticsearch.sn2ne.xlarge\",\"elasticsearch.sn2ne.2xlarge\",\"elasticsearch.sn2ne.4xlarge\",\"elasticsearch.sn1ne.4xlarge\",\"elasticsearch.ic5.xlarge\",\"elasticsearch.ic5.2xlarge\",\"elasticsearch.ic5.3xlarge\",\"elasticsearch.ic5.4xlarge\",\"elasticsearch.r5.large\",\"elasticsearch.r5.xlarge\",\"elasticsearch.r5.2xlarge\"]",
    "instanceSupportNodes" : "[ \"WORKER\", \"WORKER_WARM\", \"COORDINATING\", \"KIBANA\", \"MASTER\", \"ELASTIC_WORKER\" ]",
    "node" : {
      "minAmount" : 2,
      "maxAmount" : 50
    },
    "jvmConfine" : {
      "memory" : 32,
      "supportGcs" : "[\"CMS\",\"G1\"]",
      "supportEsVersions" : "[\"6.7.0_with_X-Pack\",\"6.7.0_with_A-Pack\",\"7.4.0_with_X-Pack\"]"
    },
    "clientNodeAmountRange" : {
      "minAmount" : 2,
      "maxAmount" : 25
    },
    "warmNodeProperties" : {
      "diskList" : {
        "scaleLimit" : 2048,
        "minSize" : 500,
        "maxSize" : 5120,
        "diskType" : "cloud_efficiency",
        "diskEncryption" : true,
        "valueLimitSet" : "[2560,3072,3584,4096,4608,5120]"
      },
      "spec" : "[\"elasticsearch.sn2ne.large\",\"elasticsearch.sn2ne.xlarge\",\"elasticsearch.sn2ne.2xlarge\",\"elasticsearch.sn2ne.4xlarge\",\"elasticsearch.sn1ne.8xlarge\",\"elasticsearch.ic5.large\",\"elasticsearch.ic5.xlarge\",\"elasticsearch.ic5.2xlarge\",\"elasticsearch.ic5.3xlarge\",\"elasticsearch.ic5.4xlarge\",\"elasticsearch.r5.large\",\"elasticsearch.r5.xlarge\",\"elasticsearch.r5.2xlarge\"]",
      "amountRange" : {
        "minAmount" : 2,
        "maxAmount" : 50
      }
    },
    "kibanaNodeProperties" : {
      "spec" : "[\"elasticsearch.n4.small\",\"elasticsearch.sn2ne.large\",\"elasticsearch.sn2ne.xlarge\",\"elasticsearch.sn2ne.2xlarge\",\"elasticsearch.sn1ne.large\"]",
      "amountRange" : {
        "minAmount" : 1,
        "maxAmount" : 20
      }
    },
    "elasticNodeProperties" : {
      "diskList" : {
        "scaleLimit" : 2048,
        "minSize" : 500,
        "maxSize" : 5120,
        "diskType" : "cloud_ssd",
        "diskEncryption" : true,
        "valueLimitSet" : "[2560,3072,3584,4096,4608,5120]"
      },
      "spec" : "[\"elasticsearch.sn2ne.large\",\"elasticsearch.sn2ne.xlarge\",\"elasticsearch.sn2ne.2xlarge\",\"elasticsearch.sn2ne.4xlarge\",\"elasticsearch.sn1ne.8xlarge\",\"elasticsearch.ic5.large\",\"elasticsearch.ic5.xlarge\",\"elasticsearch.ic5.2xlarge\",\"elasticsearch.ic5.3xlarge\",\"elasticsearch.ic5.4xlarge\",\"elasticsearch.r5.large\",\"elasticsearch.r5.xlarge\",\"elasticsearch.r5.2xlarge\"]",
      "amountRange" : {
        "minAmount" : 2,
        "maxAmount" : 25
      }
    }
  }
}

HTTP status code

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