PolarisMesh

批量更新服务实例

PUT

/naming/v1/instances

最后修改时间：2024-08-21 04:18:20

责任人：未设置

请求参数

Header 参数

X-Polaris-Token

string

必需

鉴权凭据，当OpenAPI接口鉴权开启时必须开启

Body 参数application/json

array of:

string

实例ID

可选

如果不设置，则由服务端根据 service、namespace、host、port 生成唯一实例ID

service

string

服务名称

必需

namespace

string

命名空间

必需

host

string

实例IP

必需

port

integer

实例端口

必需

location

object

实例的地理信息

可选

region

string

可选

zone

string

可选

campus

string

可选

metadata

object

实例标签

可选

enableHealthCheck

boolean

是否开启健康检查

可选

healthCheck

object

健康检查类型

可选

heartbeat

object

心跳健康检查

可选

type

integer

健康检查类型

可选

healthy

boolean

是否健康

可选

默认值为 true

isolate

boolean

是否隔离

可选

默认值为 false

priority

integer

实例优先级

可选

protocol

string

实例端口协议

可选

version

string

实例版本

可选

weight

integer

实例权重

可选

默认值 100

示例

[
  {
    "service": "EchoServerGolangTest",
    "namespace": "echo",
    "host": "127.0.0.1",
    "port": 8080,
    "location": {
      "region": "ap-guangzhou",
      "zone": "ap-guangzhou-3",
      "campus": ""
    },
    "metadata": {
      "env": "pre"
    }
  }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'http://119.91.66.223:8090/naming/v1/instances' \
--header 'X-Polaris-Token;' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "service": "EchoServerGolangTest",
        "namespace": "echo",
        "host": "127.0.0.1",
        "port": 8080,
        "location": {
            "region": "ap-guangzhou",
            "zone": "ap-guangzhou-3",
            "campus": ""
        },
        "metadata": {
            "env": "pre"
        }
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

info

string

提示信息

必需

示例

{
  "code": 0,
  "info": "string"
}

修改于 2024-08-21 04:18:20

批量创建服务实例

批量删除服务实例