Eureka REST 相关接口

---

可供非 Java 应用程序使用的 Eureka REST 操作。

appID 是应用程序的名称，instanceID 是与实例关联的唯一标识符。在 AWS 云中，instanceID 是实例的实例 ID；在其他数据中心，它是实例的主机名。

对于 XML/JSON，HTTP 的 ACCEPT 类型以及提供的 content-type 必须分别包含 application/xml 或 application/json。

操作	HTTP 动作	描述
注册新应用程序实例	POST /eureka/v2/apps/{appID}	输入： JSON/XML 负载 HTTP 状态码： 成功时返回 204
注销应用程序实例	DELETE /eureka/v2/apps/{appID}/{instanceID}	HTTP 状态码： 成功时返回 200
发送应用程序实例心跳	PUT /eureka/v2/apps/{appID}/{instanceID}	HTTP 状态码： * 成功时返回 200 * 如果 instanceID 不存在则返回 404
查询所有实例	GET /eureka/v2/apps	HTTP 状态码： 成功时返回 200 输出： JSON/XML
查询特定 appID 的所有实例	GET /eureka/v2/apps/{appID}	HTTP 状态码： 成功时返回 200 输出： JSON/XML
查询特定 appID/instanceID	GET /eureka/v2/apps/{appID}/{instanceID}	HTTP 状态码： 成功时返回 200 输出： JSON/XML
查询特定 instanceID	GET /eureka/v2/instances/{instanceID}	HTTP 状态码： 成功时返回 200 输出： JSON/XML
将实例移出服务	PUT /eureka/v2/apps/{appID}/{instanceID}/status?value=OUT_OF_SERVICE	HTTP 状态码： * 成功时返回 200 * 失败时返回 500
将实例移回服务（移除覆盖状态）	DELETE /eureka/v2/apps/{appID}/{instanceID}/status?value=UP	HTTP 状态码： * 成功时返回 200 * 失败时返回 500 (value=UP 是可选的，它作为移除覆盖状态后回退状态的建议值)
更新元数据	PUT /eureka/v2/apps/{appID}/{instanceID}/metadata?key=value	HTTP 状态码： * 成功时返回 200 * 失败时返回 500
查询特定 vip 地址下的所有实例	GET /eureka/v2/vips/{vipAddress}	HTTP 状态码： * 成功时返回 200，输出：JSON/XML * 如果 vipAddress 不存在则返回 404
查询特定安全 vip 地址下的所有实例	GET /eureka/v2/svips/{svipAddress}	HTTP 状态码： * 成功时返回 200，输出：JSON/XML * 如果 svipAddress 不存在则返回 404

注册 (REGISTER)

注册时，需要提交一个符合以下 XSD 的 XML（或 JSON）请求体：

{"$schema": "http://json-schema.org/draft-04/schema#","title": "Eureka Instance Registration","type": "object","required": ["hostName","app","ipAddr","vipAddress","secureVipAddress","status","securePort","homePageUrl","statusPageUrl","healthCheckUrl","dataCenterInfo"],"properties": {"hostName": {"type": "string","description": "在 EC2 中应为公共 DNS 名称（在 EC2 内部解析为私有 IP）"},"app": {"type": "string","description": "应用程序名称 (appID)"},"ipAddr": {"type": "string","description": "实例的 IP 地址"},"vipAddress": {"type": "string","description": "虚拟 IP 地址"},"secureVipAddress": {"type": "string","description": "安全虚拟 IP 地址"},"status": {"type": "string","enum": ["UP", "DOWN", "STARTING", "OUT_OF_SERVICE", "UNKNOWN"],"description": "实例状态"},"port": {"type": "integer","minimum": 1,"description": "服务端口（可选）"},"securePort": {"type": "integer","minimum": 1,"description": "安全端口"},"homePageUrl": {"type": "string","description": "主页 URL"},"statusPageUrl": {"type": "string","description": "状态页 URL"},"healthCheckUrl": {"type": "string","description": "健康检查 URL"},"dataCenterInfo": {"type": "object","required": ["name"],"properties": {"name": {"type": "string","enum": ["MyOwn", "Amazon"],"description": "数据中心名称"},"metadata": {"type": "object","properties": {"ami-launch-index": {"type": "string"},"local-hostname": {"type": "string"},"availability-zone": {"type": "string"},"instance-id": {"type": "string"},"public-ipv4": {"type": "string"},"public-hostname": {"type": "string"},"ami-manifest-path": {"type": "string"},"local-ipv4": {"type": "string"},"hostname": {"type": "string"},"ami-id": {"type": "string"},"instance-type": {"type": "string"}},"description": "仅当 name 为 Amazon 时需要 AWS 元数据","additionalProperties": false}},"additionalProperties": false},"leaseInfo": {"type": "object","properties": {"evictionDurationInSecs": {"type": "integer","minimum": 1,"description": "租约驱逐时间（秒），默认为 90 秒（可选）"}},"additionalProperties": false},"metadata": {"type": "object","description": "应用特定的键值对元数据（可选）","additionalProperties": {"type": ["string", "number", "boolean", "null"]}}},"additionalProperties": false
}

续约 (RENEW)

示例： PUT /eureka/v2/apps/MYAPP/i-6589ef6

响应：
• 状态码: 200 (成功)

• 状态码: 404 (Eureka 不认识该实例，请先注册)

• 状态码: 500 (失败)

注销 (CANCEL)

(如果 Eureka 在 evictionDurationInSecs（驱逐持续时间）内未收到服务节点的心跳，则该节点将自动注销)

示例： DELETE /eureka/v2/apps/MYAPP/i-6589ef6

响应：
• 状态码: 200 (成功)

• 状态码: 500 (失败)

---