功能介绍
更新 终端节点 。
调用方法
请参见如何调用API。
URI
PUT /v1/endpoint-groups/{endpoint_group_id}/endpoints/{endpoint_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
endpoint_group_id |
是 |
String |
终端节点组ID。 最小长度:1 最大长度:36 |
endpoint_id |
是 |
String |
终端节点ID。 最小长度:1 最大长度:36 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
终端节点ID。 |
resource_id |
String |
对应后端资源ID。 |
endpoint_group_id |
String |
终端节点组ID。 |
resource_type |
String |
终端节点类型。 枚举值:
|
status |
String |
配置状态,取值:
枚举值:
|
weight |
Integer |
终端节点权重。 最小值:0 最大值:100 |
health_state |
String |
终端的健康状态,取值:
枚举值:
|
created_at |
String |
创建时间。 |
updated_at |
String |
更新时间。 |
domain_id |
String |
租户ID。 |
ip_address |
String |
IP地址。 |
frozen_info |
云服务 或资源实例冻结信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
status |
Integer |
云服务或资源实例状态,取值:
最小值:0 最大值:2 |
effect |
Integer |
在冻结/解冻操作下,取值:
最小值:1 最大值:3 缺省值:1 |
scene |
Array of strings |
更新云服务状态的业务场景列表,取值:
最大长度:16 |
请求示例
更新终端节点,将权重修改为5。
PUT https://{ga_endpoint}/v1/endpoint-groups/3a9f50bb-f041-4eac-a117-82472d8a0007/endpoints
/0aa23a52-1ac2-4a2d-8dfa-1e11cb26079d { "endpoint" : { "weight" : 5 } }
响应示例
状态码: 200
操作成功
{ "endpoint" : { "id" : "0aa23a52-1ac2-4a2d-8dfa-1e11cb26079d", "resource_id" : "08155cd2-5897-49be-933f-eec757fd4010", "endpoint_group_id" : "3a9f50bb-f041-4eac-a117-82472d8a0007", "resource_type" : "EIP", "status" : "ACTIVE", "weight" : 5, "health_state" : "HEALTHY", "created_at" : "2019-01-08T01:21:37.151Z", "updated_at" : "2019-01-08T01:21:37.151Z", "domain_id" : "99a3fff0d03c428eac3678da6a7d0f24", "ip_address" : "208.182.11.121", "frozen_info" : { "status" : 2, "effect" : 1, "scene" : [ "ARREAR", "POLICE" ] } }, "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9" }
状态码
状态码 |
描述 |
---|---|
200 |
操作成功 |
错误码
请参见错误码。