华为云用户手册

  • 卸载应用 登录KooPhone管理控制台,进入KooPhone云手机页面。 单击通用云手机左侧导航栏的“云手机实例管理”。 选择如下任一方式卸载应用。 在实例列表选择一个或多个需要批量应用卸载的云手机实例,在列表左上方“更多”中选择“应用卸载”。 在实例列表选择一个需要应用卸载的云手机实例,在右侧操作列“更多”中选择“应用卸载”。 在弹窗输入应用包名,单击“确定”。 批量应用卸载时,弹窗页面展示可卸载与不可卸载云手机实例列表。 应用卸载仅限于运行中的云手机,任何其他状态的云手机都不允许卸载应用。 页面弹窗提示“应用卸载提交成功”,单击“确定”。 完成应用卸载需要一段时间,单击“应用部署查询”可以查看卸载进度。
  • 上传应用 登录KooPhone管理控制台,进入KooPhone云手机页面。 单击通用云手机左侧导航栏的“应用部署”,选择“应用库管理”。 在应用库管理界面,单击“上传应用”。 图1 应用库管理界面 在上传应用弹窗中,添加应用参数后,单击“确定”。参数说明如表1所示。 图2 上传应用弹窗 表1 应用参数说明 参数 参数说明 应用名称 用户上传应用时填写的应用名称。 输入规则:只能由英文字母、数字、中文字符、短横线(-)、下划线(_)和点(.)组成,且长度为1-20个字符。 应用描述 用户上传应用时填写的应用描述。 输入规则:只能由英文字母、数字、中文字符、短横线(-)、下划线(_)和中英文逗句号组成,且长度为1-100个字符。 上传区域 购买云手机实例的区域,可在下拉列表中手动选择上传区域。 上传应用 展示本地应用程序的名称,必须是APK文件。 单击“添加文件”选择本地文件进行上传,单次仅能上传一个文件。 支持单击按钮删除已临时上传的应用包重新上传。 页面弹窗提示“应用上传成功”,单击“确定”。
  • 更多操作 部门添加成功后,您还可以进行以下操作。 表1 部门管理 操作名称 操作步骤 编辑部门 单击待修改部门所在行“操作”列下的“编辑部门”。 修改部门信息,单击“更新”。 说明: 组织创建成功后,会默认生成一个一级部门,该一级部门不支持编辑。 添加子部门 单击待添加子部门的部门所在行“操作”列下的“添加子部门”。 输入部门名称、设置部门CODE(可选),单击“确认”。 删除部门 单击待删除部门所在行“操作”列下的“删除”。 单击“确认”。 说明: 删除部门前,需先删除该部门下所有子部门,否则无法删除部门。 删除部门后,数据无法恢复,请谨慎操作。
  • 重置密码 仅支持为通过为新创建的组织和部门添加成员加入组织的管理式华为账号重置密码。 在“组织和用户管理”页面,选择组织。页面左上方可选择不同的组织。 单击“成员管理”。 选中目标部门。支持搜索部门名称,可搜索后选中部门名称。 单击待重置密码成员所在行“操作”列的“重置密码”。 在“重置密码”窗口选择“自动生成密码”或“手工输入密码”。如果选择“手工输入密码”,需输入具体密码。密码设置完成后单击“确定”。
  • 创建KooPhone组织 登录KooPhone管理控制台,进入KooPhone云手机页面。 单击通用云手机左侧导航栏的“组织和用户管理”。 单击“创建组织”,输入组织名称,并单击“下一步”。名称由1-60个中文、英文、数字及合法字符组成。 设置组织的 域名 。 输入组织简称,可使用2-30位字母、数字或它们的组合,如example,后缀名为固定的.orgid.top,如图1所示。单击“下一步”。 域名是指网址中“www.”之后的内容,如: www.example.com中的example.com即为域名;或电子邮件地址中“@”符号之后的内容,如username@example.com中的example.com即为域名。 图1 设置组织域名 阅读“管理式华为账号”相关声明,单击“同意”。
  • 下载KooPhone通用云手机APP客户端 管理员创建用户账号并将购买的云手机实例分配给用户后,用户手机会接收到账号创建成功及云手机分配成功的通知短信和邮件。根据短信和邮件中的账号密码信息和链接可完成下载安装和登录。 KooPhone客户端提供两种下载方式。 方式一:用户访问短信邮件中的下载链接,下载并安装客户端APP。 图1 云手机分配成功短信 方式二:用户可以访问云手机服务官网-KooPhone客户端下载页,进入下载页扫码下载安装包。 KooPhone对Android终端运行系统的最低配置要求:Android6.0。 父主题: 下载登录和使用通用云手机客户端
  • 查看并使用桌面悬浮球 桌面悬浮球隐藏了桌面快捷菜单。您可以拖动桌面悬浮球调整位置,或单击桌面悬浮球打开快捷菜单以查看云机当前网络信号,或进行如下操作: 打开“声音保持”,音视频类应用在后台运行时可继续播放声音。 打开“静音”可一键开启云手机静音模式。 打开“画中画”按钮,开启画中画模式,退出云手机APP后,也能进行后台运行,前台小窗展示。 单击“导航按键”可设置云机导航方式。 单击“返回主屏”,可返回云机桌面。 单击“重启云机”可重新启动云手机。 单击“退出云机”可回到云机首页。 图1 云手机悬浮球功能
  • 登录KooPhone通用云手机APP客户端 打开KooPhone通用云手机APP客户端。 首次登录时,您需要同意《隐私政策》、《用户协议》及《第三方SDK采集个人数据清单》才可继续使用云手机。 输入账号、密码并获取验证码验证身份登录。 使用临时密码首次登录需设置新密码,密码不得少于8个字符,密码必须同时包含字母和数字,且不能含有空格。 首次登录会询问您“是否信任此浏览器?”,建议选择信任,当您下次登录时,系统将不再要求提供验证码。
  • 为成员分配通用云手机 当您购买了云手机实例后,需要将云手机绑定用户,才能为用户分配云手机使用。本章节介绍如何通过控制台解绑/绑定用户。 登录KooPhone管理控制台,进入KooPhone云手机页面。 单击通用云手机左侧导航栏的“云手机实例管理”。 在实例列表选择需要绑定/解绑的云手机实例。 解绑用户:在右侧“操作”列中选择“解绑用户”,解除云手机实例与用户的绑定关系。解绑成功,用户手机号码会收到解绑通知短信。 解绑用户会初始化云手机实例,个人数据将被清除且不保存。 绑定用户:在右侧“操作”列中选择“绑定用户”。 在绑定用户页选择组织和用户,并单击“确定”。绑定用户页支持搜索功能,可输入用户名、账号搜索用户。 确认绑定用户信息,单击“确定”。 图1 绑定用户 父主题: 分配并管理通用云手机实例
  • 退订云手机实例 登录KooPhone管理控制台,进入云手机页面。 单击左侧导航栏的“云手机实例管理”。 选择如下任一方式退订云手机实例。 在实例列表选择一个或多个需要退订的云手机实例,在列表左上方“更多”中选择“退订”。 在实例列表选择一个需要退订的云手机实例,在右侧操作列“更多”中选择“退订”。 在页面弹窗单击“确认”。 系统将跳转至退订资源页,如图1所示。 您可以再次确认需要退订的云手机实例。 图1 退订资源 选择退订原因并勾选“我已确认本次退订金额和相关费用”和“资源退订后,未放入回收站的资源将立即删除且无法恢复,我已确认数据完成备份或不再使用”。 单击右下角“确认”按钮。 在弹窗页查看退订并删除资源的信息,单击“确定”。
  • 续费云手机实例 登录KooPhone管理控制台,进入KooPhone云手机页面。 单击通用云手机左侧导航栏的“云手机实例管理”。 选择如下任一方式续费云手机实例。 在实例列表选择一个或多个需要续费的云手机实例,在列表左上方“更多”中选择“续费”。 在实例列表选择一个需要续费的云手机实例,在右侧操作列“更多”中选择“续费”。 在页面弹窗单击“确认”。 系统将跳转至续费页,如图1所示。 您可以再次确认需要续费的云手机实例,并拖动滑块调节“续费时长”。 “统一到期日”勾选后,您续费的所有实例会统一至您设置的每月X日,默认选择每月1日,您可单击编辑按钮自定义日期。 图1 续费页 图2 设置统一到期日 设置完成后单击“去支付”,按页面提示完成支付。
  • 查看通用云手机实例详细信息 在云手机实例管理页面,实例列表区域可以查看到实例详细信息。单击实例列表右上方设置按钮,可自定义实例列表展示参数,必选与可选项详见表1。 表1 参数说明 参数 是否必选 参数说明 云手机名称/ID 是 云手机名称:购买云手机时自定义的云手机名称。 云手机ID:系统会给云手机实例分配一个实例ID,用于标记该实例。 区域 是 云手机的物理数据中心所在的位置,区域不同即物理数据中心距离用户的物理距离不同,网络延迟不同。 说明: 云手机购买成功后不能更换区域。 规格信息 是 云手机的规格信息,包含vCPU、内存等。 运行状态 是 包含已停止、运行中、下线中、启动中、已关机。 登录状态 否 包含已登录、未登录。已登录指云机正在串流,未登录指云机无串流。 分配状态 否 包含已分配、未分配。 用户名 否 管理员为成员配置的用户姓名。 账号名 否 管理员为成员设置的账号名。 计费模式 是 显示包年/包月、按需计费,以及剩余到期时间或状态信息。 正常状态:显示距离到期时间的倒计时(包年/包月);云手机实例创建时间(按需计费)。 到期冻结状态:显示已冻结以及距离删除时间的倒计时。 公安冻结状态:显示已冻结(违规)。 违规冻结状态:显示已冻结(违规)以及距离删除时间的倒计时。 您可以选择一台或多台云手机实例进行重启、开机、关机、续费、退订、应用卸载、删除。关于应用卸载的详细请参见应用卸载。 云手机ID,单击可切换为:云手机名称、区域、规格信息、用户名等参数。在搜索栏输入对应参数可进行筛选,或者单击运行状态旁的筛选按钮进行筛选。 单击右侧搜索按钮,可筛选出对应过滤条件的实例信息。 单击右上角的,可刷新到所有实例的最新信息。 父主题: 分配并管理通用云手机实例
  • 接口约束 您必须是桶拥有者或拥有取消分段上传任务的权限,才能取消分段上传任务。建议使用 IAM 或桶策略进行授权,如果使用IAM则需授予obs:object:AbortMultipartUpload权限,如果使用桶策略则需授予AbortMultipartUpload权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 input 表2 是 参数解释: 取消分段上传任务接口入参,详见表2。 表2 请求参数列表 参数名称 参数类型 是否必选 描述 Bucket string 必选 参数解释: 桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 取值范围: 长度为3~63个字符。 默认取值: 无 Key string 必选 参数解释: 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 约束限制: 无 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 UploadId string 必选 参数解释: 分段上传任务的ID。任务ID可以通过初始化分段上传任务生成。 约束限制: 无 取值范围: 长度为32的字符串,例如:000001648453845DBB78F2340DD460D8。 默认取值: 无
  • 返回结果 表3 返回结果 参数类型 描述 表4 说明: 该接口返回是一个Promise类型,需要使用Promise、async/await语法处理。 参数解释: 接口返回信息,详见表4。 表4 Response 参数名称 参数类型 描述 CommonMsg ICommonMsg 参数解释: 接口调用完成后的公共信息,包含HTTP状态码,操作失败的错误码等,详见ICommonMsg。 InterfaceResult 表6 参数解释: 操作成功后的结果数据,详见表6。 约束限制: 当Status大于300时为空。 表5 ICommonMsg 参数名称 参数类型 描述 Status number 参数解释: OBS服务端返回的HTTP状态码。 取值范围: 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 Code string 参数解释: OBS服务端返回的错误码。 Message string 参数解释: OBS服务端返回的错误描述。 HostId string 参数解释: OBS服务端返回的请求服务端ID。 RequestId string 参数解释: OBS服务端返回的请求ID。 Id2 string 参数解释: OBS服务端返回的请求ID2。 Indicator string 参数解释: OBS服务端返回的详细错误码。 表6 BaseResponseOutput 参数名称 参数类型 描述 RequestId string 参数解释: OBS服务端返回的请求ID。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 Bucket string 必选 参数解释: 桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 取值范围: 长度为3~63个字符。 默认取值: 无 Prefix string 可选 参数解释: 限定返回的分段上传任务中的对象名必须带有prefix前缀。 例如,假设您拥有以下对象:logs/day1、logs/day2、logs/day3和ExampleObject.jpg。如果您将logs/指定为前缀,将返回以字符串“logs/”开头的三个对象所在的分段上传任务。如果您指定空的前缀且请求中没有其他过滤条件,将返回桶中的所有分段上传任务。 约束限制: 长度大于0且不超过1024的字符串。 取值范围: 无 默认取值: 无 MaxUploads number 可选 参数解释: 列举分段上传任务的最大数目。 约束限制: 当该参数超出1000时,按照默认的1000进行处理。 取值范围: 1~1000,单位:个。 默认取值: 1000 Delimiter string 可选 参数解释: 对分段上传任务中的对象名进行分组的字符。通常与前缀prefix搭配使用,如果指定了prefix,从prefix到第一次出现delimiter间具有相同字符串的对象名会被分成一组,形成一条CommonPrefixes;如果没有指定prefix,从对象名的首字符到第一次出现delimiter间具有相同字符串的对象名会被分成一组,形成一条CommonPrefixes。 例如,桶中有3个对象,分别为abcd、abcde、bbcde。如果指定delimiter为d,prefix为a,abcd、abcde会被分成一组,形成一条前缀为abcd的CommonPrefixes;如果只指定delimiter为d,abcd、abcde会被分成一组,形成一条前缀为abcd的CommonPrefixes,而bbcde会被单独分成一组,形成一条前缀为bbcd的CommonPrefixes。 约束限制: 无 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 KeyMarker string 可选 参数解释: 列举分段上传任务的起始位置。表示列举时返回指定的KeyMarker之后的分段上传任务。 约束限制: 无 取值范围: 上次请求返回体的NextKeyMarker值。 默认取值: 无 UploadIdMarker string 可选 参数解释: 列举分段上传任务的起始位置(uploadId标识)。 约束限制: 只有与KeyMarker参数一起使用时才有意义,即列举时返回指定KeyMarker的UploadIdMarker之后的分段上传任务。 取值范围: 对象的分段上传任务ID,即上次请求返回体的NextUploadIdMarker值。 默认取值: 无 EncodingType string 可选 参数解释: 用于指定对响应中的Key进行指定类型的编码。如果Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Key进行编码。 约束限制: 无 取值范围: 可选值为url。 默认取值: 无,不设置则不编码。
  • 接口约束 您必须是桶拥有者或拥有列举分段上传任务的权限,才能列举分段上传任务。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:ListBucketMultipartUploads权限,如果使用桶策略则需授予ListBucketMultipartUploads权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。
  • 功能说明 列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。 通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果指定的桶包含的分段上传任务数量大于1000,则返回结果中InterfaceResult.IsTruncated为true表明本次没有返回全部结果,并可通过InterfaceResult.NextKeyMarker和InterfaceResult.NextUploadIdMarker获取下次列举的起点。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 Bucket string 必选 参数解释: 桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 取值范围: 长度为3~63个字符。 默认取值: 无 Key string 必选 参数解释: 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 约束限制: 无 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 UploadId string 必选 参数解释: 分段上传任务的ID。任务ID可以通过初始化分段上传任务生成。 约束限制: 无 取值范围: 长度为32的字符串,例如:000001648453845DBB78F2340DD460D8。 默认取值: 无 PartNumberMarker number 可选 参数解释: 列举已上传段的起始位置。 约束限制: 无 约束限制: 只有PartNumber数目大于该参数的Part会被列出 默认取值: 无 MaxParts number 可选 参数解释: 列举已上传段的返回结果最大段数目,即分页时每一页中段数目。 约束限制: 如果该参数超出1000时,则按照默认的1000进行处理。 取值范围: 范围是[1,1000] 默认取值: 1000 EncodingType string 可选 参数解释: 用于指定对响应中的Key进行指定类型的编码。如果Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Key进行编码。 约束限制: 无 取值范围: 可选值为url。 默认取值: 无,不设置则不编码。
  • 功能说明 通过分段上传任务的ID,列举指定桶中已上传的段。 您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信息,最多为1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索所有段。请注意,返回的分段列表不包括已合并的分段。
  • 接口约束 您必须是桶拥有者或拥有列举已上传的段的权限,才能列举已上传的段。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:ListMultipartUploadParts权限,如果使用桶策略则需授予ListMultipartUploadParts权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。 列举段至多返回1000个段信息,如果指定的Upload ID包含的段数量大于1000,则返回结果中InterfaceResult.IsTruncated为true表明本次没有返回全部段,并可通过InterfaceResult.NextPartNumberMarker获取下次列举的起始位置。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 Bucket string 必选 参数解释: 桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 取值范围: 长度为3~63个字符。 默认取值: 无 Key string 必选 参数解释: 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 约束限制: 无 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 PartNumber number 必选 参数解释: 段号。 约束限制: 无 取值范围: 取值范围是[1,10000]的非负整数。 默认取值: 无 UploadId string 必选 参数解释: 分段上传任务的ID。任务ID可以通过初始化分段上传任务生成。 约束限制: 无 取值范围: 长度为32的字符串。 例如:000001648453845DBB78F2340DD460D8。 默认取值: 无 ContentMD5 string 可选 参数解释: 待上传对象数据的MD5值(经过Base64编码),提供给OBS服务端,校验数据完整性。 约束限制: 消息体128-bit MD5值经过base64编码后得到的字符串。 取值范围: 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串。 示例:n58IG6hfM7vqI4K0vnWpog==。 默认取值: 无 Body string | stream.Readable 可选 参数解释: 待上传对象的数据流。 约束限制: 单次上传大小范围是[0, 5GB]。 取值范围: 无 默认取值: 无 SourceFile string 可选 参数解释: 待上传对象的源文件路径。 约束限制: 单次上传大小范围是[0, 5GB]。 Body与SourceFile不能同时使用。 当Body与SourceFile都为空时,上传对象的大小为0字节。 Offset、PartSize和SourceFile配套使用,用于指定上传源文件中的某一分段数据。 取值范围: 无 默认取值: 无 Offset number 可选 参数解释: 源文件中某一分段的起始偏移大小。 约束限制: Offset、PartSize和SourceFile配套使用,用于指定上传源文件中的某一分段数据。 取值范围: 非负整数,小于待上传对象的大小,单位:字节。 默认取值: 0 PartSize number 可选 参数解释: 当前段的长度。 约束限制: Offset、PartSize和SourceFile配套使用,用于指定上传源文件中的某一分段数据。 取值范围: 100KB~5GB,单位:字节。 默认取值: 102400字节 SseKms string 当使用SSE-KMS方式时,必选 参数解释: 表示服务端加密是SSE-KMS方式。对象使用SSE-KMS方式加密。 约束限制: 当前仅支持kms。 取值范围: 可选值:kms,即选择SSE-KMS方式加密对象。 默认取值: 无 SseKmsKey string 可选 参数解释: SSE-KMS加密方式下使用的KMS主密钥的ID值。 约束限制: 有效值支持两种格式: regionID:domainID(账号ID):key/key_id key_id 其中: regionID是使用密钥所属region的ID,可在地区和终端节点页面获取; domainID是使用密钥所属账号的账号ID,获取方法参见如何获取账号ID和用户ID?(Node.js SDK); key_id是从 数据加密 服务创建的密钥ID,获取方法请参见查看密钥。 取值范围: 无 默认取值: 如果用户没有提供该头域,那么默认的主密钥将会被使用。 如果默认主密钥不存在,将默认创建并使用。 SseC string 当使用SSE-C方式时,必选 参数解释: 表示服务端加密是SSE-C方式。对象使用SSE-C加密方式。 约束限制: 仅支持AES256。 取值范围: 可选值:AES256,即选择SSE-C方式加密对象。 默认取值: 无 SseCKey string 当使用SSE-C方式时,必选 参数解释: SSE-C方式下加密使用的密钥,该密钥用于加密对象。 约束限制: 该头域由256bit的密钥经过Base64编码得到,示例:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw= 取值范围: 无 默认取值: 无
  • 返回结果 表2 返回结果 参数类型 描述 表3 说明: 该接口返回是一个Promise类型,需要使用Promise、async/await语法处理。 参数解释: 接口返回信息,详见表3。 表3 Response 参数名称 参数类型 描述 CommonMsg ICommonMsg 参数解释: 接口调用完成后的公共信息,包含HTTP状态码,操作失败的错误码等,详见ICommonMsg。 InterfaceResult 表5 参数解释: 操作成功后的结果数据,详见表5。 约束限制: 当Status大于300时为空。 表4 ICommonMsg 参数名称 参数类型 描述 Status number 参数解释: OBS服务端返回的HTTP状态码。 取值范围: 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 Code string 参数解释: OBS服务端返回的错误码。 Message string 参数解释: OBS服务端返回的错误描述。 HostId string 参数解释: OBS服务端返回的请求服务端ID。 RequestId string 参数解释: OBS服务端返回的请求ID。 Id2 string 参数解释: OBS服务端返回的请求ID2。 Indicator string 参数解释: OBS服务端返回的详细错误码。 表5 UploadPartOutput 参数名称 参数类型 描述 RequestId string 参数解释: OBS服务端返回的请求ID。 ETag string 参数解释: 对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A,下载对象时ETag为B,则说明对象内容发生了变化。ETag只反映变化的内容,而不是其元数据。上传的对象或复制操作创建的对象,都有唯一的ETag。 约束限制: 当对象是服务端加密的对象时,ETag值不是对象的MD5值。
  • 功能说明 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。 上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置。如果您使用之前上传的段的同一段编号上传新段,则之前上传的段将被覆盖。无论您何时上传段,OBS都将在其响应中返回ETag标头。对于每个段上传任务,您必须记录每个段编号和ETag值。您在后续的合并请求中需要添加这些值以完成多段上传。
  • 接口约束 您必须是桶拥有者或拥有合并段的权限,才能合并段。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。 上传段接口要求除最后一段以外,其他段的大小范围是100KB~5GB,最后一段的大小范围是0~5GB。但是上传段接口并不会立即校验上传段的大小(因为不知道是否为最后一块);只有调用合并段接口时才会校验。 上传的段的编号有范围限制,其范围是1~10000。 OBS 3.0的桶支持最小段的大小为100KB,OBS 2.0的桶支持最小段的大小为5MB。请在OBS 3.0的桶上执行分段上传操作。
  • 常见的Content-Type 常见的Content-Type(MIME)列表如下: 表1 常见的Content-Type(MIME)列表 文件扩展名 Content-Type(Mime-Type) 文件扩展名 Content-Type(Mime-Type) .*(二进制流,未知的文件类型) application/octet-stream .tif image/tiff .a11 application/x-a11 .acp audio/x-mei-aac .ai application/postscript .aif audio/aiff .aifc audio/aiff .aiff audio/aiff .anv application/x-anv .apk application/vnd.android.package-archive .asa text/asa .asf video/x-ms-asf .asp text/asp .asx video/x-ms-asf .au audio/basic .avi video/avi .awf application/vnd.adobe.workflow .biz text/xml .bmp application/x-bmp .bot application/x-bot .c4t application/x-c4t .c90 application/x-c90 .cal application/x-cals .cat application/vnd.ms-pki.seccat .cdf application/x-netcdf .cdr application/x-cdr .cel application/x-cel .cer application/x-x509-ca-cert .cg4 application/x-g4 .cgm application/x-cgm .cit application/x-cit .class java/ .cml text/xml .cmp application/x-cmp .cmx application/x-cmx .cot application/x-cot .crl application/pkix-crl .crt application/x-x509-ca-cert .csi application/x-csi .css text/css .csv text/csv .cut application/x-cut .dbf application/x-dbf .dbm application/x-dbm .dbx application/x-dbx .dcd text/xml .dcx application/x-dcx .der application/x-x509-ca-cert .dgn application/x-dgn .dib application/x-dib .dll application/x-msdownload .doc application/msword .docx application/vnd.openxmlformats-officedocument.wordprocessingml.document .dot application/msword .dotx application/vnd.openxmlformats-officedocument.wordprocessingml.template .drw application/x-drw .dtd text/xml .dwf Model/vnd.dwf .dwf application/x-dwf .dwg application/x-dwg .dxb application/x-dxb .dxf application/x-dxf .edn application/vnd.adobe.edn .emf application/x-emf .eml message/rfc822 .ent text/xml .epi application/x-epi .eps application/x-ps .eps application/postscript .etd application/x-ebx .exe application/x-msdownload .fax image/fax .fdf application/vnd.fdf .fif application/fractals .fo text/xml .frm application/x-frm .g4 application/x-g4 .gbr application/x-gbr . application/x- .gif image/gif .gl2 application/x-gl2 .gp4 application/x-gp4 .hgl application/x-hgl .hmr application/x-hmr .hpg application/x-hpgl .hpl application/x-hpl .hqx application/mac-binhex40 .hrf application/x-hrf .hta application/hta .htc text/x-component .htm text/html .html text/html .htt text/webviewhtml .htx text/html .icb application/x-icb .ico image/x-icon .ico application/x-ico .iff application/x-iff .ig4 application/x-g4 .igs application/x-igs .iii application/x-iphone .img application/x-img .ins application/x-internet-signup .ipa application/vnd.iphone .isp application/x-internet-signup .IVF video/x-ivf .java java/* .jfif image/jpeg .jpe image/jpeg .jpe application/x-jpe .jpeg image/jpeg .jpg image/jpeg .jpg application/x-jpg .js application/x-javascript .jsp text/html .la1 audio/x-liquid-file .lar application/x-laplayer-reg .latex application/x-latex .lavs audio/x-liquid-secure .lbm application/x-lbm .lmsff audio/x-la-lms .ls application/x-javascript .ltr application/x-ltr .m1v video/x-mpeg .m2v video/x-mpeg .m3u audio/mpegurl .m4e video/mpeg4 .mac application/x-mac .man application/x-troff-man .math text/xml .mdb application/msaccess .mdb application/x-mdb .mfp application/x-shockwave-flash .mht message/rfc822 .mhtml message/rfc822 .mi application/x-mi .mid audio/mid .midi audio/mid .mil application/x-mil .mml text/xml .mnd audio/x-musicnet-download .mns audio/x-musicnet-stream .mocha application/x-javascript .mov video/quicktime .movie video/x-sgi-movie mp1 audio/mp1 .mp2 audio/mp2 .mp2v video/mpeg .mp3 audio/mp3 .mp4 video/mp4 .mpa video/x-mpg .mpd application/vnd.ms-project .mpe video/x-mpeg .mpeg video/mpg .mpg video/mpg .mpga audio/rn-mpeg .mpp application/vnd.ms-project .mps video/x-mpeg .mpt application/vnd.ms-project .mpv video/mpg .mpv2 video/mpeg .mpw application/vnd.ms-project .mpx application/vnd.ms-project .mtx text/xml .mxp application/x-mmxp .net image/pnetvue .nrf application/x-nrf .nws message/rfc822 .odc text/x-ms-odc .out application/x-out .p10 application/pkcs10 .p12 application/x-pkcs12 .p7b application/x-pkcs7-certificates .p7c application/pkcs7-mime .p7m application/pkcs7-mime .p7r application/x-pkcs7-certreqresp .p7s application/pkcs7-signature .pc5 application/x-pc5 .pci application/x-pci .pcl application/x-pcl .pcx application/x-pcx .pdf application/pdf .pdb chemical/x-pdb .pdx application/vnd.adobe.pdx .pfx application/x-pkcs12 .pgl application/x-pgl .pic application/x-pic .pko application/vnd.ms-pki.pko .pl application/x-perl .plg text/html .pls audio/scpls .plt application/x-plt .png image/png .png application/x-png .pot application/vnd.ms-powerpoint .potx application/vnd.openxmlformats-officedocument.presentationml.template .ppa application/vnd.ms-powerpoint .ppm application/x-ppm .pps application/vnd.ms-powerpoint .ppsx application/vnd.openxmlformats-officedocument.presentationml.slideshow .ppt application/vnd.ms-powerpoint .ppt application/x-ppt . pptx application/vnd.openxmlformats-officedocument.presentationml.presentation .pr application/x-pr .prf application/pics-rules .prn application/x-prn .prt application/x-prt .ps application/x-ps .ps application/postscript .ptn application/x-ptn .pwz application/vnd.ms-powerpoint .r3t text/vnd.rn-realtext3d .ra audio/vnd.rn-realaudio .ram audio/x-pn-realaudio .ras application/x-ras .rat application/rat-file .rdf text/xml .rec application/vnd.rn-recording .red application/x-red .rgb application/x-rgb .rjs application/vnd.rn-realsystem-rjs .rjt application/vnd.rn-realsystem-rjt .rlc application/x-rlc .rle application/x-rle .rm application/vnd.rn-realmedia .rmf application/vnd.adobe.rmf .rmi audio/mid .rmj application/vnd.rn-realsystem-rmj .rmm audio/x-pn-realaudio .rmp application/vnd.rn-rn_music_package .rms application/vnd.rn-realmedia-secure .rmvb application/vnd.rn-realmedia-vbr .rmx application/vnd.rn-realsystem-rmx .rnx application/vnd.rn-realplayer .rp image/vnd.rn-realpix .rpm audio/x-pn-realaudio-plugin .rsml application/vnd.rn-rsml .rt text/vnd.rn-realtext .rtf application/msword .rtf application/x-rtf .rv video/vnd.rn-realvideo .sam application/x-sam .sat application/x-sat .sdp application/sdp .sdw application/x-sdw .sis application/vnd.symbian.install .sisx application/vnd.symbian.install .sit application/x-stuffit .slb application/x-slb .sld application/x-sld .sldx application/vnd.openxmlformats-officedocument.presentationml.slide .slk drawing/x-slk .smi application/smil .smil application/smil .smk application/x-smk .snd audio/basic .sol text/plain .sor text/plain .spc application/x-pkcs7-certificates .spl application/futuresplash .spp text/xml .ssm application/streamingmedia .sst application/vnd.ms-pki.certstore .stl application/vnd.ms-pki.stl .stm text/html .sty application/x-sty .svg image/svg+xml .swf application/x-shockwave-flash .tdf application/x-tdf .tg4 application/x-tg4 .tga application/x-tga .tif image/tiff .tif application/x-tif .tiff image/tiff .tld text/xml .top drawing/x-top .torrent application/x-bittorrent .tsd text/xml .txt text/plain .uin application/x-icq .uls text/iuls .vcf text/x-vcard .vda application/x-vda .vdx application/vnd.visio .vml text/xml .vpg application/x-vpeg005 .vsd application/vnd.visio .vsd application/x-vsd .vss application/vnd.visio .vst application/vnd.visio .vst application/x-vst .vsw application/vnd.visio .vsx application/vnd.visio .vtx application/vnd.visio .vxml text/xml .wav audio/wav .wax audio/x-ms-wax .wb1 application/x-wb1 .wb2 application/x-wb2 .wb3 application/x-wb3 .wbmp image/vnd.wap.wbmp .wiz application/msword .wk3 application/x-wk3 .wk4 application/x-wk4 .wkq application/x-wkq .wks application/x-wks .wm video/x-ms-wm .wma audio/x-ms-wma .wmd application/x-ms-wmd .wmf application/x-wmf .wml text/vnd.wap.wml .wmv video/x-ms-wmv .wmx video/x-ms-wmx .wmz application/x-ms-wmz .wp6 application/x-wp6 .wpd application/x-wpd .wpg application/x-wpg .wpl application/vnd.ms-wpl .wq1 application/x-wq1 .wr1 application/x-wr1 .wri application/x-wri .wrk application/x-wrk .ws application/x-ws .ws2 application/x-ws .wsc text/scriptlet .wsdl text/xml .wvx video/x-ms-wvx .xap application/x-silverlight-app .x_b application/x-x_b .xdp application/vnd.adobe.xdp .xdr text/xml .xfd application/vnd.adobe.xfd .xfdf application/vnd.adobe.xfdf .xhtml text/html .xls application/vnd.ms-excel .xls application/x-xls .xlsx application/vnd.openxmlformats-officedocument.spreadsheetml.sheet .xltx application/vnd.openxmlformats-officedocument.spreadsheetml.template .xlw application/x-xlw .xml text/xml .xpl audio/scpls .xq text/xml .xql text/xml .xquery text/xml .xsd text/xml .xsl text/xml .xslt text/xml .xwd application/x-xwd .x_t application/x-x_t .yaml text/vnd.yaml .yml text/vnd.yml .webp image/webp .tar application/x-tar .zip application/zip
  • 获取账号、IAM用户、项目的名称和ID 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID 在华为云首页右上角,单击“控制台”。 在右上角的用户名中选择“我的凭证”。 图1 进入我的凭证 在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。 每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。 图2 查看账号名、账号ID、用户名、用户ID、项目名称、项目ID 调用API获取用户ID、项目ID 获取用户ID请参考:管理员查询IAM用户列表。 获取项目ID请参考:查询指定条件下的项目列表。
  • 日志配置 OBS Node.js SDK基于log4js开源库提供了日志功能,您可以通过ObsClient.initLog开启日志功能并进行配置。代码示例如下: obsClient.initLog({ name: 'test', // 日志名称 file_full_path:'./logs/OBS-SDK.log', // 配置日志文件路径 max_log_size:20480, // 配置日志文件大小,单位:字节 backups:10, // 配置最大可保留的日志文件个数 level:'warn', // 配置日志级别 log_to_console:true // 配置是否将日志打印到console }); 日志功能默认是关闭的,需要主动开启。 使用file_full_path参数配置日志文件路径,可配置相对路径或绝对路径。
  • 日志内容格式 SDK日志格式为:日志时间|日志级别|调用接口|日志内容。示例如下: 2017/10/12 10:21:05 666|INFO |ListBuckets|enter ListBuckets... 2017/10/12 10:21:05 672|INFO |ListBuckets|prepare request parameters ok,then Send request to service start 2017/10/12 10:21:05 715|INFO |ListBuckets|2017-10-12 10:21:05|http cost 34 ms|0| 2017/10/12 10:21:05 716|INFO |ListBuckets|get response start, statusCode:200
  • 日志级别 当系统出现问题需要定位且当前的日志无法满足要求时,可以通过修改日志的级别来获取更多的信息。其中debug日志信息最丰富,error日志信息最少。 具体说明如下: debug:调试级别,如果设置为这个级别,将打印SDK记录的所有日志。 info:信息级别,如果设置为这个级别,除了打印warn级别的信息外,还将打印HTTP/HTTPS请求的耗时时间等信息。 warn:告警级别,如果设置为这个级别,除了打印error级别的信息外,还将打印一些关键事件的信息。 error:错误级别,如果设置为这个级别,仅打印发生异常时的错误信息。
共100000条