华为云用户手册

配置并执行yaml构建任务 单击“下一步”，进入“构建模板”页面。 选择“空白构建模板”，单击“下一步”。 选择何种构建模板并不影响使用yaml构建，可以选择系统推荐模板，也可以不使用模板 进入“构建步骤”页签，页面左上角选择“代码化”。 系统会在选择源码源阶段配置的代码仓库及分支中，自动读取yaml文件，可在此处对yaml文件进行修改。 修改完成后需单击右上角“新建”。 单击“新建并执行”，yaml文件修改即可生效并运行yaml构建任务，构建脚本提交后将覆盖原build.yml文件。

前提准备 已有可用项目，如果没有，请新建项目。 已在项目中新建可用代码仓库，如果没有，请新建代码仓库。 在代码仓库中，新建“.cloudbuild”目录，并将yaml文件存放在该目录下，yaml文件编写方法及规范请参考build.yml文件的结构详解。 若yaml文件不存放在“.cloudbuild”目录，可通过“CB_BUILD_YAML_PATH”参数来指定yaml文件在代码仓中的路径。参数配置可参考配置构建参数。

规则说明 2020年10月16日前，未在CodeArts某个区域下产生过费用的用户，按照新版计费规则，需在该区域开通/购买CodeArts或单独购买CodeArts Build套餐后使用。 在该区域内产生过费用的用户，延续旧版计费规则，可参考购买服务在该区域开通编译构建服务包年/包月套餐。 例如： 用户于2020年3月在“华北-北京四”购买了半年期的包月套餐。由于疫情影响业务，套餐到期后关闭了CodeArts服务；2020年10月20日将重新启用CodeArts。 若用户仍使用“华北-北京四”，可以购买旧版套餐使用。 若用户使用其它区域，则需购买CodeArts或者编译构建服务新版计费。 更多计费详情，请参考计费说明。

购买服务 进入购买编译构建服务页面。 确认服务规格信息，单击“免费开通”。 表1 资源规格 资源项 资源规格 构建时长（分钟/月） 1800分钟/月。 构建并发（个） 1个内置执行机（2U8G）和1个自定义执行机并发。 确认套餐包配置信息，勾选“我已经阅读并同意”协议，单击页面右下角“立即开通”，即可下单成功。 表2 套餐包配置 配置项 配置详情 计费模式 包年/包月。 区域 选择需要使用的区域。不同区域购买的资源不能跨区使用，需慎重选择。 产品 选择“Build专业版”。 产品描述 免费使用构建时长1800分钟/月，单租户1个内置执行机(2U8G)并发和1个自定义执行机并发，使用限制性资源池，超过并发数时构建任务会进行排队。用户可额外购买构建加速包提升效率和购买构建并发包扩容。 购买时长 选择“1个月”。 自动续费 勾选后将开启自动续费。自动续费规则请参考自动续费规则说明。 下单成功即服务开通成功。

购买须知 在CodeArts支持的区域内，各区域独立开通购买、独立计费。 您可以购买CodeArts Build套餐，或者开通/购买软件开发生产线服务组合套餐，体验一站式、全流程、安全可信的软件开发生产线。 购买编译构建服务需要您拥有租户账号，或拥有Tenant Administrator权限的IAM用户账号，配置权限策略方法请参考创建用户组并授权。 若已经购买了CodeArts套餐，则无需再单独购买CodeArts Build套餐。

方案架构 图1 业务架构 架构说明：该方案结合多端应用与先进技术，旨在提升企业的业务效率和用户体验。支持APP、小程序、H5、PC端等，并可灵活嵌入员工办公平台如Welink、企业微信、飞书等。借助华为云盘古大模型和数字内容Metastudio，高效展示企业业务价值，并支持营销内容的创作与分发。 此外，该方案还集成了华为Metastudio的数字人服务、声音复刻和AI智能抠图，快速生成销售数字分身。智能问答功能基于盘古大模型+向量数据库，提升企业知识库的互动体验。为确保业务的高可用性和高性能，另外该方案结合了华为CCE云容器引擎和RDS云数据库RDS服务。CCE提供容器应用管理能力和应用级弹性扩容，确保业务快速响应需求。RDS具备完善的性能监控和安全防护措施，简化运营流程，使企业更专注于应用开发和业务发展。这一全面方案将多端应用、AI技术与内容创作融为一体，助力企业提升业务效率和用户体验。 核心应用 利用AI增强的销售和营销工具，涉及客户数据分析。内容自动化创建及市场智能推广，旨在提高业务效率和促进销售增长。 能力中台 作为技术枢纽，集成了智能内容中心、推广中心、客户中心和数据中心等。为企业提供内容管理、市场推广、客户关系和数据分析的综合能力，以支撑业务增长和决策制定。 开放平台对接 开放对接平台使企业的OA、CRM、财务和CMS系统能够与外部系统集成。优化了业务流程，提高了运营效率，同时确保了信息的一致性和易访问性。 图2 部署架构

方案优势 一站式服务 全面的业务覆盖： 方案通过集成销售、推广和管理等功能，为企业提供了从前端的客户接触点到后端的运营管理的全链条服务。这意味着企业可以在一个平台上解决多种业务需求，无需投资于多个不同的系统或工具，从而降低了复杂性和成本。 流程协同： 集成化的服务让不同的部门（如销售、市场、客服）能够更加紧密地协作共享信息和数据，提高工作效率和一致性，避免信息孤岛的问题。 数据驱动决策 实时数据分析： 方案提供的实时数据分析和可视化大屏，使得企业能够即时获取业务运营的关键指标和趋势，从而快速响应市场变化。 预测性分析： 利用先进的数据挖掘和机器学习技术，物料能够收集市场趋势和客户行为，为企业的战略规划和运营决策提供科学依据。 用户体验优化 定制化界面与交互： 方案允许企业根据自己的品牌风格和用户需求定制化界面和交互设计，提供更加个性化和友好的用户体验。 智能化功能： 利用AI技术，如自然语言处理和图像识别，方案可以提供智能客服、个性化推荐等功能，提升用户满意度和粘性。 灵活性和扩展性 模块化设计： 方案采用模块化设计，使得企业可以根据当前的业务需求选择合适的模块使用，并在未来随着业务的发展灵活添加新模块或功能。 云原生架构： 基于云原生技术构建，方案能够无缝地在云环境中扩展，支持横向扩展和自动扩展功能，确保在用户数量剧增或数据量激增时，系统依然保持高性能和稳定性。

应用场景 加推利用AIGC和Martech技术，为企业成功打造了智能销售工具库系统。 数字人名片展业系统：递出名片的同时更好向客户介绍自己、产品业务和品牌实力； 销售推广工具库：包含文件网盘、获客文章、海报、短视频等，将营销工具和内容赋能销售随时随地推广； 智能AI雷达：客户关键浏览访问实时智能提醒、客户每次浏览价值智能生成小结、客户内容传播数字人脉可视化、客户跟进时机智能预测提醒； 企业数字人脉系统：所有递出的名片连接客户企业清晰可查、销售推广客户互动智能报表生成、企业Boss雷达智能调度每个员工、开放对接平台无缝对接企业相关系统。 企业销售和市场推广 业务挑战：在当今快速变化的市场环境中，企业面临的销售和市场推广挑战愈发复杂多元。首先，缺乏一个集成化和智能化的营销工具及内容管理平台，使得销售团队难以高效利用和管理营销资源，影响了客户互动的质量和转化效率。其次，分散的销售网络和缺乏有效的调度机制导致企业无法实现资源的优化配置，同时，缺少实时的市场数据反馈和分析系统，使得企业难以及时洞察市场变化，快速调整营销策略以应对竞争。此外，随着客户需求的日益个性化，企业在提供定制化和互动性强的客户体验方面面临巨大挑战，这直接关系到客户满意度和忠诚度的提升。 业务效果：企业可以通过定制化的智能名片集成产品视频、和即时沟通功能，增强潜在客户的互动体验。小程序推广码可以结合留资信息和事件触发，为特定场合或活动提供专属内容，从而提高用户参与度和转化率。 方案优势：引入灵活配置内容和交互式元素到智能名片中，如物料展示、即时问答等，以提升用户的参与感和品牌记忆度。 客户关系管理 业务效果：通过高级线索管理系统，企业能够实现线索的捕获和分配，确保高价值线索得到优先处理。转介绍系统可以通过激励机制鼓励现有客户或合作伙伴分享推荐，进一步扩大潜在客户基础。 方案优势：数据导向引入分析模型来预测客户需求和购买行为，实现更个性化的客户服务和准确营销。 内容管理与分享 业务效果：内容中台不仅支持文本和图像，还可以管理和分发互动式内容如在线课程、互动问答等，为用户提供更丰富的知识分享和学习体验。 方案优势：利用模块化技术生成个性化内容推荐，根据企业的用户画像，为企业提供量身定制的阅读列表，增强用户粘性。 任务和活动管理 业务效果：任务中心可以与企业的CRM系统和销售管道无缝集成，自动化任务分配和进度追踪，确保销售团队专注于最有价值的活动和客户。 方案优势：引入游戏化元素，如排行榜、成就徽章等，激励销售团队以更积极的态度参与销售任务和市场活动。 企业内部管理 业务效果：通过高度可配置的员工管理系统，企业可以根据不同的业务单位和角色设置不同的权限和数据访问级别，确保信息安全同时提升工作效率。 方案优势：确保员工数据和业务记录的不可篡改性和透明度，增强内部治理的信任度。

响应示例 状态码： 200 successful operation { "storage_pool" : { "id" : "d70a8f73-edef-4b71-beb3-7dbc22f0365e", "name" : "SAS-ojoiv", "edge_site_id" : "a4a36874-c41b-4295-9fd5-6823864fd564", "storage_type" : "SAS", "status" : "AVAILABLE", "assigned_size" : 36, "resource_spec_code" : "ies.blockstorage.gear1", "capacity" : 144, "market_options" : { "charge_mode" : "prepaid", "prepaid_options" : { "order_id" : "CS2201181056V3SK6", "product_id" : "OFFI644832402269233154", "pay_mode" : "FULL" } }, "created_at" : "2022-01-18T02:56:02.76091Z", "updated_at" : "2022-01-18T02:59:56.5601Z", "effected_at" : "2022-01-19T02:59:25Z" } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 storage_pool StoragePool object 存储池 表4 StoragePool 参数 参数类型 描述 id String 存储池ID name String 存储池名称 edge_site_id String 边缘小站ID storage_type String 存储类型。 SAS：高IO SSD：超高IO SAS_SD：高IO(软件定义型专用) SSD_SD：超高IO(软件定义型专用) SAS_ARM：高IO（鲲鹏） SSD_ARM：超高IO（鲲鹏） status String 存储池状态。 CREATING：创建中 AVAILABLE：可用 EXPANDING：扩容中 PENDING_PAYMENT：待支付 assigned_size Integer 存储池大小。 当前购买的存储容量。 resource_spec_code String 资源规格编码 capacity Integer 总容量 market_options MarketOptions object 计费信息 created_at String 创建时间 updated_at String 更新时间 effected_at String 生效时间 表5 MarketOptions 参数 参数类型 描述 charge_mode String 计费模式。 prepaid：包周期 prepaid_options PrepaidOptions object 包周期计费信息 表6 PrepaidOptions 参数 参数类型 描述 order_id String 订单ID product_id String 产品ID pay_mode String 包周期付款类型 FULL: 全预付 HALF：半预付 PAID_BY_YEAR：按年付费

URI GET /v1/{domain_id}/regions 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String path中租户的账号ID 最大长度：36 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页的数量 最小值：1 最大值：2000 缺省值：2000 marker 否 String 分页标识 sort_key 否 Array 排序字段 sort_dir 否 Array 排序方式，取值范围： desc：降序 asc：升序

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 regions Array of RegionDetail objects 区域列表 page_info PageInfo object 分页信息 表5 RegionDetail 参数 参数类型 描述 region_id String 区域ID display_name String 区域名称 表6 PageInfo 参数 参数类型 描述 next_marker String 下一页标识。 current_count Integer 当前页数量。

响应示例 状态码： 200 successful operation { "storage_pools" : [ { "id" : "d70a8f73-edef-4b71-beb3-7dbc22f0365e", "name" : "SAS-ojoiv", "edge_site_id" : "a4a36874-c41b-4295-9fd5-6823864fd564", "storage_type" : "SAS", "volume_type" : "SAS", "status" : "AVAILABLE", "assigned_size" : 36, "resource_spec_code" : "ies.blockstorage.gear1", "capacity" : 144, "market_options" : { "charge_mode" : "prepaid", "prepaid_options" : { "order_id" : "CS2201181056V3SK6", "product_id" : "OFFI644832402269233154", "pay_mode" : "FULL" } }, "created_at" : "2022-01-18T02:56:02.76091Z", "updated_at" : "2022-01-18T02:59:56.5601Z", "effected_at" : "2022-01-19T02:59:25Z" } ], "page_info" : { "current_count" : 1 } }

URI GET /v1/{domain_id}/storage-pools 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String path中租户的账号ID 最大长度：36 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页的数量 最小值：1 最大值：2000 缺省值：2000 marker 否 String 分页标识 sort_key 否 Array 排序字段 sort_dir 否 Array 排序方式，取值范围： desc：降序 asc：升序 edge_site_id 否 String 边缘小站ID

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 storage_pools Array of StoragePool objects 存储池列表 page_info PageInfo object 分页信息 表5 StoragePool 参数 参数类型 描述 id String 存储池ID name String 存储池名称 edge_site_id String 边缘小站ID storage_type String 存储类型。 SAS：高IO SSD：超高IO SAS_SD：高IO(软件定义型专用) SSD_SD：超高IO(软件定义型专用) SAS_ARM：高IO（鲲鹏） SSD_ARM：超高IO（鲲鹏） status String 存储池状态。 CREATING：创建中 AVAILABLE：可用 EXPANDING：扩容中 PENDING_PAYMENT：待支付 assigned_size Integer 存储池大小。 当前购买的存储容量。 resource_spec_code String 资源规格编码 capacity Integer 总容量 market_options MarketOptions object 计费信息 created_at String 创建时间 updated_at String 更新时间 effected_at String 生效时间 表6 MarketOptions 参数 参数类型 描述 charge_mode String 计费模式。 prepaid：包周期 prepaid_options PrepaidOptions object 包周期计费信息 表7 PrepaidOptions 参数 参数类型 描述 order_id String 订单ID product_id String 产品ID pay_mode String 包周期付款类型 FULL: 全预付 HALF：半预付 PAID_BY_YEAR：按年付费 表8 PageInfo 参数 参数类型 描述 next_marker String 下一页标识。 current_count Integer 当前页数量。

响应示例 状态码： 200 successful operation { "edge_site" : { "id" : "cc89b1e5-521d-4a85-be83-e6f7217fc63e", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "name" : "测试站点", "description" : "测试站点：位于安徽", "region_id" : "cn-north-4", "project_id" : "060576838600d5762f2dc000470eb164", "availability_zone_id" : null, "status" : "initial", "location" : { "description" : "测试站点场地信息", "zone_code" : "CN", "address" : "广东省 深圳市 南山区", "country" : "CN", "province" : "广东省", "city" : "深圳市", "district" : "南山区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } }, "created_at" : "2022-04-15T07:59:20.641Z", "updated_at" : null } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 edge_site EdgeSiteDetail object 边缘小站详情 表4 EdgeSiteDetail 参数 参数类型 描述 id String 边缘小站ID domain_id String 边缘小站所属账号ID name String 边缘小站名称 description String 边缘小站描述 region_id String 边缘小站所属区域ID project_id String 边缘小站所属项目ID availability_zone_id String 边缘小站的可用区ID status String 边缘小站的部署状态 location LocationDetail object 场地详情 created_at String 边缘小站创建时间 updated_at String 边缘小站更新时间 表5 LocationDetail 参数 参数类型 描述 name String 场地名称（已废弃），传入该参数不会再生效，新建站点也不会再返回该字段 description String 场地描述 zone_code String 场地所在地区 address String 部署位置 country String 场地所在国家（逐步下线，使用zone_code替代） province String 场地所在省/自治区/直辖市 city String 场地所在市/区 district String 场地所在区/县 condition Condition object 场地条件 表6 Condition 参数 参数类型 描述 environment Integer 机房环境条件 取值范围： 0：机房条件不属于上述任何一种情况 1：机房使用模块化数据中心方案进行建设 2：机房已通过国家级或行业级标准化认证 最小值：0 最大值：2 缺省值：0 space Integer 机柜空间条件 取值范围： 0：暂无扩容计划，不考虑额外余量 1：机柜余量相对充裕，可放置空间超过3柜 2：机柜余量相对紧张，可放置空间3柜以内 最小值：0 最大值：2 缺省值：0 transport Integer 运输条件 取值范围： 0：运输通道和机房门的高度或宽度不满足要求 1：运输通道，货梯，机房门均可满足整机柜滚轮搬运 2：运输通道，货梯，机房门不能支持整机柜滚轮搬运，沿途有台阶 最小值：0 最大值：2 缺省值：0 installation String 整柜安装评估 取值范围： UNCLEAR：不清楚是否允许整柜安装，需要评估 UNSUPPORT：不允许整柜安装，需将设备放入现有机柜 SUPPORT：可支持整柜安装，并入现有机柜组 缺省值：UNCLEAR

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 quotas QuotaResources object 资源配额详情列表 表4 QuotaResources 参数 参数类型 描述 resources Array of QuotaDetail objects 资源配额列表 表5 QuotaDetail 参数 参数类型 描述 type String 资源类型 取值范围： edge_site：边缘小站 compute_device：计算设备 quota Integer 资源的总配额 约束：资源的默认配额数可以修改，默认配置：边缘小站（10） used Integer 已创建的资源个数 取值范围：0~quota值

响应示例 状态码： 200 successful operation { "edge_site" : { "id" : "cc89b1e5-521d-4a85-be83-e6f7217fc63e", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "name" : "测试站点", "description" : "测试站点：位于安徽", "region_id" : "cn-north-4", "project_id" : "060576838600d5762f2dc000470eb164", "availability_zone_id" : null, "status" : "initial", "location" : { "description" : "测试站点场地信息", "zone_code" : "CN", "address" : "安徽省 合肥市 瑶海区", "country" : "CN", "province" : "安徽省", "city" : "合肥市", "district" : "瑶海区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } }, "created_at" : "2022-04-15T07:59:20.641Z", "updated_at" : "2022-04-15T08:59:20.641Z" } }

请求示例 更新边缘小站，部署位置为中国/安徽省/合肥市/瑶海区，机房暂不确定是否满足条件，机柜暂无扩容计划，运输通道和机房门的高度或宽度不满足要求，可支持整柜安装，并入现有机柜组 PUT https://{ies_endpoint}/v1/{domain_id}/edge-sites/{site_id} { "edge_site" : { "description" : "测试站点：位于安徽", "location" : { "description" : "测试站点场地信息", "country" : "CN", "province" : "安徽省", "city" : "合肥市", "district" : "瑶海区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } } } } 更新边缘小站 PUT https://{ies_endpoint}/v1/{domain_id}/edge-sites/{site_id} { "edge_site" : { "description" : "边缘小站更新", "location" : { "description" : "测试站点场地信息", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } } } }

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 edge_site EdgeSiteDetail object 边缘小站详情 表8 EdgeSiteDetail 参数 参数类型 描述 id String 边缘小站ID domain_id String 边缘小站所属账号ID name String 边缘小站名称 description String 边缘小站描述 region_id String 边缘小站所属区域ID project_id String 边缘小站所属项目ID availability_zone_id String 边缘小站的可用区ID status String 边缘小站的部署状态 location LocationDetail object 场地详情 created_at String 边缘小站创建时间 updated_at String 边缘小站更新时间 表9 LocationDetail 参数 参数类型 描述 name String 场地名称（已废弃），传入该参数不会再生效，新建站点也不会再返回该字段 description String 场地描述 zone_code String 场地所在地区 address String 部署位置 country String 场地所在国家（逐步下线，使用zone_code替代） province String 场地所在省/自治区/直辖市 city String 场地所在市/区 district String 场地所在区/县 condition Condition object 场地条件 表10 Condition 参数 参数类型 描述 environment Integer 机房环境条件 取值范围： 0：机房条件不属于上述任何一种情况 1：机房使用模块化数据中心方案进行建设 2：机房已通过国家级或行业级标准化认证 最小值：0 最大值：2 缺省值：0 space Integer 机柜空间条件 取值范围： 0：暂无扩容计划，不考虑额外余量 1：机柜余量相对充裕，可放置空间超过3柜 2：机柜余量相对紧张，可放置空间3柜以内 最小值：0 最大值：2 缺省值：0 transport Integer 运输条件 取值范围： 0：运输通道和机房门的高度或宽度不满足要求 1：运输通道，货梯，机房门均可满足整机柜滚轮搬运 2：运输通道，货梯，机房门不能支持整机柜滚轮搬运，沿途有台阶 最小值：0 最大值：2 缺省值：0 installation String 整柜安装评估 取值范围： UNCLEAR：不清楚是否允许整柜安装，需要评估 UNSUPPORT：不允许整柜安装，需将设备放入现有机柜 SUPPORT：可支持整柜安装，并入现有机柜组 缺省值：UNCLEAR

操作步骤 查询支持边缘小站接入的区域列表并确认拟接入的区域ID。 接口相关信息 URI格式：GET /v1/{domain_id}/regions 接口详情请参见：查询支持的区域列表。 请求示例 GET https://{endpoint}/v1/{domain_id}/regions {endpoint}信息请从地区和终端节点获取。 {domain_id}信息获取方式参见获取账号ID。 响应示例 状态码： 200 OK { "regions" : [ { "region_id" : "cn-north-9", "display_name" : "华北-乌兰察布一" }, { "region_id" : "cn-south-1", "display_name" : "华南-广州" } ] } 创建边缘小站。 接口相关信息 URI格式：POST /v1/{domain_id}/edge-sites 接口详情请参见：创建边缘小站 请求示例 POST https://{endpoint}/v1/{domain_id}/edge-sites {endpoint}信息请从地区和终端节点获取。 {domain_id}信息获取方式参见获取账号ID。 请求Body体 { "edge_site": { "name": "test11111111", "description": "teasra", "region_id": "br-iaas-odin1", "location": { "name": "test11111111111", "description": "description", "country": "CN", "province": "安徽省", "city": "合肥市", "district": "瑶海区", "condition": { "environment": 0, "space": 0, "transport": 0 } } } } 响应示例 状态码： 200 OK { "edge_site": { "id": "cc89b1e5-521d-4a85-be83-e6f7217fc63e", "domain_id": "2b76febbe5d34eac85d26435c1f15809", "name": "test11111111", "description": "teasra", "region_id": "br-iaas-odin1", "project_id": "060576838600d5762f2dc000470eb164", "availability_zone_id": null, "status": "initial", "location": { "name": "test11111111111", "description": "description", "country": "CN", "province": "安徽省", "city": "合肥市", "district": "瑶海区", "condition": { "environment": 0, "space": 0, "transport": 0 } }, "created_at": "2022-04-15T07:59:20.641Z", "updated_at": null } }

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 云服务存在两种部署方式：项目级服务和全局级服务。 项目级服务需要获取项目级别的Token，此时请求body中auth.scope的取值为project。 全局级服务需要获取全局级别的Token，此时请求body中auth.scope的取值为domain。 调用本服务API需要domain级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择domain，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "domain": { "name": "xxxxxxxx" } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 父主题： 使用前必读

响应示例 状态码： 200 successful operation { "edge_site" : { "id" : "cc89b1e5-521d-4a85-be83-e6f7217fc63e", "domain_id" : "2b76febbe5d34eac85d26435c1f15809", "name" : "测试站点", "description" : "测试站点：位于安徽", "region_id" : "cn-north-4", "project_id" : "060576838600d5762f2dc000470eb164", "availability_zone_id" : null, "enterprise_project_id" : "0", "status" : "initial", "location" : { "description" : "站点场地信息", "zone_code" : "CN", "address" : "安徽省 合肥市 瑶海区", "country" : "CN", "province" : "安徽省", "city" : "合肥市", "district" : "瑶海区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0, "installation" : "SUPPORT" } }, "created_at" : "2022-04-15T07:59:20.641Z", "updated_at" : null } }

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 edge_site EdgeSiteDetail object 边缘小站详情 表8 EdgeSiteDetail 参数 参数类型 描述 id String 边缘小站ID domain_id String 边缘小站所属账号ID name String 边缘小站名称 description String 边缘小站描述 region_id String 边缘小站所属区域ID project_id String 边缘小站所属项目ID availability_zone_id String 边缘小站的可用区ID status String 边缘小站的部署状态 location LocationDetail object 场地详情 created_at String 边缘小站创建时间 updated_at String 边缘小站更新时间 表9 LocationDetail 参数 参数类型 描述 name String 场地名称（已废弃），传入该参数不会再生效，新建站点也不会再返回该字段 description String 场地描述 zone_code String 场地所在地区 address String 部署位置 country String 场地所在国家（逐步下线，使用zone_code替代） province String 场地所在省/自治区/直辖市 city String 场地所在市/区 district String 场地所在区/县 condition Condition object 场地条件 表10 Condition 参数 参数类型 描述 environment Integer 机房环境条件 取值范围： 0：机房条件不属于上述任何一种情况 1：机房使用模块化数据中心方案进行建设 2：机房已通过国家级或行业级标准化认证 最小值：0 最大值：2 缺省值：0 space Integer 机柜空间条件 取值范围： 0：暂无扩容计划，不考虑额外余量 1：机柜余量相对充裕，可放置空间超过3柜 2：机柜余量相对紧张，可放置空间3柜以内 最小值：0 最大值：2 缺省值：0 transport Integer 运输条件 取值范围： 0：运输通道和机房门的高度或宽度不满足要求 1：运输通道，货梯，机房门均可满足整机柜滚轮搬运 2：运输通道，货梯，机房门不能支持整机柜滚轮搬运，沿途有台阶 最小值：0 最大值：2 缺省值：0 installation String 整柜安装评估 取值范围： UNCLEAR：不清楚是否允许整柜安装，需要评估 UNSUPPORT：不允许整柜安装，需将设备放入现有机柜 SUPPORT：可支持整柜安装，并入现有机柜组 缺省值：UNCLEAR

请求示例 创建边缘小站，区域为cn-north-4（北京四），部署位置为中国/安徽省/合肥市/瑶海区，机房暂不确定是否满足条件，机柜暂无扩容计划，运输通道和机房门的高度或宽度不满足要求，可支持整柜安装，并入现有机柜组 POST https://{ies_endpoint}/v1/{domain_id}/edge-sites { "edge_site" : { "name" : "测试站点", "description" : "测试站点：位于安徽", "region_id" : "cn-north-4", "location" : { "description" : "站点场地信息", "zone_code" : "CN", "address" : "安徽省 合肥市 瑶海区", "country" : "CN", "province" : "安徽省", "city" : "合肥市", "district" : "瑶海区", "condition" : { "environment" : 0, "space" : 0, "transport" : 0 } } } }

响应示例 状态码： 200 successful operation { "rack" : { "id" : "fe89570e-da65-4a4d-a64b-03231257dd96", "name" : "basic-absuv", "edge_site_id" : "a4a36874-c41b-4295-9fd5-6823864fd564", "rack_category_id" : "47ac059f-5df3-422b-b08a-eabba8c01980", "rack_type" : "BASIC", "status" : "AVAILABLE", "storage_assigned_size" : 36, "description" : null, "rack_sn_no" : "rack_sn_no", "rack_location_no" : "rack_location_no", "created_at" : "2022-01-18T02:56:02.759098Z", "updated_at" : "2022-01-18T02:59:56.559151Z", "effected_at" : "2022-01-19T02:59:25Z", "market_options" : { "charge_mode" : "prepaid", "prepaid_options" : { "order_id" : "CS2201181056V3SK6", "product_id" : "OFFI645544463633592326", "pay_mode" : "FULL" } }, "compute_unit" : [ { "flavor_type" : "C6", "count" : 4 }, { "flavor_type" : "Pi2", "count" : 1 } ], "storage_unit" : { "storage_type" : "SAS", "capacity" : 144, "gears" : [ 36, 72, 108, 144 ], "flavor_type" : "string", "count" : 1 }, "rack_info" : { "power" : 6000, "size" : "600mm*1200mm*2000mm（宽*深*高）", "has_lock" : true } } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 rack Rack object 机柜 表4 Rack 参数 参数类型 描述 id String 机柜ID name String 机柜名称 edge_site_id String 边缘小站ID rack_category_id String 机柜目录ID rack_type String 机柜类型 status String 机柜状态。 CREATING：创建中 AVAILABLE：可用 EXPANDING：扩容中 PENDING_PAYMENT: 待支付 storage_assigned_size Integer 已分配存储容量 description String 机柜描述 rack_sn_no String 机柜SN号 rack_location_no String 机柜位置号 created_at String 创建时间 updated_at String 更新时间 effected_at String 生效时间 market_options MarketOptions object 计费信息 compute_unit Array of ComputeSpec objects 计算单元信息 storage_unit StorageUnit object 存储单元 rack_info RackInfo object 机柜信息 表5 MarketOptions 参数 参数类型 描述 charge_mode String 计费模式。 prepaid：包周期 prepaid_options PrepaidOptions object 包周期计费信息 表6 PrepaidOptions 参数 参数类型 描述 order_id String 订单ID product_id String 产品ID pay_mode String 包周期付款类型 FULL: 全预付 HALF：半预付 PAID_BY_YEAR：按年付费 表7 ComputeSpec 参数 参数类型 描述 flavor_type String 算力规格类型，如C6 最小长度：1 最大长度：64 count Integer 计算单元设备数 最小值：1 表8 StorageUnit 参数 参数类型 描述 storage_type String 存储类型。 SAS：高IO SSD：超高IO SAS_SD：高IO(软件定义型专用) SSD_SD：超高IO(软件定义型专用) SAS_ARM：高IO（鲲鹏） SSD_ARM：超高IO（鲲鹏） capacity Integer 存储池大小，单位：TB。 最小值：1 gears Array of integers 存储池销售档位 flavor_type String 规格类型。例如：highio-4T 最小长度：1 最大长度：64 count Integer 存储节点台数。 最小值：1 表9 RackInfo 参数 参数类型 描述 power Integer 机柜功率，单位：w size String 机柜尺寸，如100*200*200，单位：cm 最大长度：64 has_lock Boolean 是否有机柜锁。