华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 访问令牌，承载用户的身份、权限等信息。 token所需权限请参见授权项。 表3 请求Body参数 参数 是否必选 参数类型 描述 protocol 是 Object 协议信息。 表4 protocol 参数 是否必选 参数类型 描述 mapping_id 否 String 映射ID。身份提供商类型为iam_user_sso时，不需要绑定映射ID，无需传入此字段;否则此字段必填。

响应示例 状态码为 200 时: 请求成功。 { "protocol": { "mapping_id": "ACME", "id": "saml", "links": { "self": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME/protocols/saml", "identity_provider": "https://iam.myhuaweicloud.com/v3/OS-FEDERATION/identity_providers/ACME" } } }

创建命名空间 当创建实例时，会自动生成一个默认的命名空间public（保留空间）， 该命名空间不可编辑和删除。您可以直接使用此命名空间实现资源和服务的隔离。一共可以创建50个命名空间。 登录微服务引擎控制台。 在左侧导航栏选择“注册配置中心”。 单击待操作的Nacos引擎实例名称。 在左侧导航栏选择“命名空间”，单击“创建命名空间”。 在弹出的创建命名空间对话框中设置参数如下，其中带*的配置项为必填。 表1 命名空间参数 参数 说明 *命名空间名称 可自定义填写命名空间名称，支持除@、#、$、%、^、&和*外的任意字符，且不超过128个字符。 命名空间ID 仅支持大小写字母、数字、短划线（-）和下划线（_）,且不超过128个字符。命名空间ID必须唯一。 说明： 创建时若未输入ID值，则由系统随机生成。 单击“确定”，命名空间创建完成。

灰度发布 为保障新特性能平稳上线，可以通过灰度发布功能选择少部分用户试用，待新特性成熟以后，再切换版本让所有用户使用。 基于ServiceComb Java Chassis框架开发的微服务需要在POM中添加依赖darklaunch或handler-router，并且在配置文件中增加servicecomb.router.type=router。 基于Spring Cloud Huawei框架开发的微服务需要在POM中增加依赖spring-cloud-starter-huawei-router。 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 单击“微服务目录”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 在“微服务列表”页签，单击微服务名称，进入详情页面，单击“灰度发布”。 单击“添加发布规则”，弹出“创建新规则”弹框。 按照权重方式添加灰度规则。 “发布规则”选择“权重”，显示权重规则设置页签。 对权重规则进行设置，权重规则配置项如下表所示。 配置项 说明 规则名称 自定义规则名称。 作用域 选择规则作用的版本。 勾选“是否添加自定义版本”，根据界面提示添加新版本。 规则配置 配置所选版本的引流权重，流量会按照配置的百分比分配给所选择的服务版本。 单击“确定”，完成权重规则配置和灰度发布。 按照自定义方式添加灰度规则。 只有ServiceComb Java Chassis框架开发的微服务通过依赖darklaunch实现灰度能力和Spring Cloud Huawei框架开发的微服务实现灰度能力，可通过此功能实现下发灰度规则。依赖handler-router下发的灰度规则需要手动在配置中心下发。 “发布规则”选择“自定义”，显示自定义规则设置页签。 对自定义规则进行设置，自定义规则配置项如下表所示。 配置项 说明 规则名称 自定义规则名称。 作用域 选择规则作用的版本。 勾选“是否添加自定义版本”，根据界面提示添加新版本。 规则配置 设置匹配规则的参数，使用darklaunch实现灰度能力时，设置的是policyCondition内容，其他设置的是Headers参数。 Spring Cloud Huawei框架开发的微服务设置的Headers参数请参见设置Header参数 。 参数名 根据契约的参数名或Header自定义的key作为参数名设置。 规则 通过选择匹配符和契约的Key或Header的Key对应的Value确定符合该规则的请求将被分配到微服务版本中。 说明： 当匹配符选~时，可使用*或者?字符的模糊匹配规则自定义规则值，*表示任意长度字符，?表示一个字符。比如，字段Name的规则值配置为*1000时，表示Name后4位为1000的都能匹配上。 当匹配符没有选~时，*或者?字符只是普通字符，没有模糊匹配的作用。 单击“确定”，完成自定义规则配置和灰度发布。 下发灰度发布规则样例如下： ServiceComb Java Chassis框架开发的微服务，在ServiceComb引擎页面下发规则是基于darklaunch依赖下发的，通过配置自定义方式添加灰度规则。 其中，在规则配置中，参数名Key必须是契约里面存在的。有可能服务端接口写的是String paramA，加了注解实际生成的是paramB，所以这里应该是写paramB。 通过选择匹配符和契约的Key对应的Value确定符合该规则的请求将被分配到微服务版本中。 成功下发的规则内容如下：配置项为cse.darklaunch.policy.${serviceName}。 ServiceComb Java Chassis框架开发的微服务，依赖handler-router下发的灰度规则需要手动在配置中心下发，配置项为：servicecomb.routeRule.${serviceName}，内容如下： Spring Cloud Huawei框架开发的微服务，ServiceComb引擎页面下发灰度规则如下：

查看实例列表 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 单击“微服务目录”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击“实例列表”，进入实例列表查看引擎的所有实例。 支持使用微服务名称搜索目标实例，也可以选择环境、应用筛选实例。

删除微服务 微服务删除后，可通过恢复备份数据进行恢复。 如果删除的服务有实例，需要先将对应实例删除，否则服务会再次注册。 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 单击“微服务目录”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击“微服务列表”，进入微服务列表： 批量删除微服务：勾选待删除的微服务，单击微服务列表上面的“删除”。 删除单个微服务：单击待删除微服务所在行“操作”列的“删除”。 在输入框输入“DELETE”确认删除，单击“确定”。

查看微服务列表 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 单击“微服务目录”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击“微服务列表”，查看该引擎下当前账号下的所有微服务。 支持使用微服务名称搜索目标服务，也可以选择环境、应用筛选服务。

查看微服务详情 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 单击“微服务目录”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击“微服务列表”下待查看的微服务名称，进入微服务详情页查看实例列表、被调用服务、调用服务、配置、服务契约等信息。

查看应用列表 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 单击“微服务目录”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击“应用列表”，查看该引擎下当前账号下的所有应用的详细信息。 支持使用应用名称搜索目标应用，也可以选择环境，筛选应用。

控制台资源管理 Nacos引擎支持命名空间关联企业项目，关系为N:1，即N个命名空间可关联到一个企业项目。 默认在创建命名空间中创建的命名空间是没有关联企业项目，可以通过编辑企业项目操作，将命名空间同企业项目进行关联。 登录微服务引擎控制台。 在左侧导航栏选择“注册配置中心”。 单击待操作的Nacos引擎。 在左侧导航栏选择“权限控制”。 在“控制台资源管理”页签下，单击待操作的命名空间右侧“企业项目”的，在“编辑企业项目”弹出框中，在下拉框中选择企业项目，单击“确定”，编辑成功。 编辑企业项目时，只支持更换企业项目，不可将企业项目置空。 父主题： 权限控制

创建证书 登录微服务引擎控制台。 在左侧导航栏选择“应用网关 ”。 单击待操作的实例名称。 在左侧导航栏，选择“证书管理”。 单击“创建证书”，在弹出框中配置如下参数，其中带*为必填参数。 表1 证书配置参数 参数 说明 *证书名称 自定义输入合法的证书名称。支持以点（.）和短划线（-）连接的小写字母和数字，不超过128个字符。 *证书类型 支持 域名 证书。 *证书文件 在使用HTTPS协议时，服务器证书用于SSL握手协商，需提供证书内容和私钥。证书包含证书的公钥和签名等信息，证书扩展名为“.pem”或“.crt”，您可直接输入证书内容或单击“上传”上传证书文件。 *私钥文件 在使用HTTPS协议时，服务器证书用于SSL握手协商，需提供证书内容和私钥。证书的私钥，私钥扩展名为“.key”，您可直接输入私钥文件内容或单击“上传”上传符合格式的私钥文件。 单击“确定”，完成证书创建。

管理标签 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版 ”。 单击待操作的引擎的名称，进入该引擎的详细信息页面。 在“ServiceComb引擎信息”区域的“标签”参数处，您可以根据实际需要，执行以下操作： 新增标签 新增标签会影响引擎业务十秒左右，请在业务低峰期时增加。 单击“标签管理”，弹出“编辑标签”窗口。 单击“ 新增标签”，您可在输入框分别输入标签键和标签值。 单击“确定”，为实例添加标签成功。 修改标签 修改标签会影响引擎业务十秒左右，请在业务低峰期时修改。 单击“标签管理”，弹出“编辑标签”窗口。 您可在原有的输入框中修改标签键与标签值信息。 单击“确定”，标签修改成功。 删除标签 单击标签所在行的，在弹出的确认框中单击“确定”，删除该标签。

示例流程 图1 给用户授权微服务引擎权限流程 创建用户组并授权 在 IAM 控制台创建用户组，并授予 CS E“CSE ReadOnlyAccess”权限。 创建用户并加入用户组。 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，验证微服务引擎的只读权限。 在“服务列表”中选择“微服务引擎 CSE”，进入微服务引擎控制台，在左侧导航栏选择“ServiceComb”，单击“购买微服务引擎”，若提示权限不足，表示“CSE ReadOnlyAccess”已生效。 在“服务列表”中选择除微服务引擎 CSE外的任一服务，若提示权限不足，表示“CSE ReadOnlyAccess”已生效。

扩容应用网关 应用网关规格支持在线扩容，只有低规格的实例支持扩容到高规格。 登录微服务引擎控制台。 左侧导航栏选择“应用网关 ”。 单击待操作的实例“操作”栏的“扩容”，也可在应用网关的“基础信息”页面，单击“基础信息”区域“容量规格”后的“扩容”。 在“应用网关规格变更”页面，选择待变更的规格。 单击“立即变更”，确认无误后，单击“提交”。待实例运行状态由“变更中”变成“可用”时，扩容成功。 父主题： 管理应用网关

查看角色 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的开启了安全认证的ServiceComb引擎。 单击“系统管理”。 在弹出的“安全认证”对话框输入该ServiceComb引擎下关联了admin角色权限的账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 在“角色管理”页签，单击待查看角色名称前的，展开待查看角色的详细信息。 展开后可以查看角色的服务组、配置组和“权限动作”。

编辑角色 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的开启了安全认证的ServiceComb引擎。 单击“系统管理”。 在弹出的“安全认证”对话框输入该ServiceComb引擎下关联了admin角色权限的账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 在“角色管理”页签，单击待编辑角色“操作”列的“编辑”。 根据实际业务需求，修改服务组、配置组和“权限动作”。 单击“保存”，完成角色编辑。

删除角色 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的开启了安全认证的ServiceComb引擎。 单击“系统管理”。 在弹出的“安全认证”对话框输入该ServiceComb引擎下关联了admin角色权限的账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 在“角色管理”页签，单击待删除角色“操作”列的“删除”。在弹出的对话框中输入“DELETE”，单击“确定”。 角色删除后无法恢复，请谨慎操作。 删除角色前要先确认该角色没有被账号关联。取消角色同账号之间的关联，请参考编辑账号。

创建角色 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的开启了安全认证的ServiceComb引擎。 单击“系统管理”。 在弹出的“安全认证”对话框输入该ServiceComb引擎下关联了admin角色权限的账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 在“角色管理”页签，单击“创建角色”。 输入新角色名称。 角色创建后，角色名称不可修改。 对权限进行配置。 设置“权限组”。 设置服务权限。 选择“全部服务”。 可以对该ServiceComb引擎的所有微服务资源实施相应的权限动作。 选择“自定义服务组”，可按照表2进行设置。 表2 自定义服务组操作 操作名称 操作说明 新增匹配规则 单击“添加服务组匹配规则”，根据实际业务需要，选择“应用”、“环境”、“服务”三个参数值来匹配规则过滤该角色可以实施权限动作的微服务。 说明： 应用名称、环境名称和服务名称是微服务的三个参数： 如果单条匹配规则只设置了一个参数，则角色对与该参数值相匹配的微服务有操作权限。 例如添加匹配规则“环境:production”，那么该角色只对环境名称是“production”的微服务有操作权限。 如果单条匹配规则设置了多于一个参数，则角色对与所有参数值都相匹配的微服务有操作权限。 例如添加匹配规则“环境:production”“应用:abc”，那么该角色对环境名称是“production”且应用名称是“abc”的微服务有操作权限。 在启用自动发现的情况下，微服务会通过注册中心查询注册中心、配置中心、仪表盘等服务的实例地址。对微服务授予查询权限时，需要包含应用default的权限，添加匹配规则“应用:default”。 设置微服务匹配规则后，单击“确定”。 编辑匹配规则 单击待编辑的匹配规则后的“”，即可根据实际业务需要，重新设置该条匹配规则的“服务组”和“权限动作”。 重新设置服务组匹配规则后，单击“确定”。 删除匹配规则 单击待删除的匹配规则后的“”，即可根据实际业务需要，删除该条服务组匹配规则。 自定义服务组最多可以同时设置20条微服务匹配规则。 当自定义服务组设置了多条匹配规则时，只要微服务满足其中任意一条匹配规则，角色就对该微服务有操作权限。 设置配置权限。 选择“全部配置”。 可以对该ServiceComb引擎的所有配置资源实施相应的权限动作。 选择“自定义配置组”，可按照表3进行设置。 表3 自定义配置组操作 操作名称 操作说明 新增匹配规则 单击“添加配置组匹配规则”，根据实际业务需要，选择“应用”、“环境”、“服务”三个参数值来匹配规则过滤该角色可以实施权限动作的配置。当应用级配置、微服务级配置不能满足使用需求时，也可以通过增加自定义匹配规则来匹配配置的自定义标签过滤该角色可以实施权限动作的配置。 说明： 应用名称、环境名称和服务名称是配置的三个参数： 如果单条匹配规则只设置了一个参数，则角色对与该参数值相匹配的配置有操作权限。 例如添加匹配规则“环境:production”，那么该角色只对环境名称是“production”的配置有操作权限。 如果单条匹配规则设置了多于一个参数，则角色对与所有参数值都相匹配的配置有操作权限。 例如添加匹配规则“环境:production”“应用:abc”，那么该角色对环境名称是“production”且应用名称是“abc”的配置有操作权限。 设置配置匹配规则后，单击“确定”。 编辑匹配规则 单击待编辑的匹配规则后的“”，即可根据实际业务需要，重新设置该条匹配规则的配置组和“权限动作”。 重新设置配置组匹配规则后，单击“确定”。 删除匹配规则 单击待删除的匹配规则后的“”，即可根据实际业务需要，删除该条配置组匹配规则。 自定义配置组最多可以同时设置20条配置匹配规则。 当自定义配置组设置了多条匹配规则时，只要配置满足其中任意一条匹配规则，角色就对该配置有操作权限。 设置“权限动作”。 按照实际的业务需求，设置角色对选择的服务组、配置组可实施的权限动作，可以勾选多个。 全选：对该服务组、配置组资源可实施增加、删除、修改和查询四种动作。 增加：对该服务组、配置组资源可实施增加的动作。 删除：对该服务组、配置组资源可实施删除的动作。 如果只勾选了删除，将无法通过界面对服务组、配置组资源进行删除，必须同时勾选查询。 修改：对该服务组资源可实施修改的动作。 如果只勾选了修改，将无法通过界面对服务组、配置组资源进行修改操作，必须同时勾选查询。 查询：对该服务组、配置组资源可实施查询的动作。 单击“创建”，创建角色。

删除ServiceComb引擎 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待删除的引擎“操作”列的“删除”，也可单击待删除的引擎，在“ServiceComb引擎信息”区域，单击“删除”。 当引擎“计费模式”为“包年/包月”时，单击“退订”，在弹出的对话框中单击“确定”。进入费用中心退订资源页面，请根据页面提示完成退订操作。 在弹出的对话框中输入“DELETE”，单击“确定”。 若删除失败，可执行“强制删除”。

管理标签 登录微服务引擎控制台。 在左侧导航栏选择“应用网关 ”。 单击待查看的实例的名称，进入该实例的基本信息页面。 在“更多设置”区域的“标签”参数处，您可以根据实际需要，执行以下操作： 新增标签 新增标签会影响网关业务十秒左右，请在业务低峰期时增加。 单击“标签管理”，弹出“编辑标签”窗口。 单击“ 新增标签”，您可在输入框中分别输入标签键和标签值。 单击“确定”，为实例添加标签成功。 修改标签 修改标签会影响网关业务十秒左右，请在业务低峰期时修改。 单击“标签管理”，弹出“编辑标签”窗口。 您可在原有的输入框中修改标签键与标签值信息。 单击“确定”，标签修改成功。 删除标签 单击标签所在行的，在弹出的确认框中单击“确定”，删除该标签。

查看服务列表 登录微服务引擎控制台。 在左侧导航栏选择“注册配置中心”。 单击待查看的Nacos引擎实例名称。 选择“服务管理”，在“命名空间”下拉框中选择命名空间，在“命名空间ID”框中自动填充ID。 当选择的命名空间为“public”即保留空间，其命名空间ID默认为空。 查看该引擎该命名空间下的所有服务。 支持使用服务名称和分组名称搜索目标服务。 搜索目标服务时，模糊查询支持的字符有：,$*+.|?。

查看服务详情 登录微服务引擎控制台。 在左侧导航栏选择“注册配置中心”。 单击待操作的Nacos引擎实例名称。 在左侧导航栏选择“服务管理”。 单击待查看的服务名，可查看服务详情。 查看服务基本信息，包括服务名称、命名空间名称、服务分组、命名空间ID、保护阈值和集群数。 在“实例信息”页签，可查看实例信息，包括实例的IP、端口、所属集群、健康状态、上下线状态、权重和元数据，也可进行实例操作，如根据元数据搜索实例、对实例进行上下线和修改权重等操作。 在“订阅者”页签，可查看所有订阅当前服务的客户端实例列表。列表中可以查看订阅者和客户端的版本。

创建服务 您可以通过控制台创建服务，刚创建的服务为空服务（即提供者数量为0），在服务列表中默认显示空服务，若您不想再显示空服务，可单击“隐藏空服务”后的隐藏空服务。 登录微服务引擎控制台。 在左侧导航栏选择“注册配置中心”。 单击待操作的Nacos引擎实例名称。 在左侧导航栏选择“服务管理”。 在“命名空间”下拉框中选择命名空间，在“命名空间ID”框中自动填充ID。 当选择的命名空间为“public”即保留空间，其命名空间ID默认为空。 单击“创建服务”，在“创建服务”弹出框中输入配置项信息如下，其中带*的配置项为必填。 表1 配置项 配置项 说明 *服务名称 可自定义输入服务名称。支持输入数字、大小写字母和特殊字符（_-.:），长度不超过236个字符。 分组 可设置服务所属分组。支持输入数字、大小写字母和特殊字符（_-.:），长度不超过128个字符。 *保护阈值 该服务下的健康实例占总实例数比例不足阈值时，触发保护阈值。取值范围为0~1，默认为0。 单击“确定”，服务创建完成。

实例操作 根据元数据搜索：在“实例信息”页签，在“集群列表”中选择某集群，在“元数据搜索”输入框中分别输入元数据的key及value值，单击“添加筛选”可显示符合条件的实例信息。也可单击“清空”清空搜索数据。 实例上下线：在“实例信息”页签，单击待操作的实例右侧“操作”栏的“上线”或“下线”可将该实例进行上下线，待操作完成，其实例的“上下线状态”也会同步更新。 修改实例权重：在“实例信息”页签，鼠标放置待修改权重值的实例的“权重”列，单击修改权重值，其取值范围为1~99，修改完成后，单击“确定”。 若使用Nacos的权重功能，进行流量负载分摊，需要在客户端注册Nacos提供的NacosRule为Bean。 @Bean NacosRule nacosRule() { return new NacosRule(); } 并在application.properties配置文件中增加配置。 xxx-service.ribbon.NFLoadBalancerRuleClassName=com.alibaba.cloud.nacos.ribbon.NacosRule 其中xxx-service为客户端的服务名称，即 spring.application.name=xxx-service

管理标签 登录微服务引擎控制台。 在左侧导航栏选择“注册配置中心 ”。 单击待操作的引擎的名称，进入该引擎的详细信息页面。 在“更多设置”区域的“标签”参数处，您可以根据实际需要，执行以下操作： 新增标签 新增标签会影响Nacos引擎业务十秒左右，请在业务低峰期时增加。 单击“标签管理”，弹出“编辑标签”窗口。 单击“ 新增标签”，您可在输入框分别输入标签键和标签值。 单击“确定”，为实例添加标签成功。 修改标签 修改标签会影响Nacos引擎业务十秒左右，请在业务低峰期时修改。 单击“标签管理”，弹出“编辑标签”窗口。 您可在原有的输入框中修改标签键与标签值信息。 单击“确定”，标签修改成功。 删除标签 单击标签所在行的，在弹出的确认框中单击“确定”，删除该标签。

登录微服务引擎控制台 登录华为云控制台。 单击，选择区域。 单击左上角，在服务列表选择“微服务引擎 CSE”，进入微服务引擎控制台。 当您使用从ServiceStage发放的微服务引擎实例时，如想在CSE中发放新实例，需要对CSE云服务进行授权。 当您没有授予任何权限时，由于CSE使用依赖VPC、DNS云服务，因此需要先创建云服务委托，将操作权限委托给CSE。 授权后，CSE将在 统一身份认证 服务为您创建名为cse_admin_trust的委托，授权成功后，可以进入服务委托列表查看。该操作需要有Security Administrator角色权限，请到“统一身份认证”服务中确认。 如不授权，将影响微服务引擎部分功能的正常使用，包括：创建引擎、升级引擎、开启/关闭安全认证。

设置黑白名单 基于公钥认证机制，ServiceComb引擎提供了黑白名单功能。通过黑白名单，可以控制微服务允许其他哪些服务访问。 只有启用了公钥认证，设置的黑白名单才能生效，请参考公钥认证。 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 选择“微服务治理”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击需要治理的微服务。 单击“黑白名单”。 单击“新增”，为应用添加黑白名单，黑白名单配置项如下表所示。 图13 设置黑白名单 配置项 配置项说明 类型 黑名单：表示根据匹配规则匹配到的微服务都不允许访问当前服务。 白名单：表示根据匹配规则匹配到的微服务允许访问当前服务。 匹配规则 使用正则表达式表示。 例如“匹配规则”设置为data*，指在黑名单下匹配到的名称以data开头的服务不允许访问当前服务，或者在白名单下匹配到的名称以data开头的服务允许访问当前服务。 单击“确定”，保存配置。

设置错误注入 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 选择“微服务治理”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击需要治理的微服务。 单击“错误注入”。 单击“新增”，选择合理的策略，错误注入策略配置项如下表所示。 图11 设置错误注入（类型为延迟） 图12 设置错误注入（类型为错误） 配置项 配置项说明 注入对象 需要测试容错能力的微服务，可以具体到微服务的方法。 类型 测试微服务的容错能力类型： 延迟 错误 协议 访问微服务出现延时或错误的协议： Rest Highway 触发概率 访问微服务出现延时或错误的概率。 延迟时间 访问微服务出现延时的时长，“类型”选择为“延迟”时才需要配置。 http错误码 访问微服务出现错误的HTTP错误码，“类型”选择为“错误”时才需要配置。该错误码为HTTP标准的错误码。 单击“确定”，保存配置。

设置容错 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 选择“微服务治理”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击需要治理的微服务。 单击“容错”。 单击“新增”，选择合理的策略，容错策略配置项如下表所示。 图7 设置容错（Spring Cloud开发框架接入的微服务） 图8 设置容错（Java Chassis开发框架接入的微服务） 配置项 配置项说明 下游微服务 设置本微服务调用下游微服务的容错规则，下拉菜单可直接选择。 说明： 此配置适用于Spring Cloud开发框架接入的微服务。 容错对象 该应用依赖的应用或方法，下拉菜单可直接选择。 说明： 此配置适用于Java Chassis开发框架接入的微服务。 是否开启容错 开启：向容错对象发起请求时发生错误的处理策略，开启后，会根据选择的处理策略处理请求。 关闭：关闭容错策略，即使请求失败也会等到超时后，再返回失败结果。 容错策略 当“是否开启容错”配置项设置为“开启”时需配置。 Spring Cloud开发框架接入的微服务，需设置： 尝试同一个微服务实例次数。 尝试新的微服务实例次数。 Java Chassis开发框架接入的微服务，需设置： Failover 在不同服务器上重新尝试建立连接。 Failfast 不再重新尝试建立连接，即请求失败时会立即返回失败结果。 Failback 在同一个服务器上重新尝试建立连接。 custom 尝试同一个服务器次数：尝试与同一个服务器重新建立连接的次数。 尝试新的服务器次数：尝试与新的服务器建立连接的次数。 单击“确定”，保存配置。

设置降级 登录微服务引擎控制台。 在左侧导航栏选择“ServiceComb引擎专享版”。 单击待操作的引擎。 选择“微服务治理”。 未开启安全认证的ServiceComb引擎，请执行6。 开启安全认证的ServiceComb引擎，请执行5。 在弹出的“安全认证”对话框输入账号名及其密码，单击“确定”。 首次连接ServiceComb引擎，请输入root账号名及创建ServiceComb引擎时输入的密码。 创建账号请参考新增账号。 单击需要治理的微服务。 单击“降级”。 单击“新增”，选择合理的策略，降级策略配置项如下表所示。 图5 设置降级（Spring Cloud开发框架接入的微服务） 图6 设置降级（Java Chassis开发框架接入的微服务） 配置项 配置项说明 降级对象 选择需要降级的微服务。 指定请求路径 可单击，通过设置Method、Path和Headers来指定请求路径。 说明： 此配置适用于Spring Cloud开发框架接入的微服务。 降级策略 开启：开启降级。 关闭：关闭降级。 单击“确定”，保存配置。