华为云用户手册

邀请管理 权限 对应API接口 授权项（Action） IAM 项目(Project) 企业项目(Enterprise Project) 查询邀请相关信息 GET /v1/organizations/handshakes/{handshake_id} organizations:handshakes:get × × 接受邀请 POST/v1/received-handshakes/{handshake_id}/accept organizations:handshakes:accept iam:agencies:createServiceLinkedAgency × × 拒绝邀请 POST /v1/received-handshakes/{handshake_id}/decline organizations:handshakes:decline × × 取消邀请 POST /v1/organizations/handshakes/{handshake_id}/cancel organizations:handshakes:cancel × × 列出收到的邀请 GET /v1/received-handshakes organizations:receivedHandshakes:list × × 列出发送的邀请 GET /v1/organizations/handshakes organizations:handshakes:list × ×

组织管理 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 创建组织 POST /v1/organizations organizations:organizations:create iam:agencies:createServiceLinkedAgency × × 查询所属组织信息 GET /v1/organizations organizations:organizations:get × × 删除组织 DELETE /v1/organizations organizations:organizations:delete × × 离开当前组织 POST /v1/organizations/leave organizations:organizations:leave × × 列出组织的根 GET /v1/organizations/roots organizations:roots:list × ×

组织单元管理 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 创建组织单元 POST /v1/organizations/organizational-units organizations:ous:create organizations:resources:tag（如果请求带标签） × × 列出组织单元 GET /v1/organizations/organizational-units organizations:ous:list × × 查询有关组织单元的信息 GET /v1/organizations/organizational-units/{organizational_unit_id} organizations:ous:get × × 更改组织单元名称 PATCH /v1/organizations/organizational-units/{organizational_unit_id} organizations:ous:update × × 删除组织单元 DELETE /v1/organizations/organizational-units/{organizational_unit_id} organizations:ous:delete × ×

支持标签策略的云服务 当前支持使用标签策略的云服务和资源类型如下表所示： 表1 支持标签策略的云服务和资源类型 服务名称 资源类型 DDoS原生基础防护服务（Anti-DDoS） 公网IP（ip） DDoS防护服务（AAD） 实例（instance） 应用运维管理 （ AOM ） 告警规则（alarmRule） API网关（APIG） 实例（instance） 弹性伸缩（AS） 弹性伸缩组（scalingGroup） 裸金属服务器（BMS） 实例（instance） 云堡垒机 （CBH） 实例（instance） 云备份（CBR） 存储库（vault） 云连接（CC） 带宽包（bandwidthPackage） 中心网络（centralNetwork） 云连接（cloudConnection） 云容器引擎（CCE） 集群（cluster） 云容器实例 CCI 命名空间（namespace） 内容分发网络（CDN） 域名 （domain） 云监控服务 （ CES ） 告警规则（alarm） 云防火墙 （CFW） 实例（instance） DDoS原生高级防护（CNAD） 防护包（package） 微服务引擎（ CS E） 引擎（engine） 云凭据管理服务（C SMS ） 凭据（secret） 云搜索服务 （ CSS ） 集群（cluster） 日志流（logstream） 存储库（repository） 云审计 服务（ CTS ） 追踪器（tracker） 数据治理中心 （ DataArts Studio ） 实例（instance） 工作空间（workspace） 数据库安全服务（DBSS） 审计实例（auditInstance） 云专线（DCAAS） 物理连接（directconnect） 全球专线接入网关（gdgw） 链路聚合组（lag） 虚拟网关（vgw） 虚拟接口（vif） 分布式缓存服务（DCS） 实例（instance） 文档数据库服务（DDS） 实例名称（instanceName） 专属加密（DHSM） 硬件安全模块（hsm） 数据湖探索 （ DLI ） 数据库（database） 增强型跨源连接（edsconnection） 弹性资源池（elasticresourcepool） 作业（jobs） 队列（queue） 资源（resource） 分布式消息服务（DMS） Kafka实例（kafka） RabbitMQ实例（rabbitmq） RocketMQ实例（rocketmq） 云解析服务（DNS） 反向解析记录（ptr） 域名（zone） 数据复制服务 （DRS） 任务（job） 数据仓库 服务（DWS） 集群（cluster） 弹性云服务器（ECS） 实例（instance） 弹性负载均衡（ELB） 监听器（listener） 负载均衡器（loadbalancer） 企业路由器（ER） 连接（attachments） 实例（instances） 路由表（routeTables） 云硬盘（EVS） 磁盘（volume） 函数工作流 （FunctionGraph） 函数（function） 全球加速（GA） 加速器实例（accelerator） 监听器（listener） 云数据库 GaussDB 实例（instance） 云数据库 GaussDB(for MySQL) 实例（instance） 云数据库 GeminiDB（原 云数据库 GaussDB for NoSQL） 实例（instance） 统一身份认证 服务（IAM） 委托（agency） 用户（user） 镜像服务 （IMS） 镜像（image） 设备接入 IoTDA 实例（instance） 密钥管理服务（KMS） 用户主密钥（cmk） 云日志 服务（LTS） 日志接入（accessConfig） 主机组（hostGroup） 日志组（logGroup） 日志流（logStream） AI开发平台 ModelArts Notebook实例（notebook） 资源池（pool） 服务（service） 训练作业（trainJob） MapReduce服务 （ MRS ） 集群（cluster） NAT网关（NAT） 组织（Organizations） 账号（account） 组织单元（ou） 策略（policy） 根（root） 私有证书管理服务（PCA） 私有CA（ca） 资源访问管理 （ RAM ） 资源共享实例（resourceShare） 云数据库（RDS） 实例 (instances) 配置审计 （Config）（原 资源管理服务 RMS ） 合规规则（policyAssignments） SSL证书管理服务（SCM） 证书（cert） 安全云脑 （SecMaster） 工作空间（workspace） 应用管理与运维平台（ServiceStage） 应用（app） 环境（environment） 高性能弹性文件服务（SFS Turbo） SFS Turbo（shares） 消息通知 服务（ SMN ） 主题（topic） 虚拟私有云（VPC） 弹性公网IP（publicip） 子网（subnet） 虚拟私有云（vpc） VPC终端节点 （VPCEP） 终端节点服务（endpointServices） 终端节点（endpoints） 虚拟专用网络 （VPN） 对端网关（customerGateways） VPN连接（vpnConnections） VPN网关（vpnGateways） Web应用防火墙 （WAF） 高级实例（premiumlnstance） 父主题： 标签策略管理

前提条件 给用户组授权之前，请先了解用户组可以添加的使用ModelArts及其依赖服务的权限，并结合实际需求进行选择，MaaS服务支持的系统权限，请参见表1。 表1 服务授权列表 待授权的服务 授权说明 IAM权限设置 是否必选 ModelArts 授予子用户使用ModelArts服务的权限。 ModelArts CommonOperations没有任何专属资源池的创建、更新、删除权限，只有使用权限。推荐给子用户配置此权限。 ModelArts CommonOperations 必选 如果需要给子用户开通专属资源池的创建、更新、删除权限，此处要勾选ModelArts FullAccess，请谨慎配置。 ModelArts FullAccess 可选 ModelArts FullAccess权限和ModelArts CommonOperations权限建议二选一。 OBS 对象存储服务 授予子用户使用OBS服务的权限。ModelArts的数据管理、开发环境、训练作业、模型推理部署均需要通过OBS进行数据中转。 OBS OperateAccess 必选 SWR容器镜像 仓库 授予子用户使用SWR服务权限。ModelArts的 自定义镜像 功能依赖镜像服务SWR FullAccess权限。 SWR OperateAccess 必选 CES 云监控 授予子用户使用CES云监控服务的权限。通过CES云监控可以查看ModelArts的在线服务和对应模型负载运行状态的整体情况，并设置监控告警。 CES FullAccess 必选 SMN消息服务 授予子用户使用SMN消息服务的权限。SMN消息通知服务配合CES监控告警功能一起使用。 SMN FullAccess 必选 VPC虚拟私有云 子用户在创建ModelArts的专属资源池过程中，如果需要开启自定义网络配置，需要配置VPC权限。 VPC FullAccess 可选

准备资源池 在ModelArts Studio大模型即服务平台进行模型调优、压缩或部署时，需要选择资源池。MaaS服务支持专属资源池和公共资源池。 专属资源池：专属资源池不与其他用户共享，资源更可控。在使用专属资源池之前，您需要先创建一个专属资源池，然后在AI开发过程中选择此专属资源池。MaaS服务可以使用在ModelArts Standard形态下创建的专属资源池用于模型训推。创建专属资源池的操作指导请参见创建Standard专属资源池。 MaaS服务只支持使用驱动版本是23.0.5的专属资源池，其他版本会导致任务失败。当专属资源池的驱动版本不适配时，可以参考升级Standard专属资源池驱动升级驱动。 公共资源池：公共资源池提供公共的大规模计算集群，根据用户作业参数分配使用，资源按作业隔离。MaaS服务可以使用ModelArts Standard形态下提供的公共资源池完成模型训推，按照使用量计费，方便快捷。选择公共资源池时，可以通过购买套餐包获取优惠的资源费用，请参见购买套餐包。 资源池必须和MaaS服务在同一个Region下，否则无法选择到该资源池。

购买套餐包 MaaS服务提供了按需套餐包，用户可以提前购买按需套餐包，从而获得灵活的、更高性价比的算力资源。当购买了套餐包，在使用公共资源池运行任务时，将会优先抵扣套餐包的配额，超出当前套餐包的额度或使用时段，将自动转为按需收费。 关于套餐包的约束限制、资源包抵扣顺序和套餐包余量预警请参见套餐包。 购买操作如下： 登录ModelArts管理控制台。 在左侧导航栏中，选择“ModelArts Studio”进入ModelArts Studio大模型即服务平台。 在ModelArts Studio首页单击“购买套餐包”，进入购买页面。 在购买页面，选择套餐包“规格”和“购买数量”，单击“立即购买”，确认订单详情，单击“去支付”，根据界面提示完成套餐包支付。 支付完成后，在ModelArts Studio大模型即服务平台创建任务时，选择套餐包规格的公共资源池，在运行任务时既可优先使用套餐包资源。

应用中心介绍 “MaaS应用实践中心”提供基于行业客户应用场景的AI解决方案。MaaS提供的模型服务和华为云各AI应用层构建工具之间相互连通，通过灵活的组合方案，来帮助客户快速解决模型落地应用时所面临的业务及技术挑战。 MaaS应用实践中心结合 KooSearch 企业搜索服务、盘古数字人大脑和Dify，为具体的客户应用场景提供一整套解决方案。 KooSearch 企业搜索 服务：基于在MaaS开源大模型部署的模型API，搭建企业专属方案、LLM驱动的语义搜索、多模态搜索增强。 盘古数字人大脑：基于在MaaS开源大模型部署的模型API，升级智能对话解决方案，含智能客服、数字人。 Dify：支持自部署的应用构建开源解决方案，用于Agent编排、自定义工作流。

常见问题 首次使用ModelArts如何配置授权？ 直接选择“新增委托”中的“普通用户”权限即可，普通用户包括用户使用ModelArts完成AI开发的所有必要功能权限，如数据的访问、训练任务的创建和管理等。一般用户选择此项即可。 如何获取访问密钥AK/SK？ 如果在其他功能（例如访问模型服务等）中使用到访问密钥AK/SK认证，获取AK/SK方式请参考如何获取访问密钥章节。 如何删除已有委托列表下面的委托名称？ 图8 已有委托 需要前往统一身份认证服务IAM控制台的委托页面删除。 图9 统一身份认证 进入ModelArts控制台的某个页面时，为什么会提示权限不足？ 图10 页面提示权限不足 可能原因是用户委托权限配置不足或模块能力升级，需要更新授权信息。根据界面操作提示追加授权即可。

约束与限制 华为云账号 只有华为云账号可以使用委托授权，可以为当前账号授权，也可以为当前账号下的所有IAM用户授权。 多个IAM用户或账号，可使用同一个委托。 一个账号下，最多可创建50个委托。 对于首次使用ModelArts的新用户，请直接新增委托即可。一般用户新增普通用户权限即可满足使用要求。如果有精细化权限管理的需求，可以自定义权限按需设置。 IAM用户 如果已获得委托授权，则可以在权限管理页面中查看到已获得的委托授权信息。 如果未获得委托授权，当打开“访问授权”页面时，ModelArts会提醒您当前用户未配置授权，需联系此IAM用户的管理员账号进行委托授权。

修改授权的权限范围 在查看授权详情时，如果想要修改授权范围，可以在权限详情页单击“去IAM修改委托权限”。 图6 去IAM修改委托权限 进入IAM控制台的委托页面。找到对应的委托信息，修改该委托的基本信息，主要是持续时间。“持续时间”可以选择永久、1天，或者自定义天数，例如 30天。 图7 手动创建的委托 在授权记录页面单击“授权”，勾选要配置的策略，单击下一步设置最小授权范围，单击确定，完成授权修改。 设置最小授权范围时，可以选择指定的区域，也可以选择所有区域，即不设置范围。

删除授权 为了更好的管理您的授权，您可以删除某一IAM用户的授权，也可批量清空所有用户的授权。 删除某一用户的授权 在“权限管理”页面，展示当前账号下为其IAM用户配置的授权列表，针对某一用户，您可以单击“操作”列的“删除”，输入“DELETE”后单击“确认”，可删除此用户的授权。删除生效后，此用户将无法继续使用ModelArts的相关功能。 批量清空所有授权 在“权限管理”页面，单击授权列表上方的“清空授权”，输入“DELETE”后单击“确认”，可删除当前账号下的所有授权。删除生效后，此账号及其所有IAM子用户将无法继续使用ModelArts的相关功能。

场景描述 MaaS服务的访问授权是通过ModelArts统一管理的，当用户已拥有ModelArts的访问授权时，无需单独配置MaaS服务的访问授权，当用户没有ModelArts的访问授权时，则需要先完成配置才能正常使用MaaS服务。 ModelArts在任务执行过程中需要访问用户的其他服务，典型的就是训练过程中，需要访问OBS读取用户的训练数据。在这个过程中，就出现了ModelArts“代表”用户去访问其他云服务的情形。从安全角度出发，ModelArts代表用户访问任何云服务之前，均需要先获得用户的授权，而这个动作就是一个“委托”的过程。用户授权ModelArts再代表自己访问特定的云服务，以完成其在ModelArts平台上执行的AI计算任务。 ModelArts提供了一键式自动授权功能，用户可以在ModelArts的权限管理功能中，快速完成委托授权，由ModelArts为用户自动创建委托并配置到ModelArts服务中。 本章节主要介绍一键式自动授权方式。一键式自动授权方式支持给IAM子用户、联邦用户（虚拟IAM用户）、委托用户和所有用户授权。

什么是KooCLI 华为云命令行工具服务（Koo Command Line Interface，KooCLI，原名HCloud CLI）是为发布在 API Explorer 上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源。 KooCLI只提供了一种通过CLI调用云服务API的方法。在使用KooCLI之前，您需要熟悉该API。KooCLI无法为您提供云服务API的具体使用方面的专业帮助，相关问题请咨询服务oncall。 在使用KooCLI之前，您可以使用API Explorer平台查找所需的API、查看在线文档和调试API。 KooCLI灵活性高且易于扩展： 单一可执行文件，绿色免安装，下载解压后即可使用。 多操作系统支持，包括Linux、Windows、Mac。 扩展性强，您可基于此工具对云服务API进行封装，扩展出您想要的功能，实现脚本化管理云服务资源。 下载KooCLI，请参考《快速入门》。 您也可以在线体验KooCLI。 在Windows系统使用KooCLI时，请勿双击执行hcloud.exe文件，正确的用法是在hcloud.exe文件所在目录下打开命令行工具（支持CMD、PowerShell）后执行相应命令。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS类云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

界面转换模型 导入模型至HiLens Studio后，在HiLens Studio界面打开一个技能项目。 单击HiLens Studio界面左侧的。 左侧将显示开发项目的文件目录，详细说明请见项目文件说明。 图3 文件目录 右键单击文件夹“model”，单击“Model Convertion”。 弹出“Model Convertion”对话框。 按表2填写模型转换的信息，单击“OK”。 图4 Model Convertion 表2 Convert Model参数说明 参数 说明 Model Path 待转换的模型文件在技能项目文件中的位置。一般将模型导入至文件夹“model”。 Configuration 待转换模型的配置文件在技能项目文件中的位置。例如“model/aipp_rgb.cfg”。 Output Path 模型转换后输出位置。 Type 模型转换的类型，包括“TF-FrozenGraph-To-Ascend-HiLens”、“Caffe to Ascend”。 “TF-FrozenGraph-To-Ascend-HiLens” 支持将Tensorflow frozen graph模型转换成可在ascend芯片上运行的模型。 “Caffe to Ascend” 支持将Caffe模型转换成可在ascend芯片上运行的模型。 Advanced Options 当模型转换类型为“TF-FrozenGraph-To-Ascend-HiLens”时，可填写高级选项，包括张量形状、转换输出节点等参数选项，详情请见表3。 表3 Advanced Options 参数名称 参数说明 Input Tensor Shape 输入张量形状。若在上文“模型来源”中，选择需要转换格式的模型（非om格式模型），并且转换类型是“Tensorflow frozen graph 转 Ascend”或“Tensorflow SavedModel 转 Ascend”时，需要填写输入张量形状。 张量形状即模型输入数据的shape，输入数据格式为NHWC，如“input_name:1,224,224,3”，必填项。“input_name”必须是转换前的网络模型中的节点名称。当模型存在动态shape输入时必须提供。例如“input_name1:?,h,w,c”，该参数必填，其中“?”为batch数，表示1次处理的图片数量，需要根据实际情况填写，用于将动态shape的原始模型转换为固定shape的离线模型。 如果存在多个输入，请以分号（;）隔开。 out_nodes 转换输出节点，即指定输出节点,例如“node_name1:0;node_name1:1;node_name2:0”，其中“node_name”必须是模型转换前的网络模型中的节点名称,冒号后的数字表示第几个输出,例如“node_name1:0”，表示节点名称为“node_name1”的第0个输出。 input_format 输入数据格式，默认是“NHWC”,如果实际是“NCHW”的话,需要通过此参数指定“NCHW”。 net_format 优选数据格式，即指定网络算子优先选用的数据格式，“ND(N=4)”和“5D”。仅在网络中算子的输入数据同时支持“ND”和“5D”两种格式时，指定该参数才生效。“ND”表示模型中算子按“NCHW”转换成通用格式，“5D”表示模型中算子按华为自研的5维转换成华为格式。“5D”为默认值。 fp16_high_precsion 生成高精度模型，指定是否生成高精度“FP16 Davinci”模型。 0为默认值，表示生成普通“FP16 Davinci”模型，推理性能更好。 1表示生成高精度“FP16 Davinci”模型，推理精度更好。 output_type 网络输出数据类型，“FP32”为默认值,推荐分类网络、检测网络使用；图像超分辨率网络，推荐使用“UINT8”，推理性能更好。

导入/转换模型操作 针对本地开发的模型，首先需要导入模型至HiLens Studio。针对非“om”格式的模型，还需要在HiLens Studio进行模型转换。 导入和转换模型的操作流程如图1所示，操作指引如表1所示。 图1 操作流程 表1 导入/转换模型操作 操作 操作方式 操作指引 步骤一：导入模型至HiLens Studio 方式一：从本地导入 本地导入模型至HiLens Studio 方式二：从OBS导入 OBS导入模型至HiLens Studio 步骤二：在HiLens Studio转换模型 方式一：使用命令行转换模型 命令行转换模型 方式二：通过HiLens Studio界面转换模型 界面转换模型

本地导入模型至HiLens Studio 在HiLens Studio界面单击左上角，左侧将展示开发项目的文件目录。 在开发项目的文件目录区选择文件夹或空白区域，右键单击选择“Upload Files...”，在本地选择已经开发好的模型文件并导入至HiLens Studio。 caffe模型：caffe模型文件“.caffemodel”和“.prototxt”，根据业务选择上传配置文件“.cfg”。 tensorflow模型：“.pb”模型文件，根据业务选择上传配置文件“.cfg”。

模型要求 导入的模型可为“.om”格式、“.pb”格式或“.caffemodel”格式，其中“.om”格式的模型才可以在HiLens Kit上运行，“.pb”格式或“.caffemodel”格式的模型在导入HiLens Studio之后，需要将模型转换至“.om”格式。 并非所有模型都能转换成功，进行导入（转换）模型操作前，请确认是否为“.om”模型支持的TensorFlow和Caffe算子边界，详情请见附录Caffe算子边界和Tensorflow算子边界。

4. 运行时配置（可选） 图4 运行时配置-22 部分技能在运行的时候需要用户配置参数，比如人脸判断类的技能需要用户上传人脸库等。运行时配置就像是一个“钩子”，开发者把“钩子”放出去，用户运行技能的时候设置了这些配置项，HiLens就会帮开发者把“钩子”收回来，这时候在代码里面开发者就可以使用这些用户的设置。您可以在界面中单击添加配置标签，参考表3填写您的配置。 您还可以单击“预览JSON格式”查看“钩子”的格式。开发者通过HiLens Framework提供的get_skill_config接口获取技能配置的JSON格式，读取里面字段的值来使用用户的配置。 运行时配置JSON格式如下所示： { //全局配置 "Language": "enum", //视频分路配置 "multi_camera": [ //该字段key值multi_camera固定，值表示摄像头分路配置 { "camera_names": [ //该字段key值camera_names固定，值表示该分组配置里包含了哪些摄像头 "cameraX", "cameraY" ], "FaceLib": { //配置名 "from": "file source", //文件类型值，表示文件来自哪个服务。比如OBS "path": "file path" //文件类型值，表示文件的路径 } } ], } 表3 运行时配置的参数说明 字段名称 说明 配置名 配置的名称，逻辑代码里面可用该字段获取该配置的值。运行时配置指技能在运行的时候，由用户配置的内容。比如人脸判断技能需要用户上传人脸库等。需要说明的是，整个运行时配置是可选的，但如果添加了一条配置，那么“配置名”、“配置说明”是必填项。 值类型 表示该配置项的值是什么类型的数据。 数值类型（int、float）、枚举类型、字符串和文件类型。 值约束 表示该配置可以设置的范围。跟值类型有关。 数值类型：用开闭区间的表示方法。如[1,100)表示大于等于1小于100。 字符串和文件：该项无需输入。 枚举：集合的表示方式，如{a,b}。 配置说明 说明该配置的作用，以及配置方法。该字段非常重要，用户会根据该字段的说明来配置，所以如果有运行时配置，开发者一定要在这里解释清楚。 配置对象 HiLens Kit可以连接多个（个数不大于设备上所安装技能的支持通道数之和）摄像头，所以可以开发支持多路视频的技能。 选择“视频”，则表示该配置是可以针对设备上每个摄像头视频进行配置的，比如摄像头1和摄像头2采用不同的人脸库。 选择“全局”,则表示设备上所有摄像头都用同一个配置值。

背景信息 在华为HiLens控制台开发技能时，会占用OBS资源，需要收取一定费用，收费规则请参见对象存储服务 OBS。 算法模型必须是.om格式，且满足华为HiLens的要求，详细可参考开发算法模型。 逻辑代码的存储方式有两种：“在线编辑代码”和“从OBS上传代码”。 如果您的代码逻辑较简单，建议直接在线编辑代码。 如果您的代码结构比较复杂，推荐用本地IDE开发完成后，使用OBS上传代码zip或tar.gz包的方式，上传操作可参见OBS快速入门。上传到OBS需要收取一定费用，收费规则请参见对象存储服务 OBS。 上传文件时，要求此OBS桶与您使用的华为HiLens处于同一区域。 若您从OBS上传代码，需要将所有代码文件压缩后上传，上传的文件必须为“.zip”或“tar.gz”格式，且入口文件必须在一级目录。如下示例所示，入口代码（“main.py”）在一级目录，其它的代码按需求自行设计，您可将模型与代码一起打包上传。 入口代码所在文件（如上面的main.py）通过参数【代码执行文件】进行配置，后面会有说明。 代码目录示例如下所示： skill/ |---main.py #入口文件，名称与新建技能的“代码配置”参数一致 |---depends/ #可选，用于存放模型文件 |---workspace/ #工作空间，用于存放技能生成的数据 |---data/ #用于存放运行时配置

上传数据至OBS 使用 ModelArts Pro 进行应用开发时，您需要将数据上传至OBS桶中。 首先需要获取访问OBS权限，在未进行委托授权之前，无法使用此功能。您需要提前获得OBS授权，详情请见配置访问权限。 已创建用于存储数据的OBS桶及文件夹，且数据存储的OBS桶与ModelArts Pro在同一区域（目前仅支持华为-北京四），详情请见创建OBS桶。 上传数据至OBS，OBS上传数据的详细操作请参见《对象存储服务快速入门》。 您在创建OBS桶时，需保证您的OBS桶与ModelArts Pro在同一个区域。 建议根据业务情况及使用习惯，选择OBS使用方法。 如果您的数据量较小（小于100MB）或数据文件较少（少于100个），建议您使用控制台上传数据。控制台上传无需工具下载或多余配置，在少量数据上传时，更加便捷高效。 如果您的数据量较大或数据文件较多，建议选择OBS Browser+或obsutil工具上传。OBS Browser+是一个比较常用的图形化工具，支持完善的桶管理和对象管理操作。推荐使用此工具创建桶或上传对象。obsutil是一款用于访问管理OBS的命令行工具，对于熟悉命令行程序的用户，obsutil是执行批量处理、自动化任务较好的选择。 如果您的业务环境需要通过API或SDK执行数据上传操作，或者您习惯于使用API和SDK，推荐选择OBS的API或SDK方法创建桶和上传对象。 上述说明仅罗列OBS常用的使用方式和工具，更多OBS工具说明，请参见《OBS工具指南》。

前提条件 普通用户成功将购买的技能安装到设备上，详情请参见安装技能。 开发者成功将技能部署到设备上，详情请参见安装和调试技能。 技能输出模块中定义了将数据输出至OBS的场景，针对此类技能，才能通过数据管理页面查看数据。 如果您的技能开发者，您需要查看自己开发的技能在设备上的运行效果，在开发技能时，您需要指定数据存储至OBS中才能保证可以通过管理控制台下载。 如果您是技能使用者，需要在技能市场中，通过技能详情页面了解此技能是否将数据存储至OBS中。

手动收集日志 当前设备固件版本在1.3.3及以后版本，需要手动收集日志。 在华为HiLens管理控制台，单击左侧导航栏“数据管理（Beta）”，进入“数据管理”页面。 单击选中日志上传失败的设备，然后单击右上角的“保存所有日志”。 弹出“上传日志”对话框。 图2 保存日志 勾选需要上传到OBS的设备日志，单击“确定”。 等待日志收集。 日志按需收集，系统日志文件较大，收集耗时较长。 图3 上传日志 一般5分钟以后，待日志收集完成，在“数据管理”页面单击设备卡片，进入对应文件夹下载日志文件压缩包至本地，即可查看日志。

查看数据 您可根据数据输出类型，查看设备数据以及技能的运行效果，技能输出方式请见表1。 视频数据大多数技能通过设备的HDMI接口输出到显示屏，少数视频数据输出到服务器查看。请前往“技能市场”，在“技能详情”页面的“产品描述”中查看此技能的输出设置。例如，明星脸判断技能，其描述为“可以通过HDMI查看”，表示此技能部署后，需通过显示屏查看技能运行效果。 除“HDMI”输出方式以外，其他输出方式的技能存储在OBS中，需根据配置数据存储位置（OBS存储路径）查看数据。 表1 技能输出方式 方式 查看数据说明 HDMI 直接通过设备的HDMI接口输出到显示屏。 RTMP 实时输出到服务器供用户查看，服务器地址请查看技能“产品描述”。 H264_FILE 以文件的方式输出到OBS供用户查看。 OBS文件路径请见配置数据存储位置（OBS存储路径）。

企业SSO登录 当企业拥有自己的鉴权系统，并想用自己的鉴权系统登录华为云会议，可以使用企业SSO登录，配置后企业成员就可以使用企业内部统一鉴权登录华为云会议客户端。 企业SSO登录的配置操作详情请参考：如何配置企业SSO登录？ 仅旗舰版支持企业SSO登录。 打开华为云会议桌面端。 单击“SSO”打开“SSO登录”界面。 输入企业域名，或单击“我不知道企业域名”后输入 企业邮箱 。 单击“登录”，将在浏览器中跳转至鉴权页面。 图1 企业SSO登录 输入账号和密码，企业鉴权通过后页面跳转至华为云会议管理平台，华为云会议管理平台将拉起华为云会议桌面端。 拉起成功后，进入桌面端首页。 图2 进入桌面端首页 父主题： 桌面端

华为云会议的开放能力 华为云会议提供服务端开放集成和客户端开放集成能力，开发者可以根据业务的需要使用对应的接口集成开发。 服务端集成：华为云会议提供服务端REST接口开放，包括企业管理、用户管理、通讯录管理、会议管理、会议控制、仪表盘、网络研讨会管理等能力。第三方业务系统（包括业务后台或者终端App）可以调用相关接口实现自己的业务逻辑。 客户端SDK集成：华为云会议提供了客户端SDK开放，开发者可以在自己开发的App上集成华为云会议的视频会议能力，实现创会、入会、会控等功能。SDK中已经集成了入会后的UI，第三方App只需调用少量接口就可以在自己的App中集成华为云会议的视频能力。 客户端Scheme应用集成：华为云会议客户端提供URL Protocol定义好的参数，第三方应用（包括Web页面或者终端App）可以直接拉起华为云会议客户端并且入会。 图1 华为云会议开放性介绍

集成场景 2：第三方APP通过UI SDK集成，快速集成会议客户端能力 第三方应用有自己的App，通过在App上调用会议客户端UI SDK接口，快速集成会议功能。只需要在客户的App上开发对应的入口并调用对应的接口预约会议、创建会议、加入会议，入会后的会控操作都是SDK提供的界面，无需新开发。 该场景适用于第三方需要将会议能力集成到自己的App内，并且UI SDK提供的会中界面满足使用要求。 图3 第三方App基于终端UI SDK集成场景 上图中①②③的界面都在同一个App中，其中①②是第三方自己的App界面，③是SDK提供的界面。SDK的详细介绍参考《客户端SDK参考》。

集成场景 1：第三方系统预约会议，并拉起华为云会议客户端加入会议 第三方应用可以调用华为云会议服务端的REST API预约会议，并且在页面上加入跳转到拉起华为云会议客户端的URL，实现单击入会的效果。 该场景适用于第三方需要在自己的业务系统中管理和调度会议，并且允许用户使用华为云会议客户端参加会议。 图2 终端Scheme应用集成 REST API的详细介绍参考《服务端API参考》。拉起会议客户端的URL的详细介绍参考《终端Scheme应用集成》。

为什么通过API接口方式下载CDN日志时，返回“细粒度鉴权不通过”错误码？ 可能原因是没有查询到当前项目，可以在请求路径中传参数enterprise_project_id=ALL 例如： GET https://cdn.myhuaweicloud.com/v1.0/cdn/logs?query_date=1502380500000&domain_name=www.example.com&page_size=10&page_number=1&enterprise_project_id=ALL