华为云用户手册

步骤4：在华为云控制台提交域名转入 登录域名注册控制台。 在左侧树状导航栏，选择“域名转入”。 在页面右上角，单击“域名转入”。 在“域名转入”区域的文本框中，输入待转入域名以及转移密码。 填写格式：域名+空格+转移密码，例如：example.com password1。 每行填写一个域名，如需一次性转入多个域名，以换行符隔开。最多支持一次性转入5个域名。 图5 输入域名和转移密码 转移密码即步骤1：获取转移密码获取的转移密码。 若用户已经提交了某一域名的转入申请，则不能重复提交该域名的转入申请，否则，系统会提示该域名已经存在。 单击“立即转入”，系统进行转入域名的合法性校验。 当转入域名因域名名称、域名状态等问题无法转入时，您需要根据提示的原因处理后，再次进行转入。 当转入的域名全部合法，则直接进入下一步。 设置订单信息。 在“域名信息”栏，设置域名信息。 域名转入仅支持选择已通过实名认证的信息模板，不限于用户类型，可以是个人用户或者企业用户。 单击“立即购买”，进行订单确认。 若订单信息无误，阅读并勾选协议。 单击“去支付”。 选择支付方式后付款，提交域名转入。

步骤5：查看转入进度 系统自动校验转移密码，命名审核等，校验通过后注册局会向原服务商发送转出确认通知，原服务商确认后(不同服务商确认时间不同，可以催原服务商尽快确认转出)，域名开始转入。 在域名转入页面您可以查看转入进度。 单击页面上方的“返回转入列表”，查看域名转入状态。 单击域名“操作”列的“查看”，进入转入流程页面。 图6 域名转入状态 在转入流程页面，可以对转入域名进行进一步操作，详细内容请参见表3。 表3 域名转入后续操作 域名状态 说明 后续操作 提交转入 域名转入提交完成，启动域名转入流程。 无需操作，等待系统转入处理。 若要取消转入，可以在转入流程页面通过单击“取消转入”实现。 审核中 域名转入进入审核阶段。 无需操作，等待系统转入处理。 若要取消转入，可以在转入流程页面通过单击“取消转入”实现。 域名转入过程通常需要5~7天。 转入成功 域名转入成功。 域名转入成功，需要对域名进行实名认证，详细操作请参见实名认证域名。 转入失败 域名转入失败。 根据界面提示的域名转入失败原因，进行处理： 用户取消转入 域名转移密码错误 注册局转移失败 当前域名正在转入中 域名服务商取消了该域名的转入操作 通知邮件确认超时 转入密码错误 填写的转入密码不正确，无法转入域名。 需要重新核对转入密码后，再次执行转入操作。 转入撤销 执行“取消转入”操作后，域名转入进入“转入撤销”状态。 域名状态为“转入提交”和“审核中”的域名可以执行“取消转入”。 无需操作，域名转入流程结束。

资源和成本规划 表2 资源和成本规划 资源 资源名称 资源说明 数量 每月费用（元） 实名认证信息模板 根据域名所有者定义模板名称 根据工信部域名实名认证的要求，在进行域名注册、域名过户（用户类型及域名所有者变更）、域名实名认证、域名转入等操作时，需要填写域名的用户信息。 建议您在进行上述操作前，首先创建域名的信息模板。 1 信息模板不计费 转入域名 域名的名称 域名转入是免费办理的。但因域名注册局的规定，转入时需在原期限上续费1年，因此，需支付域名续费1年的费用。 用户自定义迁移的域名数量 在华为云的价格详情中，点击域名类型查看相应的价格。

步骤3：获取转移密码 域名转入华为云前，必须在域名服务商处获取转移密码（auth-code）才能进行。 以下列服务商为例子，域名转入华为云需先获取原服务商的转移码（auth-code）。请在原服务服务商帮助中心搜索“域名转出”，查看获取转移码的方法。 如果域名注册商是新网，则不支持将该域名转入华为云。 华为云的域名注册服务与新网合作，通过华为云注册的域名其注册商为新网，由华为云提供域名管理服务。因此在从其他服务商处将域名转入华为云时，新服务商为‘新网’。 如果原域名服务商拒绝提供域名转移密码，可采用以下方式进行投诉： 国际域名投诉：https://forms.icann.org/en/resources/compliance/complaints/transfer/form 国内域名投诉：supervise@cnnic.cn（邮箱），010-58813000（电话）

步骤2：创建实名认证的信息模板 您可以通过创建信息模板操作预先设置域名所有者的信息，并对信息模板进行实名认证。完成信息模板创建后，在域名转入时可以直接使用已经创建的信息模板设置域名信息。 信息模板的实名认证审核由注册局负责，一般1个工作日内即可完成审核（部分需要3~5个工作日）。 登录域名注册控制台。 进入“域名列表”页面。 在左侧树状导航栏中，选择“信息模板”。 在页面右上角，单击“创建信息模板”。 图4 创建信息模板 设置“用户类型” 根据实名认证证件内容填写“基本信息”区域。填写说明请参考信息模板简介。 完成模板信息填写后单击“提交”，完成信息模板的配置。 在左侧树状导航栏中，选择“信息模板”。 在信息模板列表中，可以查看已创建的信息模板。 此时，信息模板的“认证状态”为“实名认证审核中”。待信息模板的“认证状态”变为“已实名认证”，表示信息模板实名认证审核通过。 实名认证一般1个工作日内即可完成审核（部分需要3~5个工作日），请您耐心等待。

流程指导 域名转入华为云管理的流程如下： 在华为云控制台查看域名是否支持转入华为云。 在原服务商处获取转移密码（auth-code）。 在华为云控制台提交域名转入。 查看转入进度。 系统自动校验转移密码，命名审核等，校验通过后注册局会向原服务商发送转出确认通知，原服务商确认后(不同服务商确认时间不同，可以催原服务商尽快确认转出)，域名开始转入。 （可选）如需使用华为云DNS解析您的域名，可参考域名转入华为云解析将原服务商的解析记录转移至华为云。 视频指导：域名转入华为云操作指导 图2 域名转入华为云流程图

应用场景 域名转入分为域名转入华为云管理和域名转入华为云解析。 域名转入：使用第三方服务商注册的域名，想要转入华为云管理。 域名解析：已使用第三方DNS服务商进行解析，想要转入华为云DNS解析。 根据实际业务域名转入分为三种具体的场景，如表1所示。本节操作介绍的是将域名转入华为云管理的操作步骤。 表1 业务诉求与解决方案 业务诉求 解决方案 域名转入华为云管理 域名在原服务商处解析 参考本节操作，将域名转入华为云管理即可。 域名转入华为云管理 域名转入华为云解析 步骤1：参考本节操作转入域名管理。 步骤2：参考域名转入华为云解析将解析转入华为云。 域名在原服务商处管理 域名转入华为云解析 步骤1：参考域名转入华为云解析将解析转入华为云。 步骤2：在云服务商处修改域名的DNS地址为华为云DNS地址。

方案架构 域名转入华为云分为“域名转入华为云管理”和“域名转入华为云解析”。 域名转入华为云管理：将域名的管理权转入华为云，该操作是针对域名的管理权，不改变域名的“DNS服务器”设置以及域名的解析记录，因此，不影响域名的正常解析。 本节操作介绍的是将域名转入华为云管理的操作步骤。 域名转入华为云解析：将域名的解析记录集转移至华为云云解析服务。具体操作请参考域名转入华为云解析。 图1 域名转入华为云 某些域名服务商不提供单独的DNS服务，例如GoDaddy，在域名转出后会删除原有的域名解析数据。因此，从GoDaddy转入华为云的域名，其解析会失效。 在域名转移期间，不支持修改域名的“DNS服务器”设置，即不支持进行解析的迁移。 为了保证在域名转入时，域名的解析不受影响，建议您在域名转入操作前先将域名的解析迁移至华为云，待解析迁移完成后再进行域名转入操作。解析迁移的详细指导，请参见迁移域名到华为云进行解析。

应用场景 账号间转移域名分为账号间转移域名管理权和账号间转移域名的解析记录。 以为域名在账号A处管理和解析为例，计划转移至账号B，根据具体业务分为以下三种场景，如表1所示。本节操作介绍的是将域名的解析记录从账号A转移到账号B的操作方法。 账号间转移域名解析记录，需要先删除转移前账号云解析服务控制台下托管的域名及对应解析记录，此过程有可能导致解析中断，请谨慎操作。 表1 业务诉求与解决方案 业务诉求 解决方案 域名从账号A转移至账号B管理 域名解析记录集从账号A转移至账号B 步骤1：参考域名账号间转移，将域名从账号A转移至账号B管理。 步骤2：参考本节操作将域名解析记录集从账号A转移至账号B。 域名在账号A处管理 域名解析记录集从账号A转移至账号B 参考本节操作将域名解析记录集从账号A转移至账号B。 域名从账号A转移至账号B管理 域名在账号A处解析 参考域名账号间转移，将域名从账号A转移至账号B管理。

操作步骤 要在B账号中重新添加域名解析，需要先登录A账号导出解析记录，删除原有的解析记录。然后在账号B导入解析记录。 登录A账号导出解析记录。 A账号登录域名解析控制台 在域名列表中，单击待导出的域名，进入域名详情页面。 在左侧导航栏，单击“批量导入/导出”。 单击页面右上角的“批量导出”，开始批量导出域名的解析记录。 导出完成后，会生成格式为“域名.xlsx”的解析记录表格。例如“example.com.xlsx”。 在“example.com.xlsx”中可以查看导出的解析记录，包括域名、记录类型、TTL值以及记录值。 在A账号的域名解析控制台删除域名和解析记录。 此处删除公网域名会导致解析中断，直至B账号导入解析记录后才可以恢复解析。 A账号登录域名解析控制台 在域名列表中，勾选待删除的公网域名，单击“删除”。 在“删除公网域名”页面，单击“是”，确认删除公网域名。 登录B账号，导入解步骤1的解析记录。 B账号登录域名解析控制台 单击“创建公网域名”，将域名添加至域名解析控制台。 单击域名，进入域名详情页面。 在左侧导航栏，单击“批量导入/导出”。 单击页面右上角的“批量导入”，导入1导出的解析记录。 导入完成后，可以通过查看“导入成功记录”和“导入失败记录”检查解析记录导入是否成功。

常见问题 域名账号间转移是否影响DNS解析？ 域名账号间转移不影响域名的DNS解析。 域名账号间转移是指将域名的管理权从一个华为云账号转移至另一个华为云账号，不改变域名的“DNS服务器”设置以及域名的解析记录，因此，不影响域名的正常解析。 域名账号间转移后，域名的解析记录不变，仍然归属在初始账号中。 如果要将域名的解析也转移至目的账号，则可能会导致DNS解析中断。这是由于同一个域名在华为云的云解析服务只能创建一次，所以需要在初始账号中删除已创建的公网域名及对应的解析记录后，才能在目的账号中重新创建公网域名并配置解析记录。详细操作过程，请参见删除公网域名和配置网站解析（华为云注册域名）。 域名转移与域名过户有什么区别？ 表2 域名与解析常见迁移操作 类型 说明 是否影响DNS解析 域名账号间转移 （转移管理权） 将域名的管理权从一个华为云账号转移至另一个华为云账号。 否。 不改变域名的“DNS服务器”设置以及域名的解析记录，因此，不影响域名的正常解析。 解析账号间转移 将域名的解析记录从账号A转移到账号B 是 账号间转移域名解析记录，需要先删除转移前账号中托管的域名及对应解析记录，此过程有可能导致解析中断，请谨慎操作。 域名过户 域名用户类型以及域名所有者的变更，即更换域名的实名认证模板。 否。 不改变域名的“DNS服务器”设置以及域名的解析记录，因此，不影响域名的正常解析。

续费相关的功能 华为云UCS支持从UCS控制台续费包年/包月资源，如表1所示。 表1 续费相关的功能 功能 计费项 说明 手动续费 UCS集群管理服务 包年/包月的UCS服务从购买到计费周期结束、转换为按需计费之前，您可以随时在UCS控制台为其续费，以继续按优惠价格使用UCS服务。 自动续费 UCS集群管理服务 开通自动续费后，UCS包年/包月套餐包会在每次到期前自动续费，避免因忘记手动续费而导致使用成本增加。

包年/包月服务 对于包年/包月计费模式的云服务，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户，详细的退订规则请参见云服务退订规则概览。UCS服务不属于五天无理由退订服务。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。

修订记录 发布日期 修改说明 2023-04-17 第六次正式发布。 新增 计费说明，新增到期后影响描述。 2023-04-10 第五次正式发布。 新增 规格族 2020-12-14 第四次正式发布。 修改 专属计算集群与专属云的关系，完善描述。 2020-03-31 第三次正式发布。 新增 计费说明 2019-05-30 第二次正式发布。 新增 区域和可用区 2018-03-30 第一次正式发布。

计费项 计费项分为包含服务和关联服务两类。 包含服务： 专属弹性云服务器，您可以在专属虚拟化计算服务中灵活创建多种规格的专属弹性云服务器，专属弹性云服务器免费，但关联的IP、带宽、云硬盘等需要单独收费。 关联服务（用户根据需求单独购买，另行计费）： 镜像服务：对于公共镜像，部分商用操作系统会收取一定的License费用。对于市场镜像，镜像价格以镜像市场中镜像供应商提供的信息为准。 弹性公网IP：按照IP个数来收费。 公网带宽：采用按流量和按带宽两种计费模式。 云硬盘：用户可灵活选择普通云硬盘，专属计算集群硬盘等多种存储方案。云硬盘采用按需计费和包周期计费两种模式，其中，专属计算集群中的云服务器系统盘，仅支持按需计费。 各产品的价格详情，请参见价格计算器。

计费模式 计费模式：虚拟计算资源池仅支持包年的计费模式，包年计费是先购买再使用的方式，用户在购买时，系统会根据用户所选的机型对用户云账户中的金额进行扣除。 计费周期：以年为计费周期，计费周期以UTC+8时区的时间为准。计费周期的起点是资源开通的时间点（精确到秒），终点是指定使用时长后的第一个 00:00:00。 举例：假设用户在2017年2月1日13:23:56开通资源，计费周期终点是2018年2月2日00:00:00。 计费量纲：以物理服务器台数作为计费量纲。 购买：以年为购买周期，新购物理服务器数量不得少于4台。 续费：以年为续费周期，续费物理服务器数量不少于4台。一个计费周期到期后，您可以选择手动续费或者自动续费，继续使用资源，也可以选择中止服务。 举例：假设用户有8台物理服务器在2018年2月2日00:00:00资源到期，续费服务器数量不得小于4台。续费周期起点是2018年2月2日00:00:00资源到期，终点是2019年2月3日00:00:00。 退款：不支持无理由退款，如果用户要求退款请走工单方式申请。

到期后影响 图1描述了包年专属计算集群资源各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图1 包年专属计算集群资源生命周期 到期预警 包年专属计算集群资源在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年专属计算集群资源到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访问包年专属计算集群资源。 如果您在宽限期内仍未续费包年专属计算集群资源，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期冻结的资源（主机及主机上云服务器实例）执行任何操作。 保留期到期后，若包年专属计算集群资源仍未续费，那么专属计算集群及其内已发放的ECS实例、弹性公网IP、云硬盘和云备份都将被释放，数据无法恢复。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "********", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求方法 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

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 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 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-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。

请求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在同一个区域也相同，所以简洁起见将这两部分省略。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 用户 由账号在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的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 父主题： 使用前必读

响应示例 状态码： 200 OK { "count" : 2, "compareJobs" : [ { "id" : "48c6acb4-1473-48fd-8676-df3705758c27", "type" : "lines", "options" : { }, "status" : "SUCCESSFUL", "start_time" : "2024-03-14T06:30:14Z", "end_time" : "2024-03-14T06:31:14Z", "export_status" : "INIT", "report_remain_seconds" : -1 }, { "id" : "9e01bd96-e627-4538-a545-5f31d1c88e94", "type" : "lines", "options" : { }, "status" : "SUCCESSFUL", "start_time" : "2024-03-14T06:30:14Z", "end_time" : "2024-03-14T06:31:14Z", "export_status" : "INIT", "report_remain_seconds" : -1, "proportion_value" : "1" } ] } 状态码： 400 Bad Request { "error_code" : "DRS.M00202", "error_msg" : "The value of jobId is invalid." }

URI GET /v3/{project_id}/jobs/{job_id}/table/compare 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 job_id 是 String 任务ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页显示的条目数量。 缺省值：1000 offset 否 Integer 偏移量，表示从此偏移量开始查询， offset大于等于0。 缺省值：0

URI POST /v5/{project_id}/jobs/{job_id}/db-object/template 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 job_id 是 String 任务ID。 表2 Query参数 参数 是否必选 参数类型 描述 file_import_db_level 否 String 文件模板支持数据同步级别，不填默认为table表级。 缺省值：table 枚举值： database table

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 发送的实体的MIME类型。使用multipart/form-data，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：multipart/form-data X-Auth-Token 是 String 从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。 缺省值：en-us 枚举值： en-us zh-cn 表4 FormData参数 参数 是否必选 参数类型 描述 file 是 File 待上传的模板文件。

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 send_success Boolean 是否上传完成。 process_status String 文件解析状态。 parsed_success_number String 解析成功的行数。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：1 最大长度：512

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json X-Auth-Token 是 String 从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。 缺省值：en-us 枚举值： en-us zh-cn