Queries the detailed information of all Logstash clusters or a specified Logstash cluster.
Debugging
Request headers
/openapi/logstashes
Request syntax
GET /openapi/logstashes HTTP/1.1
Request parameters
Parameter | Type | Position | Required | Example | Description |
---|---|---|---|---|---|
page | Integer | Query | No | 1 |
The page number of the returned page. Default value: 1. |
size | Integer | Query | No | 10 |
The number of entries to return on each page. Default value: 20. |
description | String | Query | No | ls-cn-abc |
The name of the instance. You can specify a keyword to match multiple instances. For example, if you query an instance named abc, all the instances named abc, abcde, xyabc, and xabcy may be returned. |
instanceId | String | Query | No | ls-cn-n6w1o5jq**** |
The ID of the instance. |
version | String | Query | No | 5.5.3_with_X-Pack |
The version of the instance. |
resourceGroupId | String | Query | No | rg-acfm2h5vbzd**** |
The ID of the resource group. |
tags | String | Query | No | [{"tagKey":"key1","tagValue":"value1"}] |
The tag of the instance. Valid values: |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | AC442F2F-5068-4434-AA21-E78947A9**** |
The ID of the request. |
Headers | Object |
Details of the request header. |
|
X-Total-Count | Integer | 10 |
The number of entries returned per page. |
Result | Array of Instance |
Detailed information about the matching instances. |
|
paymentType | String | postpaid |
The billing method of the instance. Supported: prepaid (subscription) and postpaid (pay-as-you-go). |
nodeAmount | Integer | 2 |
The number of data nodes. |
description | String | ls-cn-abc |
The name of the VPC. |
createdAt | String | 2018-07-13T03:58:07.253Z |
The time when the instance was created. |
status | String | active |
The state of the instance. Valid values: Normal, Active, Inactive, and Invalid. |
updatedAt | String | 2018-07-18T10:10:04.484Z |
The time when the instance was last updated. |
instanceId | String | ls-cn-n6w1o5jq**** |
The ID of the instance. |
version | String | 6.7.0_with_X-Pack |
The version of the instance. Currently, only 6.7.0_with_X-Pack and 7.4.0_with_X-Pack are supported. |
Tags | Array of tags |
The tag of the instance. Valid values: |
|
TagValue | String | dev |
The tag value of the cloud disk. |
TagKey | String | env |
The tag key of the cloud disk. |
nodeSpec | Object |
The configuration information of the data node. |
|
spec | String | logstash.n4.small |
The instance type of the ECS instance. |
disk | Integer | 50 |
The disk size of the node. |
diskEncryption | Boolean | false |
Specifies whether to use disk encryption. Valid values:
|
diskType | String | cloud_ssd |
The type of the disk. |
networkConfig | Object |
The network configurations. |
|
vpcId | String | vpc-abc |
The ID of the VPC. |
vsArea | String | cn-hangzhou-* |
The zone where the cluster resides. |
type | String | vpc |
The network type. Currently, only Virtual Private Cloud (VPC) is supported. |
vswitchId | String | vsw-def |
The ID of the vSwitch. |
The returned data also contains the following parameters.
Parameter |
Type |
Example |
Description |
---|---|---|---|
enablePublic |
Boolean |
false |
Specifies whether to enable Internet access. Default value: false. |
commodityCode |
String |
elasticsearch_logstash_post |
The code of the service. |
endTime |
Long |
4749897600000 |
The last expiration time of the subscription instance. |
clusterTasks |
Array |
[] |
The task list of the instance. |
resourceGroupId |
String |
rg-acfm2h5vbzd**** |
The ID of the resource group to which the instance belongs. |
zoneCount |
Integer |
1 |
The number of zones in which the Elasticsearch cluster is deployed. |
protocol |
String |
HTTP |
The access protocol of the instance. |
zoneInfos |
Array |
The information about the zones. |
|
└zoneId |
String |
cn-hangzhou-i |
The zone ID of the cluster. |
└status |
String |
NORMAL |
The status of the zone. Supported: ISOLATION (offline) and NORMAL (normal). |
instanceType |
String |
logstash |
The edition of the instance. |
inited |
Boolean |
true |
Indicates whether the instance has been initialized. |
config |
Array |
[] |
Configure ECS instances. |
endpointList |
Array |
The node information. |
|
└host |
String |
172.16.xx.xx |
The IP address of the node. |
└port |
Integer |
9200 |
The access port number of the node. |
└zoneId |
String |
cn-hangzhou-i |
The zone ID of the node. |
Examples
Sample requests
GET /openapi/logstashes?page=1&size=10&description=ls-cn-abc&instanceId=ls-cn-n6w1o5jq****&version=5.5.3_with_X-Pack&resourceGroupId=rg-acfm2h5vbzd****&tags=[{"tagKey":"key1","tagValue":"value1"}] 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" : "ls-cn-n6w1o5jq****",
"version" : "6.7.0_with_X-Pack",
"description" : "test",
"nodeAmount" : 1,
"paymentType" : "postpaid",
"status" : "active",
"enablePublic" : false,
"nodeSpec" : {
"spec" : "elasticsearch.sn1ne.large",
"disk" : 20,
"diskType" : "cloud_ssd"
},
"networkConfig" : {
"vpcId" : "vpc-bp16k1dvzxtmagcva****",
"vswitchId" : "vsw-bp1k4ec6s7sjdbudw****",
"vsArea" : "cn-hangzhou-i",
"type" : "vpc"
},
"createdAt" : "2020-05-27T01:30:15.947Z",
"updatedAt" : "2020-05-27T01:40:51.333Z",
"commodityCode" : "elasticsearch_logstash_post",
"extendConfigs" : [ ],
"endTime" : 4746268800000,
"clusterTasks" : [ ],
"resourceGroupId" : "rg-acfm2h5vbzd****",
"zoneCount" : 1,
"protocol" : "HTTP",
"zoneInfos" : [ {
"zoneId" : "cn-hangzhou-i",
"status" : "NORMAL"
} ],
"instanceType" : "logstash",
"inited" : true,
"tags" : [ ],
"config" : { },
"endpointList" : [ {
"host" : "172.16.**.**",
"port" : 9600,
"zoneId" : "cn-hangzhou-i"
} ]
} ],
"RequestId" : "918C05D8-4689-4A79-B6D5-D2500991****",
"Headers" : {
"X-Total-Count" : 1
}
}
Error codes
For a list of error codes, see Service error codes.