Nacos API

批量更新实例元数据(Beta)

PUT

/nacos/v1/ns/instance/metadata/batch

批量更新实例元数据(1.4起)

注意：该接口为Beta接口，后续版本可能有所修改，甚至删除，请谨慎使用。

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request PUT 'http://127.0.0.1:8848/nacos/v1/ns/instance/metadata/batch?namespaceId=public&serviceName=xxx@xxx&metadata={{metadata}}'

Response Example

{
  "updated": [
    "2.2.2.2:8080:unknown:xxxx-cluster:ephemeral",
    "3.3.3.3:8080:unknown:xxxx-cluster:ephemeral"
  ]
}

Request

Query Params

namespaceId

string

required

命名空间ID

Example:

public

serviceName

string

required

服务名(group@@serviceName)

Example:

xxx@xxx

consistencyType

string

optional

实例的类型(ephemeral/persist) 优先级高于instances参数，如果进行配置，则忽略instances参数的值。当值为'ephemeral'，则对serviceName下的所有非持久化实例进行更新。当值为'persist'，则对serviceName下的所有持久化实例进行更新。当为其他值，没有实例进行更新。

instances

string

optional

需要更新的实例,json数组。通过ip+port+ephemeral+cluster定位到某一实例。

metadata

string

required

元数据信息

Example:

Responses

🟢200成功

application/json

Body

updated

array[string]

required

Modified at 2022-11-14 02:31:26

更新实例的健康状态

批量删除实例元数据(Beta)