华为云用户手册

  • 企业用户 主体信息 主体负责人必须是法定代表人。 负责人未满16周岁不得备案。 《医疗机构执业许可证》不能作为主办单位有效证件备案,医疗机构只能用营业执照或者事业单位法定代表人证书备案。 外省须上传居住证+(有效期大于两个月)。 主体负责人必须是法人,网站负责人不是法人不需要上传授权书。如法人是外国人时,可以上传授权书,法人授权书可以盖法人签名章。 政府机关备案,域名后缀必须是gov.cn。 营业执照是复印件加盖公司公章也可以。 主体负责人身份证件可以是中国香港居民,只要有港澳通行证就可以,如果没有港澳通行证,可以用回乡证。事业单位目前暂时是能使用法人证件黑白件需要加盖公章。 网站负责人为中国香港居民不能用护照,只能提供港澳通行证,核验单日期60天有效期。 主体负责人手机号码不得与应急号码重复,暂无归属地要求。 网站信息 网站名称:使用符合中文命名习惯的纯中文或者中英文进行命名,能反映网站基本内容或基本物证,不侵权、不违反九不准信息、不超过须特许范围的特有字眼范围的即可。跟自己的网站身份、资质相匹配。 个人不同前缀域名超过5个(含5个)、单位不同前缀域名超过31个时(不含31个),需提供每个域名的域名证书、网站建设方案书原件(可自行撰写,无格式要求)、主办单位有效证件复印件、接入商与网站主办者签订的接入合同复印件等材料至管局。 广东宗教备案:根据《宗教事务条例》第四十七条规定,应当经省宗教民族委员会审核同意后,并向我局提交该批准文件(与主办单位证件一并上传)。 一个网站只能填写一个首页url。 广东省《互联网备案承诺书》需要法人手写签字,盖公司公章,填写日期。 同一家公司备案多个网站,网站名称可以完全相同;网站名称需要用公司名称或者简称。 域名所有者可以是企业法人,对所有者名称是公司名称的中英文没有要求,域名证书不用上传。 未备案网站禁止访问;已备案网站必须正常访问,需要在主页底部的中央位置标明备案号,并在备案编号下方按照要求链接工信部备案管理系统网址,供公众查询核对。备案号必须要有;备案号标号规范:“粤ICP备xxxxxx号”,链接到http://beian.miit.gov.cn。注意:备案号不要带-1、-2这些网站序号,也不要少了“省ICP备”“号”这些字符。 网站负责人非主体负责人的情况下,手机号码不得与主体负责人手机号码重复,应急号码也不得与主体负责人的所有联系方式重复,无归属地要求。 电子材料 有效证件原件电子版。 证件加水印只能限制用于备案用途。 中国香港居民作为负责人证件必须提供《港澳通行证》。 《互联网信息服务备案承诺书》。 涉及前置审批相关行业,必须办理前置审批文件,详情请参见前置审批。 变更备案 证件有变更允许先接入后变更。 允许个人企业间自由变更,网站内容与变更后的主体一致即可。 可以更换主体、支持网站迁移。 新增接入 新增接入:接入的网站可以不开放,如已经开放,需要按照要求开放;没有接入的网站必须按照要求正常开放;底部需悬挂备案号。 不同备案号下的域名可以指向同一网站内容。 企业可以备案论坛的网站,正常备案即可。 注:现接入信息与原备案信息不一致时,可以直接变更备案信息,接入备案成功后信息将发生变更,原接入商信息也会同时进行变更。
  • 个人用户 主体信息 个人未满18周岁不予以备案。 外省身份证需提供有效的广东省居住证和权威网站有效期限查询结果页面。 个人备案,是港澳居民的,必须提供港澳居民居住证备案,不能提供港澳来往大陆通行证"。 个人备案未满十八岁只要出示工作证明盖上公章,跟身份证一起上传就可以进行备案。 联系电话不能与手机号码相同。 主体负责人手机号码不得与应急号码重复,暂无归属地要求。 网站信息 使用符合中文命名习惯的纯中文或者中英文进行命名,能反映网站基本内容或基本物证,不侵权、不违反九不准信息、不超过须特许范围的特有字眼范围的即可。跟自己的网站身份、资质相匹配。 个人备案前缀不相同的域名数超5个时须提供每个域名的域名注册证书和网站建设方案书,连同主办单位有效证件复印件、接入商与网站主办者签订的接入合同复印件提供我局核验。 已备案成功的域名必须能够访问,并在网站首页底部中间位置放置备案号,且链接至工信部网站。 一个网站只能填写一个首页url;个人必须备注清楚网站内容。 个人博客/论坛/空间,不得涉及交易、广告,视频需原创拍摄,如果转载的,只能提供链接,不能直接在个人博客/论坛/空间播放。 除所需提供材料外,需额外提供《备案承诺书》。 电子材料 有效证件原件电子版。 变更备案 个人性质可以变更为其他个人或单位备案。 新增接入 接入备案信息符合当前管局规则即可。 新增接入:接入的网站可以不开放,如已经开放,需要按照要求开放;没有接入的网站必须按照要求正常开放;底部需悬挂备案号。 个人备案名称不能涉及乡村,拼音,地区等信息。 注:现接入信息与原备案信息不一致时,可以直接变更备案信息,接入备案成功后信息将发生变更,原接入商信息也会同时进行变更。
  • 个人用户 主体信息 证件地址非本省需要上传居住证明。 不同主体,手机号码不能重复提交;手机号码与应急号码不得重复,归属地要求吉林省内。 网站信息 域名所有人需与主办人名称一致。 网站服务内容,只可选其他,不能选博客/个人空间。 电子材料 有效证件原件电子版。 变更备案 个人性质备案不可以变更为其他个人或单位性质备案,当已备案的个人是单位法人时,可以个人变单位。 证件住所、通信地址符合当前管局规则即可。
  • 企业用户 主体信息 不同主体,手机号码不能重复提交。 主体负责人可以不是法人。 主体负责人不是法人时需要上传法人授权书; 主体负责人是法人,网站负责人不是法人时不用上传网站负责人授权书。 吉林政府机构网站需要提供《政府网站域名业务审核表》原件扫描件或复印件。 法定代表人为外籍人士或中国香港、中国澳门、中国台湾居民时,需授权给中国内地身份证的人员进行备案,且需提供主体负责人授权书。 主体负责人手机号码不得与应急号码重复,暂无归属地要求。 网站信息 域名所有人必须和主办单位名称或者法定代表人一致。 网站负责人非主体负责人的情况下,手机号码不得与主体负责人手机号码重复,应急号码也不得与主体负责人的所有联系方式重复,无归属地要求。 电子材料 有效证件原件电子版。 涉及前置审批相关行业,必须办理前置审批文件,详情请参见前置审批。 变更备案 企业变更为企业有工商出具的证明可以,其他情况不允许。 法人可以变更为企业,非法人不允许。
  • 个人用户 主体信息 个人备案需填写两个联系方式,归属地必须是同省的。 个人备案对于是否是本省的身份证没有要求。 网站信息 个人支持跨省提交备案。网站服务内容选其他。 已备案成功的网站没有要求必须开放,如开放网站内容不能超出范围。 个人备案对备案IP地址无要求。 电子材料 有效证件原件电子版。 变更备案 个人性质备案不可以变更为其他个人或单位性质备案,当已备案的个人是单位法人时,可以个人变单位。 证件住所、通信地址符合当前管局规则即可。 辽宁空壳可以新增网站。
  • 企业用户 主体信息 手机号码必须本地号码。 单位名称若包含投资管理、担保、典当、贷款、理财,则主体负责人和网站负责人必须为法定代表人。 主体负责人不是法定代表人时需提供主体负责人授权书,金融行业必须是法人。 负责人不一致时;手机号码不能与应急号码互换位置,应急号码填写第三人。 联系电话无归属地要求。 如果法人是中国香港人,必须提供护照,护照要是原件拍照或者原件彩色扫描件,不可以是彩色复印件。 主体负责人手机号码不得与应急号码重复,暂无归属地要求。 网站信息 域名所有人必须和主办单位名称或者法定代表人一致。 未备案成功的网站必须关闭状态。 企业备案,域名所有者只能是公司或者法人的名称,其他都不可以。 证件号码有变化时需要先变更再接入,主体或网站负责人有变化,可以先接入再变更。 辽宁已备案网站如打开需要跟备案主体性质保持一致,个人不可以涉及企业。 主体负责人是法人,网站负责人可以不是法人,无授权书要求。 网站负责人非主体负责人的情况下,手机号码不得与主体负责人手机号码重复,应急号码也不得与主体负责人的所有联系方式重复,无归属地要求。 电子材料 有效证件原件电子版。 涉及前置审批相关行业,必须办理前置审批文件,详情请参见前置审批。 变更备案 个人变企业:个人如果是法人可以变更为企业。 企业变企业:企业不能直接变企业,除非有变更函。 辽宁空壳可以新增网站。
  • CAE权限 默认情况下,管理员创建的IAM用户没有任何权限,需要将其加入用户组,并给用户组授予策略或角色,才能使得用户组中的用户获得对应的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限对云服务进行操作。 CAE部署时通过物理区域划分,为项目级服务。授权时,“授权范围”需要选择“指定区域项目资源”,然后在指定区域(如华东-上海一)对应的项目(cn-east-3)中设置相关权限,并且该权限仅对此项目生效;如果“授权范围”选择“所有资源”,则该权限在所有区域项目中都生效。访问CAE时,需要先切换至授权区域。 权限根据授权精细程度分为角色和策略。 角色:IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度,提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系,因此给用户授予角色时,可能需要一并授予依赖的其他角色,才能正确完成业务。角色并不能满足用户对精细化授权的要求,无法完全达到企业对权限最小化的安全管控要求。 策略:IAM最新提供的一种细粒度授权的能力,可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式,能够满足企业对权限最小化的安全管控要求。 如表1所示, 包括了CAE的所有系统权限。 表1 CAE系统权限说明 系统角色/策略名称 描述 类别 依赖系统权限 CAE依赖服务应用场景 CAE FullAccess 云应用引擎所有权限。 系统策略 需要配合以下权限共同使用: OBS Administrator AOM FullAccess SWR Admin BSS Finance VPC ReadOnlyAccess ServiceStage ReadOnlyAccess ELB FullAccess 拥有操作CAE的所有权限。 CAE ReadOnlyAccess 云应用引擎只读权限。 系统策略 需要配合以下权限共同使用 ServiceStage ReadOnlyAccess LTS ReadOnlyAccess obs:bucket:GetBucketLocation obs:bucket:GetBucketStorage obs:bucket:GetBucketStoragePolicy 拥有对CAE资源的只读权限。 OBS Administrator 对象存储服务管理员。 系统策略 无 选择OBS的软件包部署组件、云存储授权解绑。 AOM FullAccess 应用运维管理服务所有权限。 系统策略 无 CAE创建环境。 SWR Admin 容器镜像服务管理员,拥有该服务下的所有权限。 系统角色 无 进行组件相关操作,包括组件的创建、部署、升级、回退。 DNS Administrator 云解析服务管理员,拥有该服务下的所有权限。 系统角色 VPC Administrator Tenant Guest 查询和配置公网域名需要该权限,授权该角色后可以删除其依赖的VPC Administrator、Tenant Guest角色,不影响域名配置功能。 BSS Finance 费用中心财务管理员,拥有财务操作相关的所有权限。 系统角色 无 购买套餐包,进行支付时需要该权限。 KMS CMKFullAccess 密钥管理服务(KMS)的加密密钥所有权限。拥有该权限的用户可以完成基于策略授权的所有操作。 系统角色 无 CAE环境变量引用凭据时需要获取您在凭据管理服务凭据信息的访问权限。 CSMS ReadonlyAccess 数据加密服务中凭据管理服务(CSMS)的只读权限。拥有该权限的用户可以完成基于策略授权的所有操作。 系统角色 无 CAE凭据配置需要获取您在凭据管理服务凭据信息的访问权限。 如果表1所列的这些权限不满足实际需求, 您可以参考表2在这个基础上自定义策略。 表2 CAE常用操作与系统权限之间的关系 操作 CAE ReadOnlyAccess CAE FullAccess 购买套餐包 x √ 创建环境 x √ 查询所有环境 √ √ 查询环境信息 √ √ 删除环境 x √ 创建应用 x √ 查询应用信息 √ √ 查询所有应用信息 √ √ 更新应用信息 x √ 删除应用 x √ 创建组件 x √ 查询组件信息 √ √ 查询组件配置 √ √ 查询组件事件 √ √ 查询所有组件和实例 √ √ 查看使用量数据 √ √ 修改组件配置 x √ 组件操作:伸缩,升级,回退,停止,启动,重启,编辑 x √ 删除组件 x √ 一键部署Demo x √ 开启证书配置 x √ 查看证书配置 √ √ 修改证书配置 x √ 关闭证书配置 x √ 域名配置 x √ 查看域名 √ √ 取消域名配置 x √ 云储存授权 x √ 解绑云存储 x √ 远程登录 x √ 使用自定义细粒度策略,请使用管理员用户进入统一身份认证(IAM)服务,按需选择云应用引擎的细粒度权限进行授权操作。细粒度权限依赖说明请参见表3。 表3 云应用引擎细粒度权限依赖说明 权限名称 权限描述 依赖权限 应用场景 cae:environment:create 创建环境 vpc:vpcs:get vpc:vpcs:list vpc:vpcs:create vpc:subnets:get vpc:subnets:create vpc:ports:get vpc:ports:create OBS Administrator AOM FullAccess BSS Finance SWR Admin 创建环境 购买套餐包 开启证书配置 修改证书配置 域名配置 云存储授权 cae:environment:list 查询所有环境 obs:bucket:GetBucketLocation obs:bucket:GetBucketStorage obs:bucket:GetBucketStoragePolicy 查询环境 系统设置查看云存储授权 cae:environment:get 查询环境信息 无 查看证书配置 查看域名 cae:environment:delete 删除环境 vpc:ports:delete OBS Administrator 删除环境 关闭证书配置 取消域名配置 解绑云存储 cae:application:create 创建应用 rds:instance:list rds:databaseUser:list rds:database:list cse:engine:get cse:engine:list lts:groups:create lts:topics:create lts:*:list lts:*:get OBS Administrator SWR Admin 创建应用 创建组件 修改组件配置 一键部署Demo cae:application:get 查询应用信息 rds:instance:list rds:databaseUser:list rds:database:list cse:engine:get cse:engine:list 查看应用信息 查看组件信息 查看组件配置 cae:application:list 查询所有应用信息 无 查看所有应用信息 查看使用量数据 查看所有组件和实例 查看组件事件 cae:application:modify 更新应用信息 OBS Administrator SWR Admin 组件操作: 伸缩 升级 回退 停止 启动 重启 编辑 cae:application:delete 删除应用 lts:groups:delete lts:topics:delete OBS Administrator 删除应用 删除组件 删除组件配置 cae:application:createConsole 远程登录 cae:application:delete cae:application:modify cae:application:get 远程登录
  • 步骤1:准备工作 已注册华为账号并开通华为云,进行了实名认证,且在使用ModelArts前检查账号状态,账号不能处于欠费或冻结状态。 注册华为账号并开通华为云 进行实名认证 配置委托访问授权 ModelArts使用过程中涉及到OBS、SWR、IEF等服务交互,首次使用ModelArts需要用户配置委托授权,允许访问这些依赖服务。 使用华为云账号登录ModelArts管理控制台,在左侧导航栏单击“全局配置”,进入“全局配置”页面,单击“添加授权”。 在“访问授权”页面,选择需要授权的“授权对象类型”,选择新增委托及其对应的权限“普通用户”,并勾选“我已经详细阅读并同意《ModelArts服务声明》”,然后单击“创建”。 图1 配置委托访问授权 完成配置后,在ModelArts控制台的全局配置列表,可查看到此账号的委托配置信息。 图2 查看委托配置信息
  • 步骤7:预测结果 在“在线服务”页面,单击在线服务名称,进入服务详情页面。 单击“预测”页签,请求类型选择“multipart/form-data”,请求参数填写“image”,单击“上传”按钮上传示例图片,然后单击“预测”。 预测完成后,预测结果显示区域将展示预测结果,根据预测结果内容,可识别出此图片的数字是“2”。 本案例中使用的MNIST是比较简单的用做demo的数据集,配套算法也是比较简单的用于教学的神经网络算法。这样的数据和算法生成的模型仅适用于教学模式,并不能应对复杂的预测场景。即生成的模型对预测图片有一定范围和要求,预测图片必须和训练集中的图片相似(黑底白字)才可能预测准确。 ModelArts的AI Gallery中提供了常见的精度较高的算法和相应的训练数据集,用户可以在AI Gallery的资产集市中获取。 图17 示例图片 图18 预测结果展示
  • 步骤1:准备工作 已注册华为账号并开通华为云,且在使用 ModelArts 前检查账号状态,账号不能处于欠费或冻结状态。 配置委托访问授权 ModelArts使用过程中涉及到OBS、SWR、IEF等服务交互,首次使用ModelArts需要用户配置委托授权,允许访问这些依赖服务。 使用华为云账号登录ModelArts管理控制台,在左侧导航栏单击“全局配置”,进入“全局配置”页面,单击“添加授权”。 在弹出的“访问授权”窗口中: 授权对象类型:所有用户 委托选择:新增委托 权限配置:普通用户 选择完成后勾选“我已经详细阅读并同意《ModelArts服务声明》”,然后单击“创建”。 图1 配置委托访问授权 完成配置后,在ModelArts控制台的全局配置列表,可查看到此账号的委托配置信息。 图2 查看委托配置信息
  • 步骤2:准备训练数据 本案例使用的数据是MNIST数据集,您可以从MNIST官网下载数据集至本地,以下4个文件均要下载。 图3 MNIST数据集 “train-images-idx3-ubyte.gz”:训练集的压缩包文件,共包含60000个样本。 “train-labels-idx1-ubyte.gz”:训练集标签的压缩包文件,共包含60000个样本的类别标签。 “t10k-images-idx3-ubyte.gz”:验证集的压缩包文件,共包含10000个样本。 “t10k-labels-idx1-ubyte.gz”:验证集标签的压缩包文件,共包含10000个样本的类别标签。 如果单击MNIST官网链接后提示输入登录信息,可在浏览器中直接粘贴此链接免登录:http://yann.lecun.com/exdb/mnist/ 出现登录提示是由于浏览器使用了https的方式打开了该链接,使用http的方式打开则无需登录信息。
  • 步骤4:创建OBS桶并上传文件 将上一步中的数据和代码文件、推理代码文件与推理配置文件,从本地上传到OBS桶中。在 ModelArts 上运行训练作业时,需要从OBS桶中读取数据和代码文件。 登录OBS管理控制台,按照如下示例创建OBS桶和文件夹,创建后如图4所示。创建OBS桶和文件夹的操作指导请参见创建桶和新建文件夹。 {OBS桶} # OBS对象桶,用户可以自定义名称,例如:test-modelarts-xx -{OBS文件夹} # OBS文件夹,自定义名称,此处举例为pytorch - mnist-data # OBS文件夹,用于存放训练数据集,可以自定义名称,此处举例为mnist-data - mnist-code # OBS文件夹,用于存放训练脚本train.py,可以自定义名称,此处举例为mnist-code - infer # OBS文件夹,用于存放推理脚本customize_service.py和配置文件config.json - mnist-output # OBS文件夹,用于存放训练输出模型,可以自定义名称,此处举例为mnist-output 创建的OBS桶所在区域和后续使用ModelArts必须在同一个区域Region,否则会导致训练时找不到OBS桶。具体操作可参见查看OBS桶与ModelArts是否在同一区域。 创建OBS桶时,桶的存储类别请勿选择“归档存储”,归档存储的OBS桶会导致模型训练失败。 图4 OBS文件目录 上传Step1 准备训练数据下载的MNIST数据集压缩包文件到OBS中。上传文件至OBS的操作指导请参见上传对象。 上传数据到OBS中时,请不要加密,否则会导致训练失败。 文件无需解压,直接上传压缩包至OBS中即可。 图5 上传数据集到“mnist-data”文件夹中 上传训练脚本“train.py”到“mnist-code”文件夹中。 图6 上传训练脚本“train.py”到“mnist-code”文件夹中 上传推理脚本“customize_service.py”和推理配置文件“config.json”到“infer”文件中。 图7 上传“customize_service.py”和“config.json”到“infer”文件夹中
  • 步骤5:创建新版自动学习图像分类项目 确保数据集创建完成且可正常使用后,在ModelArts控制台,左侧导航栏选择“自动学习”,进入自动学习总览页面。 图8 创建项目 单击选择“图像分类”创建项目。完成参数填写: 计费模式:按需计费。 名称:自定义您的项目名称。 描述:自定义描述您的项目详情,例如垃圾分类。 数据集:下拉选择已下载的数据集(步骤2中已成功导入的数据集,默认为下拉数据集列表中的第一个数据集)。 输出路径:选择您步骤1创建好的OBS文件夹下的路径,用来存储训练模型等相关文件。 训练规格:根据您的实际需要选择对应的训练规格。根据您选择的资源规格不同,收费标准不同,价格详情请参见价格详情。 图9 创建图像分类 参数填写完成,单击“创建项目”。
  • 步骤6:运行工作流 项目完成创建之后,会自动跳转到新版自动学习的运行总览页面。同时您的工作流会自动从数据标注节点开始运行。您需要做的是: 观察数据标注节点,待数据标注节点变为橘色即为“等待操作”状态。双击数据标注节点,打开数据标注节点的运行详情页面,单击“继续运行”。 在弹出的窗口中,单击“确定”,工作流会开始继续运行。 当工作流运行到“服务部署”节点,状态会变为“等待输入”,您需要填写以下两个输入参数,其他参数保持默认。 计算节点规格:根据您的实际需求选择相应的规格,不同规格的配置费用不同,选择好规格后,配置费用处会显示相应的费用。 是否自动停止:为了避免资源浪费,建议您打开该开关,根据您的需求,选择自动停止时间,也可以自定义自动停止的时间。 图10 用户输入 只有华北-北京四支持限时免费规格,且每个用户只限创建一个基于免费规格的实例。 参数填写完毕之后,单击运行状况右边的“继续运行”,单击确认弹窗中的“确定”即可继续完成工作流的运行。 图11 继续运行
  • 步骤2:创建OBS桶 登录OBS管理控制台,在桶列表页面右上角单击“创建桶”,创建OBS桶。例如,创建名称为“dataset-exeml”的OBS桶。 图1 创建桶 创建桶的区域需要与ModelArts所在的区域一致。例如:当前ModelArts在华北-北京四区域,在对象存储服务创建桶时,请选择华北-北京四。请参考查看OBS桶与ModelArts是否在同一区域检查您的OBS桶区域与ModelArts区域是否一致。 请勿开启桶加密,ModelArts不支持加密的OBS桶,会导致ModelArts读取OBS中的数据失败。 在桶列表页面,单击桶名称,进入该桶的概览页面。 图2 桶列表 单击左侧导航的“对象”,在对象页面单击“新建文件夹”,创建OBS文件夹。具体请参见新建文件夹章节。 图3 新建文件夹
  • 步骤4:配置委托访问授权 ModelArts使用过程中涉及到OBS、SWR、IEF等服务交互,首次使用ModelArts需要用户配置委托授权,允许访问这些依赖服务。 使用华为云账号登录ModelArts管理控制台,在左侧导航栏单击“全局配置”,进入“全局配置”页面,单击“添加授权”。 在弹出的“访问授权”窗口中,参数选择如下: 授权对象类型:所有用户 委托选择:新增委托 权限配置:普通用户 选择完成后勾选“我已经详细阅读并同意《ModelArts服务声明》”,然后单击“创建”。 图6 配置委托访问授权 完成配置后,在ModelArts控制台的全局配置列表,可查看到此账号的委托配置信息。 图7 查看委托配置信息
  • 步骤3:准备训练数据集 单击8类常见生活垃圾图片数据集,进入AI Gallery数据集详情页,单击右侧“下载”。 选择对应的云服务区域例如:华北-北京四,需要确保您选择的区域与您的管理控制台所在的区域一致。 进入“下载详情”页面,填写以下参数。 下载方式:ModelArts数据集。 目标区域:华北-北京四。 数据类型:系统会根据您的数据集,匹配到相应的数据类型。例如本案例使用的数据集,系统匹配为“图片”类型。 数据集输入位置:用来存放源数据集信息,例如本案例中从Gallery下载的数据集。单击图标选择您的OBS桶下的任意一处目录,但不能与输出位置为同一目录。 数据集输出位置:用来存放输出的数据标注的相关信息,或版本发布生成的Manifest文件等。单击图标选择OBS桶下的空目录,且此目录不能与输入位置一致,也不能为输入位置的子目录。 图4 下载详情 完成参数填写,单击“确定”,自动跳转至AI Gallery个人中心“我的下载”页签,单击按钮,查看下载进度,等待5分钟左右下载完成,单击展开下载详情,可以查看该数据集的“目标位置”。 图5 等待下载完成
  • 上传算法至SFS 下载Swin-Transformer代码。 git clone --recursive https://github.com/microsoft/Swin-Transformer.git 修改lr_scheduler.py文件,把第27行:t_mul=1. 注释掉。 修改data文件夹下imagenet22k_dataset.py,把第28行:print("ERROR IMG LOADED: ", path) 注释掉。 修改data文件夹下的build.py文件,把第112行:prefix = 'ILSVRC2011fall_whole',改为prefix = 'ILSVRC2021winner21k_whole'。 在Swin-Transformer目录下创建requirements.txt指定python依赖库: # requirements.txt内容如下 timm==0.4.12 termcolor==1.1.0 yacs==0.1.8 准备run.sh文件中所需要的obs文件路径。 准备imagenet数据集的分享链接 勾选要分享的imagenet21k_whole数据集文件夹,单击分享按钮,选择分享链接有效期,自定义提取码,例如123456,单击“复制链接”,记录该链接。 准备obsutil_linux_amd64.tar.gz的分享链接 单击此处下载obsutil_linux_amd64.tar.gz,将其上传至OBS桶中,设置为公共读。单击属性,单击复制链接。 链接样例如下: https://${bucketname_name}.obs.cn-north-4.myhuaweicloud.com/${folders_name}/pytorch.tar.gz 在Swin-Transformer目录下,创建运行脚本run.sh。 脚本中的"SRC_DATA_PATH=${imagenet数据集在obs中分享链接}",需要替换为上一步中的imagenet21k_whole文件夹分享链接。 脚本中的"https://${bucket_name}.obs.cn-north-4.myhuaweicloud.com/${folder_name}/obsutil_linux_amd64.tar.gz",需要替换为上一步中obsutil_linux_amd64.tar.gz在OBS上的路径(需将文件设置为公共读)。 单机单卡运行脚本: # 在代码主目录下创建一个run.sh,内容如下 #!/bin/bash # 从obs中下载数据到本地SSD盘 DIS_DATA_PATH=/cache SRC_DATA_PATH=${imagenet数据集在obs中分享链接} OBSUTIL_PATH=https://${bucket_name}.obs.cn-north-4.myhuaweicloud.com/${folder_name}/obsutil_linux_amd64.tar.gz mkdir -p $DIS_DATA_PATH && cd $DIS_DATA_PATH && wget $OBSUTIL_PATH && tar -xzvf obsutil_linux_amd64.tar.gz && $DIS_DATA_PATH/obsutil_linux_amd64*/obsutil share-cp $SRC_DATA_PATH $DIS_DATA_PATH/ -ac=123456 -r -f -j 256 && cd - IMAGE_DATA_PATH=$DIS_DATA_PATH/imagenet21k_whole MASTER_PORT="6061" /home/ma-user/anaconda3/envs/pytorch/bin/python -m torch.distributed.launch --nproc_per_node=1 --master_addr localhost --master_port=$MASTER_PORT main.py --data-path $IMAGE_DATA_PATH --cfg ./configs/swin/swin_base_patch4_window7_224_22k.yaml --local_rank 0 多机多卡运行脚本: # 创建run.sh #!/bin/bash # 从obs中下载数据到本地SSD盘 DIS_DATA_PATH=/cache SRC_DATA_PATH=${imagenet数据集在obs中分享链接} OBSUTIL_PATH=https://${bucket_name}.obs.cn-north-4.myhuaweicloud.com/${folder_name}/obsutil_linux_amd64.tar.gz mkdir -p $DIS_DATA_PATH && cd $DIS_DATA_PATH && wget $OBSUTIL_PATH && tar -xzvf obsutil_linux_amd64.tar.gz && $DIS_DATA_PATH/obsutil_linux_amd64*/obsutil share-cp $SRC_DATA_PATH $DIS_DATA_PATH/ -ac=123456 -r -f -j 256 && cd - IMAGE_DATA_PATH=$DIS_DATA_PATH/imagenet21k_whole MASTER_ADDR=$(echo ${VC_WORKER_HOSTS} | cut -d "," -f 1) MASTER_PORT="6060" NNODES="$VC_WORKER_NUM" NODE_RANK="$VC_TASK_INDEX" NGPUS_PER_NODE="$MA_NUM_GPUS" /home/ma-user/anaconda3/envs/pytorch/bin/python -m torch.distributed.launch --nnodes=$NNODES --node_rank=$NODE_RANK --nproc_per_node=$NGPUS_PER_NODE --master_addr $MASTER_ADDR --master_port=$MASTER_PORT main.py --data-path $IMAGE_DATA_PATH --cfg ./configs/swin/swin_base_patch4_window7_224_22k.yaml 推荐先使用单机单卡运行脚本,待正常运行后再改用多机多卡运行脚本。 多机多卡run.sh中的“VC_WORKER_HOSTS”、“VC_WORKER_NUM”、“VC_TASK_INDEX”、“MA_NUM_GPUS”为ModelArts训练容器中预置的环境变量。训练容器环境变量详细介绍可参考查看训练容器环境变量。 通过obsutils,将代码文件夹放到OBS上,然后通过OBS将代码传至SFS相应目录中。 在SFS中将代码文件Swin-Transformer-main设置归属为ma-user。 chown -R ma-user:ma-group Swin-Transformer 执行以下命令,去除Shell脚本的\r字符。 cd Swin-Transformer sed -i 's/\r//' run.sh Shell脚本在Windows系统编写时,每行结尾是\r\n,而在Linux系统中行每行结尾是\n,所以在Linux系统中运行脚本时,会认为\r是一个字符,导致运行报错“$'\r': command not found”,因此需要去除Shell脚本的\r字符。 父主题: 多机多卡
  • 获取软件 表1 软件名称 软件名称 说明 下载地址 Ascend-cann-atb_7.0.0_linux-aarch64_abi0.run 推理依赖软件 https://ascend-cloud-llm-infer-ops.obs.cn-southwest-2.myhuaweicloud.com/version_packages/atb_llm_7.0.T61.B010.tar Ascend-cann-llm_7.0.0_linux-aarch64_torch2.0.1-abi0.tar.gz ascendcloud-llmframework_6.3.902_*.tar.gz 说明: 这里的*表示具体的时间戳。 Ascend-vllm插件 获取路径:Support网站。 说明: 如果没有软件下载权限,请联系您所在企业的华为方技术支持下载获取。 Baichuan-13b 从Huggingface下载的预训练权重文件 https://huggingface.co/baichuan-inc/Baichuan-13B-Base https://huggingface.co/baichuan-inc/Baichuan-13B-Chat (推荐) 下载完毕后的权重文件夹包含以下内容,此处以Baichuan-13b-chat为例。 Baichuan-13B-Chat ├── Baichuan-13B 模型社区许可协议.pdf ├── Community License for Baichuan-13B Model.pdf ├── config.json ├── configuration_baichuan.py ├── generation_config.json ├── generation_utils.py ├── gitattributes.txt ├── handler.py ├── modeling_baichuan.py ├── model.safetensors.index.json ├── pytorch_model-00001-of-00003.bin ├── pytorch_model-00002-of-00003.bin ├── pytorch_model-00003-of-00003.bin ├── pytorch_model.bin.index.json ├── quantizer.py ├── README.md ├── requirements.txt ├── special_tokens_map.json └── tokenization_baichuan.py
  • 返回结果 表4 返回结果 类型 说明 GetResult 参数解释: SDK公共结果对象。 表5 GetResult 参数名称 参数类型 描述 status int 参数解释: HTTP状态码。 取值范围: 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 默认取值: 无 reason str 参数解释: HTTP文本描述。 默认取值: 无 errorCode str 参数解释: OBS服务端错误码,当status参数小于300时为空。 默认取值: 无 errorMessage str 参数解释: OBS服务端错误描述,当status参数小于300时为空。 默认取值: 无 requestId str 参数解释: OBS服务端返回的请求ID。 默认取值: 无 indicator str 参数解释: OBS服务端返回的错误定位码。 默认取值: 无 hostId str 参数解释: 请求的服务端ID,当status参数小于300时为空。 默认取值: 无 resource str 参数解释: 发生错误时相关的桶或对象,当status参数小于300时为空。 默认取值: 无 header list 参数解释: 响应消息头列表,由多个元组构成。每个元组均包含两个元素,代表响应头的键值对。 默认取值: 无 body object 参数解释: 操作成功后的结果数据,当status大于300时为空。该值根据调用接口的不同而不同,参见“桶相关接口”章节和“对象相关接口”章节的详细描述。 默认取值: 无 表6 GetResult.body GetResult.body类型 说明 CopyPartResponse 参数解释: 复制段响应结果。详见CopyPartResponse。 表7 CopyPartResponse 参数名称 参数类型 描述 etag str 参数解释: 段的base64编码的128位MD5摘要。ETag是段内容的唯一标识,可以通过该值识别段内容是否有变化。 取值范围: 长度为32的字符串。 默认取值: 无 lastModified str 参数解释: 对象的最近一次修改时间。 约束限制: 日期格式为GMT的格式。 例如:Wed, 25 Mar 2020 02:39:52 GMT。 默认取值: 无 sseKms str 参数解释: 表示服务端加密是SSE-KMS方式。对象使用SSE-KMS方式加密。 取值范围: 可选值:kms,即选择SSE-KMS方式加密对象。 默认取值: 无 sseKmsKey str 参数解释: SSE-KMS加密方式下使用的KMS主密钥的ID值。 取值范围: 有效值支持两种格式: regionID:domainID(账号ID):key/key_id key_id 其中: regionID是使用密钥所属region的ID,可在地区和终端节点页面获取; domainID是使用密钥所属账号的账号ID,获取方法参见如何获取账号ID和用户ID?(Python SDK); key_id是从数据加密服务创建的密钥ID,获取方法请参见查看密钥。 默认取值: 如果用户没有提供该头域,那么默认的主密钥将会被使用。 如果默认主密钥不存在,将默认创建并使用。 sseC str 参数解释: 使用SSE-C方式加解密对象时,选择的加解密算法。 取值范围: 支持的值为AES256,即高级加密标准(Advanced Encryption Standard,AES)。 默认取值: 无 sseCKeyMd5 str 参数解释: SSE-C方式下加密使用密钥的MD5值,该值用于验证密钥传输过程中是否出错。 约束限制: 由密钥值经过MD5加密再经过Base64编码后得到,示例:4XvB3tbNTN+tIEVa0/fGaQ== 默认取值: 无
  • 接口约束 您必须是桶拥有者或拥有复制段的权限,才能复制段。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。 拷贝段的结果不能仅根据HTTP返回头域中的status_code来判断请求是否成功,头域中status_code返回200时表示服务端已经收到请求,且开始处理拷贝段请求。拷贝是否成功会在响应消息的body中,只有body体中有ETag标签才表示成功,否则表示拷贝失败。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 bucketName str 必选 参数解释: 目标桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 默认取值: 无 objectKey str 必选 参数解释: 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 说明: 对象链接地址格式为:https://桶名.域名/文件夹目录层级/对象名。如果该对象存在于桶的根目录下,则链接地址将不需要有文件夹目录层级。 partNumber int 必选 参数解释: 段号。 取值范围: [1,10000] 默认取值: 无 uploadId str 必选 参数解释: 分段上传任务的ID,例如:000001648453845DBB78F2340DD460D8 取值范围: 长度为32的字符串。 默认取值: 无 copySource str 必选 参数解释: 指定源桶、源对象和源对象版本号(可为空)的参数,格式:源桶名/源对象名?versionId=源对象版本号。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 默认取值: 无 copySourceRange str 可选 参数解释: 指定复制源对象的范围。例如:0-999,即对象的第1个字节到1000字节。 取值范围: 取值区间:[0,对象长度-1],格式:x-y,即对象的第x+1字节到第y+1字节。 约束限制: 如果range的最大长度超出对象长度-1,仍旧取对象长度-1。 默认取值: 无 destSseHeader SseCHeader 或 SseKmsHeader 可选 参数解释: 服务端加密头域,用于加密目标对象。详见SseCHeader或SseKmsHeader sourceSseHeader SseCHeader 可选 参数解释: 服务端解密头域,用于解密源对象。详见SseCHeader 表2 SseCHeader 参数名称 参数类型 是否必选 描述 encryption str 必选 参数解释: 以SSE-C方式加密对象。 取值范围: AES256,即高级加密标准(Advanced Encryption Standard,AES)。 默认取值: 无 key str 必选 参数解释: SSE-C方式下加密的密钥,与加密方式对应,如encryption=‘AES256’,name密钥就是由AES256加密算法得到的密钥。 取值范围: 长度为32字符串。 默认取值: 无 表3 SseKmsHeader 参数名称 参数类型 是否必选 描述 encryption str 必选 参数解释: 以SSE-KMS方式加密对象。 取值范围: 可选值:kms,即选择SSE-KMS方式加密对象。 默认取值: 无 key str 可选 参数解释: SSE-KMS方式下加密的主密钥。 取值范围: 支持两种格式的密钥描述方式: regionID:domainID(租户ID):key/key_id key_id 其中: regionID是使用密钥所属region的ID,可在地区和终端节点页面获取; domainID是使用密钥所属账号的账号ID,获取方法参见如何获取账号ID和用户ID?(Python SDK); key_id是从数据加密服务创建的密钥ID,获取方法请参见查看密钥。 默认取值: 如果用户没有提供该头域,那么默认的主密钥将会被使用。 如果默认主密钥不存在,将默认创建并使用。
  • 功能说明 初始化分段上传任务后,通过分段上传任务的ID,复制段到指定桶中。 多段上传任务创建后,用户可以通过指定多段上传任务号,为特定的任务上传段。添加段的方式还包括调用段拷贝接口。允许客户将已上传对象的一部分或全部拷贝为段。 将源对象object拷贝为一个段part1,如果在拷贝操作之前part1已经存在,拷贝操作执行之后,旧的段数据part1会被新拷贝的段数据覆盖。拷贝成功后,只能列举到最新的段part1,旧的段数据将会被删除。因此在使用拷贝段接口时请确保目标段不存在或者已无价值,避免因拷贝段导致数据误删除。拷贝过程中源对象object无任何变化。
  • 返回结果 表9 返回结果 类型 说明 GetResult 参数解释: SDK公共结果对象。 表10 GetResult 参数名称 参数类型 描述 status int 参数解释: HTTP状态码。 取值范围: 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 默认取值: 无 reason str 参数解释: HTTP文本描述。 默认取值: 无 errorCode str 参数解释: OBS服务端错误码,当status参数小于300时为空。 默认取值: 无 errorMessage str 参数解释: OBS服务端错误描述,当status参数小于300时为空。 默认取值: 无 requestId str 参数解释: OBS服务端返回的请求ID。 默认取值: 无 indicator str 参数解释: OBS服务端返回的错误定位码。 默认取值: 无 hostId str 参数解释: 请求的服务端ID,当status参数小于300时为空。 默认取值: 无 resource str 参数解释: 发生错误时相关的桶或对象,当status参数小于300时为空。 默认取值: 无 header list 参数解释: 响应消息头列表,由多个元组构成。每个元组均包含两个元素,代表响应头的键值对。 默认取值: 无 body object 参数解释: 操作成功后的结果数据,当status大于300时为空。该值根据调用接口的不同而不同,参见“桶相关接口”章节和“对象相关接口”章节的详细描述。 默认取值: 无 表11 GetResult.body GetResult.body类型 说明 PutContentResponse 参数解释: 上传对象响应结果,参考PutContentResponse。 表12 PutContentResponse 参数名称 参数类型 描述 storageClass str 参数解释: 对象的存储类型。 取值范围: 当对象存储类型是标准存储时,该值为空。 可选择的存储类型参见StorageClass。 默认取值: 无 versionId str 参数解释: 对象的版本号。如果桶的多版本状态为开启,则会返回对象的版本号。 取值范围: 长度为32的字符串。 默认取值: 无 etag str 参数解释: 对象的etag值,即base64编码的128位MD5摘要。etag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时etag为A,下载对象时etag为B,则说明对象内容发生了变化。etag只反映变化的内容,而不是其元数据。上传的对象或拷贝操作创建的对象,都有唯一的etag。 约束限制: 当对象是服务端加密的对象时,etag值不是对象的MD5值。 取值范围: 长度为32的字符串。 默认取值: 无 sseKms str 参数解释: SSE-KMS方式的算法。 取值范围: kms,即以SSE-KMS方式加密对象。 默认取值: 无 sseKmsKey str 参数解释: SSE-KMS加密方式下使用的KMS主密钥的ID值。 取值范围: 有效值支持两种格式: regionID:domainID(账号ID):key/key_id key_id 其中: regionID是使用密钥所属region的ID,可在地区和终端节点页面获取; domainID是使用密钥所属账号的账号ID,获取方法参见如何获取账号ID和用户ID?(Python SDK); key_id是从数据加密服务创建的密钥ID,获取方法请参见查看密钥。 默认取值: 如果用户没有提供该头域,那么默认的主密钥将会被使用。 如果默认主密钥不存在,将默认创建并使用。 sseC str 参数解释: SSE-C方式的算法。 取值范围: AES256。 默认取值: 无 sseCKeyMd5 str 参数解释: SSE-C方式下加密使用密钥的MD5值,该值用于验证密钥传输过程中是否出错。 约束限制: 由密钥值经过MD5加密再经过Base64编码后得到,示例:4XvB3tbNTN+tIEVa0/fGaQ== 默认取值: 无 objectUrl str 参数解释: 对象的全路径。 默认取值: 无
  • 接口约束 您必须是桶拥有者或拥有创建文件夹的权限,才能创建创建文件夹。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。 创建文件夹本质上来说是创建了一个大小为0且对象名以“/”结尾的对象。 多级文件夹创建最后一级即可,比如src1/src2/src3/,创建src1/src2/src3/即可,无需创建src1/、src1/src2/。
  • 功能说明 通过分段上传任务的ID,列举指定桶中已上传的段。 您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信息,最多为1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索所有段。请注意,返回的分段列表不包括已合并的分段。
  • 接口约束 您必须是桶拥有者或拥有列举已上传的段的权限,才能列举已上传的段。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:ListMultipartUploadParts权限,如果使用桶策略则需授予ListMultipartUploadParts权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。 仅使用返回的列表进行验证。发送完成多段上传请求时,您不应使用此列表的结果。但是,当上传段和OBS返回的相应的ETag值时,将保留您自己的指定段编号的列表。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 bucketName str 必选 参数解释: 桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 默认取值: 无 objectKey str 必选 参数解释: 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 说明: 对象链接地址格式为:https://桶名.域名/文件夹目录层级/对象名。如果该对象存在于桶的根目录下,则链接地址将不需要有文件夹目录层级。 uploadId str 必选 参数解释: 分段上传任务的ID,例如:000001648453845DBB78F2340DD460D8 取值范围: 长度大于0且不超过32的字符串。 默认取值: 无 maxParts int 可选 参数解释: 列举已上传段的返回结果最大段数目,即分页时每一页中段数目。 约束限制: 如果该参数超出1000时,则按照默认的1000进行处理。 取值范围: [1,1000] 默认取值: 1000 partNumberMarker int 可选 参数解释: 列举已上传段的起始位置。 约束限制: 只有PartNumber数目大于该参数的Part会被列出 默认取值: 无 encoding_type str 可选 参数解释: 用于指定对响应中的Key 进行指定类型的编码。如果Key 包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Key 进行编码。 取值范围: 可选值为url。 默认取值: 无,不设置则不编码。
  • 获取账号、IAM用户、项目的名称和ID 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID 在华为云首页右上角,单击“控制台”。 在右上角的用户名中选择“我的凭证”。 图1 进入我的凭证 在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。 每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。 图2 查看账号名、账号ID、用户名、用户ID、项目名称、项目ID 调用API获取用户ID、项目ID 获取用户ID请参考:管理员查询IAM用户列表。 获取项目ID请参考:查询指定条件下的项目列表。
  • 请求参数 表1 请求参数列表 参数名称 参数类型 是否必选 描述 bucketName str 必选 参数解释: 桶名。 约束限制: 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。 桶命名规则如下: 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。 禁止使用IP地址。 禁止以“-”或“.”开头及结尾。 禁止两个“.”相邻(如:“my..bucket”)。 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。 默认取值: 无 objectKey str 必选 参数解释: 目标对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 versionId str 可选 参数解释: 对象的版本号,用于删除指定版本号的对象。例如:G001117FCE89978B0000401205D5DC9。 取值范围: 长度为32的字符串。 默认取值: 无,如果不设置则默认删除最新版本的对象。
共100000条