华为云用户手册

模型包规范 模型包必须存储在OBS中，且必须以“model”命名。“model”文件夹下面放置模型文件、模型推理代码。 模型推理代码文件必选，其文件名必须为“customize_service.py”，“model”文件夹下有且只能有1个推理代码文件，模型推理代码编写请参见模型推理代码编写说明。 使用模板导入的模型包结构如下所示： model/ │ ├── 模型文件 //必选，不同的框架，其模型文件格式不同，详细可参考模型包示例。 ├── 自定义Python包 //可选，用户自有的Python包，在模型推理代码中可以直接引用。 ├── customize_service.py //必选，模型推理代码，文件名称必须为“customize_service.py”，否则不视为推理代码。

计费说明 需求管理不支持单独购买，开通CodeArts基础版或购买CodeArts专业版即可使用需求管理服务。 CodeArts基础版/专业版介绍请参考计费说明。 详细计费规则与使用额度请参考需求管理产品价格详情。 CodeArts基础版、专业版于2020年10月推出，目前只开放给CodeArts新用户与存量免费体验用户。 新用户定义：在华为云当前区域未开通过CodeArts按需服务组合、单个服务的按需，未购买过CodeArts包月套餐包（1元/1000元），未创建过任何CodeArts项目和资源。 在此之前已开通CodeArts服务组合或单个服务的用户仍沿用旧版计费方式，后续将支持此类用户购买基础版、专业版，过渡至新计费模式。旧版计费详情请参见旧版计费方式说明，开通方式请参考旧版本开通/关闭按需计费方式说明。

身份认证 用户访问需求管理的方式有多种，包括需求管理用户界面、API、SDK，无论访问方式封装成何种形式，其本质都是通过需求管理提供的REST风格的API接口进行请求。 需求管理的接口需要经过认证请求后才可以访问成功。 需求管理支持两种认证方式： Token认证：通过Token认证调用请求，访问需求管理用户界面默认使用Token认证。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。 关于认证鉴权的详细介绍及获取方式，请参见认证鉴权。

添加VPC访问CAE环境配置 如果要使用此功能，您需要在使用具备“安全管理员 Security Administrator 权限”的华为云账号、访问CAE页面单击“授权”，才能使用此功能，未授权不影响已有功能。 登录CAE控制台。 在左侧导航栏中选择“系统设置”。 单击“系统网络配置”模块中的“编辑”，进入“系统网络配置”页面。 在“CAE与VPC网络连通性配置”模块中，单击“添加配置”。 在下拉框中选择子网，单击“确定”。 VPC固定为创建环境时关联的VPC，子网选择环境所属子网。 目前只支持添加一条配置。 图4 配置VPC访问CAE环境

操作步骤 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管”下的“配置审计 Config”。 在“资源清单”页面的资源列表中，单击需要查看的资源名称，进入资源概览页。 选择“资源时间线”页签，查看资源变更的历史记录。 在“资源时间线”页签的右上角设置筛选时间。 “资源时间线”页面默认展示过去3个月的资源变更历史记录。 您也可以通过单击“查看JSON”来查看此时资源的所有属性。 图1 查看资源时间线

操作步骤 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管”下的“配置审计 Config”。 在“资源清单”页面的资源列表中，单击需要查看的资源名称，进入资源概览页。 可以查看资源概览、资源合规、关联资源、资源时间线。 图2 查看资源概览 单击资源概览右上角的“查看详情”，跳转到资源对应服务的控制台，查看该资源的详情。 也可以通过单击资源列表操作列的“查看详情”，查看该资源的详情。

操作步骤 使用创建组织合规规则包的组织帐号登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管”下的“配置审计 Config”。 单击页面左侧的“合规规则包”，进入“合规规则包”页面。 选择“组织合规规则包”页签，在组织合规规则包列表中单击操作列的“删除”。 在弹出的确认框中单击“确定”，完成组织合规规则包的删除。 组织合规规则包删除后，此组织合规规则包部署的成员帐号的合规规则包列表中也将自动删除此合规规则包。 图1 删除组织合规规则包

MFS和SMN服务对比 MFS和SMN服务的主要不同点，如下表所示。 表1 服务差异说明 差异 MFS SMN 区域限制 “华北-北京一”和“华东-上海二”区域不支持使用MFS。 无 时效性 高，一般在5分钟以内。 中等，全局高峰期会出现排队现象，偶发十分钟以上的延迟。 计费 免费 SMN将对发送的消息通知单独计费，具体的计费标准请参考SMN价格详情。 通知方式 仅支持发送REST消息。 支持发送短信、邮件、REST等多类型的消息。 JSON消息体 JSON消息体示例如图1所示。 JSON消息体示例如图2所示。 图1 MFS的JSON消息体 图2 SMN的JSON消息体

Hive服务运行状态为亚健康是否会影响上层业务？ 问： MRS集群内的Hive服务运行状态显示为“亚健康”，是否会影响上层业务？ 答： 集群中服务运行状态为“亚健康”表示服务部分增强功能无法正常工作。 在本示例场景中，登录Manager查看集群其它服务状态，发现HBase服务被停止。当HBase已安装且状态不正常时，Hive、Spark和Loader服务将处于“亚健康”状态。 此时并不会影响基于Hive服务的上层业务，手动重启HBase服务后，Hive服务运行状态恢复正常。 父主题： 集群管理类

响应示例 状态码： 200 查询集群节点信息成功 { "node_list" : [ { "id" : "16413746-258e-4a3c-bea9-8496fdbefde3", "name" : "ty-default--BGy6PUIN-K-dws-cn-cn-2-1", "status" : "ACTIVE", "sub_status" : "CREATED", "spec" : "dws2.kc1.2xlarge", "inst_create_type" : null, "alias_name" : null, "az_code" : "cn-north-4c" }, { "id" : "46d8754b-3ed3-4b92-85b5-7479ef5b10ac", "name" : "ty-default--BGy6PUIN-K-dws-cn-cn-1-1", "status" : "ACTIVE", "sub_status" : "CREATED", "spec" : "dws2.kc1.2xlarge", "inst_create_type" : null, "alias_name" : null, "az_code" : "cn-north-4c" } ], "count" : 2, "failed_count" : 0 }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 node_list Array of ClusterNodeInfo objects 逻辑集群节点列表。 count Integer 逻辑集群节点总数。 failed_count Integer 逻辑集群节点失败总数。 表4 ClusterNodeInfo 参数 参数类型 描述 id String 节点ID。 name String 节点名称。 status String 节点状态。 sub_status String 节点子状态。 spec String 节点规格。 inst_create_type String 实例创建类型。 alias_name String 节点别名。 az_code String 可用区编码。

URI GET /v2/{project_id}/clusters/{cluster_id}/nodes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 表2 Query参数 参数 是否必选 参数类型 描述 deleted 否 String 是否被删除，true/false。 node_ids 否 Array 节点ID列表。 offset 否 Integer 分页查询，偏移。 limit 否 Integer 分页查询，每页显示的条目数量。 filter_by 否 String 过滤字段。 filter 否 String 过滤字段内容。 order_by 否 String 排序字段。 order 否 String 排序：升序/降序。

响应示例 状态码： 200 查询集群拓扑ring环节点信息成功 { "cluster_rings" : [ { "instance_info_lists" : [ { "id" : "a57e49db-c04b-45c7-9863-f7b6f3eed1b8", "name" : "ty-default--BGy6PUIN-K-dws-cn-cn-1-1", "manage_ip" : "172.16.26.233", "traffic_ip" : "192.168.0.217", "internal_ip" : "172.16.66.153", "internal_mgnt_ip" : null, "eip" : null, "elb" : null, "status" : 200, "az_code" : "cn-north-4c" }, { "id" : "3a37f794-be37-42d1-a299-a3eb94888ccb", "name" : "ty-default--BGy6PUIN-K-dws-cn-cn-2-1", "manage_ip" : "172.16.34.21", "traffic_ip" : "192.168.0.80", "internal_ip" : "172.16.65.89", "internal_mgnt_ip" : null, "eip" : null, "elb" : null, "status" : 200, "az_code" : "cn-north-4c" }, { "id" : "8763cbf1-5851-44a5-9e71-cbae35201f27", "name" : "ty-default--BGy6PUIN-K-dws-dn-1-1", "manage_ip" : "172.16.9.16", "traffic_ip" : "192.168.0.88", "internal_ip" : "172.16.67.64", "internal_mgnt_ip" : null, "eip" : null, "elb" : null, "status" : 200, "az_code" : "cn-north-4c" } ] } ], "count" : 1 }

URI GET /v2/{project_id}/clusters/{cluster_id}/topo/rings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页查询，偏移。 limit 否 Integer 分页查询，每页显示的条目数量。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 cluster_rings Array of TopoRingInfo objects 集群拓扑环列表信息。 count Integer 集群环数量。 表4 TopoRingInfo 参数 参数类型 描述 instance_info_lists Array of TopoInstanceInfo objects 集群实例列表信息。 表5 TopoInstanceInfo 参数 参数类型 描述 id String 实例ID。 name String 实例名称。 manage_ip String 实例管理IP。 traffic_ip String 业务IP。 internal_ip String 内部通信IP。 internal_mgnt_ip String 内部管理IP。 eip String EIP。 elb String elb地址。 status String 实例状态。 az_code String 可用区编码。

响应示例 状态码： 200 查询集群列表成功。 { "logical_clusters" : [ { "logical_cluster_id" : "fa9d69a0-3814-4fb9-98df-d9f4f5ef53ca", "logical_cluster_name" : "elastic_group", "cluster_rings" : [ { "ring_hosts" : [ { "host_name" : "host-172-16-20-246", "back_ip" : "172.16.73.90", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-4-26", "back_ip" : "172.16.123.5", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-43-90", "back_ip" : "172.16.92.175", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 } ] } ], "status" : "Normal", "first_logical_cluster" : false, "action_info" : { "progress" : 100, "completed" : true, "result" : "success", "logs" : null, "action_name" : "Grow", "start_time" : "2023-06-05 01:58:43", "end_time" : "2023-06-05 02:11:50" }, "edit_enable" : true, "restart_enable" : true, "delete_enable" : false, "add_to_elastic" : true, "mode" : null, "cluster_type" : null } ], "count" : 1, "add_enable" : true }

URI GET /v2/{project_id}/clusters/{cluster_id}/logical-clusters 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页查询，偏移。 limit 否 Integer 分页查询，每页显示的条目数量。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 logical_clusters Array of LogicalClusterInfo objects 逻辑集群列表信息。 count Integer 逻辑集群总数量。 add_enable Boolean 作为互斥结果，如果集群内有其他运维操作，该值为false，此时不能添加逻辑集群。 表4 LogicalClusterInfo 参数 参数类型 描述 logical_cluster_id String 逻辑集群ID。 logical_cluster_name String 逻辑集群名称。 cluster_rings Array of ClusterRing objects 逻辑集群主机信息。 status String 逻辑集群状态。 first_logical_cluster Boolean 是否为第一个逻辑集群。第一个创建或者转换的逻辑集群不能删除，因为其中包含了一些系统视图。 action_info ActionInfo object 逻辑集群操作信息。 edit_enable Boolean 是否允许编辑。 restart_enable Boolean 是否允许重启。 delete_enable Boolean 是否允许删除。 add_to_elastic Boolean 是否允许弹性伸缩。 mode String 逻辑集群模式。 waiting_for_killing Integer 等待被销毁。 cluster_type String 集群类型。 表5 ClusterRing 参数 参数类型 描述 ring_hosts Array of RingHost objects 集群主机信息。 表6 RingHost 参数 参数类型 描述 host_name String 主机名称。 back_ip String 后端IP地址。 cpu_cores Integer 主机CPU核数。 memory Double 主机内存。 disk_size Double 主机磁盘大小。 表7 ActionInfo 参数 参数类型 描述 action_name String 操作名称。当前允许操作如下： Create：创建 Expand：扩容 Restart：重启 Delete：删除 Shrink：缩容 progress Integer 操作进度，默认10。 completed Boolean 是否完成操作。 start_time String 操作开始时间。 end_time String 操作结束时间。 result String 操作结果。success或者failed，默认空字符串。 logs String 操作日志。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 logical_cluster 是 CreateLogicalClusterInfo object 创建逻辑集群信息。 表3 CreateLogicalClusterInfo 参数 是否必选 参数类型 描述 logical_cluster_name 是 String 逻辑集群名称。 cluster_rings 是 Array of ClusterRing objects 逻辑集群环信息。 表4 ClusterRing 参数 是否必选 参数类型 描述 ring_hosts 是 Array of RingHost objects 集群主机信息。 表5 RingHost 参数 是否必选 参数类型 描述 host_name 是 String 主机名称。 back_ip 是 String 后端IP地址。 cpu_cores 是 Integer 主机CPU核数。 memory 是 Double 主机内存。 disk_size 是 Double 主机磁盘大小。

请求示例 POST https://{Endpoint}/v2/9b06d044ea4f49f1a58b2bed2b0084bd/clusters/9b7ff56b-47b3-4d00-a1fd-4c023d34404b/logical-clusters { "logical_cluster" : { "logical_cluster_name" : "v3_logical", "cluster_rings" : [ { "ring_hosts" : [ { "host_name" : "host-172-16-20-246", "back_ip" : "172.16.73.90", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-4-26", "back_ip" : "172.16.123.5", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-4-26", "back_ip" : "172.16.123.5", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 } ] } ] } }

URI POST /v2/{project_id}/clusters/{cluster_id}/logical-clusters/{logical_cluster_id}/restart 表1 路径参数 参数 是否必选 参数类型 描述 cluster_id 是 String 指定重启集群的ID。获取方法，请参见获取集群ID。 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 logical_cluster_id 是 String 指定待重启逻辑集群的ID。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 logical_cluster_tasks Array of LogicalClusterTaskInfo objects 逻辑集群任务信息。 count Long 逻辑集群任务总数。 表4 LogicalClusterTaskInfo 参数 参数类型 描述 type String 任务类型。 logical_cluster_name String 逻辑集群名称。 start_time String 任务开始时间。 end_time String 任务结束时间。 result String 任务执行结果。 log String 任务执行日志。

URI GET /v2/{project_id}/clusters/{cluster_id}/logical-clusters/tasks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页查询，偏移。 limit 否 Integer 分页查询，每页显示的条目数量。 logical_cluster_name 否 String 集群名称。 type 否 String 类型。 order_by 否 String 排序字段。 order 否 String 排序：升序/降序。

请求示例 GET https://{Endpoint}/v2/9b06d044ea4f49f1a58b2bed2b0084bd/clusters/9b7ff56b-47b3-4d00-a1fd-4c023d34404b/logical-clusters/tasks?offset=0&limit=10&logical_cluster_name=test_logical&type=Expand&order_by=startTime&order=DESC

响应示例 状态码： 200 查询任务信息成功。 { "logical_cluster_tasks" : [ { "type" : "Grow", "logical_cluster_name" : "elastic_group", "start_time" : "2023-06-05 01:58:43", "end_time" : "2023-06-05 02:11:50", "result" : "success", "log" : "Expand from outside success" }, { "type" : "Create", "logical_cluster_name" : "test_logical", "start_time" : "2023-06-21 08:35:58", "end_time" : "2023-06-21 08:36:14", "result" : "failed", "log" : "list index out of range\\nChecking whether the reentry command is consistent with the previous command." } ], "count" : 2 }

URI GET /v2/{project_id}/clusters/{cluster_id}/logical-clusters/rings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页查询，偏移。 limit 否 Integer 分页查询，每页显示的条目数量。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 cluster_rings Array of LogicalClusterRingInfo objects 集群环列表信息。 count Integer 集群环数量。 表4 LogicalClusterRingInfo 参数 参数类型 描述 ring_hosts Array of RingHost objects 集群主机环信息。 表5 RingHost 参数 参数类型 描述 host_name String 主机名称。 back_ip String 后端IP地址。 cpu_cores Integer 主机CPU核数。 memory Double 主机内存。 disk_size Double 主机磁盘大小。

响应示例 状态码： 200 查询逻辑集群可用ring环节点信息成功 { "cluster_rings" : [ { "ring_hosts" : [ { "host_name" : "host-172-16-20-246", "back_ip" : "172.16.73.90", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-4-26", "back_ip" : "172.16.123.5", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-43-90", "back_ip" : "172.16.92.175", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 } ] } ], "count" : 1 }

URI POST /v2/{project_id}/clusters/{cluster_id}/convert-to-logical-cluster/{name} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 name 是 String 逻辑集群名称。

请求示例 PUT https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/logical-clusters/0b494d0d-8431-4c4f-8a06-2cc42d0d0c7d { "cluster_rings" : [ { "ring_hosts" : [ { "host_name" : "host-172-16-20-246", "back_ip" : "172.16.73.90", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-4-26", "back_ip" : "172.16.123.5", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 }, { "host_name" : "host-172-16-43-90", "back_ip" : "172.16.92.175", "cpu_cores" : 8, "memory" : 32.0, "disk_size" : 800.0 } ] } ], "mode" : null, "waiting_for_killing" : 0 }