对于注册中心 Nacos 类型 Upstream，通过 Nacos 服务的 metadata，配置不同的灰度版本，可以对注册中心内的服务进行灰度发布，进行多版本管理功能。

添加 Upstream 版本

根据 Nacos 应用的 metadata，配置相应的灰度版本。

1. 登录 API 网关控制台，在顶部导航栏，选择目标地域。

2. 在左侧导航栏选择 后端管理 > Upstream 列表。 在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。

3. 在灰度版本区域，单击 新增灰度版本。在弹出的新增灰度版本对话框中，设置版本信息。

   配置项	说明
   版本名称	自定义名称，用于标识该灰度版本。 名称长度限制为 2～63 个字符。 字符中只能包含大小写字母、数字和中划线(-)。 不能以中划线(-)开头。 同一 Upstream 下版本名称唯一。
   标签	填写当前版本在 Nacos 服务中对应的 metadata（key:value）。您需要根据实际业务的注册信息中选择一个键值对，作为划分当前版本的依据。一般存在于环境变量或 SDK 中。 注意 请务必保证标签的正确性。标签填写错误将导致流量无法转发至当前版本。 相同的标签仅支持配置一个灰度版本。

4. 单击 确定，完成灰度版本配置。

编辑 Upstream 版本

如果您修改了 Nacos 服务的 metadata，需要在网关侧同步修改当前灰度版本对应的标签。

1. 登录 API 网关控制台， 在顶部导航栏，选择目标地域。

2. 在左侧导航栏选择 后端管理 > Upstream 列表。 在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。

3. 在灰度版本表格中，选择要修改的灰度版本，单击 操作 列的 编辑 按钮。

4. 修改标签的键值对，修改完成后单击 确定。

删除 Upstream 版本

如果您在 Nacos 服务的 metadata 已废弃或删除，可删除当前灰度版本。
注意
删除灰度版本前，必须删除当前灰度版本关联的所有路由。

1. 登录 API 网关控制台， 在顶部导航栏，选择目标地域。

2. 在左侧导航栏选择 后端管理 > Upstream 列表。 在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。

3. 在灰度版本表格中，选择要删除的灰度版本，单击 操作 列的 删除 按钮。

4. 在弹出的二次确认框中，单击 删除，删除当前灰度版本。