UpdateLogstashDescription - 修改Logstash实例名称-检索分析服务 Elasticsearch版(ES)-阿里云帮助中心

接口说明

调用该接口时，请注意：实例状态为生效中（activating）、失效（invalid）和冻结（inactive）时，无法修改实例名称。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

elasticsearch:UpdateLogstashDescription

*Logstash

acs:elasticsearch:{#regionId}:{#accountId}:logstashes/{#logstashesId}

无

PATCH /openapi/logstashes/{InstanceId}/description HTTP/1.1

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	ls-cn-n6w1o5jq****

名称	类型	必填	描述	示例值
clientToken	string	否	用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不超过 64 个 ASCII 字符。	5A2CFF0E-5718-45B5-9D4D-70B3FF****
body	object	否	修改 Logstash 实例名称的请求体。
description	string	否	修改后的 Logstash 实例名称。	logstash_name

RequestBody 中还需填入 description 字段，用来指定修改后的实例名称，示例如下。

{
    "description": "logstash_name"
}

Result 中还包含以下参数。

参数名称	数据类型	示例值	描述
instanceId	String	ls-cn-n6w1o5jq****	实例 ID。
description	String	ls-cn-abc	实例名称。
nodeAmount	Integer	2	实例的节点个数。
paymentType	String	postpaid	实例的付费方式。支持：prepaid（包年包月）、postpaid（按量付费）。
status	String	active	实例的状态，支持四种状态：正常（active）、生效中（activating）、冻结（inactive）和失效（invalid）。
esVersion	String	6.7.0_with_X-Pack	实例的版本。
createdAt	String	2018-07-13T03:58:07.253Z	实例的创建时间。
updatedAt	String	2018-07-13T03:58:07.253Z	实例最后更新的时间。
nodeSpec			节点的配置信息。
└spec	String	logstash.n4.small	节点规格。
└disk	Integer	40	节点的硬盘大小。
networkConfig			网络配置。
└type	String	vpc	网络类型。目前只支持专有网络 VPC（Virtual Private Cloud）。
└vpcId	String	vpc-abc	VPC ID。
└vswitchId	String	vsw-abc	虚拟交换机 ID。
vsArea	String	cn-hangzhou-*	实例所在的可用区。
domainList			域名列表。
└domain	String	ls-cn-abc.logstash.aliyuncs.com	实例分配的私网域名。
└port	Integer	7001	端口号。

说明

└表示子参数，其他参数说明请参见 ListLogstash 。

正常返回示例

JSON格式

{
  "RequestId": "5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****",
  "Result": {
    "description": "logstash_name"
  }
}

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

更多信息，参考变更详情。