华为云用户手册

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

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 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），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

API概览 目前还未提供购买、删除专属主机的接口，您只能通过管理控制台创建或删除，其他如查询专属主机详情、列表等操作，可以使用接口。 表1 接口说明 类型/接口 说明 查询专属主机列表 查询专属主机列表，可以在URI中增加flavor、dedicated_host_id、state等参数，来过滤查询结果。 查询专属主机详情 查询某一台专属主机的详细信息，例如：专属主机的名称、所属的可用区、可用的vCPU核数、可用的内存大小等。 查询专属主机上的云服务器 查询专属主机上已部署的云服务器信息，例如：云服务器的名称、ID、状态等。 更新专属主机属性 使用该接口可以修改专属主机名称，以及是否开启自动部署功能。开启自动部署后，云服务器可自动调度到这台专属主机上。 查询可用的专属主机类型 查询某一AZ内可用的专属主机类型。 查询API版本信息 查询专属主机当前所有可用的版本信息列表以及指定的版本信息。 专属主机标签管理 为专属主机增删标签，以及按标签搜索专属主机。 配额设置 查询租户的专属主机配额。 在专属主机上创建云服务器的相关接口，请参考《弹性云服务器API参考》。

响应示例 { "quota_set": [ { "used": 0, "resource": "c6", "hard_limit": 5 }, { "used": 0, "resource": "m6", "hard_limit": 5 } ] }

响应示例 { "dedicated_host_types": [ { "host_type": "c6", "host_type_name": "dedicated_general_purpose" }, { "host_type": "m6", "host_type_name": "memory_optimized" } ] }

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 dedicated_host 是 Object 专属主机，详情请参见表3 dedicated_host字段数据结构说明。 表3 dedicated_host字段数据结构说明 参数 位置 参数类型 是否必选 描述 auto_placement in String 否 在创建云服务器时（未指定专属主机ID），是否允许云服务器自动分配在一台可用的专属主机上。 取值范围：“on”或“off”。 name in String 否 专属主机名称。

URI PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id String 是 项目ID。 获取方式请参见获取项目ID。 dedicated_host_id String 是 专属主机ID。 可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。

请求示例 更新专属主机属性，在创建云服务器时，不允许云服务器自动分配在一台可用的专属主机上；将专属主机名称更新为DeH_vm3。 PUT https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/74259164-e63a-4ad9-9c77-a1bd2c9aa187 { "dedicated_host": { "auto_placement": "off", "name": "DeH_vm3" } }

URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id String 是 项目ID。 获取方式请参见获取项目ID。 dedicated_host_id String 是 专属主机ID。 可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。

响应示例 { "servers": [ { "addresses": { "68269e6e-4a27-441b-8029-35373ad50bd9": [ { "addr": "192.168.0.3", "version": 4, "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:1b:35:78", "OS-EXT-IPS:type": "fixed" } ] }, "created": "2012-09-07T16:56:37Z", "flavor": { "id": "1" }, "id": "05184ba3-00ba-4fbc-b7a2-03b62b884931", "metadata": { "os_type": "Linux" }, "name": "new-server-test", "status": "ACTIVE", "tenant_id": "a90b2728805d4240a72cc2eeb4e1244d", "updated": "2012-09-07T16:56:37Z", "user_id": "fake", "task_state": "", "image": { "id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b" } } ] }

URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id String 是 项目ID。 获取方式请参见获取项目ID。 dedicated_host_id String 是 专属主机ID。 可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。

响应示例 { "dedicated_host": { "dedicated_host_id": "d465d0ae-f859-4a83-a508-8db654c05e7e", "name": "DEH001", "auto_placement": "off", "availability_zone": "cn-east-3a", "host_properties": { "vcpus": 74, "cores": 22, "sockets": 2, "memory": 151552, "host_type": "c6", "host_type_name": "dedicated_general_purpose", "available_instance_capacities": [ { "flavor": "c6.large.2" }, { "flavor": "c6.xlarge.2" }, { "flavor": "c6.2xlarge.2" }, { "flavor": "c6.3xlarge.2" }, { "flavor": "c6.6xlarge.2" }, { "flavor": "c6.16xlarge.2" } ] }, "state": "available", "project_id": "9c53a566cb3443ab910cf0daebca90c4", "available_vcpus": 20, "available_memory": 40960, "instance_total": 5, "allocated_at": "2016-10-10T14:35:47Z", "released_at": "", "instance_uuids": [ "erf5th66cb3443ab912ff0daebca3456", "23457h66cb3443ab912ff0daebcaer45" ] } }

响应示例 { "dedicated_hosts": [ { "dedicated_host_id": "d465d0ae-f859-4a83-a508-8db654c05e7e", "name": "DEH001", "auto_placement": "off", "availability_zone": "cn-east-3a", "host_properties": { "vcpus": 74, "cores": 22, "sockets": 2, "memory": 151552, "host_type": "c6", "host_type_name": "dedicated_general_purpose", "available_instance_capacities": [ { "flavor": "c6.large.2" }, { "flavor": "c6.xlarge.2" }, { "flavor": "c6.2xlarge.2" }, { "flavor": "c6.3xlarge.2" }, { "flavor": "c6.6xlarge.2" }, { "flavor": "c6.16xlarge.2" } ] }, "state": "available", "project_id": "9c53a566cb3443ab910cf0daebca90c4", "available_vcpus": 20, "available_memory": 40960, "instance_total": 5, "allocated_at": "2016-10-10T14:35:47Z", "released_at": "" } ], "total": 1 }

请求消息 可以在URI中增加如下参数，来过滤查询结果：host_type、host_type_name、flavor、dedicated_host_id、state、tenant、availability_zone、name、limit、marker、tags、instance_uuid、或者changes-since。 例如：/v1.0/{project_id}/dedicated-hosts?host_type={host_type}&state={state} 表2 请求参数 参数 位置 参数类型 是否必选 描述 dedicated_host_id query String 否 专属主机ID。 name query String 否 专属主机名称。 host_type query String 否 专属主机类型。 host_type_name query String 否 专属主机类型的名称。 flavor query String 否 规格ID。 state query String 否 专属主机状态。 取值范围：“available”、“fault”或“released”。 tenant query String 否 取值范围：租户ID或“all”。 只有具有DeH管理员权限的用户可以指定该参数。 availability_zone query String 否 专属主机所属AZ。 limit query String 否 每个页面上显示的条目数。 marker query String 否 该值是上一页最后一条记录的ID。如果“marker”取值无效，将会返回“400”错误码。 tags query String 否 专属主机标签。 instance_uuid query String 否 专属主机上的云服务器ID。 changes-since query String 否 当专属主机更新了状态时，按日期和时间戳过滤响应。为了便于记录更改，还可能返回最近删除的专属主机。 日期和时间戳的格式为ISO 8601： CCYY-MM-DDThh:mm:ss±hh:mm 如果包含“hh:mm”值，则将时区作为UTC的偏移量返回。例如，“2015-08-27T09:49:58-05:00”。如果您省略时区，则假定为UTC时区。

状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求页面的访问被禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。 父主题： 公共参数

调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

概述 欢迎使用专属主机（Dedicated Host，DeH）。专属主机是指用户可独享的专属物理主机资源。您可以将云服务器创建在您的专属主机上，满足您对隔离性、安全性、性能的更高要求。同时，您还可以在迁移业务至专属主机时，继续使用迁移前的服务器端软件许可，即支持自带许可（BYOL），提高对云服务器的自治。 您可以使用本文档提供API对专属主机进行相关操作，如查询、删除、更新等。支持的全部操作请参见API概览。 在调用专属主机API之前，请确保已经充分了解专属主机相关概念，详细信息请参见“专属主机产品介绍”。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下，您可以查看项目ID。 企业项目 企业项目是项目的升级版，针对企业不同项目间的资源进行分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。

操作场景 使用网络研讨会前，需要先进行资源分配与激活。 一次性资源 一次性资源分配之后需要激活才可以召开正式会议，激活后72小时内可无限次使用，激活前只能召开受限的测试会议（最大5嘉宾+10观众接入，限时45分钟）。 一次性资源最大有效期是1年，购买后请一年内激活使用，否则会自动过期。 一个网络研讨会资源同时只能分配给一个用户。 分配了网络研讨会资源的用户，才可以创建网络研讨会；若用户仅加入网络研讨会，则无需网络研讨会资源。 企业管理员可给同一个用户分配最多10个网络研讨会资源。

操作步骤 请单击下载，下载并安装桌面客户端。 推荐您从官方渠道下载客户端，如果您是从非官方渠道获取的客户端安装文件，请您确认软件合法性。 Windows软件合法性校验方法如下： 右键“xxx.exe”安装文件。 选择“属性”。 在上方导航栏选择“数字签名”页签。 在签名列表中，查看签名者姓名是否为“Huawei Technologies xxxx”，如果不是，请不要使用该软件包安装客户端。 Mac软件合法性在安装时系统会进行校验，请留意系统提示，如果不合法，请您不要继续安装客户端。 企业用户从短信或邮件中获取用户账号密码，登录桌面端。 图1 登录客户端

操作场景 管理员添加企业用户后，用户下载华为云会议桌面客户端即可登录使用。 操作系统要求 类型 最低要求 建议配置 Windows客户端 Windows 10及以上版本（32位或64位） Windows 10及以上版本（32位或64位） Mac客户端 macOS 10.12及以上版本 macOS 10.15及以上版本 硬件要求 类型 最低要求 建议配置 Windows客户端 CPU：i5 双核 内存：4G 硬盘可用空间：3G CPU： Intel i7 四核及以上 内存： 8GB及以上 硬盘可用空间： 8GB及以上 Mac客户端 CPU：4核 内存：4G 硬盘可用空间：3G CPU：4核 内存：4G 硬盘可用空间：8GB及以上 最低要求的设备，将受限于CPU处理性能，视频清晰度最高只能达到360P。

操作场景 管理员添加企业用户后，用户下载华为云会议移动客户端即可登录使用。 操作系统要求 类型 最低要求 建议配置 Android客户端 Android 6.0/Harmony 2.0 Android 10.0及以上/Harmony 2.0及以上 iOS客户端 iOS 11 iOS 14 及以上版本 硬件要求 类型 最低要求 建议配置 Android客户端 CPU：双核 1.5GHz 内存：2G 硬盘可用空间：800M CPU： 四核2GHz及以上 内存： 6G及以上 硬盘可用空间： 1G iOS客户端 CPU：- 内存：1G 硬盘可用空间：500M CPU：- 内存：3G 硬盘可用空间：1GB

方案架构 根据企业对会议功能应用需求，使用华为云会议方案，如表3。 表3 会议功能需求与方案 会议功能需求 云会议方案 多端接入 支持华为云会议桌面端/移动端、硬件终端、第三方硬件终端多种会议终端接入，满足各类会议场景。 会议控制 桌面端/移动端、华为云会议管理平台，多端超强会控能力。 资源管理 资源管理、业务发放、会议管理融为一体，企业管理员轻松掌握企业资源使用情况。 音视频质量 提供高清视频、共享画面，高效协同。 会议录播 1080P高清录制，高效转码，视频、音频、辅流多流录制。 安全可靠 从云、管、端三个层面全方位确保云会议业务安全可靠，为会议业务保驾护航。

应用场景 A企业下属有多个子公司和项目组，广泛分布于全国多个区域。为满足企业日常运作中线上会议交流、远程协作的需求，也为应对在家办公场景，A企业部署了华为云会议，让内部工作沟通、远程商务交流等更加顺畅。 A企业当前有5个子公司，各地共有100个项目组，总人数3000人，主要使用的会议类型如表 A企业主要会议类型所示。 表1 A企业主要会议类型 会议类型 说明 线上会议 员工与员工、员工与客户的业务交流场景 单次会议参会人数2~500 单个用户随时随地接入会议 会议室+线上会议 员工与不同项目组会议室/办公区、员工与商务伙伴的业务交流场景 单次会议参会人数2~500 会议室、单个用户接入会议 会议室+会议室线上会议 不同地域、会议室、办公区的业务交流场景 单次会议参会人数2~500 会议室接入会议 网络研讨会 大型会议场景 单次会议参会人数500~5000 会议室、单个用户接入会议 会议室会议 小组会议讨论场景 单次会议参会人数2~15 会议设备线下使用 A企业当前会议使用场景详情如表 会议使用情况所示。 表2 会议使用情况 会议场景 使用范围 入会终端类型 所属类型 部门例会、客户交流、线上面试 企业内全员可用 外部人员可入会 桌面端/移动端 线上会议 跨企业、跨地区业务沟通 企业内全员可用 会议室/办公区可用 桌面端/移动端、硬件终端 会议室+线上会议 业务培训 会议室/办公区可用 硬件终端 会议室+会议室线上会议 企业全员大型会议、线上招聘宣讲会 企业内全员可用 会议室/办公区可用 外部人员可入会 桌面端/移动端/Web端、硬件终端 网络研讨会 临时小组讨论、项目头脑风暴 会议室/办公区可用 硬件终端 会议室会议

数据迁移方案 表2 数据迁移方案 源数据库 迁移工具 特点 操作指导 RDS for MySQL DRS 支持全部数据、库级或表级数据迁移 支持全量和增量数据迁移 业务中断最小化 适用任何数据量 将MySQL迁移到TaurusDB TaurusDB mysqldump 支持全量数据迁移 业务中断影响较大 适合小型数据量 使用mysqldump迁移TaurusDB数据 DAS 支持全量数据迁移 业务中断影响较大 适合中型数据量 使用DAS导出导入功能迁移TaurusDB数据 本地自建MySQL数据库 E CS 自建MySQL数据库 DRS 支持全部数据、库级或表级数据迁移 支持全量和增量数据迁移 业务中断最小化 适用任何数据量 自建MySQL迁移到TaurusDB 其他云上MySQL数据库 DRS 支持全部数据、库级或表级数据迁移 支持全量和增量数据迁移 业务中断最小化 适用任何数据量 其他云MySQL迁移到TaurusDB

常用迁移工具介绍 表1 常用工具介绍 工具名称 工具介绍 计费说明 了解更多 DRS（推荐使用） DRS提供了实时迁移和实时同步功能，可以快速解决多场景下，数据库之间的数据流通问题，操作便捷、简单，仅需分钟级就能搭建完成迁移任务。通过服务化迁移，免去了传统的DBA人力成本和硬件成本，帮助您降低数据传输的成本。 按需计费。 具体的计费详情请参见计费说明。 什么是 数据复制服务 （DRS） mysqldump mysqldump是MySQL自带的一个命令行工具，用于备份和恢复MySQL数据库。 免费 什么是mysqldump DAS 当进行数据备份或迁移时，可以使用DAS的数据导出功能，获取完整的数据信息，再将数据从本地或者从OBS桶导入目标数据表。 免费 什么是数据管理服务（DAS）

TaurusDB多主实例简介 TaurusDB提供了多主版实例，在一个实例中通过多个读写节点来实现多写多读。多主版实例包含最少2个最多63个读写节点，没有只读节点。 在多主版实例中，读写节点通过共享元数据的方式对实例的元数据进行统一管理，用户可以通过数据库代理地址访问整个TaurusDB实例，数据库代理会自动转发用户的SQL命令到正确的读写节点。 相比于单主实例，多主版实例支持不同库或表在不同节点上并发写入，最多支持在63个节点同时写入数据，极大的提升了并发读写能力。 父主题： 多主实例（公测）

优势 支持全球范围部署，本地就近读取数据 具有区域/洲际的业务形态，主实例所产生的数据能直接在从实例就近读取到，无需直接访问主实例上的节点。 跨区域复制延迟低 无间断地从DFV存储中直接读取Redo Log进行异步复制，结合高吞吐的并行数据同步能力，使得复制延迟小于1秒成为现实。 数据同步对主节点的业务无影响 主实例复制节点直接从DFV存储中的不同节点并行地读取数据进行同步。主节点无需直接向从实例同步数据，只需向主实例复制节点更新Redo Log在存储中的位点信息即可。这样，主节点的业务不会受到RegionlessDB复制的影响。 超高扩展的只读节点 支持最多创建5个从实例，每个从实例最多支持15个只读节点。 创建实例时最多可批量申请10个只读节点。 支持Region级别的快速容灾恢复 主实例Region级别故障，相较于传统的容灾方案，RegionlessDB能够在选定的从实例中快速地完成主从切换, 达到分钟级的RTO和秒级的RPO时间。 如需使用快速容灾恢复，请提交工单处理。 RPO（Recovery Point Objective）主要指的是业务系统所能容忍的数据丢失量。 RTO（Recovery Time Objective）主要指的是所能容忍的业务停止服务的最长时间，也就是从灾难发生到业务系统恢复服务功能所需要的最短时间周期。

后续操作 返回实例列表，在左侧导航栏，选择“任务中心”，查看规格变更任务的执行进度。 对于变更方式为“立即变更”的任务： 在“即时任务”页签，搜索“TaurusDB实例规格变更”任务，查看执行进度。即时任务不支持取消。 对于变更方式为“可维护时间段”的任务： 在“定时任务”页签，搜索实例ID，查看该实例下规格变更的任务执行情况。 如果任务为“待执行”状态，单击“取消”，取消执行该任务。 更多操作，请参见查看TaurusDB实例任务。

免责声明 华为云为产品开通的正常功能可满足大部分客户日常需求，对于触发器类的功能，建议您在业务程序侧实现。如您确实需要开通事件定时器功能，因为一些已知的社区风险等，需要了解以下风险内容： 事件定时器实际触发时间与设置时间不符。 事件定时器未触发。 因为事件定时器特性的特殊性，可能实际执行情况与业务初始预期不符。 数据库使用遇到问题时，可能因为事件定时器的原因影响分析判断。 无法使用异构容灾特性。 其它未知问题。