华为云用户手册

  • 导出组织和账号的消费明细 进入“消费明细”页面。 选择需要查看消费明细的页签。 包年/包月:根据资源维度展示包年/包月账单信息,同一个资源在一个月中只展示一条数据。 按需:根据资源维度展示按需账单信息,同一个资源在一个月中只展示一条数据。 预留实例:购买了预留实例的用户,可以查看预留实例的消费信息。 选择待导出的账号或组织。 单击“导出”。 设置查询条件,筛选出需要导出的消费明细。 单击“确定”。 即可导出根据查询条件筛选出的消费明细。 系统跳转到“导出记录”页面,客户可以在“导出记录”页面下载导出的消费明细。
  • 设置子账号预算 财务托管模式下,您可以通过如下两种方式进入成本中心,对子账号进行成本预算的设置,监控子账号的消费。 创建子账号成功后,单击创建子账号成功的提示消息中的“设置成本预算”,直接跳转至“成本中心”。 单击“组织与账号”页面提示中的“成本预算”进入“成本中心”。 新建预算的具体操作请参见新建预算。管理子账号的成本预算具体操作请参见预算管理。 企业子账号新关联到企业主账号上,子账号之前的消费资金不属于预算消费。企业子账号与企业主账号解除关联后,子账号之后的消费资金不属于预算消费。 未关联成功的企业子账号不允许分配预算。 新建预算时,请在“设置成本范围”的“关联账号”中勾选需要分配预算的子账号,才能为企业子账号设置预算。 父主题: 组织管理
  • 导出企业项目下的资源信息 当前企业项目管理控制台暂不支持导出资源信息,如需导出企业项目下的资源信息,请在配置审计服务控制台操作。 登录管理控制台。 单击页面左上角的图标,在弹出的服务列表中,选择“管理与监管”下的“配置审计 Config”,进入“资源清单”页面。 在“资源清单”页面中部通过企业项目筛选资源。 单击“导出资源列表”按钮,导出所选企业项目下的全部资源信息。 图3 导出企业项目下的资源信息 导出的文件格式为Excel格式,文件中将包含您所选企业项目下的全部资源的特定资源属性。
  • 其他操作 修改名称及描述:在“企业项目群管理”页面,选择一条待修改的企业项目群,单击“操作”列的“修改名称”,即可修改该企业项目群的名称和描述信息。 管理项目列表:在“企业项目群管理”页面,选择一条待修改企业项目的企业项目群,单击“操作”列的“更多”,选择“管理项目列表”,即可修改该企业项目群中的企业项目。 解散企业项目群:在“企业项目群管理”页面,选择一条待删除的企业项目群,单击“操作”列的“更多”,选择“解散”,即可解散该企业项目群。 企业项目群被解散后,您将无法查看该企业项目群的财务信息,但是企业项目群中的成员不受影响,您仍可以在企业项目的财务信息中查看各企业项目的财务信息。
  • 为用户组添加 IAM 用户 管理员可以参考以下操作将IAM用户Test_User_A和Test_User_B分别添加至用户组Test_E CS _A和Test_ECS_B。 登录华为云,在右上角单击“控制台”。 在控制台页面,鼠标移动至右上方的用户名,在下拉列表中选择“ 统一身份认证 ”。 在左侧导航窗格中,单击“用户组”。 在用户组列表中,单击新建的用户组“Test_ECS_A”右侧的“用户组管理”。 图1 用户组管理 在“可选用户”中选择需要添加至用户组中的用户。 图2 为用户组添加用户 单击“确定”,完成添加。 父主题: 快速入门
  • 回收代金券 企业主账号回收给子账号发放的代金券时,仅可以回收在有效期内的、剩余的代金券金额。 进入“资金拨款与开票”页面。 选择主账号下需要回收代金券的子账号。 单击操作列的“回收”。 进入“回收”页面。 单击“代金券”选项框。 进入“代金券回收”页面。 选择待回收的代金券,单击“确定”。 系统提示“资金安全验证”弹窗。 进行身份二次验证。 选择验证方式。 单击“获取验证码”后,在输入框中填写正确的验证码。 单击“确定”。 系统提示提交操作成功信息。 进入企业中心“总览”页面,可以开通或关闭资金安全验证功能。如您已经在“总览”页面打开开关才会执行该步骤,如未开启,则不需要。开通或关闭该功能,请参考设置资金安全。 单击“继续回收”进入“回收”页面或单击“返回资金拨款与开票”返回“资金拨款与开票”页面。
  • 回收信用额度 进入“资金拨款与开票”页面。 选择主账号下需要回收资金的子账号。 单击操作列的“回收”。 进入“回收”页面。 单击“信用额度”选项框。 进入“信用额度”页面。 设置回收额度,单击“确定”。 系统提示“资金安全验证”弹窗。 进行身份二次验证。 选择验证方式。 单击“获取验证码”后,在输入框中填写正确的验证码。 单击“确定”。 系统提示提交操作成功信息。 进入企业中心“总览”页面,可以开通或关闭资金安全验证功能。如您已经在“总览”页面打开开关才会执行该步骤,如未开启,则不需要。开通或关闭该功能,请参考设置资金安全。 单击“继续回收”进入“回收”页面或单击“返回资金拨款与开票”返回“资金拨款与开票”页面。
  • 回收账户余额 进入“资金拨款与开票”页面。 单个回收 选择需要划拨资金的子账号,单击右侧操作列的“回收”,进入“回收”页面。 选择回收方式“账户余额”,进入“账户余额”页面。 设置回收金额,单击“确定”。 系统提示“资金安全验证”弹窗。 批量回收 勾选需要划拨资金的子账号,单击左上角的“回收”,进入“批量回收”页面。 选择回收方式“账户余额”,进入“账号检查”页面。 单击“下一步”为检查通过的子账号批量回收。 设置回收金额,包括如下回收方式:单击“确认回收”。 自定义回收金额:当输入的自定义金额大于账户可回收余额时,可以选择“不回收”或“按可回收余额回收”;也可以在“本次回收金额”中为每个子账号账号单独设置不同的回收金额。 按可回收金额全部回收:按实际可回收的全部金额进行回收;也可以在“本次回收金额”中为每个子账号账号单独设置不同的回收金额。 您也可以单击子账号后的“移除”,移除不需要回收余额的子账号。 可回收金额=账户余额-欠票金额。 系统提示“资金安全验证”弹窗。 进行身份二次验证。 选择验证方式。 单击“获取验证码”后,在输入框中填写正确的验证码。 单击“确定”。 系统提示提交操作成功信息。 进入企业中心“总览”页面,可以开通或关闭资金安全验证功能。如您已经在“总览”页面打开开关才会执行该步骤,如未开启,则不需要。开通或关闭该功能,请参考设置资金安全。 单击“继续回收”进入“回收”页面或单击“返回资金拨款与与开票”返回“资金拨款与开票”页面。
  • 创建组织策略 进入“组织策略管理”页面。 选择“全部策略”页签。 单击“创建策略”,进入“创建策略”页面。 设置策略相关信息。 JSON语法介绍请参见策略语言说明。 通过完全新建的方式创建策略 输入策略名称、策略描述等基本信息。 设置策略效果。 组织策略权限集效果: 拒绝:指定的操作拒绝,其他操作都允许。 允许:指定的操作允许,其他操作都拒绝。 组织策略实现原理: 企业中心添加子账号,子账号默认权限是所有操作都允许做。企业中心增加组织策略,组织策略对子账号的权限做约束。对于拒绝策略,实现时使用的是拒绝指定操作;对于允许策略,实现时使用的是拒绝所有操作,仅仅对允许做的操作不拒绝。 由策略的实现可知当子账号有多条拒绝策略时,每条拒绝策略都会生效。当子账号有多条允许策略时,只会有一条允许策略生效,其他允许策略不生效。因此建议您设置允许策略时,将子账号的所有允许操作都配置到一条策略中。 选择需要进行权限控制的云服务以及权限项。 单击“确认”。 通过复制现有策略的方式创建策略 输入策略名称、策略描述等基本信息。 单击“复制现有策略”。 系统弹出“复制现有策略”对话框。 选择需要的策略。 单击“确定”,已选策略的Action将在策略内容中显示。 根据实际需要修改策略内容中的Action。 单击“校验语法”。 系统提示“未发现语法问题,校验通过”。 单击“确认”。
  • 责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击,华为云在遵从法律法规业界标准的基础上,以安全生态圈为护城河,依托华为独有的软硬件优势,构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任,如图1所示。 华为云:负责云服务自身的安全,提供安全的云。华为云的安全责任在于保障其所提供的 IaaS、PaaS 和 SaaS 类云服务自身的安全,涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身,也包括运维运营安全,以及更广义的安全合规遵从。 租户:负责云服务内部的安全,安全地使用云。华为云租户的安全责任在于对使用的 IaaS、PaaS 和 SaaS 类云服务内部的安全以及对租户定制配置进行安全有效的管理,包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统,虚拟防火墙、API 网关和高级安全服务,各项云服务,租户数据,以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施,包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题: 安全
  • 创建IAM用户 管理员可以参考以下操作分别创建IAM用户Test_User_A和Test_User_B。 登录华为云,在右上角单击“控制台”。 在控制台页面,鼠标移动至右上方的用户名,在下拉列表中选择“统一身份认证”。 在左侧导航窗格中,选择“用户”,单击右上方的“创建用户”。 图1 创建用户 在“创建用户”界面配置用户基本信息。 图2 配置用户基本信息 单击右下角的“下一步”,进入“加入用户组(可选)”界面。 此步骤为可选步骤,可将该用户加入用户组Test_ECS_A,也可暂时不将用户添加至用户组。 单击右下角的“创建用户”,用户创建成功。 具体请参见创建IAM用户。 父主题: 快速入门
  • 主账号向子账号发起权限变更申请 进入“组织和账号”页面。 选择需要变更子账号权限的组织,单击关联账号数量后的“展开”。 选择待变更权限的子账号,单击“操作”列的“权限变更”。 系统显示“账号信息”页面。 在“权限要求”区域,勾选需要增加的权限(或取消勾选需要减少的权限项),单击“确认”。 如果勾选了“禁止子账号自行开票”的权限要求,并且子账号接受了该申请,则子账号不能开发票。 如果当前账号为经销商代售子客户,由经销商伙伴为您开具发票。 如果子账号有商务折扣,不允许勾选“允许子账号继承主账号商务折扣”。 单击权限变更记录后的“查看”即可查看该子账号权限变更的历史记录。 系统提示权限变更申请已成功发送,请等待子账号确认信息。 单击“关闭”。
  • 创建组织策略 进入“组织策略管理”页面。 选择“全部策略”页签。 单击“创建策略”,进入“创建策略”页面。 设置策略相关信息。 JSON语法介绍请参见策略语法。 通过完全新建的方式创建策略 输入策略名称、策略描述等基本信息。 设置策略效果。 组织策略权限集效果: 拒绝:指定的操作拒绝,其他操作都允许。 允许:指定的操作允许,其他操作都拒绝。 组织策略实现原理: 企业中心添加子账号,子账号默认权限是所有操作都允许做。企业中心增加组织策略,组织策略对子账号的权限做约束。对于拒绝策略,实现时使用的是拒绝指定操作;对于允许策略,实现时使用的是拒绝所有操作,仅仅对允许做的操作不拒绝。 由策略的实现可知当子账号有多条拒绝策略时,每条拒绝策略都会生效。当子账号有多条允许策略时,只会有一条允许策略生效,其他允许策略不生效。因此建议您设置允许策略时,将子账号的所有允许操作都配置到一条策略中。 选择需要进行权限控制的云服务以及权限项。 单击“确认”。 通过复制现有策略的方式创建策略 输入策略名称、策略描述等基本信息。 单击“复制现有策略”。 系统弹出“复制现有策略”对话框。 选择需要的策略。 单击“确定”,已选策略的Action将在策略内容中显示。 根据实际需要修改策略内容中的Action。 单击“校验语法”。 系统提示“未发现语法问题,校验通过”。 单击“确认”。
  • 创建用户组 管理员可以参考以下操作分别创建用户组Test_ECS_A和Test_ECS_B。 登录华为云,在右上角单击“控制台”。 在控制台页面,鼠标移动至右上方的用户名,在下拉列表中选择“统一身份认证”。 在左侧导航窗格中,选择“用户组”页签,单击右上方的“创建用户组”。 图1 创建用户组 在“创建用户组”界面,输入“用户组名称”,例如“Test_ECS_A”。 图2 用户组名称 单击“确定”。 用户组创建完成后,用户组列表中会显示新创建的用户组。 具体请参见创建用户组并授权。 父主题: 快速入门
  • 回收代金券 企业主账号回收给子账号发放的代金券时,仅可以回收在有效期内的、剩余的代金券金额。 进入“资金拨款与开票”页面。 选择主账号下需要回收代金券的子账号。 单击操作列的“回收”。 进入“回收”页面。 单击“代金券”选项框。 进入“代金券回收”页面。 选择待回收的代金券,单击“确定”。 系统提示“资金安全验证”弹窗。 进行身份二次验证。 选择验证方式。 单击“获取验证码”后,在输入框中填写正确的验证码。 单击“确定”。 系统提示提交操作成功信息。 进入企业中心“总览”页面,可以开通或关闭资金安全验证功能。如您已经在“总览”页面打开开关才会执行该步骤,如未开启,则不需要。开通或关闭该功能,请参考设置资金安全。 单击“继续回收”进入“回收”页面或单击“返回资金拨款与开票”返回“资金拨款与开票”页面。
  • 回收信用额度 进入“资金拨款与开票”页面。 选择主账号下需要回收资金的子账号。 单击操作列的“回收”。 进入“回收”页面。 单击“信用额度”选项框。 进入“信用额度”页面。 设置回收额度,单击“确定”。 系统提示“资金安全验证”弹窗。 进行身份二次验证。 选择验证方式。 单击“获取验证码”后,在输入框中填写正确的验证码。 单击“确定”。 系统提示提交操作成功信息。 进入企业中心“总览”页面,可以开通或关闭资金安全验证功能。如您已经在“总览”页面打开开关才会执行该步骤,如未开启,则不需要。开通或关闭该功能,请参考设置资金安全。 单击“继续回收”进入“回收”页面或单击“返回资金拨款与开票”返回“资金拨款与开票”页面。
  • 回收账户余额 进入“资金拨款与开票”页面。 单个回收 选择需要划拨资金的子账号,单击右侧操作列的“回收”,进入“回收”页面。 选择回收方式“账户余额”,进入“账户余额”页面。 设置回收金额,单击“确定”。 系统提示“资金安全验证”弹窗。 批量回收 勾选需要划拨资金的子账号,单击左上角的“回收”,进入“批量回收”页面。 选择回收方式“账户余额”,进入“账号检查”页面。 单击“下一步”为检查通过的子账号批量回收。 设置回收金额,包括如下回收方式:单击“确认回收”。 自定义回收金额:当输入的自定义金额大于账户可回收余额时,可以选择“不回收”或“按可回收余额回收”;也可以在“本次回收金额”中为每个子账号账号单独设置不同的回收金额。 按可回收金额全部回收:按实际可回收的全部金额进行回收;也可以在“本次回收金额”中为每个子账号账号单独设置不同的回收金额。 您也可以单击子账号后的“移除”,移除不需要回收余额的子账号。 可回收金额=账户余额-欠票金额。 系统提示“资金安全验证”弹窗。 进行身份二次验证。 选择验证方式。 单击“获取验证码”后,在输入框中填写正确的验证码。 单击“确定”。 系统提示提交操作成功信息。 进入企业中心“总览”页面,可以开通或关闭资金安全验证功能。如您已经在“总览”页面打开开关才会执行该步骤,如未开启,则不需要。开通或关闭该功能,请参考设置资金安全。 单击“继续回收”进入“回收”页面或单击“返回资金拨款与与开票”返回“资金拨款与开票”页面。
  • 设置余额预警 余额预警是指当资金配额余额低于设置的值时,系统会发送短信和邮件通知预警接收人。 进入“配额管理”页面。 如果余额预警开关是关闭状态,请先开启余额预警开关;如果资金余额预警开关已经开启,直接执行3。 关闭配额余额预警开关后,您将无法收到相关的预警通知。 设置资金配额的余额预警信息。 单击“警报阈值”后的“修改”按钮,修改警报阈值。 单击“ 消息通知 ”后的“消息接收配置”,设置预警消息的告警接收人。
  • 操作场景 开通企业项目的客户,可以为企业项目设置资金配额,用于控制企业项目合理使用资金。 当企业项目资金配额不足时,客户可以设置控制新订购包年/包月云资源和新开通按需云资源。对于已存在的资源不进行控制,包括按需资源的消费、自动续订包年/包月资源、手工续订包年/包月资源、按需转包年/包月、资源修改配置等。 在企业项目财务信息管理页面,可以查看企业项目的资金配额信息,设置资金配额限制的开启或关闭、设置余额预警的开启或关闭等。 为企业项目设置资金配额仅用于控制企业项目合理使用资金。企业项目的客户在购买云资源时,仍然从客户的华为云账户扣钱,同时扣减企业项目的资金配额。
  • 设置资金配额限制 进入项目管理的“企业项目管理”页面,单击企业项目操作列的“查看消费 ”。 进入“费用账单”页面。 单击左侧的“配额管理”,进入“企业项目资金配额设置”页面。 缺省(default)企业项目的资金配额不可设置。 如果资金配额限制开关是关闭状态,请先开启资金配额限制开关;如果资金配额限制开关已经开启,直接执行5。 关闭资金配额限制开关后,该项目消费将不受配额限制。 在“配额余额设置”页面勾选当配额余额不足时的处理策略,设置配额余额。 配额余额不足是指当您的包年/包月资源或者按需资源开通时所需的费用高于您的配额余额,配额余额不足时的处理策略主要包括以下两种: 允许按需资源新开通和包周期资源新购:当企业项目配额余额不足时,允许按需资源新开通和包年/包月资源新购。 禁止按需资源新开通,禁止包周期资源新购:当企业项目配额余额不足时,限制按需资源新开通和包年/包月资源新购。由于按需资源为后扣费模式,会延迟一天扣除配额。因此在消费配额抵扣为负数的前一天,仍允许按需资源新开通。 单击“确定”。 系统提示提交设置操作成功信息。 图1 资金配额设置 单击“当前配额余额”后的“调整”即可修改当前的配额余额。 单击“配额调整记录”后的“查看”即可查看配额调整的历史记录。
  • 导出组织和账号的消费明细 进入“消费明细”页面。 选择需要查看消费明细的页签。 包年/包月:根据资源维度展示包年/包月账单信息,同一个资源在一个月中只展示一条数据。 按需:根据资源维度展示按需账单信息,同一个资源在一个月中只展示一条数据。 预留实例:购买了预留实例的用户,可以查看预留实例的消费信息。 选择待导出的账号或组织。 单击“导出”。 设置查询条件,筛选出需要导出的消费明细。 单击“确定”。 即可导出根据查询条件筛选出的消费明细。 系统跳转到“导出记录”页面,客户可以在“导出记录”页面下载导出的消费明细。
  • 什么是“同一法人”? “同一法人”关联类型是指企业主账号和子账号同属于一个企业法人。“同一法人”关联类型,要求主账号和子账号必须都是企业客户,并且都已通过实名认证,实名认证名称相同或者统一社会信用代码相同。 总分公司场景,如: 子账号企业名称 = 主账号企业名称 + “*”+ “分公司”,企业主子账号属于同一法人。变更公司名称,企业名称变化,统一社会信用代码不变,仍属于同一法人。 父主题: 财务独立
  • 新注册的华为账号登录华为云每次都要输入验证码,怎么取消? 基于华为账号的安全考虑,不建议您取消验证码功能。若您想要取消,可以在下一次使用华为账号登录华为云时,获取验证码登录后,单击“信任”按钮,后续您在该浏览器登录华为云时,系统将不会要求输入验证码进行验证。 如您的华为账号在华为账号中心开启了“双重验证”功能,即使是信任浏览器,登录账号依然需要输入验证码进行验证。 “信任”环境会根据您的实际使用情况及使用时间发生变化,具体依赖您实际登录情况为准。 父主题: 登录
  • 账号中的手机号码不可用(手机丢失、注销了手机号码等无法收取验证码),怎么更换? 如果手机号不可用,请提交工单处理或拨打客服电话4000-955-988反馈。 按照华为云售后支持回复提供所需材料用于身份核验。材料审核通过后,华为云售后支持会尽快为您更换手机号。 通常,您需提供以下信息和材料: 账号名称 姓名及身份证号码(用于进行人脸活体检测或银行卡身份验证) 变更后的手机号 您的联系方式:手机号(可以同变更后的手机号或填其他手机号)、邮件地址(选填) 对于企业实名认证账号,不仅需要提供以上信息和材料,还需要增加提供企业全称、企业证件号码、法定代表人姓名、对应企业证件: 当您为法定代表人身份时,请提供加盖单位公章的申请函(下载模板),法定代表人签字按手印。 当您为被授权人身份时,请提供加盖单位公章的授权书(下载模板),被授权人和法定代表人签字按手印。 如果情况特殊,包括但不限于下列情形,请按照华为云售后支持回复意见提供补充材料,以便我们进一步核实。 您为外籍人士,请提供相应国家/地区的身份证件(港澳台居民居住证、港澳台来往内地通行证、海外护照等)。 实名认证企业账号负责人离职的,历史上有消费/结算时,请提供现有与华为云的交易凭证(包括:华为云出具的账单、开具的发票、企业向华为云支付/汇款凭证等),此外还需提供实名认证企业账号负责人的离职证明。 实名认证企业被注销、吊销、解散、收购的,请提供登记管理机关(如:市场监督管理局)的证明,云账号资产处置证明(全部自然人股东签字并按手印 ;涉及法人实体股东的,由法人实体股东盖公章和对应法定代表人签字并按手印),拟承接该账号管理权的企业全称、企业证件号码、法定代表人姓名和对应企业证件(具体以华为云工作人员回复为准)。 其他情况,请与华为云工作人员充分沟通,以华为云工作人员回复为准。 父主题: 登录
  • 各类账号、手机号、电子邮件地址功能说明和设置指引 信息 用途 设置入口 约束 账号名 登录、找回密码 华为账号中心 华为账号的账号名。 只能修改一次。 租户名 华为云交易、IAM用户登录、华为云API调用等 华为云账号中心 租户名为客户在华为云业务中的账号名。 当租户名和华为账号的账号名不同时,华为云账号中心会展示租户名,相同时不会展示。 登录手机号/登录电子邮件地址 登录、安全验证 华为账号中心 一个手机号/电子邮件地址唯一绑定一个华为账号。 管理手机号 检索多账号名,选择登录 华为账号中心 如果某个手机号已经注册了一个华为账号,您使用该手机号注册的第二个或第三个华为账号登录华为云时,在华为云账号中心“华为账号信息”区域会出现“管理手机号”。 安全手机号/安全邮件地址 安全验证 华为账号中心 可绑定多个华为账号。 业务手机号/业务邮件地址 接收华为云资讯、活动消息以及业务相关验证码 华为云账号中心 仅在华为云账号手机号与华为账号手机号不一致时显示的华为云账号手机号。 一个手机号最多被三个华为云账号绑定为业务手机号。 仅在华为云账号邮件地址与华为账号邮件地址不一致时显示的华为云账号邮件地址。 一个邮件地址最多被三个华为云账号绑定为业务邮件地址。 接收人中的手机号和邮件地址 接收华为 云消息 通知 华为云消息中心 可绑定多个接收人。 父主题: 基本概念
  • 方案架构 图1 方案架构图 部署该解决方案会使用到如下资源: API网关:API托管服务, 通过APIG,对外提供 人证核身 人脸识别 的组合API能力。 函数工作流 :用于实现人证核身和人脸识别的组合业务逻辑,并通过APIG对外提供服务。 人脸识别服务 :提供动作活体检测功能,判断当前用户是否为真人。 人证核身服务:将活体检测截取的人脸照片与上传的身份证证件信息关联起来,对身份真实性的核验。 对象存储服务 :用于存放人证核身过程所需要的人像动作视频。
  • 安装SDK 使用SDK前,需要安装“HuaweiCloud.SDK.Core”和“HuaweiCloud.SDK.Ivs”,有两种安装方式,分别如下。 使用 .NET CLI 工具 dotnet add package HuaweiCloud.SDK.Core dotnet add package HuaweiCloud.SDK.Ivs 使用 Package Manager Install-Package HuaweiCloud.SDK.Core Install-Package HuaweiCloud.SDK.Ivs
  • 开始使用SDK 导入依赖模块 import com.huaweicloud.sdk.core.auth.ICredential; // 对用户身份进行认证 import com.huaweicloud.sdk.core.auth.BasicCredentials; // 请求异常类 import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; // 导入ivs sdk import com.huaweicloud.sdk.ivs.v2.region.IvsRegion; import com.huaweicloud.sdk.ivs.v2.*; import com.huaweicloud.sdk.ivs.v2.model.*; 配置认证信息 配置AK、SK信息。华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。 // 创建AK、SK认证凭据 public static ICredential getCredential(String ak, String sk) { return new BasicCredentials() .withAk(ak) .withSk(sk); } 初始化认证信息: String ak = System.getenv("HUAWEICLOUD_SDK_AK"); String sk = System.getenv("HUAWEICLOUD_SDK_SK"); ICredential credential = getCredential(ak, sk); 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 图3 Windows环境新建环境变量 初始化客户端 指定region方式 public static IvsClient getClient(Region region, ICredential auth) { // 初始化客户端 return IvsClient.newBuilder() .withCredential(auth) .withRegion(region) .build(); } 华北-北京四region获取:IvsRegion.CN_NORTH_4 华北-北京一region获取:IvsRegion.CN_NORTH_1 发送请求并查看响应 // 以调用标准版(三要素)DetectStandardByIdCardImage 接口为例 DetectStandardByIdCardImageRequest request = new DetectStandardByIdCardImageRequest(); DetectStandardByIdCardImageResponse response = client.detectStandardByIdCardImage(request); System.out.println(response.toString()); 异常处理 表1 异常处理 一级分类 一级分类说明 二级分类 二级分类说明 ConnectionException 连接类异常 HostUnreachableException 网络不可达、被拒绝。 SslHandShakeException SSL认证异常。 RequestTimeoutException 响应超时异常 CallTimeoutException 单次请求,服务器处理超时未返回。 RetryOutageException 在重试策略消耗完成后,仍无有效的响应。 ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误,Http响应码:[500,]。 ClientRequestException 请求参数不合法,Http响应码:[400, 500) // 捕获和处理不同类型的异常 DetectStandardByIdCardImageRequest request = new DetectStandardByIdCardImageRequest(); try { DetectStandardByIdCardImageResponse response = client.detectStandardByIdCardImage(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); }
  • 安装SDK 推荐使用 Composer 安装 SDK 。 Composer 是 php 的依赖管理工具,允许您在项目中声明依赖关系并安装这些依赖: // 安装 Composer curl -sS https://getcomposer.org/installer | php // 安装 PHP SDK composer require huaweicloud/huaweicloud-sdk-php 安装完毕后,你需要引入 Composer 的自动加载文件: require 'path/to/vendor/autoload.php';
  • 开始使用SDK 导入依赖模块 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcore.exceptions import exceptions # 导入IVS的库 from huaweicloudsdkivs.v2.region.ivs_region import IvsRegion from huaweicloudsdkivs.v2 import * import os 配置认证信息 配置AK、SK信息。华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。 // 创建AK、SK认证凭据 def GetCredential(): return BasicCredentials(ak, sk) 初始化认证信息: ak = os.environ.get("HUAWEICLOUD_SDK_AK") sk = os.environ.get("HUAWEICLOUD_SDK_SK") credentials = GetCredential(ak, sk) 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 图3 Windows环境新建环境变量 初始化客户端 指定region方式 # 选择服务部署区域 def GetClient(): return IvsClient.new_builder(IvsClient) \ .with_credentials(credentials) \ .with_region(IvsRegion.CN_NORTH_4) \ .build() CN_NORTH_4:华北-北京四 CN_NORTH_1:华北-北京一 发送请求并查看响应 # 以调用标准版(三要素)接口 DetectStandardByIdCardImage 为例 request = DetectStandardByIdCardImageRequest() response = client.detect_standard_by_id_card_image(request) print(response) 异常处理 表1 异常处理 一级分类 一级分类说明 二级分类 二级分类说明 ConnectionException 连接类异常 HostUnreachableException 网络不可达、被拒绝。 SslHandShakeException SSL认证异常。 RequestTimeoutException 响应超时异常 CallTimeoutException 单次请求,服务器处理超时未返回。 RetryOutageException 在重试策略消耗完成后,仍无有效的响应。 ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误,Http响应码:[500,]。 ClientRequestException 请求参数不合法,Http响应码:[400, 500) # 异常处理 try: request = DetectStandardByIdCardImageRequest() response = client.detect_standard_by_id_card_image(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)
共100000条