华为云用户手册

创建加密镜像 创建加密镜像分为通过外部镜像文件创建加密镜像和通过加密弹性云服务器创建加密镜像。 通过外部镜像文件创建加密镜像 用户使用OBS桶中已上传的外部镜像文件创建私有镜像，可以在注册镜像时选择KMS加密及密钥完成镜像加密。具体操作步骤请参考通过外部镜像文件创建Windows系统盘镜像和通过外部镜像文件创建Linux系统盘镜像。 通过加密弹性云服务器创建加密镜像 用户选择弹性云服务器创建私有镜像时，如果该云服务器的系统盘已加密，那么使用该云服务器创建的私有镜像也是加密的。加密镜像使用的密钥和系统盘的密钥保持一致。具体操作请参考通过云服务器创建Windows系统盘镜像和通过云服务器创建Linux系统盘镜像。 父主题： 加密镜像

创建过程 私有镜像创建过程如图1所示。 图1 Windows系统盘镜像创建过程 步骤说明如下： 准备符合平台要求的外部镜像文件，请参考准备镜像文件（Windows）。 上传外部镜像文件到OBS个人桶中，请参考上传镜像文件（Windows）。 通过管理控制台选择上传的镜像文件，并将镜像文件注册为私有镜像，请参考注册镜像（Windows）。 私有镜像注册成功后，使用该镜像创建新的云服务器，请参考使用镜像创建弹性云服务器（Windows）。

创建过程 私有镜像创建过程如图1所示。 图1 Linux系统盘镜像创建过程 步骤说明如下： 准备符合平台要求的外部镜像文件，请参考准备镜像文件（Linux）。 上传外部镜像文件到OBS个人桶中，请参考上传镜像文件（Linux）。 通过管理控制台选择上传的镜像文件，并将镜像文件注册为私有镜像，请参考注册镜像（Linux）。 私有镜像注册成功后，使用该镜像创建新的云服务器，请参考使用镜像创建弹性云服务器（Linux）。

背景知识 导出镜像的流程如下，适用于将云上的服务器系统及软件环境复制到线下集群或私有云环境使用。 图1 导出镜像流程 导出镜像所需时间取决于私有镜像大小和当前导出任务的并发数，需要您耐心等待。 支持导出zvhd2、qcow2、vmdk、vhd和zvhd格式的镜像。创建的私有镜像默认格式为zvhd2，导出过程中，不同的格式会导致导出的镜像大小不同。 对于大于128GB的镜像，您可以使用快速导出功能（即导出时需要勾选“使用快速导出”）将镜像导出到OBS桶中，但是无法指定导出格式，导出的镜像文件格式为zvhd2，如果需要导出其他格式，可以在镜像导出后，转换为需要的格式。 加密镜像无法使用快速导出功能。若要将此镜像导出，可以解密后再导出。

部分内核TCP网络概率性不通 问题描述： 修复CVE-2019-11477（TCP SACK）的内核引入新问题，在Socket buffer很低的情况下可能导致网络不通。 涉及镜像： 镜像类型 内核版本 2019-06-26至2019-09-29期间的CentOS 7公共镜像 3.10.0-957.21.3.e17.x86_64 2019-06-26至2019-10-15期间的Ubuntu 16、Ubuntu 18公共镜像 Ubuntu 16.04：4.4.0-151-generic Ubuntu 18.04：4.15.0-52-generic 2019-06-26至2019-10-15期间的Debian 9.0公共镜像 4.9.0-9-amd64 2019-06-27至2019-10-15期间的Fedora 29、openSUSE 15.0公共镜像 Fedora 29：5.1.11-200.fc29.x86_64 openSUSE 15.0：4.12.14-1p150.12.64-default 解决方案： 升级到最新的内核。各镜像类型升级内核的命令如下： CentOS/Fedora：yum update kernel Ubuntu：apt-get update && apt-get install linux-image-generic openSUSE：zypper refresh && zypper install kernel-default Debian：apt-get update && apt search linux-image && apt-get install linux-image-xxx 其中，apt search linux-image可以查询最新的内核版本；apt-get install linux-image-xxx用于升级到最新内核版本。

Windows Server DHCP租约设置过长（大于99天），可能导致网络不通的问题 问题描述： Windows Server操作系统的DHCP Client服务存在已知问题，当租约设置过长（大于99天）会导致您的实例无法自动续约IP。当第一次的租约到期时会导致实例网络不通。 涉及镜像： Windows Server 2008、Windows Server 2012 R2、Windows Server 2016、Windows Server 2019公共镜像及私有镜像 解决方案： 调整实例所在的子网DHCP租约为1天或者无限租约。 执行以下命令，使租约设置生效。 如下操作会短暂影响网络连接，请暂停业务或者在业务低峰期进行操作。 ipconfig /renew

Windows Server 2012 R2的Server Manager工具与VMTools不兼容导致磁盘错误重置数据丢失 问题描述： Windows Server 2012 R2系统 云服务器配置 了2块数据盘，使用Windows系统自带的Server Manager工具去重置第二块数据盘时，发现第一块数据盘被重置，导致第一块数据盘数据丢失。 涉及镜像： 2019-02-19之前的Windows Server 2012 R2公共镜像 解决方案： 涉及的云服务器请将VMTools升级至2.5.0.156及之后较新的版本。

内核在网卡增删场景下，概率性导致系统异常的问题 问题描述： 在云服务器上进行网卡热插拔事件或者等价行为，概率性出现以下两种情况： 触发内核panic，OS自动重启 软中断使用率冲高，网络收发包异常 Patch链接如下：https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git/commit/?id=f00e35e259948b995aa1f3ee7fddb05f34a50157 涉及镜像： CentOS 7公共镜像及私有镜像 解决方案： 建议进行内核版本升级修复对应Bug，升级至CentOS 7内核版本3.10.0-1160.25.1.e17.x86_64。

1822网卡卸载实例不兼容Linux 3.16.x内核的问题 问题描述： 使用华为自研25GE智能高速网卡硬件卸载功能的弹性云服务器（包含但不限于c3ne、m3ne、c6、m6、g5、p2v、g5r、p2vs、p2s、pi2、fp1cn1、ai1、e3.26xlarge.14、e3.52xlarge.14、e3.52xlarge.20、kc1、km1）与Linux 3.16.x内核分支（3.16.47~3.16.x）操作系统版本存在兼容性问题，会概率性导致网络不通等现象。 涉及镜像： Debian 8.2.0 64bit、Debian 8.8.0公共镜像 解决方案： 当前已在相关规格下线Debian 8公共镜像。使用涉及镜像创建的云服务器尽快迁移到S3、C3上面。

私有镜像优化过程 为了成功安装原生的XEN和KVM驱动，需要先卸载弹性云服务器操作系统中安装的PV Driver。 具体操作请参见在Linux系统中卸载PV driver。 KVM虚拟化类型请忽略此步骤。 修改grub文件磁盘标识方式为UUID。 具体操作请参见修改grub文件磁盘标识方式为UUID。 修改fstab文件磁盘标识方式为UUID。 具体操作请参见修改fstab文件磁盘标识方式为UUID。 安装原生的驱动。 对于XEN虚拟化类型，请安装原生的XEN驱动和KVM驱动。具体操作请参见怎样安装原生的XEN和KVM驱动。 对于KVM虚拟化类型，请安装原生的KVM驱动。具体操作请参见安装原生的KVM驱动。 清除日志文件、历史记录等，关闭云服务器。 具体操作请参见清除日志文件。 通过弹性云服务器创建Linux私有镜像。

后续操作 请检查分辨率是否可以正常调整。若无法正常调整，请检查系统启动模式。 按下Win+R，打开运行命令输入框，在里面输入“msinfo32”，按回车键。在系统信息界面右侧窗口找到BIOS模式。 如果显示“传统”，表示系统启动方式为BIOS。请重新在启动方式步骤选择“BIOS”启动方式。 如果显示“UEFI”，表示系统启动方式为UEFI，设置方法参见UEFI启动方式安装的Windows操作系统无法调整分辨率如何解决。

步骤2：购买E CS 登录管理控制台，查看是否有弹性云服务器。 有Linux弹性云服务器，参考购买并通过Linux系统连接TaurusDB标准版实例。 有Windows弹性云服务器，执行3。 无弹性云服务器，执行2。 购买弹性云服务器时，选择Windows操作系统。 由于需要在ECS下载MySQL客户端，因此需要为ECS绑定弹性公网IP（EIP），并且选择与TaurusDB标准版实例相同的区域、VPC和安全组，便于TaurusDB标准版和ECS网络互通。 购买Windows弹性云服务器请参考《弹性云服务器快速入门》中“购买弹性云服务器”章节。 在ECS实例基本信息页，查看ECS实例的区域和VPC。 图4 查看ECS的区域和VPC 在TaurusDB标准版实例基本信息页，查看TaurusDB标准版实例的区域和VPC。 图5 查看TaurusDB标准版实例的VPC 确认ECS实例与TaurusDB标准版实例是否处于同一区域、同一VPC内。 是，执行步骤3：测试连通性并安装MySQL-Front。 如果不在同一区域，请重新购买实例。不同区域的云服务之间内网互不相通，无法访问实例。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。 如果不在同一VPC，可以修改ECS的VPC，请参见切换虚拟私有云。

步骤3：测试连通性并安装MySQL-Front 登录ECS实例，请参见《弹性云服务器用户指南》中“Windows弹性云服务器管理控制台远程登录（VNC方式）”。 在RDS“实例管理”页面，单击实例名称进入实例概览页面。 在左侧导航栏中选择“连接管理”，在“连接信息”模块获取实例的内网地址和数据库端口。 图6 查看TaurusDB标准版实例的内网地址和端口 在ECS上打开cmd命令窗，测试是否可以正常连接到TaurusDB标准版实例内网地址的端口。 telnet 192.168.*.* 3306 如果可以通信，说明网络正常。 如果无法通信，请检查安全组规则。 查看ECS的安全组的出方向规则，如果目的地址不为“0.0.0.0/0”且协议端口不为“全部”，需要将TaurusDB标准版实例的内网IP地址和端口添加到出方向规则。 查看TaurusDB标准版实例的安全组的入方向规则，需要将ECS实例的私有IP地址和端口添加到入方向规则。 在ECS上打开浏览器，下载并安装MySQL-Front工具（以5.4版本为例）。 图7 选择位置 图8 选择开始菜单 图9 选择附加任务 图10 完成

步骤4：使用MySQL-Front连接实例 启动MySQL-Front客户端。 在对话框中，单击“新建”。 图11 新建登录信息 输入需要连接的实例信息，单击“确定”。 图12 添加信息 表1 参数说明 参数 说明 名称 连接数据库的任务名称。若不填写，系统默认与Host一致。 主机 获取的读写内网地址。 端口 获取的数据库端口，默认3306。 用户 实例的账号名称，默认root。 密码 要实例的账号所对应的密码。 在登录信息窗口，选中创建的连接，单击“打开”。 图13 打开登录信息 若连接信息无误，即会成功连接实例。 图14 登录成功

步骤1：购买TaurusDB标准版实例 进入购买云数据库RDS页面。 在“快速购买”页面，配置实例基础参数。 下面的配置项仅作为示例，实际购买时根据用户需求选择合适的资源。 图1 基础配置 参数 示例 参数说明 计费模式 按需计费 实例的计费模式。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。 区域 华北-北京四 资源所在的区域。 说明： 不同区域内的产品内网不互通，且创建后不能更换，请谨慎选择。 引擎版本 8.0 数据库版本。 实例类型 高可用 实例的架构类型。 主备：采用一主一备的经典高可用架构，主备实例的每个节点的规格保持一致。备机提高了实例的可靠性，创建主机的过程中，会同步创建备机，备机创建成功后，用户不可见。 性能规格 独享型 2U4GB 实例的CPU和内存规格。 磁盘存储 SSD云盘 100GB 实例的存储空间。 您申请的存储空间会有必要的文件系统开销，这些开销包括索引节点和保留块，以及数据库运行必需的空间。 磁盘加密 不加密 选择加密后会提高数据安全性，但对数据库读写性能有少量影响，请按照您的使用策略进行选择。 如果使用共享KMS密钥，对应的 CTS 事件为createdatakey和decrydatakey，仅密钥所有者能够感知到该事件。 实例高级配置。 图2 高级配置 参数 示例 参数说明 虚拟私有云 vpc-default 实例所在的虚拟网络环境，可以对不同业务进行网络隔离。 如果没有可选的虚拟私有云，单击“创建虚拟私有云”，完成创建后单击。具体操作请参见创建虚拟私有云和子网。 子网 subnet-default 通过子网提供与其他网络隔离的、可以独享的网络资源，以提高网络安全性。 数据库端口 3306 数据库端口默认为3306，实例创建成功后可修改。↵ TaurusDB标准版数据库端口设置范围为1024～65535（其中12017、33071、33062被系统占用不可设置）。 安全组 default 安全组限制实例的安全访问规则，加强TaurusDB与其他服务间的安全访问。 企业项目 default 对于已成功关联企业项目的用户，仅需在“企业项目”下拉框中选择目标项目。 更多关于企业项目的信息，请参见《企业管理用户指南》。 表名大小写 不区分大小写 表名是否区分大小写。目标实例与原实例表名大小写设置不一致，可能会导致恢复失败。 购买数量 1 批量创建实例的个数。 配置完成后，单击“立即购买”。 查看购买成功的TaurusDB标准版实例。 图3 购买成功

步骤3：测试连通性并安装MySQL客户端 登录ECS实例，请参见《弹性云服务器用户指南》中“Linux弹性 云服务器远程登录 （VNC方式）”。 在RDS“实例管理”页面，单击实例名称进入实例概览页面。 在左侧导航栏选择“连接管理”，在“连接信息”模块获取TaurusDB标准版实例的内网地址和数据库端口。 图6 查看TaurusDB标准版实例的内网地址和端口 在ECS上测试是否可以正常连接到TaurusDB标准版实例内网地址的端口。 telnet 192.168.*.* 3306 如果可以通信，说明网络正常。 如果无法通信，请检查安全组规则。 查看ECS的安全组的出方向规则，如果目的地址不为“0.0.0.0/0”且协议端口不为“全部”，需要将TaurusDB标准版实例的内网IP地址和端口添加到出方向规则。 查看TaurusDB标准版的安全组的入方向规则，需要将ECS实例的私有IP地址和端口添加到入方向规则。 在ECS上下载Linux系统的MySQL客户端安装包，以mysql-community-client-8.0.28-1.el8.x86_64.rpm包为例。 建议您下载的MySQL客户端版本高于已创建的TaurusDB标准版实例中数据库版本。 wget https://dev.mysql.com/get/mysql-community-client-8.0.28-1.el8.x86_64.rpm 执行以下命令安装MySQL客户端。 rpm -ivh --nodeps mysql-community-client-8.0.28-1.el8.x86_64.rpm 如果安装过程中报conflicts，可增加replacefiles参数重新安装，如下： rpm -ivh --replacefiles mysql-community-client-8.0.28-1.el8.x86_64.rpm 如果安装过程中提示需要安装依赖包，可增加nodeps参数重新安装，如下： rpm -ivh --nodeps mysql-community-client-8.0.28-1.el8.x86_64.rpm

步骤1：购买TaurusDB标准版实例 进入购买云数据库RDS页面。 在“快速购买”页面，配置实例基础参数。 下面的配置项仅作为示例，实际购买时根据用户需求选择合适的资源。 图1 基础配置 参数 示例 参数说明 计费模式 按需计费 实例的计费模式。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。 区域 华北-北京四 资源所在的区域。 说明： 不同区域内的产品内网不互通，且创建后不能更换，请谨慎选择。 引擎版本 8.0 数据库版本。 实例类型 高可用 实例的架构类型。 主备：采用一主一备的经典高可用架构，主备实例的每个节点的规格保持一致。备机提高了实例的可靠性，创建主机的过程中，会同步创建备机，备机创建成功后，用户不可见。 性能规格 独享型 2U4GB 实例的CPU和内存规格。 磁盘存储 SSD云盘 100GB 实例的存储空间。 您申请的存储空间会有必要的文件系统开销，这些开销包括索引节点和保留块，以及数据库运行必需的空间。 磁盘加密 不加密 选择加密后会提高数据安全性，但对数据库读写性能有少量影响，请按照您的使用策略进行选择。 如果使用共享KMS密钥，对应的CTS事件为createdatakey和decrydatakey，仅密钥所有者能够感知到该事件。 实例高级配置。 图2 高级配置 参数 示例 参数说明 虚拟私有云 vpc-default 实例所在的虚拟网络环境，可以对不同业务进行网络隔离。 如果没有可选的虚拟私有云，单击“创建虚拟私有云”，完成创建后单击。具体操作请参见创建虚拟私有云和子网。 子网 subnet-default 通过子网提供与其他网络隔离的、可以独享的网络资源，以提高网络安全性。 数据库端口 3306 数据库端口默认为3306，实例创建成功后可修改。↵ TaurusDB标准版数据库端口设置范围为1024～65535（其中12017、33071、33062被系统占用不可设置）。 安全组 default 安全组限制实例的安全访问规则，加强TaurusDB与其他服务间的安全访问。 企业项目 default 对于已成功关联企业项目的用户，仅需在“企业项目”下拉框中选择目标项目。 更多关于企业项目的信息，请参见《企业管理用户指南》。 表名大小写 不区分大小写 表名是否区分大小写。目标实例与原实例表名大小写设置不一致，可能会导致恢复失败。 购买数量 1 批量创建实例的个数。 配置完成后，单击“立即购买”。 查看购买成功的TaurusDB标准版实例。 图3 购买成功

步骤2：购买ECS 登录管理控制台，查看是否有弹性云服务器。 有Linux弹性云服务器，执行3。 有Windows弹性云服务器，参考购买并通过Windows系统连接TaurusDB标准版实例。 无弹性云服务器，执行2。 购买弹性云服务器时，选择Linux操作系统，例如CentOS。 由于需要在ECS下载MySQL客户端，因此需要为ECS绑定弹性公网IP（EIP），并且选择与TaurusDB标准版实例相同的区域、VPC和安全组，便于TaurusDB标准版和ECS网络互通。 购买Linux弹性云服务器请参考《弹性云服务器快速入门》中“购买弹性云服务器”章节。 在ECS实例基本信息页，查看ECS实例的区域和VPC。 图4 ECS基本信息 在TaurusDB标准版实例概览页面，在网络信息区域查看TaurusDB标准版实例的区域和VPC。 图5 查看TaurusDB标准版实例的VPC 确认ECS实例与TaurusDB标准版实例是否处于同一区域、同一VPC内。 是，执行步骤3：测试连通性并安装MySQL客户端。 如果不在同一区域，请重新购买实例。不同区域的云服务之间内网互不相通，无法访问实例。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。 如果不在同一VPC，可以修改ECS的VPC，请参见切换虚拟私有云。

SDK列表 表1提供了TaurusDB服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导

独享型实例测试列表 表1 读写模式测试数据（X86架构多AZ场景） 模型 表数量 表数据量 线程 规格 TPS QPS 读写模式 25 250000 64 2c8g 1708.43 34168.62 64 2c16g 1645.88 32917.69 128 4c16g 4470.64 89412.78 128 4c32g 4927.94 98558.88 64 8c32g 8073.66 161473.22 64 8c64g 8570.03 171400.69 256 16c64g 14815 296300.07 256 16c128g 15975.88 319517.62 512 32c128g 21080.55 421611.01 512 32c256g 22612.02 452240.5 512 60c256g 24033.17 480663.46 512 64c512g 23644.1 472882.17

测试环境 TaurusDB测试环境如下： 区域：华北-北京四。 可用分区：多可用区。 测试用云数据库 TaurusDB实例为一主一只读集群。 弹性云服务器（Elastic Cloud Server，简称ECS）：ECS与数据库节点在同一个可用区，规格建议选择通用计算增强型 | c7.8xlarge.4 | 32vCPUs | 128GB，操作系统镜像使用CentOS 7.6 64bit位版本。由于压测工具需要安装额外的编译工具，建议ECS绑定弹性IP。

独享型实例测试列表 表1 只写模式测试数据（X86架构多AZ场景） 模型 表数量 表数据量 线程 规格 TPS QPS 只写模式 250 25000 128 2c8g 5473.22 32839.34 128 2c16g 5685.26 34111.57 256 4c16g 16312.03 97872.16 256 4c32g 17025.3 102151.81 512 8c32g 30702.7 184216.21 512 8c64g 32941.36 197648.16 512 16c64g 55022.87 330137.28 512 16c128g 61818.75 370912.52 512 32c128g 73708.67 442252.03 512 32c256g 75602.57 453615.46 512 60c256g 77489.58 464937.48 512 64c512g 77939.14 467634.84

独享型实例测试列表 表1 只读模式测试数据（X86架构多AZ场景） 模型 表数量 表数据量 线程 规格 TPS QPS 只读模式 250 25000 64 2c8g 7892.35 78923.54 64 2c16g 7989.1 79891.04 64 4c16g 21694.24 216942.43 64 4c32g 23513.22 235132.23 512 8c32g 38033.2 380332.04 512 8c64g 38101.59 381015.86 1000 16c64g 68211.25 682112.54 1000 16c128g 69562.15 695621.54 1000 32c128g 102618.26 1026182.57 1000 32c256g 103976.9 1039768.98 1000 60c256g 103048.51 1030485.11 1000 64c512g 102851.45 1028514.55

响应示例 状态码： 200 请求成功 { "count" : 1, "workspaces" : [ { "create_time" : "2024-07-02T09:25:17Z+0800", "creator_id" : "b4*****************************46a", "creator_name" : "l00644738", "description" : "我的工作空间", "domain_id" : "ac*****************************bf4", "domain_name" : "scc****09", "enterprise_project_id" : "", "enterprise_project_name" : "", "id" : "39*************bf", "is_view" : false, "modifier_id" : "", "modifier_name" : "", "name" : "我的工作空间", "project_id" : "15**************************da6", "project_name" : "cn-north-4", "region_id" : "cn-north-4", "update_time" : "2024-07-02T09:25:17Z+0800", "view_bind_id" : "", "view_bind_name" : "", "workspace_agency_list" : [ ] } ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 workspaces Array of CreateWorkspaceResponseBody objects 空间信息 count Number 数据总量 表5 CreateWorkspaceResponseBody 参数 参数类型 描述 id String 工作空间id create_time String 创建时间 update_time String 更新时间 name String 工作空间名称 description String 工作空间描述 creator_id String 创建人id creator_name String 创建人名称 modifier_id String 修改人id modifier_name String 修改人名称 project_id String 所属项目id project_name String 所属项目名称 domain_id String 所属租户id domain_name String 所属租户名称 enterprise_project_id String 企业项目id enterprise_project_name String 企业项目名称 is_view Boolean 是否是视图 region_id String 区域id view_bind_id String 视图绑定的空间id view_bind_name String 视图绑定的空间名称 workspace_agency_list Array of workspace_agency_list objects 仅用于视图场景，列出了该视图纳管的空间列表 表6 workspace_agency_list 参数 参数类型 描述 project_id String 委托空间所属项目id id String 空间委托id name String 空间委托名称 region_id String 委托空间所属region id workspace_attribution String THIS_ACCOUNT:本账号空间,CROSS_ACCOUNT:跨账号空间 agency_version String 用户创建托管空间时使用的 IAM 委托版本，V3或者V5 domain_id String 委托租户id domain_name String 委托租户名称 iam_agency_id String iam委托id iam_agency_name String iam委托名称 resource_spec_code Array of strings 委托空间购买版本 selected Boolean 是否被视图选中 状态码： 400 表7 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误消息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 错误码 message String 错误消息

URI GET /v1/{project_id}/workspaces 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Number 偏移量 指定返回记录的开始位置，必须为数字，取值范围为大于或等于0， limit 是 Number 每页显示个数 region_id 否 String 区域id name 否 String 名称查询 description 否 String 描述查询 view_bind_id 否 String 视图绑定的空间id view_bind_name 否 String 视图绑定的空间名称 create_time_start 否 String 创建时间开始，例如2024-04-26T16:08:09Z+0800 create_time_end 否 String 创建时间结束，例如2024-04-2T16:08:09Z+0800 is_view 否 Boolean 是否查询视图 true or false ids 否 String 工作空间id数组，英文逗号分隔 normal_project_id 否 String 普通项目的项目id enterprise_project_id 否 String 企业项目的项目id

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme： 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint： 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path： 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string： 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，同一个服务的Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-4”，您可以从地区和终端节点获取，对应地区和终端节点页面的“区域”字段的值。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } }} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见AK/SK认证。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json