调用UpdateInstance,修改一个实例的部分信息,包含节点数、配额、名称、硬盘等。

调用该接口时,您需要注意:

  • 当实例状态为生效中(activating)、失效(invalid)和冻结(inactive)时,无法修改信息。
  • 一次只能修改一种资源,例如不能同时变更实例规格和磁盘大小。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

PUT /openapi/instances/[InstanceId] HTTP/1.1

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String es-cn-xxx

实例ID。

clientToken String 5A2CFF0E-5718-45B5-9D4D-70B3FF****

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符。

需要填写body请求参数,详情请参见请求示例

返回数据

名称 类型 示例值 描述
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

当前请求的Request ID。

Result

当前请求返回的实例。

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

实例创建时间。

description String test

实例名称。

dictList Array

IK词典配置。

dictList

IK词典配置。

fileSize Long 1000

IK词典文件大小,单位:字节。

name String test.dic

IK词典文件名称。

sourceType String ORIGIN

来源类型。

type String MAIN

IK词典类型。可选值:MAIN(主分词)、STOP(停用词)。

domain String es-cn-abc.elasticsearch.aliyuncs.com

实例分配的私网域名。

esVersion String 5.5.3_with_X-Pack

实例版本。

instanceId String es-cn-abc

实例ID。

kibanaConfiguration

Kibana节点配置。

amount Integer 1

Kibana节点数量。

disk Integer 0

Kibana节点硬盘大小。

diskType String cloud_ssd

Kibana节点磁盘类型。(忽略)

spec String elasticsearch.n4.small

Kibana节点规格。

kibanaDomain String es-cn-abc.kibana.elasticsearch.aliyuncs.com

分配给Kibana节点的私网域名。

kibanaPort Integer 5061

分配给Kibana节点的端口。

masterConfiguration

Master节点配置。

amount Integer 3

Master节点数量。

disk Integer 20

Master节点的磁盘大小。单位:GB。

diskType String cloud_ssd

Master节点的磁盘类型。cloud_ssd:SSD云盘。

spec String elasticsearch.sn2ne.large

Master节点的规格。

networkConfig

网络配置。

type String vpc

网络类型,目前只支持VPC网络。

vpcId String vpc-abc

虚拟专有网络ID。

vsArea String cn-hangzhou-a

实例所在的可用区。

vswitchId String vsw-abc

虚拟交换机ID。

nodeAmount Integer 2

Node节点的数量。

nodeSpec

数据节点配置信息。

disk Integer 40

数据节点硬盘大小,单位为GB。

diskType String cloud_ssd

数据节点硬盘类型。cloud_ssd:SSD云盘。

spec String elasticsearch.sn2ne.xlarge

数据节点规格。

paymentType String postpaid

实例的付费方式。可选值:prepaid(包年包月)和postpaid(按量付费)。

publicDomain String es-cn-abc.elasticsearch.aliyuncs.com

当前实例的公网地址。

publicPort Integer 8033

公网端口。

status String active

实例的状态。可选值:active(正常)、activating(生效中)、inactive(冻结)和invalid(失效)。

synonymsDicts Array

同义词词典配置。

synonymsDicts

同义词词典配置。

fileSize Long 100

同义词词典文件大小。单位:字节。

name String dicts.txt

同义词文件名称。

sourceType String ORIGIN

来源类型。

type String MAIN

词典类型。可选值:MAIN(主分词)、STOP(停用词)。

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

实例最后更新时间。

示例

请求示例

PUT /openapi/instances/[InstanceId] HTTP/1.1
公共请求头
{
  "InstanceId": "es-cn-xxx"
}

请求示例补充说明

body请求示例:
{
  "nodeSpec": {
      "disk": 40
    }
}

正常返回示例

XML 格式

<Result>
    <instanceId>es-cn-abc</instanceId>
    <domain>es-cn-abc.elasticsearch.aliyuncs.com</domain>
    <description>test</description>
    <nodeAmount>2</nodeAmount>
    <paymentType>postpaid</paymentType>
    <paymentInfo/>
    <status>active</status>
    <port>9200</port>
    <esVersion>5.5.3_with_X-Pack</esVersion>
    <esConfig>
        <action.destructive_requires_name>true</action.destructive_requires_name>
        <xpack.security.audit.outputs>logfile</xpack.security.audit.outputs>
        <xpack.watcher.enabled>false</xpack.watcher.enabled>
        <action.auto_create_index>+.*,-*</action.auto_create_index>
    </esConfig>
    <kibanaDomain>es-cn-abc.kibana.elasticsearch.aliyuncs.com</kibanaDomain>
    <publicDomain/>
    <enablePublic>false</enablePublic>
    <nodeSpec>
        <spec>elasticsearch.n4.small</spec>
        <disk>40</disk>
    </nodeSpec>
    <networkConfig>
        <vpcId>vpc-abc</vpcId>
        <vswitchId>vsw-abc</vswitchId>
        <vsArea>cn-hangzhou-b</vsArea>
        <type>vpc</type>
    </networkConfig>
    <createdAt>2018-07-20T06:20:18.665Z</createdAt>
    <updatedAt>2018-07-20T06:37:29.266Z</updatedAt>
    <inited>true</inited>
    <dedicateMaster>false</dedicateMaster>
    <commodityCode>elasticsearch</commodityCode>
    <endTime>4687776000000</endTime>
</Result>
<RequestId>9FCBC546-3868-44B8-A102-5493C8C5****</RequestId>

JSON 格式

{
	"Result":{
		"port":9200,
		"nodeAmount":2,
		"kibanaIPWhitelist":[],
		"esVersion":"5.5.3_with_X-Pack",
		"enablePublic":false,
		"endTime":4687776000000,
		"nodeSpec":{
			"spec":"elasticsearch.n4.small",
			"disk":40
		},
		"inited":true,
		"description":"test",
		"kibanaDomain":"es-cn-abc.kibana.elasticsearch.aliyuncs.com",
		"createdAt":"2018-07-20T06:20:18.665Z",
		"dictList":[],
		"domain":"es-cn-abc.elasticsearch.aliyuncs.com",
		"dedicateMaster":false,
		"publicIpWhitelist":[],
		"esConfig":{
			"xpack.watcher.enabled":"false",
			"action.destructive_requires_name":"true",
			"xpack.security.audit.outputs":"logfile",
			"action.auto_create_index":"+.*,-*"
		},
		"status":"active",
		"paymentType":"postpaid",
		"instanceId":"es-cn-abc",
		"esIPWhitelist":[],
		"updatedAt":"2018-07-20T06:37:29.266Z",
		"esIPBlacklist":[],
		"networkConfig":{
			"vpcId":"vpc-abc",
			"vswitchId":"vsw-abc",
			"vsArea":"cn-hangzhou-b",
			"type":"vpc"
		},
		"commodityCode":"elasticsearch"
	},
	"RequestId":"9FCBC546-3868-44B8-A102-5493C8C5****"
}

错误码

HttpCode 错误码 错误信息 描述
400 InstanceNotFound The instanceId provided does not exist 实例找不到,请核对实例状态

访问错误中心查看更多错误码。