华为云用户手册

部署Docker 登录弹性云服务器。 为了更好的获取和更新系统和软件，建议您更新镜像源为华为云镜像源，详细操作，请参见如何使用华为云提供的epel镜像源(x86_64和ARM)？。 添加yum源。 yum install epel-release -y yum clean all 安装yum-util。 yum install -y yum-utils device-mapper-persistent-data lvm2 设置docker yum源。 yum-config-manager --add-repo https://mirrors.huaweicloud.com/docker-ce/linux/centos/docker-ce.repo sed -i 's+download.docker.com+mirrors.huaweicloud.com/docker-ce+' /etc/yum.repos.d/docker-ce.repo 安装并运行Docker。 yum -y install docker-ce systemctl enable docker systemctl start docker 检查安装结果。 docker --version 回显如下类似信息，表示Docker安装成功。 Docker version 26.1.4, build 5650f9b

请求示例 使用上传至OBS桶的外部镜像文件制作系统盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为tags。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "type": "E CS ", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用上传至OBS桶的外部镜像文件制作系统盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为image_tags。 1 2 3 4 5 6 7 8 9 10 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "type": "ECS", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } 使用上传至OBS桶的外部镜像文件制作数据盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为tags。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_type": "Linux", "min_disk": 40, "type": "DataImage", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用上传至OBS桶的外部镜像文件制作数据盘镜像，其中，OBS桶中外部镜像文件地址为“ims-image:centos70.zvhd2”，镜像标签数据格式为image_tags。 1 2 3 4 5 6 7 8 9 10 POST https://{Endpoint}/v2/cloudimages/quickimport/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.zvhd2", "os_type": "Linux", "min_disk": 40, "type": "DataImage", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }

功能介绍 使用上传至OBS桶中的超大外部镜像文件制作私有镜像，目前仅支持RAW或ZVHD2格式镜像文件。且要求镜像文件大小不能超过1TB。 由于快速导入功能要求提前转换镜像文件格式为RAW或ZVHD2格式，因此镜像文件小于128GB时推荐您优先使用常规的创建私有镜像的方式。 作为异步接口，调用成功，只是说明后台收到了制作请求，镜像是否制作成功需要通过异步任务查询接口查询该任务的执行状态，具体请参考异步任务查询。

请求示例 更新镜像名称为ims_test。 1 2 3 4 5 6 7 8 PATCH https://{Endpoint}/v2/cloudimages/33ad552d-1149-471c-8190-ff6776174a00 [ { "op": "replace", "path": "/name", "value": "ims_test" } ]

响应消息 响应参数 参数 参数类型 描述 file String 镜像文件下载和上传链接。 owner String 镜像属于哪个租户。 id String 镜像ID。 size Long 目前暂时不使用。 self String 镜像链接信息。 schema String 镜像视图。 status String 镜像状态。取值如下： queued：表示镜像元数据已经创建成功，等待上传镜像文件。 saving：表示镜像正在上传文件到后端存储。 deleted：表示镜像已经删除。 killed：表示镜像上传错误。 active：表示镜像可以正常使用。 tags Array of strings 镜像标签列表，提供用户可以自定义管理私有镜像的能力。用户可以通过镜像标签接口为每个镜像增加不同的标签，在查询接口中可以根据标签进行过滤。 visibility String 是否被其他租户可见。取值如下： private：私有镜像 public：公共镜像 shared：共享镜像 name String 镜像名称。name参数说明请参考镜像属性。 checksum String 目前暂时不使用。 protected Boolean 是否是受保护的，受保护的镜像不允许删除。取值为true或false。 container_format String 容器类型。 min_ram Integer 镜像运行需要的最小内存，单位为MB。参数取值依据云服务器的规格限制，默认设置为0。 云服务器的规格限制，请参见规格清单。 max_ram String 镜像支持的最大内存，单位为MB。参数取值可以参考云服务器的规格限制，默认不设置。 云服务器的规格限制，请参见规格清单。 updated_at String 更新时间。格式为UTC时间。 __os_bit String 操作系统位数，一般取值为“32”或者“64”。 __os_version String 操作系统具体版本。 __description String 镜像描述信息。_description参数说明请参考镜像属性。 disk_format String 镜像格式，目前支持zvhd2、vhd、zvhd、raw、qcow2、iso。非iso格式时默认值是zvhd2。 __isregistered String 是否是注册过的镜像，取值为“true”或者“false”。 __platform String 镜像平台分类，取值为Windows、Ubuntu、Red Hat、SUSE、CentOS、Debian、OpenSUSE、Oracle Linux、Fedora、Other、CoreOS、EulerOS。 __os_type String 操作系统类型，目前取值Linux、Windows、Other。 __system__cmkid String 加密镜像所使用的密钥ID。 min_disk Integer 镜像运行需要的最小磁盘容量，单位为GB 。linux操作系统取值为10～1024GB，Windows操作系统取值为20～1024GB。 virtual_env_type String 镜像使用环境类型：FusionCompute、Ironic、DataImage、IsoImage。 如果是云服务器镜像（即系统盘镜像），则取值为FusionCompute。 如果是数据盘镜像，则取值是DataImage。 如果是裸金属服务器镜像，则取值是Ironic。 如果是ISO镜像，则取值是IsoImage。 __image_source_type String 镜像后端存储类型，目前只支持uds。 __imagetype String 镜像类型，目前支持： 公共镜像（gold） 私有镜像（private） 共享镜像（shared） 市场镜像（market） created_at String 创建时间。格式为UTC时间。 __image_displayname String 对外展示名称。 virtual_size Integer 目前暂时不使用。 __originalimagename String 父镜像ID。 公共镜像或通过文件创建的私有镜像，取值为空。 __backup_id String 备份ID。如果是备份创建的镜像，则填写为备份的ID，否则无此参数。 __productcode String 市场镜像的产品ID。 __image_size String 镜像文件的大小，单位为字节。必须大于0。 __data_origin String 镜像来源。 公共镜像为空。 __root_origin String 表示当前镜像来源是从外部导入。取值：file。 __lazyloading String 镜像是否支持延迟加载。取值为true、false、True或False。 active_at String 镜像状态变为正常的时间。 __os_feature_list String 镜像附加属性。该属性采用JSON格式来标识镜像支持的高级特性清单。 __account_code String 收费镜像标识。 hw_firmware_type String 云服务器的启动方式。目前支持： bios：表示bios引导启动。如果无此参数，表示bios启动方式。 uefi：表示uefi引导启动。 说明： 当镜像的架构类型为ARM时，启动方式只支持uefi。 hw_vif_multiqueue_enabled String 镜像是否支持网卡多队列。取值为“true”或者“false”。 __support_kvm String 如果镜像支持KVM，取值为true，否则无需增加该属性。 __support_xen String 如果镜像支持XEN，取值为true，否则无需增加该属性。 __support_largememory String 表示该镜像是否支持超大内存特性。如果镜像支持超大内存，取值为true，否则无此属性。 镜像操作系统类型请参考“弹性云服务器类型与支持的操作系统版本”。 __support_diskintensive String 表示该镜像是否支持密集存储性特性。如果镜像支持密集存储性能，则值为true，否则无此属性。 __support_highperformance String 表示该镜像是否支持高计算性能的特性。如果镜像支持高计算性能，则值为true，否则无此属性。 __support_xen_gpu_type String 表示该镜像是支持XEN虚拟化平台下的GPU类型，取值参考表2。如果不支持，则无此属性。该属性与“__support_xen”和“__support_kvm”属性不共存。 __support_kvm_gpu_type String 表示该镜像是支持KVM虚拟化平台下的GPU类型，取值参考表3。 如果不支持，则无此属性。该属性与“__support_xen”和“__support_kvm”属性不共存。 __support_xen_hana String 如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无此属性。 该属性与“__support_xen”和“__support_kvm”属性不共存。 __support_kvm_infiniband String 如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无此属性。 该属性与“__support_xen”属性不共存。 __system_support_market Boolean 表示当前镜像是否支持发布为市场镜像。 true：支持 false：不支持 __is_offshelved String 表示当前市场镜像是否下架。 true：已下架 false：未下架 enterprise_project_id String 表示当前镜像所属的企业项目。 取值为0或无该值，表示属于default企业项目。 取值为UUID，表示属于该UUID对应的企业项目。 关于企业项目特性的详细信息，请参考“企业中心总览”。 __sequence_num String 表示当前镜像对应云服务器的系统盘插槽位置。 目前暂不使用。 __support_fc_inject String 表示当前镜像支持Cloud-Init密码/密钥注入方式。 如果取值为“true”，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。 说明： 该特性参数只对ECS系统盘镜像生效，其他类型镜像不生效。 __support_arm String 是否为ARM架构类型的镜像。取值为“true”或者“false”。 __support_agent_list String 镜像是否支持主机安全或主机监控。 hss：主机安全 ces：主机监控 取值样例： "__support_agent_list": "hss,ces" 说明： 如果查询结果无此字段，表示镜像不支持主机安全或主机监控。 __support_amd String 是否是AMD架构类型的镜像。取值为“true”或者“false”。 __support_kvm_hi1822_hisriov String 如果镜像支持sriov直通，取值为true，否则无需增加该属性。 __support_kvm_hi1822_hivirtionet String 如果镜像支持Virtio-net直通规格，取值为true，否则无需增加该属性。 响应样例 STATUS CODE 200 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 { "file": "/v2/images/33ad552d-1149-471c-8190-ff6776174a00/file", "owner": "0b1e494e2660441a957313163095fe5c", "id": "33ad552d-1149-471c-8190-ff6776174a00", "size": 2, "self": "/v2/images/33ad552d-1149-471c-8190-ff6776174a00", "schema": "/v2/schemas/image", "status": "active", "tags": [], "visibility": "private", "name": "ims_test", "checksum": "99914b932bd37a50b983c5e7c90ae93b", "hw_vif_multiqueue_enabled": "true", "protected": false, "container_format": "bare", "min_ram": 0, "updated_at": "2015-12-08T02:30:49Z", "__os_bit": "64", "__os_version": "Ubuntu 14.04 server 64bit", "__description": "ims test", "disk_format": "vhd", "__isregistered": "true", "__platform": "Ubuntu", "__os_type": "Linux", "min_disk": 40, "virtual_env_type": "FusionCompute", "__image_source_type": "uds", "__imagetype": "private", "created_at": "2015-12-04T09:45:33Z", "virtual_size": 0, "__originalimagename": "33ad552d-1149-471c-8190-ff6776174a00", "__backup_id": "", "__productcode": "", "__image_size": "449261568", "__support_fc_inject":"true", "__data_origin": null, "hw_firmware_type": "bios" }

请求消息 请求参数 参数 是否必选 参数类型 描述 [数组] 是 Array of objects 详情请参见表2。 表2 [数组]字段说明 参数 是否必选 参数类型 描述 op 是 String 操作类型，目前取值为add、replace和remove。 path 是 String 需要操作的属性名称，需要在属性名称前加“/”。 目前用户可以修改以下属性： name：镜像名称。 __description：镜像描述。 __support_kvm：支持kvm虚拟化。 __support_xen：支持xen虚拟化。 __support_largememory：表示该镜像支持超大内存。如果镜像支持超大内存，取值为true，否则无需增加该属性。 __support_diskintensive：支持密集存储。 __support_highperformance：支持高性能计算。 __support_xen_gpu_type：支持xen虚拟化gpu类型。 __support_kvm_gpu_type：支持kvm虚拟化gpu类型。 __support_xen_hana：如果镜像支持XEN虚拟化下HANA类型，取值为true。否则，无需添加该属性。该属性与“__support_xen”和“__support_kvm”属性不共存。 __is_config_init：是否完成初始化配置。 enterprise_project_id：企业项目ID。 min_ram：镜像支持的最小内存，单位为MB。取值可以参考云服务器规格限制，一般不设置。 max_ram：镜像支持的最大内存，单位为MB。取值可以参考云服务器规格限制，一般不设置。 hw_vif_multiqueue_enabled：支持网卡多队列。 hw_firmware_type：启动方式，取值为bios或uefi。 __support_kvm_infiniband：如果镜像支持KVM虚拟化下Infiniband网卡类型，取值为true。否则，无需添加该属性。该属性与“__support_xen”属性不共存。 __support_fc_inject：表示当前镜像支持Cloud-Init密码/密钥注入方式。如果取值为“true”，表示该镜像不支持Cloud-Init注入密码/密钥，其他取值时表示支持Cloud-Init注入密钥/密码。 __support_amd：是否是AMD架构类型的镜像。取值为“true”或者“false”。 __support_kvm_hi1822_hisriov：如果镜像支持sriov直通，取值为true，否则无需增加该属性。 __support_kvm_hi1822_hivirtionet：如果镜像支持Virtio-net直通规格，取值为true，否则无需增加该属性。 用户可以自定义添加或者删除一些自有的扩展属性。 value 是 String 需要操作的属性的值。参数说明请参考镜像属性。

请求示例 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为tags，虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "云服务器制作系统盘镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用云服务器数据盘制作数据盘镜像，其中，镜像标签数据格式为tags，卷ID为“c5dfbd0c-bf0a-4798-a453-61dc6b54aa30”。 1 2 3 4 5 6 7 8 9 10 11 12 POST https://{Endpoint}/v2/cloudimages/action { "data_images": [{"name": "ims_data_image_test", "description": "云服务器数据盘制作数据盘镜像", "volume_id": "c5dfbd0c-bf0a-4798-a453-61dc6b54aa30", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] }] } 使用上传至OBS桶中的外部镜像文件制作镜像，其中，镜像标签数据格式为tags，OBS桶中外部镜像文件地址为“ims-image:centos70.qcow2”。 1 2 3 4 5 6 7 8 9 10 11 12 13 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.qcow2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用云服务器制作系统盘镜像，其中，镜像标签数据格式为image_tags，虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "云服务器制作系统盘镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "image_tags": [ { "key": "key2", "value": "value2" }, { "key": "key1", "value": "value1" } ] } 使用云服务器数据盘制作数据盘镜像，其中，镜像标签数据格式为image_tags，卷ID为“c5dfbd0c-bf0a-4798-a453-61dc6b54aa30”。 1 2 3 4 5 6 7 8 POST /v2/cloudimages/action { "data_images": [{"name": "ims_data_image_test", "description": "云服务器数据盘制作数据盘镜像", "volume_id": "c5dfbd0c-bf0a-4798-a453-61dc6b54aa30", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }] } 使用上传至OBS桶中的外部镜像文件制作镜像，其中，镜像标签数据格式为image_tags，OBS桶中外部镜像文件地址为“ims-image:centos70.qcow2”。 1 2 3 4 5 6 7 8 9 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test_file", "description": "OBS文件制作镜像", "image_url": "ims-image:centos70.qcow2", "os_version": "CentOS 7.0 64bit", "min_disk": 40, "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } 使用数据盘制作系统盘镜像，其中，镜像标签数据格式为tags，卷ID为 "877a2cda-ba63-4e1e-b95f-e67e48b6129a"。 1 2 3 4 5 6 7 8 9 10 11 12 13 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "数据盘制作系统盘镜像", "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "type": "ECS", "os_version": "CentOS 7.0 64bit", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用数据盘制作系统盘镜像，其中，镜像标签数据格式为image_tags，卷ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 1 2 3 4 5 6 7 8 9 POST https://{Endpoint}/v2/cloudimages/action { "name": "ims_test", "description": "数据盘制作系统盘镜像", "volume_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "type": "ECS", "os_version": "CentOS 7.0 64bit", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }

约束与限制 使用外部镜像文件制作镜像 外部镜像文件的限制请参见“准备镜像文件（Windows）”或“准备镜像文件（Linux）”。 使用数据盘创建系统盘镜像 使用数据盘制作系统盘镜像时，需确保该数据盘中有操作系统，且操作系统已提前完成优化步骤。如何优化，请参见优化私有镜像（Windows）和优化私有镜像（Linux）。 由于系统无法校验您在调用该接口时指定的卷是否存在操作系统，因此制作系统盘镜像时，请务必确保您输入的os_version（操作系统版本）值合法，具体请参见相关参数取值列表。

约束与限制（使用云备份制作整机镜像） 创建整机镜像前，请确保创建该云备份所属的弹性云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 每个云备份只能创建一个整机镜像。 在云服务器关机状态下，制作整机镜像的过程中，用户不能启动云服务器。 通过云备份创建的整机镜像可以共享给其他租户。但是，如果这个云备份是由其他租户共享的，那么创建的整机镜像不支持共享。 不支持将整机镜像发布为市场镜像。 不支持将整机镜像导出到本地使用。 不支持同区域内复制整机镜像。 跨区域复制整机镜像各区域存在差异，请以控制台界面显示为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。

约束与限制（使用云服务器制作整机镜像） 创建整机镜像时，请确保云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 使用Windows操作系统云服务器制作整机镜像时，不允许云服务器存在跨区卷，否则制作的整机镜像创建云服务器时可能会导致数据丢失。 使用Linux操作系统云服务器制作整机镜像时，不允许云服务器存在由多个物理卷组成的卷组、或由多个物理卷组成的逻辑卷，否则制作的整机镜像创建云服务器时可能会造成数据丢失。 带有专属分布式存储磁盘的云服务器不支持创建整机镜像。 不支持将整机镜像发布为市场镜像。 不支持将整机镜像导出到本地使用。 不支持同区域内复制整机镜像。 跨区域复制整机镜像各区域存在差异，请以控制台界面显示为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。 使用Windows操作系统云服务器制作整机镜像时，需修改云服务器SAN策略为OnlineAll类型。否则可能导致使用镜像创建云服务器时，云服务器磁盘处于脱机状态。 Windows操作系统SAN策略分为三种类型：OnlineAll、OfflineShared、OfflineInternal 表1 Windows操作系统SAN策略类型 类型 说明 OnlineAll 表示所有新发现磁盘都置于在线模式。 OfflineShared 表示所有共享总线上（比如FC、ISCSI）的新发现磁盘都置于离线模式，非共享总线上的磁盘都置于在线模式。 OfflineInternal 表示所有新发现磁盘都置于离线模式。 运行cmd.exe，执行以下命令，使用DiskPart工具来查询云服务器当前的SAN策略。 diskpart 执行以下命令查看云服务器当前的SAN策略。 san 如果SAN策略为OnlineAll，请执行exit命令退出DiskPart。 否，请执行步骤3。 执行以下命令修改云服务器SAN策略为OnlineAll。 san policy=onlineall

约束与限制（使用云服务器备份制作整机镜像） 创建整机镜像时，请确保创建该云服务器备份所属的弹性云服务器已完成相关配置，否则可能导致整机镜像创建云服务器失败。 详情请参见“创建私有镜像前云服务器、裸金属服务器或镜像文件需要完成哪些初始化配置？”。 在云服务器关机状态下，制作整机镜像的过程中，用户不能启动云服务器。 使用云服务器备份创建整机镜像时，不允许云服务器备份存在共享卷。 使用云服务器备份创建整机镜像时，云服务器备份必须是可用状态，且每个云服务器备份只能创建一个整机镜像。 不支持将整机镜像发布为市场镜像。 不支持将整机镜像导出到本地使用。 不支持同区域内复制整机镜像。 跨区域复制整机镜像各区域存在差异，请以控制台界面显示为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。

请求示例 使用云服务器制作整机镜像，其中，镜像标签数据格式为tags，虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 1 2 3 4 5 6 7 8 9 10 11 12 POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "instance_whole_image", "description": "云服务器制作镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用云服务器制作整机镜像，其中，镜像标签数据格式为image_tags，虚拟机ID为“877a2cda-ba63-4e1e-b95f-e67e48b6129a”。 1 2 3 4 5 6 7 8 POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "instance_whole_image", "description": "云服务器制作镜像", "instance_id": "877a2cda-ba63-4e1e-b95f-e67e48b6129a", "vault_id": "de9fcf45-11b2-432c-8562-5c5428574600", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] } 使用云服务器备份或云备份制作整机镜像，其中，镜像标签数据格式为tags，备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。 1 2 3 4 5 6 7 8 9 10 11 12 POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "backup_whole_image", "description": "云备份制作镜像", "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3", "whole_image_type": "CBR", "tags": [ "aaa.111", "bbb.333", "ccc.444" ] } 使用云服务器备份或云备份制作整机镜像，其中，镜像标签数据格式为image_tags，备份ID为"9b27efab-4a17-4c06-bfa2-3e0cf021d3c3"。 1 2 3 4 5 6 7 8 POST https://{Endpoint}/v1/cloudimages/wholeimages/action { "name": "backup_whole_image", "description": "云备份制作镜像", "backup_id": "9b27efab-4a17-4c06-bfa2-3e0cf021d3c3", "whole_image_type": "CBR", "image_tags": [{"key":"key2","value":"value2"},{"key":"key1","value":"value1"}] }

步骤三：获取CDN的成本分配明细 登录“成本中心”。 选择“成本分析”。 单击“导出成本明细”。 设置成本类型为“摊销成本”，并设置导出周期和范围，单击“确认”，即可导出摊销成本的明细数据。 使用%账号名%_AmortizedCostDetailByUsage_YYYY-MM文件查看CDN的成本分配明细。 其中： 企业项目：即成本归属的企业项目； 产品类型：即内容分发网络 CDN； 分拆项：即 域名 ； 使用量类型：当前仅支持对CDN的流量计费、月结95峰值带宽计费、日峰值月平均计费按照域名进行成本分拆，因此使用量类型包括中国大陆95峰值带宽、中国大陆日峰值月平均带宽、流量、海外及其它地区流量、海外及其它地区95峰值带宽、海外及其它地区日峰值月平均带宽。 使用量：当前资源的用量，按月度进行汇总后，即CDN的月度总用量。 本月分摊（基于使用）：本月分摊=使用量/月度总使用量*总费用，按月度进行汇总后，即CDN的月度总摊销费用； 标签：即成本归属的成本标签。 图1 CDN的成本分配明细1（图片较长，分2段截取） 图2 CDN的成本分配明细2

场景示例 客户需要将成本在部门A、B、C之间分配。 大部分成本可以通过客户标记在资源上的标签来标识归属的部门；另外，A部门还单独使用了内容分发网络服务（假设内容分发网络服务不支持标签管理）；所有部门共用了云手机。 已知：客户已使用成本标签来标记成本，标签键：Group；标签值：部门A，部门B，部门C。 成本单元创建4小时之后，定义拆分规则，把共同成本在组织内进行分配。 拆分未分配成本时，采用自定义拆分方式，部门A拆分50%，部门B拆分30%，部门C拆分20%。 拆分共同成本时，采用自定义拆分方式，部门A拆分30%，部门B拆分30%，部门C拆分40%。

步骤二：查看成本分配详情 登录成本中心。 选择“成本单元”。 单击成本单元名称链接，查看成本分配详情。 如上图所示，查看成本占比的摊销成本净值： 摊销成本净值：按规则分配后的摊销成本净值。 拆分金额：公共成本拆分的金额，拆分金额为负数时，表示是“拆分源”。 最终分配成本：实际分配到的金额。最终分配成本=摊销成本净值+拆分金额。 最终占比：最终分配成本占总分配成本的百分比。 各部门分拆金额解读： 部门A 按照标签维度摊销的成本净值为5.94元； 分摊到的公共成本和未分配成本为30%*1251.51+50%*2452416.75=1,226,583.828元； 合计的最终分配成本为5.94+1,226,583.828=1,226,589.768元。 部门B 按照标签维度摊销的成本净值为0元； 分摊到的公共成本和未分配成本为30%*1251.51+30%*2452416.75=736,100.478元； 合计的最终分配成本为0+736,100.478=736,100.478元。 部门C 按照标签维度摊销的成本净值为0元； 分摊到的公共成本和未分配成本为40%*1251.51+20%*2452416.75=490,983.954元； 合计的最终分配成本为0+490,983.954=490,983.954元。 公共成本和未分配成本 已全部分摊到部门A、部门B和部门C，因此最终分配成本均为0。 根据成本单元查看成本明细数据。 选择“成本明细导出”，在“文件导出”页签中导出的成本明细文件，在导出的原始成本或摊销成本（文件名标识为%账号名%_AmortizedCostDetailByUsage_YYYY-MM）的成本明细文件中，可以根据成本单元过滤成本明细数据。

哪些产品支持基于标签进行成本分析？ 目前只有部分产品支持标签管理，您可以在创建资源时为资源添加标签。支持标签的产品明细请参见标签与其他云服务的关系。 资源开通成功后，携带的标签才会在“费用中心”的账单管理页面展示。 如果在创建资源时已经为资源添加了标签，但是在下单2小时后仍未在“费用中心”的账单管理页面查看到该标签，您可以在新建工单页面提交工单，联系客服人员处理。提交工单的详细步骤可参见提交工单。 在“产品类”区域选择需要查找的资源对应的产品类型，以“弹性 云服务器ECS ”为例说明。 选择问题类型为“计费相关”。 在输入框中输入问题，例如：云服务的费用没有携带资源标签，单击“下一步”。 如仍然无法搜索到答案，请单击“提交工单”。 父主题： 成本标签

什么是摊销成本？ 摊销成本是原始成本按日分摊后的有效成本，体现了客户计费周期内实际每天消耗的成本，按照摊销规则每天计算一次，有24~48小时左右的延迟。 如您购买了包年包月产品： 包年包月产品的每天应摊成本= 订单金额 / 订单生效周期的天数(即从订单生效到失效的总天数)。 分摊示例：用户2024/08/01购买的包月产品，总金额为31.62元，每天应摊成本=31.62÷31=1.02元。 了解摊销成本详细规则，请参见摊销成本的分摊规则。 了解账单金额和分摊金额的区别，请参见账单金额和分摊金额的关系说明。 父主题： 成本分析

什么是成本单元，工作原理是什么？ 成本单元是一种基于规则引擎自动归集客户成本的工具。客户可以根据关联账号、产品类型、账单类型、成本标签、企业项目甚至是其他成本单元自定义条件规则，将名下的成本按照实际需求归集到有意义的分类。企业通常对业务有多种查看视角，比如部门、项目、应用等，客户可以创建多个成本单元来匹配这些视角。 客户还可以使用成本单元来拆分公共成本，比如多个部门共享的网络、存储或资源包带来的云成本，或无法直接通过企业项目、成本标签分配的云成本，支持按自定义拆分规则，二次分配到指定的分类上。当前支持拆分的成本类型包括：原始成本净值（对应实付金额）、摊销成本净值（对应实付金额的摊销）。 成本单元从当月月初开始生效。如果您在月中新增或修改了成本单元，将追溯月初至今的成本数据。成本单元的应用有4小时的延迟，客户创建成本单元后，可以基于成本单元进行成本分析、成本监控和预算管理。客户可以使用成本单元汇总和过滤成本和使用量数据。同时，在客户导出的成本明细数据中，每个成本单元都会作为单独一列呈现，您可以了解成本单元在成本明细中的详细应用情况。 父主题： 成本单元

什么是拆分规则？ 成本单元中为拆分公共成本而定义的规则即为拆分规则。公共成本是指多个部门共享的网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以按照一定的分配比例把成本归集到成本类别中。 创建成本单元时，拆分规则是一个可选步骤。拆分规则由拆分来源、拆分目标和拆分方法组成。 拆分来源：多个部门共享的成本，或无法直接归类的成本。只能从您现有的分配规则中选择。 拆分目标：用于接收拆分到的成本，只能从您现有的分配规则中选择。 拆分方法：您希望在拆分目标之间分配拆分来源的方式，拆分方式包含：按比例拆分、平均拆分，和自定义拆分。 父主题： 成本单元

为什么页面数据存在微小的数据差异？ 成本中心计算摊销成本时，数据精度均为小数点后8位。页面展示的摊销成本，均按照四舍五入取小数点后2位，因此可能导致汇总数据和明细数据之间存在微小的精度差异。 示例：当前查询条件中，汇总的“未覆盖的按需支出”为258507.64元，未覆盖的按需支出明细为7.2+22+253572.01+4906.44=258507.65元，两者之间存在0.01元的精度差。 原因：实际进行计算时，精确的按需支出明细分别为7.20000000、22.00000000、253572.00780912和4906.43515552，四舍五入后页面展示为：7.2、22、253572.01、4906.44，汇总结果为258507.65。 汇总的按需支出为7.20000000+22.00000000+253572.00780912+4906.43515552=258507.64296464，四舍五入后页面展示为258507.64。 父主题： 概述

场景示例B 根据分摊金额查看账单金额。 客户在成本中心的“成本分析”页面查看到07月存在9.19元的云硬盘摊销成本，想要查看原始订单消费情况。 在当前页面导出的07月的摊销成本明细。 通过产品类型筛选当前分摊月的成本详情。 绿色框中是成本分摊到07月的所有订单号，红色框中是分摊月中的成本构成： 第一行订单原始成本为3.5，表示订单金额为3.5，期初分摊为0，本月分摊金额为3.390625，期末未分摊0.109375，0+3.390625+0.109375=3.5。 第二行订单原始成本为7，表示订单金额为7，期初分摊为0，本月分摊金额为5.6875，期末未分摊1.3125，0+5.6875+1.3125=7。 第三行订单原始成本为3.5，表示订单金额为3.5，期初分摊为3.3870966，本月分摊金额为0.11290322，期末未分摊0，3.3870966+0.11290322+0=3.5。 当月摊销金额=3.390625+5.6875+0.11290322=9.19102822，截取分之后的小数后，“成本分析”页面展示的摊销金额为9.19元。

是否可以创建多级分层的成本单元？ 可以。您在定义成本单元时，可以根据成本单元维度创建规则。 场景示例：如果您的企业包含多个部门（Group1、Group2、Group3），每个部门本身都包含3个团队（G1team1、G1team2、G1team3、G2team1、G2team2、G2team3、G3team1、G3team2、G3team3）。 操作步骤： 创建成本单元GroupTeam，规则分别为G1team1、G1team2、G1team3、G2team1、G2team2、G2team3...... 创建Group的成本单元时： 使用“自定义分配规则”创建规则1（规则名称为Group1），按成本单元维度GroupTeam进行成本分类，取值分别为G1team1、G1team2、G1team3。 使用“自定义分配规则”创建规则2（规则名称为Group2），按成本单元维度GroupTeam进行成本分类，取值分别为G2team1、G2team2、G2team3。 使用“自定义分配规则”创建规则2（规则名称为Group3），按成本单元维度GroupTeam进行成本分类，取值分别为G3team1、G3team2、G3team3。 父主题： 成本单元

如何查看指定周期内的摊销成本？ 包年包月产品的每天应摊成本= 订单金额 / 订单生效周期的天数(即从订单生效到失效的总天数)。客户想看查看指定周期内的摊销成本时，在“成本分析”页面设置指定周期即可。 示例：客户2024.07.01购买的包月产品，总金额为31.62元，每天应摊成本=31.62÷31=1.02元。假设查看周期为2024.07.02~2024.07.08，则摊销成本总计=1.02*7=7.14元。 父主题： 成本分析

什么是沿用已有规则？ 如果您已使用成本标签或企业项目来归集成本，那么使用“沿用已有规则”，可以直接使用成本标签或企业项目的取值来归集成本，而无需根据每个取值创建对应的分配规则。 示例：您已经在“成本标签”页面激活Group标签键，标签值分别为team1、team2、team3。创建成本单元设置为沿用已有规则Group时，将会分别按照team1、team2、team3进行成本归集。 父主题： 成本单元

什么是未归集成本？ 未归集成本是指按汇总维度查看成本数据时，没有归集到任一类型中的成本数据。 客户在“成本分析”页面查看成本和使用量的汇总数据时，“未归集”数据可能是如下几种情况： 按企业项目汇总时，购买的云服务资源不支持设置企业项目，则统一呈现为：未归集。 按成本单元汇总时，成本单元创建前的历史账期数据，以及近2天尚未应用成本单元的数据统一呈现为：未归集或noCostCategory。 按使用量类型汇总时，非按需模式下的成本数据统一呈现为：未归集，如包年/包月成本。 按可用区汇总时，无可用区的成本统一呈现为：未归集，如包年包月、资源包的成本。 父主题： 成本分析

什么是成本数据？ 成本数据用于解决客户的内部成本结算问题，基于账单数据重新计算得出。 成本数据可分为原始成本和摊销成本。 原始成本体现客户实际支付的成本，在账单数据基础上提供成本标签、成本单元等成本分配标识，当月原始成本和账单数据有1小时左右时延。 摊销成本是原始成本按日分摊后的有效成本，体现了客户的预付费资源实际每天消耗的成本，按照摊销规则每天计算一次，有24~48小时左右的延迟。 详情请参见：成本类型。 父主题： 成本分析

计算规则 成本中心每天17：00点计算并更新资源包购买建议。 按照近7天、近30天、近60天的参考周期，分别获取用户的按需消费数据； 根据参考周期N，分别估算用户月度按需用量和支出： 预计月度用量A=近N天内按需用量/N/24*730 预计月度支出B=近N天内按需成本/N/24*730 根据预计月度用量，查找规格匹配的资源包商品（可能存在多个），预估购买资源包后的月度摊销成本C，分别计算每个商品的预计月度节省成本。 资源包的月度节省成本=预计月度支出B-月度摊销成本C 最终按不同的参考周期，给出节省成本最高的资源包商品作为购买建议。 资源包建议仅提供单一规格的资源包购买，不考虑不同规格的资源包商品组合。 预计月度按需用量和支出时，默认每个月为730个小时。 预计月度支出是基于历史按需应付金额进行计算，未考虑券的抵扣，可能和实际支出有差异。 购买建议后的预计月度摊销成本，可能由两部分组成： 一部分是您购买资源包的月度摊销成本（对于包月资源包来说，等同于资源包的预付款），是基于历史消费中的商务折扣计算，可能与您最新的商务折扣有偏差； 另一部分是未被资源包覆盖的使用量，仍会按照按需计费的月度摊销成本，是基于您历史按需应付金额来估算的，可能与您最新的商务折扣有偏差。 资源包建议不对您的未来用量进行预测，仅根据您参考周期内的历史用量假设了您的将来用量。 当前建议购买的资源包，是根据按需用量的每日平均水平进行建议的，未考虑每小时的按需用量波动情况，预计节省金额可能偏高。

参数说明 界面展示的资源包字段如表1所示。 表1 资源包使用率参数说明 字段 说明 账号 资源包所属的账号。 资源包名称/ID 资源包名称/ID。 产品类型 资源包所属的产品类型。 该参数为自定义列表项，通过单击“”图标后勾选是否在界面展示。 资源包实例 资源包实例。 资源包类型名称 资源包类型名称。 该参数为自定义列表项，通过单击“”图标后勾选是否在界面展示。 区域 资源包所属的区域。 该参数为自定义列表项，通过单击“”图标后勾选是否在界面展示。 重置周期 资源包重置周期： 小时级重置：每小时 订购月重置：每个订购月的起始时间，例如每月15日~次月14日。 不可重置：不可重置 该参数为自定义列表项，通过单击“”图标后勾选是否在界面展示。 订单号 资源包订单号。 有效期 资源包有效期。 可用总量 统计周期内的资源包可用总量。 可用总量= 资源包每个重置周期内的用量*统计周期内实际周期数。 例如：某资源包套餐每月流量100GB，该套餐按月重置，订购周期为“2020/11/06 16:20:32 - 2022/01/06 23:59:59”，可用总量为100GB*14，界面显示可用总量为“1,503,238,553,600.00 Byte”。 该参数为自定义列表项，通过单击“”图标后勾选是否在界面展示。 抵扣用量 统计周期内，资源包被抵扣的用量之和。 未使用量 统计周期内，资源包未被抵扣的用量。 未使用量=可用总量-抵扣用量 使用率 统计周期内，资源包被抵扣的比例。 使用率=抵扣用量/可用总量*100% 平均使用率 平均使用率=选定时间内的抵扣用量/选定时间内的可抵扣总量

可重置资源包 可重置资源包为容量线性递减的资源包，每个重置周期结束时清零，下个重置周期初恢复，直至到期。 分摊规则： 资源包抵扣的分摊金额=(抵扣用量/重置周期总用量) * 重置周期分摊金额。 重置周期内未抵扣部分的分摊金额=重置周期分摊金额-重置周期内资源包抵扣部分的分摊金额之和（每个重置周期均提供） 。 分摊示例： 新购OBS公网流出流量包 100GB 包年，总金额480元，资源包生效时间为2024.1.1-2024.12.31，有效期内每个月有100G的用量可抵扣。资源包生效周期内共计12个重置周期，每个重置周期分摊金额=480/12=40元。 2024.01抵扣情况如下： 使用时间 抵扣用量 剩余用量 2024.01.02 5G 95G 2024.01.10 10G 85G 2024.01.13 8G 77G 2024.01.15 20G 57G 2024.01.31 15G 42G 基于以上抵扣情况，2024.01抵扣分摊金额如下： 使用时间 抵扣用量 分摊金额 账单类型 2024.01.02 5G 5G/100G*40元=2元 消费-资源包抵扣 2024.01.10 10G 10G/100G*40元=4元 消费-资源包抵扣 2024.01.13 8G 8G/100G*40元=3.2元 消费-资源包抵扣 2024.01.15 20G 20G/100G*40元=8元 消费-资源包抵扣 2024.01.31 15G 15G/100G*40元=6元 消费-资源包抵扣 2024.1.31 - 40元-23.2元=16.8元 消费-资源包未抵扣 若涉及资源包规格升配场景，升配后会产生新资源包，原资源包生命周期截止不再参与抵扣，剩余分摊金额全部转交给新资源包进行分摊。 例如：上述资源包示例中，2024.01已分摊40元，还剩480-40=440元未分摊。 从2024.02.01开始升配，由100GB 包年升配至500G包年，升配订单费用550元。那从2024.02.01开始，截止2024.12.31，原资源包的摊销成本=0，新资源包的摊销总成本=550元+440元，剩余11个重置周期，每个重置周期分摊金额=990/11=90元。

不可重置资源包 不可重置资源包是一种容量线性递减的资源包，伴随抵扣容量不断减少。 分摊规则： 资源包抵扣部分的分摊金额=(抵扣用量/资源包总用量) * 资源包总金额。 资源包未抵扣部分的分摊金额=资源包总金额-资源包抵扣部分的分摊金额之和 资源包中的未抵扣部分分摊金额（账单类型：消费-资源包未抵扣），不仅会在失效时间所在的账期提供，也会在当前账期中呈现，可根据未抵扣分摊金额来查看资源包未使用的情况。 例如：当前时间为8月，不可重置资源包的生效时间为2024/01/01 -2024/12/31，1-7月为历史账期，仅包含抵扣部分分摊金额；8月为当前账期，未抵扣部分分摊金额也会在当前账期呈现，用来查看资源包未使用的情况。 分摊示例： 新购OCR身份证识别 PKG 1万 包年，总金额520元，资源包生效时间为2024.1.1-2024.12.31，总用量10000次。