华为云用户手册

响应示例：创建桶 1 2 3 4 5 6 7 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016435CE298386946AE4C482 Location: /examplebucket x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz Date: WED, 01 Jul 2015 02:25:06 GMT Content-Length: 0

请求消息头 该操作消息头与普通请求一样，请参见表3，但可以带附加消息头，附加请求消息头如下所示。 表1 附加请求消息头 消息头名称 描述 是否必选 x-obs-acl 创建桶时，可以加上此消息头设置桶的权限控制策略，使用的策略为预定义的常用策略，包括：private、public-read、public-read-write、public-read-delivered、public-read-write-delivered、bucket-owner-full-control（各策略详细说明见ACL章节的“使用头域设置ACL”）。 类型：String 否 x-obs-storage-class 创建桶时，可以加上此消息头设置桶的默认存储类型，默认存储类型有4种：STANDARD（标准存储）、WARM（低频访问存储）、COLD（归档存储）、DEEP_ARCHIVE（深度归档存储）。如果没有指定此头域，则创建的桶为标准存储类型。 类型：String 否 x-obs-grant-read 授权给指定domain下的所有用户有READ权限。允许列举桶内对象、列举桶中多段任务、列举桶中多版本对象、获取桶元数据。 类型：String 示例：x-obs-grant-read:id=租户id 否 x-obs-grant-write 授权给指定domain下的所有用户有WRITE权限。允许创建、删除、覆盖桶内所有对象，允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。 类型：String 示例：x-obs-grant-write:id=租户id 否 x-obs-grant-read-acp 授权给指定domain下的所有用户有READ_ACP权限。允许读桶的ACL信息。 类型：String 示例：x-obs-grant-read-acp:id=租户id 否 x-obs-grant-write-acp 授权给指定domain下的所有用户有WRITE_ACP权限，允许修改桶的ACL信息。 类型： 字符串 示例：x-obs-grant-write-acp:id=租户id 否 x-obs-grant-full-control 授权给指定domain下的所有用户有FULL_CONTROL权限。 类型： 字符串 示例：x-obs-grant-full-control:id=租户id 否 x-obs-grant-read-delivered 授权给指定domain下的所有用户有READ权限，并且在默认情况下，该READ权限将传递给桶内所有对象。 类型：String 示例：x-obs-grant-read-delivered:id=租户id 否 x-obs-grant-full-control-delivered 授权给指定domain下的所有用户有FULL_CONTROL权限，并且在默认情况下，该FULL_CONTROL权限将传递给桶内所有对象。 类型：String 示例：x-obs-grant-full-control-delivered:id=租户id 否 x-obs-az-redundancy 创建桶时带上此消息头设置桶的存储类型为多AZ。不携带时默认为单AZ。用户携带该头域指定新创的桶的存储类型为多AZ，存在一种情况是当该区域如果不支持多AZ存储，则该桶的存储类型仍为单AZ。 类型：String 示例：x-obs-az-redundancy：3az 否 x-obs-fs-file-interface 创建桶时可以带上此消息头以创建并行文件系统。 类型：String 示例：x-obs-fs-file-interface:Enabled 否 x-obs-epid 企业项目id，开通企业项目的用户可以从企业项目服务获取，格式为uuid，默认项目传“0”或者不带该头域，未开通企业项目的用户可以不带该头域。 类型：String 示例：x-obs-epid:9892d768-2d13-450f-aac7-ed0e44c2585f 否 x-obs-bucket-type 创建桶时可以带上此消息头指定创建的桶类型，桶类型包括OBS桶和文件桶。 类型：String OBJECT：对象存储桶。 POSIX：并行文件系统。 示例：x-obs-bucket-type：OBJECT 否 x-obs-bucket-object-lock-enabled 创建桶时可以带上此消息头来开启WORM开关。 类型：String 示例：x-obs-bucket-object-lock-enabled:true 否 x-obs-server-side-encryption 创建桶时可以带上此头域来指定桶加密配置的加密模式。 类型：String 有效值：kms, obs 示例：x-obs-server-side-encryption: kms 否 x-obs-server-side-data-encryption 创建桶时带上此头域来指定服务端加密配置的加密算法。 类型：String 有效值：AES256、SM4 当携带了x-obs-server-side-encryption:kms, 该头域可选 AES256、SM4; 当携带了x-obs-server-side-encryption:obs, 该头域可选 AES256。 示例：x-obs-server-side-data-encryption: AES256 否 x-obs-server-side-encryption-kms-key-id SSE-KMS加密方式下使用的KMS主密钥，如果用户没有提供该头域，那么默认的主密钥将会被使用。 类型：String 有效值支持两种格式： regionID:domainID(账号ID):key/key_id key_id 其中： regionID是使用密钥所属region的ID，可在地区和终端节点页面获取。 domainID是使用密钥所属账号的账号ID，获取方法参见获取账号ID和用户ID； key_id是从 数据加密 服务创建的密钥ID，获取方法请参见查看密钥。 如果携带了x-obs-server-side-encryption: kms，该头域可选。 x-obs-sse-kms-key-project-id SSE-KMS加密方式下KMS主密钥所属的项目ID（非企业项目ID）。 类型：String 有效值：与x-obs-server-side-encryption-kms-key-id指定的KMSMasterKeyID相匹配的项目ID（非企业项目ID）。 如果未携带x-obs-server-side-encryption-kms-key-id，则不能携带该头域。

存储类型 允许用户创建不同默认存储类型的桶。发送创桶请求时携带头域“x-obs-storage-class”来指定桶的默认存储类型。桶内对象的存储类型与桶默认存储类型保持一致。存储类型有4种：STANDARD（标准存储）、WARM（低频访问存储）、COLD（归档存储）、DEEP_ARCHIVE（深度归档存储）。如果没有携带此头域 ，则创建的桶为标准存储类型。 当往桶内上传对象时，如果没有指定对象的存储类别（参考PUT上传），则该对象的存储类型取桶的默认存储类型。 OBS标准存储拥有低访问时延和较高的吞吐量，因而适用于有大量热点文件需要频繁访问数据的业务场景，例如：大数据、移动应用、热点视频、社交图片等场景。 OBS低频访问存储适用于不频繁访问（少于每月一次访问）但在需要时也要求快速访问数据的业务场景，例如：文件同步/共享、企业备份等场景。与标准存储相比，低频访问存储有相同的数据持久性、吞吐量以及访问时延，且成本较低，但是可用性略低于标准存储。 OBS归档存储适用于很少访问（平均一年访问一次）数据的业务场景，例如：数据归档、长期备份等场景。归档存储安全、持久且成本极低，可以用来替代磁带库。为了保持成本低廉，数据恢复时间可能长达数分钟到数小时不等。 深度归档存储（受限公测）适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。

请求消息元素 该操作可以带附加请求消息元素，附加请求消息元素的具体描述如表2所示。 表2 附加请求消息元素 元素名称 描述 是否必选 Location 指定Bucket在哪个区域被创建。 使用华北-北京一的终端节点创桶时 不携带Location，桶将默认创建在华北-北京一（cn-north-1） 在Location中指定其它区域，例如华北-北京四（cn-north-4），桶将创建在指定区域 使用华北-北京一以外其它区域的终端节点创桶时，必须携带Location，并且Location只能指定为该终端节点对应的区域。 例如使用obs.cn-north-4.myhuaweicloud.com终端节点创桶时，必须指定Location为cn-north-4。 有关OBS区域和终端节点的更多信息，请参考地区和终端节点。 类型：String 否

响应示例：创建指定ACL和存储类型的桶 1 2 3 4 5 6 7 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016435CE298386946AE4C482 Location: /examplebucket x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz Date: WED, 01 Jul 2015 02:25:06 GMT Content-Length: 0

功能介绍 创建桶是指按照用户指定的桶名创建一个新桶的操作。 默认情况下，一个用户可以拥有的桶的数量不能超过100个。 用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。 OBS支持在创建桶时指定桶的AZ类型，您可以开启或关闭多AZ。关闭多AZ时，桶内数据默认存储在单个AZ内；开启多AZ时，桶内数据冗余存储在多个AZ内，可靠性更高。旧桶AZ类型默认为单AZ。 OBS支持在创建桶时打开桶级WORM开关，打开后可以为桶内的对象设置WORM，详见配置桶级默认WORM策略。注意：WORM开关只能在创建桶时打开，一旦打开无法关闭；在打开WORM开关的时候会默认为桶开启多版本，且多版本状态无法关闭；您无法为一个桶同时开启WORM开关和并行文件系统。 新创建桶的桶名在OBS中必须是唯一的。如果是同一个用户重复创建同一区域的同名桶时返回成功。除此以外的其他场景重复创建同名桶返回桶已存在。用户可以在请求消息头中加入x-obs-acl等参数，设置要创建桶的权限控制策略。

操作步骤 在OBS管理控制台左侧导航栏选择“桶列表”。 在桶列表上方的搜索框中单击左键，在一级下拉框中选择“桶名称”、“区域”、“存储类别”、“数据冗余存储策略”或“企业项目”，然后在二级下拉框中选择你需要的选项，也可以输入关键字后再进行选择。 搜索到的桶会展示在桶列表中。 例如：您需要查找桶名称为“test”的桶，您只需在主页面上方的搜索框中单击左键，在一级下拉框中选择“桶名称”，在二级下拉框中选择“test”，或者选择“桶名称”后在搜索框中输入“test”，所有桶名称中包含“test”字符的桶都会展示到二级下拉框中，然后单击“test”。搜索到的桶会展示在桶列表中。 图1 搜索桶 桶列表支持组合过滤。 当筛选条件不同时：筛选条件是交集的关系。例如：选择区域“华北-北京四”后再选择存储类别“标准存储”，区域为“华北-北京四”且存储类别为“标准存储”的桶都会在列表中展示。 当筛选条件相同时：筛选条件是并集的关系。例如：选择桶名称“test-1”后再选择桶名称“test-2”进行组合搜索，桶名称为“test-1”和“test-2”的桶都会在列表中展示。 在桶列表上方的搜索框中直接输入关键字，桶名称、区域、存储类别、数据冗余存储策略或企业项目中包含关键字的所有桶都会展示到下拉框中，单击选择您需要的选项，符合条件的桶会在列表中展示。 或者在桶列表上方的搜索框中直接输入关键字，单击或Enter键。 搜索到的桶名称、区域、存储类别、数据冗余存储策略、企业项目中包含关键字的所有桶会展示在桶列表中。 例如：您在主页面上方的搜索框中输入“test”并单击或Enter键，桶名称、区域、存储类别、数据冗余存储策略、企业项目中包含“test”关键字的所有桶都会展示到桶列表中。 图2 搜索桶

约束与限制 通过OBS管理控制台上传的文件有大小和数量限制，每次最多支持100个文件同时上传，总大小不超过5GB。如果只上传1个文件，则这个文件最大为5GB。 超过5GB的文件，可以使用OBS Browser+、obsutil上传，或使用OBS SDK及API的多段接口上传，上限为48.8TB。 OBS Browser+最多同时一次上传500个文件，obsutil没有上传文件数量限制。 如果您有更大量的数据需要上传至OBS，可以参考搬迁本地数据至OBS和迁移第三方云厂商数据至OBS。 在未开启多版本控制功能的情况下，如果新上传的文件和桶内文件重名，则新上传的文件会自动覆盖老文件，且不会保留老文件的ACL等信息；如果新上传的文件夹和桶内文件夹重名，则上传后会将新老文件夹合并，合并过程如遇重名文件，会使用新上传的文件夹中的文件进行覆盖。 在开启了多版本控制功能的情况下，如果新上传的文件和桶内文件重名，则会在老文件上新增一个版本。关于多版本的详细介绍请参见多版本控制。

操作步骤 在OBS管理控制台左侧导航栏选择“桶列表”。 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。 进入待上传的文件夹，单击“上传对象”，系统弹出“上传对象”对话框。 如果待上传至OBS的文件存放在Microsoft OneDrive中，建议这些待上传文件的名称不要超过32位，以保证兼容性。 图1 上传对象 指定对象的存储类别。如果不指定，默认与桶的存储类别一致。 对象存储类别和桶存储类别可以不一致。上传对象时，对象的存储类别默认继承桶的存储类别，您也可以重新指定对象的存储类别，同时也支持在对象上传完成后修改对象的存储类别。 拖拽本地文件或文件夹至“上传对象”区域框内添加待上传的文件。 也可以通过单击“上传对象”区域框内的“添加文件”，选择本地文件进行添加。 服务端加密：可以选择“不开启加密”、“SSE-KMS”或“SSE-OBS”。详情请参见使用服务端加密方式上传对象。 如果桶配置了默认加密，上传对象时您可以选择“继承桶的加密配置”。 可选：如果您需要配置元数据或WORM保留策略，可单击“下一步：高级配置（可选）”进行配置。 当桶开启了WORM功能，高级配置才支持配置WORM保留策略。 配置元数据：可配置的对象元数据包括：ContentDisposition、ContentLanguage、WebsiteRedirectLocation、ContentEncoding、ContentType。各元数据具体含义请参见OBS元数据。元数据是一组名称值对，包括名称和值，值不能为空。如需配置两组以上元数据，单击“添加”即可新增。 配置保留策略：可选择“继承桶策略”或者选择“配置”后输入保留期，自动保护上传到此存储桶的新对象，保证其不被删除。 图2 配置元数据或WORM保留策略 单击“上传”。

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 server 是 Object 云服务器数据结构，详情请参见表3 表3 server字段数据结构说明 参数 是否必选 参数类型 描述 name 否 String 修改后的云服务器名称，字符长度范围为1-255。 description 否 String 对弹性云服务器的任意描述，最大255字节。 微版本2.19及以上版本支持。

响应示例 { "server": { "tenant_id": "7910a6e50b80402ba028c8d96c1b31fe", "image": "", "accessIPv4": "", "addresses": { "03be5c1e-e05d-4905-a105-c3bd9b730bdc": [ { "addr": "192.168.0.72", "version": 4 } ] }, "metadata": {}, "accessIPv6": "", "created": "2018-05-17T03:15:48Z", "hostId": "7dc82f6b1d406200fc63e395cf4829cbffcb49de0e9c75c5773f201f", "flavor": { "links": [ { "rel": "bookmark", "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/flavors/c3.1U1G" } ], "id": "c3.1U1G" }, "OS-DCF:diskConfig": "MANUAL", "user_id": "d698a78532ca430f8daec1858f2b500e", "name": "new-server-test", "progress": 0, "links": [ { "rel": "self", "href": "https://None/v2/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a" }, { "rel": "bookmark", "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a" } ], "id": "1a19ef4f-be0a-4526-bf2f-14b4464d536a", "updated": "2018-05-21T00:36:27Z", "status": "ACTIVE" } }

文档修订记录 发布日期 修订记录 2024-04-07 第七十三次正式发布。 新增参数“cpu_options”，涉及： 创建云服务器 创建云服务器（按需） 变更云服务器规格 变更云服务器规格（按需） 新增参数“isAutoPay”，涉及： 切换弹性云服务器操作系统（安装Cloud-init） 切换弹性云服务器操作系统（未安装Cloud-init） 2024-03-25 第七十二次正式发布。 修改参数“name”的取值范围，涉及： 创建云服务器 创建云服务器（按需） 修改云服务器 批量修改弹性云服务器 创建云服务器 修改云服务器 2024-01-15 第七十一次正式发布。 修改 修改云服务器，server字段新增参数“OS-EXT-SRV-ATTR:user_data”。 查询API版本信息列表，更新响应示例。 2023-10-13 第七十次正式发布。 修改 查询规格详情和规格扩展信息列表，os_extra_specs字段新增参数“quota:vif_max_num”和“quota:sub_network_interface_max_num”。 数据结构(查询云服务器详情)，address字段新增参数“primary”。 2023-09-12 第六十九次正式发布。 新增 修改云服务器定时删除时间。 修改 错误码，新增错误码Ecs.0090。 2023-08-18 第六十八次正式发布。 “volumetype”新增GPSSD2和ESSD2类型云硬盘，root_volume和data_volume字段数据结构说明新增参数“iops”和“throughput”，涉及： 创建云服务器 创建云服务器（按需） 2023-07-20 第六十七次正式发布。 异步接口增加说明，涉及： 删除云服务器 重装弹性云服务器操作系统（安装Cloud-init） 切换弹性云服务器操作系统（安装Cloud-init） 重装弹性云服务器操作系统（未安装Cloud-init） 切换弹性云服务器操作系统（未安装Cloud-init） 冷迁移云服务器 变更云服务器规格（按需） 批量启动云服务器 批量重启云服务器 批量关闭云服务器 批量挂载指定共享盘 批量添加云服务器网卡 批量删除云服务器网卡 弹性云服务器挂载磁盘 弹性云服务器卸载磁盘 2023-06-20 第六十六次正式发布。 修改接口约束，涉及： 创建云服务器 创建云服务器（按需） 2023-06-08 第六十五次正式发布。 新增 更换云服务器计费模式 修改 创建云服务器、创建云服务器（按需）：新增参数“allowed_address_pairs”、“metadata”。 查询云服务器详情列表，新增参数“ip_eq”。 2023-05-25 第六十四次正式发布。 新增 查询规格销售策略 智能购买组管理 规格推荐管理 修改 查询云服务器详情列表，修改参数status的描述。 2023-05-23 第六十三次正式发布。 修改 错误码，新增错误码Ecs.0089。 2023-05-19 第六十二次正式发布。 修改 查询云服务器详情，修改参数hw:cpu_threads的描述。 2023-05-12 第六十一次正式发布。 新增__system__encrypted、__system__cmkid参数，涉及： 重装弹性云服务器操作系统（安装Cloud-init） 切换弹性云服务器操作系统（安装Cloud-init） 重装弹性云服务器操作系统（未安装Cloud-init） 切换弹性云服务器操作系统（未安装Cloud-init） 新增错误码Ecs.0227。 2023-04-25 第六十次正式发布。 修改 获取VNC远程登录地址，修改参数url的描述。 2023-01-11 第五十九次正式发布。 修改 错误码，新增错误码Ecs.0066~Ecs.0071。 2022-12-09 第五十八次正式发布。 修改 查询云服务器详情列表，新增参数server_id。 2022-11-25 第五十七次正式发布。 新增 资源粒度授权 修改 权限及授权项说明，增加实例授权和标签授权的内容。 生命周期管理~FPGA逻辑文件管理，补充实例授权和标签授权列。 错误码，新增错误码Ecs.0812、Ecs.0813。 2022-08-19 第五十六次正式发布。 按标签查询云服务器列表（废弃），API废弃，移入“历史API”。 2022-07-29 第五十五次正式发布。 修改 错误码，新增错误码Ecs.0513。 2022-07-07 第五十四次正式发布。 新增 请求幂等性说明 修改 创建云服务器、创建云服务器（按需），补充支持请求幂等性的说明。 2022-06-20 第五十三次正式发布 修改 错误码，新增错误码Ecs.0706。 2022-05-20 第五十二次正式发布 修改 创建云服务器（按需），修改“hw:passthrough”参数说明。 2022-03-23 第五十一次正式发布 移动如下API至“历史API”： 查询云服务器是否配置了自动恢复动作（废弃） 管理云服务器自动恢复动作（废弃） 云服务器网卡配置虚拟IP地址（废弃） 云服务器网卡解绑虚拟IP地址（废弃） 数据结构(创建云服务器)，删除参数support_auto_recovery。 2022-03-17 第五十次正式发布 修改 通用请求返回值，增加通用请求返回值201。 2022-02-09 第四十九次正式发布 修改 移动废弃API至历史API。 2021-11-01 第四十八次正式发布 创建云服务器，修改请求参数metadata的参数类型。 创建云服务器（按需），修改请求参数metadata的参数类型。 2021-09-30 第四十七次正式发布 创建和导入SSH密钥，修改请求示例信息。 创建云服务器（按需），修改请求参数server_tags的参数类型。 2021-09-18 第四十六次正式发布 错误码，新增错误码Ecs.0016。 2021-08-27 第四十五次正式发布 创建云服务器、创建云服务器（按需）、创建云服务器新增auto_terminate_time字段。 查询云服务器网卡信息，新增attachableQuantity字段、interfaceAttachments补充delete_on_termination，driver_mode，min_rate，multiqueue_num，pci_address字段。 查询指定云服务器安全组列表，修改cidr字段为可选。 数据结构(创建云服务器)，bandwidth字段中修改size字段的取值说明。 2021-08-17 第四十四次正式发布 查询规格详情和规格扩展信息列表，响应参数os_extra_specs新增以下字段： flavors.extra_specs.hw:numa_nodes， flavors.extra_specs.hpet_support， flavors.extra_specs.instance_vnic:type， flavors.extra_specs.instance_vnic:instance_bandwidth， flavors.extra_specs.instance_vnic:max_count， flavors.extra_specs.extra_spec:io:persistent_grant， flavors.extra_specs.cond:operation:charge:stop， flavors.extra_specs.cond:spot:operation:az， flavors.extra_specs.cond:operation:roles， flavors.extra_specs.cond:spot:operation:status， flavors.extra_specs.cond:network， flavors.extra_specs.cond:storage， flavors.extra_specs.cond:compute:live_resizable， flavors.extra_specs.info:gpu:name， flavors.extra_specs.info:cpu:name， flavors.extra_specs.quota:gpu。 2021-06-24 第四十三次正式发布 新增 查询云服务器组列表，响应参数新增page_info字段。 修改 移动FPGA逻辑文件管理至“历史API”。 2021-05-27 第四十二次正式发布 新增 创建E CS 高频场景示例 获取Token 并检验Token的有效期 2021-05-10 第四十一次正式发布 修改 查询规格详情和规格扩展信息列表，新增字段ecs:instance_architecture。 2021-04-29 第四十次正式发布 修改 查询云服务器详情，status字段补充取值DELETED。 错误码，错误码Ecs.0003状态码修改为403。 2021-03-03 第三十九次正式发布 新增 数据结构(创建云服务器)，新增关于云备份策略和云备份存储库详情的字段CB_CSBS_BACKUP。 修改 查询云服务器详情列表，修改了sort_key的取值范围。 查询云服务器操作行为列表，新增字段changes-since。 2021-02-20 第三十八次正式发布。 新增 查询弹性云服务器关联的弹性公网IP。 修改 查询云服务器详情，新增os:scheduler_hints参数说明。 2021-01-29 第三十七次正式发布。 修改 查询云服务器组列表，新增page_info参数信息。 2020-11-30 第三十六次正式发布。 修改 查询云服务器组列表，新增字段limit、marker。 2020-10-10 第三十五次正式发布。 修改 创建云服务器、创建云服务器（按需），修改name字段描述，新增支持使用“正则排序”设置云服务器名称。 2020-09-22 第三十四次正式发布。 修改 创建云服务器、创建云服务器（按需），修改name取值范围描述。 2020-08-05 第三十三次正式发布。 新增 查询云服务器组列表 查询云服务器组详情 修改 移动废弃API至历史API。 创建云服务器、创建云服务器（按需），修改volumetype字段描述。 2020-07-16 第三十二次正式发布。 修改 查询云服务器详情、查询云服务器详情列表，修改status取值范围。 数据结构(查询云服务器详情)，补充metering.resourcetype的取值。 创建云服务器，修改请求示例中hw:passthrough的取值。 重装弹性云服务器操作系统（安装Cloud-init）、切换弹性云服务器操作系统（安装Cloud-init）、重装弹性云服务器操作系统（未安装Cloud-init）、切换弹性云服务器操作系统（未安装Cloud-init）补充响应示例的描述。 查询云服务器详情列表，补充说明ip字段的匹配规则为模糊匹配。 查询云服务器列表，补充说明ip字段的匹配规则为模糊匹配。 查询云服务器详情列表，补充说明ip字段的匹配规则为模糊匹配。 数据结构(创建云服务器)，补充spotPrice字段说明。 2020-06-20 第三十一次正式发布。 修改 一键重置弹性云服务器密码，新增字段is_check_password。 重装弹性云服务器操作系统（安装Cloud-init），新增mode字段，支持开机重装操作系统。 切换弹性云服务器操作系统（安装Cloud-init），新增mode字段，支持开机切换操作系统。 重装弹性云服务器操作系统（未安装Cloud-init），新增mode字段，支持开机重装操作系统。 切换弹性云服务器操作系统（未安装Cloud-init），新增mode字段，支持开机切换操作系统。 数据结构(创建云服务器)，创建云服务器的extendparam新增字段spot_duration_hours、spot_duration_count、interruption_policy。 2019-10-30 第三十次正式发布。 新增 添加云服务器组成员 删除云服务器组成员 修改 变更云服务器规格（按需）、变更云服务器规格，新增mode字段，支持开机变更规格。 删除“弹性云服务器监控指标说明”章节，移动至弹性云服务器用户指南中。 创建云服务器（按需），响应参数中新增details字段。 创建云服务器，响应参数中新增details字段。 响应（任务类），补充details数据结构。 生命周期管理修改查询云服务器详情列表（Openstack原生）的授权项，删除vpc:securityGroups:list。 生命周期管理修改查询云服务器详情（Openstack原生）的授权项，删除vpc:securityGroups:list。 查询云服务器列表、查询云服务器详情列表修改tag、not-tags字段说明，删除“受微版本2.26限制”说明。 查询云服务器详情列表、查询云服务器详情修改status取值范围，删除DELETED。 查询云服务器详情列表、查询云服务器详情补充host_status说明微版本2.16后支持。 查询规格详情和规格扩展信息列表新增响应参数attachableQuantity。 数据结构(查询规格详情)，cond:operation:status补充取值：obt_sellout：公测售罄。 修改云服务器，补充接口约束。 一键重置弹性云服务器密码，新增字段is_check_password、new_password。 2019-09-30 第二十九次正式发布。 修改 数据结构(创建云服务器)修改snapshotId字段说明。 数据结构(创建云服务器)新增字段__support_agent_list，云服务器支持 企业主机安全 、主机监控。 创建云服务器、修改云服务器、查询云服务器详情，补充响应参数server。 2019-09-12 第二十八次正式发布。 修改 变更云服务器规格（按需）功能介绍。 创建云服务器，支持创建按需和包年/包月弹性云服务器。 2019-08-23 第二十七次正式发布。 修改 新增查询弹性云服务器详情列表。 重装弹性云服务器操作系统（安装Cloud-init）删除v2.1URI。 切换弹性云服务器操作系统（安装Cloud-init）删除v2.1URI。 2019-07-30 第二十六次正式发布。 新增 API版本选择建议新增“版本选择”。 查询弹性云服务器单个磁盘信息 查询弹性云服务器挂载磁盘列表详情信息 查询弹性云服务器挂载磁盘列表信息 创建云服务器组 删除云服务器组 查询云服务器网卡信息 更新云服务器元数据 删除云服务器指定元数据 获取VNC远程登录地址 查询云服务器规格变更支持列表 查询项目标签 查询云服务器标签 批量添加云服务器标签 批量删除云服务器标签 冷迁移云服务器 一键重置弹性云服务器密码 获取云服务器密码 清除云服务器密码 修改云服务器 获取VNC远程登录地址（微版本2.6及以上） 重装弹性云服务器操作系统（安装Cloud-init）新增v2.1URI 切换弹性云服务器操作系统（安装Cloud-init）新增v2.1URI 查询云服务器标签（废弃） 变更弹性云服务器规格 弹性云服务器挂载磁盘 弹性云服务器挂载网卡 修改 创建云服务器（按需）、创建云服务器修改响应消息和响应示例，新增参数serverIds。 创建云服务器（按需）、创建云服务器修改subnet_id字段描述。 错误码新增Ecs.0802-Ecs.08010。 错误码新增Ecs.0046、Ecs.0048-Ecs.0053。 数据结构(创建云服务器)补充说明创建磁盘的metadata字段。 查询FPGA镜像详情列表、关联FPGA镜像与弹性云服务器镜像、解关联FPGA镜像与弹性云服务器镜像、查询关联列表、创建FPGA镜像修改请求参数的字段结构说明。 变更云服务器规格（按需），修改响应示例。 数据结构(创建云服务器)，v1.1接口补充enterprise_project_id字段。 查询云服务器详情列表，删除API接口未返回的参数evsOpts、hyperThreadAffinity、numaOpts、vcpuAffinity。 查询云服务器详情，删除API接口未返回的参数evsOpts、hyperThreadAffinity、numaOpts、vcpuAffinity。 查询云服务器详情列表，补充参数fault。 查询云服务器详情，补充参数fault。 查询租户配额下线limit_by_flavor字段。 生命周期管理修改查询云服务器详情（OpenStack原生）对应的授权项。 调整API授权列表结构。 2019-06-30 第二十五次正式发布。 新增 查询云服务器规格列表、查询云服务器规格详情列表新增响应参数flavors_links。 查询规格详情和规格扩展信息列表新增参数“quota:local_disk”和“quota:nvme_ssd”。 2019-05-30 第二十四次正式发布。 新增 API版本选择建议 数据结构(创建云服务器) 数据结构(查询规格详情) 数据结构(查询云服务器详情) 权限及授权项说明 云服务器状态 修改 调整文档结构。 将创建云服务器（按需）公共参数移动至数据结构(创建云服务器)。 将查询规格详情和规格扩展信息列表公共参数移动至数据结构(查询规格详情)。 将查询云服务器详情公共参数移动至数据结构(查询云服务器详情)。 批量重置弹性云服务器密码，修改接口约束：支持开机状态下批量重置云服务器密码。 一键重置云服务器密码（废弃），修改接口约束：支持开机状态下重置云服务器密码。 API（OpenStack Nova 原生）删除V2接口URI，推荐使用v2.1接口。 查询云服务器规格列表、查询云服务器规格详情列表新增响应参数flavors_links。 查询规格详情和规格扩展信息列表新增参数“quota:local_disk”和“quota:nvme_ssd”。 创建云服务器（按需）修改hw:passthrough字段描述。 数据结构(创建云服务器)新增数据结构导航。 删除“按标签查询云服务器列表”。 删除“按标签查询云服务器数量”。 查询规格详情和规格扩展信息列表修改disk、swap、OS-FLV-EXT-DATA:ephemeral、OS-FLV-DISABLED:disabled、rxtx_factor、rxtx_quota、rxtx_cap、os-flavor-access:is_public参数描述。 查询云服务器规格变更支持列表（废弃）修改rxtx_quota、rxtx_cap参数描述。 查询云服务器规格详情列表修改disk、swap、OS-FLV-EXT-DATA:ephemeral、OS-FLV-DISABLED:disabled参数描述。 查询云服务器规格详情修改disk、swap、OS-FLV-EXT-DATA:ephemeral、OS-FLV-DISABLED:disabled参数描述。 修改创建弹性云服务器。 2019-05-23 第二十三次正式发布。 新增 标签类型介绍 批量添加云服务器标签 批量删除云服务器标签 按标签查询云服务器列表 按标签查询云服务器数量 查询项目标签 查询云服务器标签 修改 API手册结构调整，优化使用前必读、如何调用API。 2019-04-30 第二十二次正式发布。 新增 创建FPGA镜像 修改 错误码，新增错误码Ecs.0119、Ecs.0027、Ecs.0028。 查询云服务器详情列表，修改offset参数描述。 2018-12-30 第二十一次正式发布。 新增创建云服务器 新增变更云服务器规格 修改删除云服务器 修改批量修改弹性云服务器 修改批量启动云服务器 修改批量重启云服务器 修改批量关闭云服务器 错误码，新增错误码。 修改权限和授权项，新增“授权项作用域”。 修改查询浮动IP资源池列表（废弃），修改接口约束。 2018-11-30 第二十次正式发布。 新增批量重置弹性云服务器密码 新增批量修改弹性云服务器 修改错误码，新增错误码。 修改查询FPGA镜像详情列表，URI中新增fpga_image_id查询参数。 修改查询FPGA镜像详情列表，新增log_directory字段。 修改查询关联列表，新增log_directory字段。 2018-11-19 第十九次正式发布。 支持竞价实例。涉及如下内容修改： 修改创建云服务器（按需），新增参数“marketType”和“spotPrice”。 修改查询租户配额，新增参数“maxTotalSpotInstances”、“maxTotalSpotCores”、“maxTotalSpot RAM Size”、“totalSpotInstancesUsed”、“totalSpotCoresUsed”和“totalSpotRAMUsed”，并修改响应样例。 修改错误码，新增错误码Ecs.0702、Ecs.0703、Ecs.0704、Ecs.0705。 2018-10-30 第十八次正式发布。 修改错误码，新增错误码Ecs.0018、Ecs.0019。 新增查询云服务器规格变更支持列表（废弃） 修改创建云服务器（按需）和创建云服务器的“description”字段，补充校验规则。 2018-09-25 第十七次正式发布。 本次变更说明如下：查询租户配额 新增查询云服务器详情 新增查询云服务器详情列表 2018-07-30 第十六次正式发布。 本次变更说明如下： 修改切换弹性云服务器操作系统（安装Cloud-init）和切换弹性云服务器操作系统（未安装Cloud-init），修改约束限制，重装操作系统失败后，支持切换操作系统。 优化文档大纲。 2018-07-04 第十五次正式发布。 本次变更说明如下： 修改创建云服务器（按需），修改字段adminPass的用法。 修改创建云服务器（按需），修改字段name的取值范围。 新增一键重置云服务器密码（废弃） 2018-05-25 第十四次正式发布。 本次变更说明如下： 新增权限和授权项，支持策略授权功能。 2018-04-30 第十三次正式发布。 本次变更说明如下： 支持v2.1版本的原生接口。 修改创建云服务器（按需），创建弹性云服务器时购买的弹性IP，该弹性IP支持使用共享带宽。 修改错误码，补充2个包年/包月错误码。 2018-03-30 第十二次正式发布。 本次变更说明如下： 新增查询弹性云服务器磁盘信息（废弃） 新增查询弹性云服务器单个磁盘信息（废弃） 修改弹性云服务器卸载磁盘，增加参数delete_flag，支持强制卸载数据盘。 修改创建云服务器（按需），增加参数isAutoRename，弹性云服务器的名称允许重名。 2018-03-03 第十一次正式发布。 本次变更说明如下： 修改重装弹性云服务器操作系统（安装Cloud-init）、切换弹性云服务器操作系统（安装Cloud-init）、重装弹性云服务器操作系统（未安装Cloud-init）和切换弹性云服务器操作系统（未安装Cloud-init）的adminpass字段描述。 2018-02-08 第十次正式发布。 本次变更说明如下： 修改创建云服务器（按需）的各字段描述。 修改创建云服务器（按需），新增字段snapshotId。 修改查询指定云服务器安全组列表 修改创建快照（废弃）的响应样例 修改查询快照（废弃）的响应样例 2017-10-18 第九次正式发布。 本次变更说明如下： 新增OpenStack原生接口。 新增重装弹性云服务器操作系统（未安装Cloud-init）。 新增切换弹性云服务器操作系统（未安装Cloud-init）。 新增云服务器网卡配置虚拟IP地址（废弃）。 新增云服务器网卡解绑虚拟IP地址（废弃）。 修改FPGA逻辑文件管理。 2017-08-14 第八次正式发布。 本次变更说明如下： 新增添加安全组。 新增移除安全组。 新增FPGA逻辑文件管理。 修改创建云服务器（按需）中“root_volume”字段数据结构说明，新增“size”字段。 修改查询云服务器详情列表中“security_groups”字段数据结构说明。 修改查询云服务器规格详情中“security_groups”字段数据结构说明。 修改创建和导入SSH密钥，修改private_key的字段说明，更新请求样例、响应样例。 2017-06-01 第七次正式发布。 本次变更说明如下： 修改创建云服务器（按需）的“data_volumes”字段说明：新增“shareable”字段、“multiattach”字段和“hw:passthrough”字段。 修改查询规格详情和规格扩展信息列表，新增字段“ecs:generation”和“ecs:virtualization_env_types”。 修改错误码，新增错误码“Ecs.0219 创建云服务器失败”。 2016-11-28 第六次正式发布。 本次变更说明如下： 修改创建云服务器（按需），新增“adminpass”的密码复杂度要求。 支持Cloudinit特性。 2016-09-12 第五次正式发布。 本次变更说明如下： 修改查询云服务器规格详情列表，新增查询云服务器规格时可选的查询检索参数。 修改添加云服务器网卡，新增“fixed_ips”字段。 修改查询租户配额，修改“maxSecurityGroups”和“maxSecurityGroupRules”的说明项。 2016-08-25 第四次正式发布。 本次变更说明如下： 修改弹性云服务器监控指标说明，新增“带外网络流入速率”和“带外网络流出速率”两个监控指标。 修改弹性云服务器监控指标说明，更新各监控指标的备注信息。 2016-07-10 第三次正式发布。 本次变更说明如下： 修改创建云服务器（按需）参数信息。 修改删除云服务器参数信息。 修改批量关闭云服务器os-stop字段信息。 修改查询规格详情和规格扩展信息列表参数信息。 修改查询任务的执行状态的“响应样例”。 修改错误码。 2016-01-26 第二次正式发布。 本次变更说明如下： 修改“请求签名流程”，更新了SDK jar包和签名过程。 修改“示例代码”，优化代码。 修改“公共请求消息头”，新增消息头，部分消息头更改为非必选。 新增“云服务器挂载磁盘”。 新增“云服务器卸载磁盘”。 新增“弹性云服务器监控指标说明”。 修改原生API URI中版本号为v2。 2015-10-15 第一次正式发布。

响应示例 响应示例请参见 响应（批量操作类）所示。 { "response": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12" } ] }

请求消息 请求参数如表2所示。 表2 请求参数 参数 参数类型 是否必选 描述 name String 是 弹性云服务器修改后的名称。 规则如下： 只能由中文字符、英文字母、数字及“_”、“-”、“.”组成，且长度为[1-128]个英文字符或[1-64]个中文字符。 批量修改弹性云服务器名称时，名不会自动按序增加数字尾缀。例如： 三个ECS的名称为test_0001，test_0002，test_0003，批量修改弹性云服务器名称为develop，则修改后3个弹性云服务器名称为develop，develop，develop。 dry_run Boolean 否 是否只预检此次请求。 true：发送检查请求，不会修改云服务器名称。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回正常响应信息。 响应结构请参见 7.5.1 响应 所示。 false：发送正常请求，通过检查后并且执行修改云服务器名称的请求。 默认值：false servers Array of objects 是 待修改的弹性云服务器ID信息，详情请参见 表3。 表3 servers字段数据结构说明 参数 参数类型 是否必选 描述 id String 是 弹性云服务器ID。

请求示例 批量修改ID为“260a0917-f7df-4b25-93ac-950da6c6b5d6”和“f6d8df1a-e257-48e2-b617-1dd92ced8c20”的云服务器的名称为“new-server-name”。 PUT https://{endpoint}/v1/{project_id}/cloudservers/server-name { "name": "new-server-name", "dry_run": false, "servers": [ { "id":"260a0917-f7df-4b25-93ac-950da6c6b5d6" }, { "id":"f6d8df1a-e257-48e2-b617-1dd92ced8c20" } ] }

响应示例 { "server": { "tenant_id": "66c860cb130b465fbafcdee43fb09c64", "image": "", "accessIPv4": "", "addresses": { "01d7aef8-442b-408e-b82f-13afff51e4e4": [ { "addr": "192.168.26.22", "version": 4 } ] }, "metadata": { "virtual_env_type": "FusionCompute" }, "description": "", "accessIPv6": "", "created": "2019-04-25T11:52:53Z", "OS-EXT-SRV-ATTR:user_data": "", "hostId": "57d278e7c53d07cd34fad3ba4fdc9f3d779017d0879726d83b45a22a", "OS-EXT-SRV-ATTR:hostname": "new-test-hostname", "flavor": { "links": [ { "rel": "bookmark", "href": "https://None/66c860cb130b465fbafcdee43fb09c64/flavors/s2.large.2" } ], "id": "s2.large.2" }, "OS-DCF:diskConfig": "MANUAL", "user_id": "f88581d53be64716a985c66ca28c75f6", "name": "new-test-hostname", "progress": 0, "links": [ { "rel": "self", "href": "https://None/v2/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0" }, { "rel": "bookmark", "href": "https://None/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0" } ], "id": "24930df0-db4c-4a8b-8914-d0bd558564b0", "updated": "2019-04-28T08:15:36Z", "status": "ACTIVE" } }

功能介绍 表1 功能介绍 功能 说明 业务开通 企业认证的华为云账号即可一键开通，用户无需关注底层资源，开箱即用，按API调用次数收费。 存证管理 基于API方式添加存证，将文件（包括图片、音视频、网页等）的哈希值上链存储。 提供生成并下载存证证书的功能。 用户可根据存证ID、存证名称等字段对已有存证快速检索。 支持用户按照小时、天、周、月粒度的存证使用量的概览统计。 存证核验 华为云租户无需登录，即可在华为云官网产品页的证据核验框对已经上链的证据进行核验和查询。 通过上传证据文件或输入证据指纹，可核验比对是否与链上证据一致。 存证查询 华为云租户无需登录，在华为云官网产品页的存证查询框处输入存证ID，可查询对应存证相关信息。 图1 新增存证 图2 存证核验 图3 存证查询

相关计费 表2 计费说明 计费项 收费标准 说明 开通可信存证 免费。 开通前需进行企业认证。 调用次数 套餐包 1个计费周期内，普通存证每满10次接口调用，扣除1次套餐包次数，不满10次不扣费。 计算公式：套餐包次数=总调用次数/10的结果取整数部分数值。例如调用19次，则扣除1次套餐包次数，19/10=1.9，取整数算1次；调用25次，则扣除2次套餐包次数，25/10=2.5，取整数算2次；以此类推。 华为云租户开通可信存证后即可调用新增存证接口完成证据上链，按调用次数收费。 计费周期为每个小时的整点开始（北京时区），如09：50在11：00之间总共调用了31次，其中11次调用发生在09：50-10：00，20次调用发生在10：00 - 11：00。则您在费用账单中会看到两次明细记录，记录1：消费时间09：00 - 10：00，套餐包使用1次=11除以10的结果取整数1；记录2：消费时间10：00-11：00，套餐包使用2次=21除以10的结果取整数2。 按需计费 1个计费周期内，普通存证每满10次接口调用，扣除1次按需费用，3元/次，不满10次不扣费。 计算公式：按需计费的次数=总调用次数/10的结果取整数部分数值。例如调用19次，则扣除1次按需费用，19/10=1.9，取整数算1次；调用25次，则扣2次按需费用，25/10=2.5，取整数算2次；以此类推。 当您的账号处于欠费冻结状态时，无法完成存证上链接口的调用；请您及时充值，以免您的业务功能受到影响。充值后待账号解冻后，您可以继续使用存证接口调用。 扣费顺序优先使用套餐包，如果套餐包用完，则按需计费。套餐包相对划算，建议您保持充足的套餐包余量。 计费采用华为云服务通用的后扣费模式，即您本周期内产生的调用次数会在下一个周期内进行扣费，扣费周期为1小时，扣费周期起始时间为每小时整点。请您根据业务使用情况预估使用额度，提前充值，防止因欠费冻结而导致您的业务受损。 您的扣费记录在账单中有记录，可以在华为云账号的控制台界面，“费用与成本”- “账单管理” - “流水和明细账单”下进行查看。

什么是数字资产链 数字资产链（Digital Asset Chain，简称DAC）是华为云自研的数字资产链平台，基于华为云 区块链 引擎，可实现数字资产的确权、可信保存、安全交易。 数字资产链的使用方式分为两种：共享版和专享版。 共享版与专享版的区别与联系如下： 共享版的用户共用一条数字资产链，在同一条数字资产链上进行资产交易活动。开通共享版数字资产链请参考开通共享版。 专享版针对不同资产交易业务可创建多个单独非共享的数字资产链，各业务间互不干扰，业务的专业性更强。购买专享版数字资产链请参考创建数字资产链。 购买专享版数字资产链节点后，默认按需计费，可选择是否购买套餐包进行抵扣； 开通共享版数字资产链后，必须购买套餐包才支持调用。详细费用和购买套餐包方法请参考计费说明和购买套餐包。 共享版和专享版可同时购买使用。 当前仅“华北-北京四”区域支持数字资产链。 父主题： 数字资产链

DAC权限 默认情况下，新建的 IAM 用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 DAC部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华北-北京四）对应的项目（cn-north-4）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问DAC时，需要先切换至授权区域。 如下表所示，包括了DAC的所有系统权限。 表1 DAC系统权限 系统权限 权限描述 权限类别 Tenant Administrator 全部云服务管理员（除IAM管理权限） 系统角色 Tenant Guest 全部云服务只读权限（除IAM权限） 系统角色

计费说明 数字资产链的费用包含以下两项： 表1 计费说明 计费项 收费标准 说明 开通共享版 免费。 开通前需进行企业认证。 购买专享版数字资产链节点 包年包月（节点）4个数字资产链节点15,000元/月。 购买专享版数字资产链扣除的包年包月费用。 调用次数 按需计费 共享版 未购买套餐包，不支持调用。 购买套餐包后，使用超出部分按需扣费，3元/次。 专享版 2元/次。 共享版未购买套餐包，暂不支持调用。套餐包到期或者用完后，会有5分钟业务连续性保护，此时按需计费。 说明： 当套餐包余额不足以支付当前调用时，调用会失败。系统会提示用户及时续费，此时请您续费后再执行调用操作。 购买共享版套餐包后，由于系统内部机制限制，会有5分钟左右的延迟，所以购买或续费套餐包后请等待5分钟后再开始调用。 专享版已购买数字资产链但未购买套餐包，此时按需计费。 说明： 调用次数单独计费，该费用不包含在购买数字资产链的费用中。 套餐包计费 支持以下几种规格： 共享版 100次/月套餐包为200元 1万次/年套餐包为15,000元 10万次/年套餐包为130,000元 50万次/年套餐包为500,000元 专享版 1万次/年套餐包为12,000元 10万次/年套餐包为100,000元 50万次/年套餐包为400,000元 购买套餐包后，先扣除已经购买的套餐包额度，超出部分按使用次数进行按需计费。 共享版 以下接口会扣除调用次数，其余接口不扣除调用次数。 租户下的资产首次发生所有权转移后（包括转移数字资产所有权、加入可组合资产、拆分子资产给用户、拆分子资产给其它可组合资产操作）计入1次费用，随后该资产的转移次数计入租户的调用量池，调用量池中的全局资产每小时（每天北京时间00:00起算）统计转移次数，每5次计1次，不满5次的部分算1次。 创建数字资产集合 修改集合信息 铸造数字资产 销毁数字资产 监管者注销数字资产 转移数字资产所有权 设置数字资产授权用户 设置集合级授权用户 批量铸造数字资产(每100个计1次，不满100的部分算1次，例如，铸造4180个算42次) 批量转移数字资产所有权(每100个计1次，不满100的部分算1次，例如，流转4180个算42次) 设置用户级授权用户 设置资产流转限制 铸造可组合资产 加入可组合资产 拆分子资产给用户 拆分子资产给其它可组合资产 数字资产链存储增强（租户上传一次计一次费，每上传一次可免费下载200次，超过200次后每200次扣一次调用次数。） 专享版 专享版数字资产链开通合约模板后，将会统计每小时专享版收费接口次数，每5次接口调用计1次套餐包用量，不满5次的部分算1次套餐包用量。 专享版数字资产链未开通合约模板，按次数收费。 以下接口会扣除调用次数，其余接口不扣除调用次数。 铸造数字资产 批量铸造数字资产 转移数字资产所有权 批量转移数字资产所有权 铸造可组合资产 加入可组合资产 拆分子资产给用户 拆分子资产给其它可组合资产 版权存证接口 父主题： 数字资产链

数字资产版权保护 数字资产版权保护服务是由华为和中国版权保护中心合作，按照《中华人民共和国著作权法》、“数字版权唯一标识符”标准及相关规定，利用区块链和大数据、人工智能等技术，对数字资产版权进行保护，登记成功的版权信息和版权权属确认信息将会保存在区块链中，保证所有的版权信息可信、可回溯。 图1 数字资产版权保护 便捷接入：支持多语言SDK接入数字资产版权保护服务，支持图片、文章、视频、音频等形式的原创数字作品的版权保护。 高效率确权：由用户发起，利用大数据等技术对数字作品信息和权属信息进行校验。数字版权登记成功后，可获得由中国版权保护中心分配的数字版权唯一标识符。 清晰化授权：面向三方内容版权交易平台，开放授权发码上链（授权范围、时长等）、权属查询等能力，使版权交易流转过程更清晰可循，更具公信力。 标准化维权：利用爬虫及大数据技术为互联网法院、版权纠纷处理中心、律师、内容平台提供侵权监测、证据固证、版权鉴定等能力，快速解决版权纠。

数字资产存储能力增强，且具备 内容审核 能力 多语言SDK提供丰富的资产存储管理接口，支持图片、视频、音频、3D模型、文本等富媒体的一键存储。安全、高可靠、类型丰富，无需考虑容量限制。 基于深度学习和大样本库的内容审核能力，支持对图片、文本、视频进行涉黄、广告、涉暴等内容的自动检测，帮助客户降低业务违规风险。 CND全球稳定加速，将数字资产对应富媒体内容分发至靠近用户的加速节点，使用户可以就近获得所需的内容，提高用户访问的响应速度，提升业务使用体验。 图2 数字资产存储能力增强

产品功能 数字资产链服务支持以下功能： 表1 功能说明 规格 功能 说明 共享版 业务调用 通过SDK完成数字资产链的业务调用。 服务运营 查看API调用的统计监控，实时查看数字资产链实例的API调用、数字资产集合、数字资产发行、数字资产流转等相关数据。请参见图1。 资产检索 通过资产编码查看资产及资产所在集合的相关信息以及流转记录，如资产编码、集合名称、集合缩写、资产名称、资产类型、资产所有者地址、资产铸造者地址、铸造时间、转移时间、所在区块高度、交易hash值、销毁时间、销毁hash值等。请参见图2和图3。 说明： 销毁的资产，检索时不展示资产信息，只展示流转记录。 图中数据为测试数据，仅供参考。 数字资产浏览器 数字资产共享版浏览器，支持用户在未登录的情况下，查看共享版区块链中数字资产总发行数量、数字资产总流转次数、区块高度、总交易数等信息。同时也可以根据资产编码、交易哈希、区块哈希等值搜索对应数字资产详细信息、区块信息、交易信息以及流转记录等。请参见图4。 专享版 链管理 实时查看数字资产链实例运行状况，对实例做相应的操作。请参见图5。 单击实例名称可以查看实例的节点资源、网络分布及查询区块和交易信息。 资产管理 实时查看数字资产链实例的API调用、数字资产集合、数字资产发行、数字资产流转等相关数据。请参见图6。 合约仓库 统一展示和管理合约模板能力。请参见图7。 图1 共享版服务运营 图2 正常资产检索信息及流转记录 图3 销毁资产检索流转记录 图4 数字资产浏览器 图5 链概览 图6 专享版服务运营 图7 合约仓库 父主题： 数字资产链

创建用户并授权使用DAC 如果您需要对您所拥有的DAC进行精细的权限管理，您可以使用 统一身份认证 服务（Identity and Access Management，简称IAM），通过IAM，您可以： 根据企业的业务组织，在您的华为账号中，给企业中不同职能部门的员工创建IAM用户，让员工拥有唯一安全凭证，并使用DAC资源。 根据企业用户的职能，设置不同的访问权限，以达到用户之间的权限隔离。 将DAC资源委托给更专业、高效的其他华为账号或者云服务，这些账号或者云服务可以根据权限进行代运维。 如果华为账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用DAC服务的其它功能。 本章节为您介绍对用户授权的方法，操作流程如图1所示。 前提条件 给用户组授权之前，请您了解用户组可以添加的DAC权限，并结合实际需求进行选择，DAC支持的系统权限，请参见：DAC系统权限。若您需要对除DAC之外的其它服务授权，IAM支持服务的所有权限请参见系统权限。 示例流程 图1 给用户授权服务权限流程 创建用户组并授权 在IAM控制台创建用户组，并授予数字资产链服务权限“Tenant Administrator”。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，切换至授权区域，验证权限。 父主题： 权限管理

操作步骤 登录DAC管理控制台，在页面左上方选择区域。 单击左侧导航栏的“套餐包管理”。 在“套餐包管理”页面查看套餐包详情。 图1 套餐包统计 在“套餐包统计”栏，可通过饼状图查看您当前有效套餐包的总量，已使用量及剩余可调用量，左侧显示数字资产共享版/可信存证总次数的数据，右侧显示数字资产专享版总次数的数据，显示数值与实际使用数据存在15分钟左右延迟，仅供业务参考。 在“套餐包详情”栏，可查看您购买过的套餐包的规格、状态、剩余量/总量、生效时间和到期时间。显示数值与实际使用数据存在约1小时延迟，与费用中心的实际账单一致。 单击，可刷新套餐包详情数据。

入门指引 数字资产链提供创建数字资产链、发起数字资产交易等功能。DAC服务的使用流程如下所示。 当前仅“华北-北京四”区域支持数字资产链服务。 图1 专享版使用流程 创建数字资产链 创建数字资产链，配置链基本参数。 购买套餐包 购买专享版套餐包，体验专享版资产链。 应用开发 下载链实例对应SDK配置和证书进行资产链对接。 发起数字资产交易 通过接口触发数字资产发行、流转，并记录到区块中。 浏览交易信息 查看数字资产链的区块、交易等信息。 父主题： 数字资产专享版

调用示例 // 触控数据结构体 struct InputTouch { uint8_t pointerID; uint8_t orientation; uint8_t action; uint16_t pressure; uint16_t touchX; uint16_t touchY; uint16_t physicalWidth; uint16_t physicalHeight; int32_t touchTime; uint8_t reserved[16]; // 保留字段 }; InputTouch inputTouch; inputTouch.pointerID = 0; inputTouch.orientation = 0; inputTouch.action = 0; // ACTION_DOWN inputTouch.pressure = 129; inputTouch.physicalWidth = 720; inputTouch.physicalHeight = 1280; inputTouch.touchX = 52; inputTouch.touchY = 157; inputTouch.touchTime = 0; int ret = InjectTouchData(inputTouch); //注意 要确保数据类型是本地字节序，数据来自网络则需要使用ntohl()方法进行本地字节序转换

输入参数 表1 输入参数说明 参数名称 说明 inputTouch 触控注入参数结构体，详见表2。 表2 触控注入参数结构体说明 参数名称 参数类型 说明 pointerID number 真机触点编号，多指触控下会有多个触点，取值范围[0,9]，即最多支持10个触点。 orientation number 真机屏幕旋转角度，默认为0，可设置为1(90°)，2(180°), 3(270°)。 action number 真机触控行为，如ACTION_DOWN, ACTION_UP，取值范围请参考：https://developer.android.com/reference/android/view/MotionEvent pressure number 真机触控压力值，默认为129。 physicalWidth number 真机屏幕分辨率宽，默认为0，取值范围[0,2160]。 physicalHeight number 真机屏幕分辨率高，默认为0，取值范围[0,4096]。 touchX number 真机触点坐标，取值范围[0,physicalWidth]。 touchY number 真机触点坐标，取值范围[0,physicalHeight]。 touchTime number 真机触控时间与上一次ACTION_DOWN时间的偏移量。 真机端触控事件的采集方式，详见端云协同的端侧SDK开源代码：端云协同的端侧SDK。 真机端触控事件采集相关代码，请参考：onTouch方法。

模板约束与限制 使用 RFS 服务进行模板部署，模板文件内容具有如下约束与限制： 不能使用Provisioners功能和Backend Configuration功能。 可以使用Module Sources功能，但仅支持Local Modules。 可以使用HuaweiCloud Provider，但Provider内部分资源禁止使用。具体清单列举如下： huaweicloud_vod_watermark_template huaweicloud_compute_keypair huaweicloud_identity_access_key huaweicloud_images_image_v2 huaweicloud_kps_keypair huaweicloud_obs_bucket_object huaweicloud_iotda_batchtask huaweicloud_cce_chart huaweicloud_iotda_batchtask_file 部分函数禁止使用。具体清单列举如下： abspath basename dirname file filebase64 filebase64sha256 filebase64sha512 fileexists fileset filemd5 filesha1 filesha256 filesha512 pathexpand templatefile 父主题： 资源编排