约束与限制 OMS 迁移任务限制参见下表。 表1 OMS迁移任务限制 类别 限制 多版本对象迁移 OMS默认只迁移源端多版本对象中的最新版本，不支持迁移历史版本的对象存储数据。 目的端桶存储类别 目的端桶的存储类别为：标准存储、低频访问存储、归档存储和深度归档存储。 迁移网络 支持公网迁移，内网迁移。不支持专线迁移。 元数据迁移 仅支持中文字符、英文字符、数字和中划线【-】迁移。除上述字符外，其他所有字符均不支持。 中文字符：迁移过程中，会被转换成URL编码形式。 注意： 不支持中文标点符号迁移，由于中文标点符号不会被转换成URL编码，因此元数据中包含中文标点符号时，将无法迁移成功。 英文字符、数字与中划线【-】：迁移过程中不需要进行编码转换，可以直接迁移。 迁移范围 目前单个任务（迁移任务/迁移任务组）仅支持迁移单桶数据，如果涉及多桶数据迁移，需要创建多个任务。 软链接 暂不支持源端软链接文件的迁移。在迁移过程中，软链接文件均会添加到失败列表中并造成迁移任务最终失败，但其中非软链接文件可正常迁移到目的端。如果源端包含软链接，请进行如下处理： 填写实际的文件路径。 对象ACL迁移 OMS暂不支持对象ACL迁移。 迁移速度 通常OMS的迁移速度参考值是10~20 TB每天。若需更高的迁移效率，建议使用迁移中心MgC的存储迁移工作流进行迁移。迁移中心MgC提供独享的集群资源，能够动态扩展迁移性能，最高支持20Gbit/s带宽。 迁移速度受源端对象个数、大小，带宽以及公网传输距离影响，建议用户创建一个含有实际数据的迁移任务来测试迁移速度，实际最大迁移速度为单个任务平均速度的5倍（单个Region内并发任务数最大为5）。如果需要更高的并发任务数，可以使用迁移中心 MgC的存储迁移工作流来自定义并发子任务数。 归档数据 对于归档类型的数据，迁移前需要您进行解冻操作，待解冻完成后再创建迁移任务，解冻时请注意如下事项： 请务必在解冻完成后再创建迁移任务。 请根据待迁移的数据总量评估并设置解冻有效期，以防迁移期间数据再次变成归档状态。 解冻操作可能会产生一定的费用，由源端云厂商收取，计费规则请咨询源端云厂商。 迁移任务 同一用户，单个Region内并发任务数最大为5。 说明： 假设分别迁移对象存储数据到华北-北京一和华南-广州时，总并发数为5*2=10个。 24小时内，单个Region内最多创建迁移任务数为1000000个。 迁移任务组 同一用户，单个Region内并发任务组数最大为5。 说明： 假设分别迁移对象存储数据到华北-北京一和华南-广州时，总并发数为5*2=10个。 同步任务 同步任务和迁移任务、迁移任务组共用配额，优先于迁移任务、迁移任务组下发。 并发执行同步中的任务数量最多为5个。 对象列表文件 对象列表文件大小不能超过1024MB。 对象列表文件必须是“.txt”类型的文件，并且该文件元数据中的“ContentType”只能为：“text/plain”。 对象列表文件必须是UTF-8无BOM格式编码格式。 对象列表文件中每行只能包含一个对象名称，并且对象名称使用URL Encode编码。 对象列表文件中每行不要添加无效空格，否则会将空格作为对象名，导致迁移失败。 对象列表文件中每行长度不要超过65535，否则会导致迁移失败。 对象列表文件的元数据中不能设置“ContentEncoding”，否则会导致迁移失败。 URL列表文件 URL列表文件大小不能超过1024MB。 URL列表文件必须是“.txt”类型的文件，并且该文件元数据中的“ContentType”只能为：“text/plain”。 URL列表文件必须是UTF-8无BOM格式编码格式。 URL列表文件中每行只能包含一个URL和目的端对象名称。 URL列表文件中每行长度不要超过65535，否则会导致迁移失败。 URL列表文件的元数据中不能设置“ContentEncoding”，否则会导致迁移失败。 URL列表文件中每行不要添加无效空格，否则会将空格作为对象名，导致迁移失败。 URL列表文件中每行使用制表符\t分隔URL和目的端对象名称，格式为：[URL][制表符][目的端对象名称]，其中源端对象名称如果包含中文、特殊字符必须使用URL Encode对URL编码；目的端对象名称如果包含中文、特殊字符也需要使用URL Encode编码。例如： http://xxx.xxx.xxx.xxx.com/doc/%e6%96%87%e4%bb%b61.txt doc/%e6%96%87%e4%bb%b61.txt http://xxx.xxx.xxx.xxx.com/doc/thefile2.txt doc/thefile2.txt http://xxx.xxx.xxx.xxx.com/the%20file.txt the%20file.txt http://xxx.xxx.xxx.xxx.com/the%20file2.txt the+file2.txt http://xxx.xxx.xxx.xxx.com/doc/thefile.txt doc/thefile.txt 注意： URL编码仅从 域名 后第二个字符开始，不要将协议头、域名以及域名两侧的斜线转码，否则将导致格式校验错误。 URL与目的端对象名称之间使用一个制表符（键盘上Tab键）进行分隔，请勿使用空格。 以上示例中，URL所表示的文件，被复制到目的端桶后，对象会被分别命名为：doc/文件1.txt、doc/thefile2.txt、the file.txt、the file2.txt以及doc/thefile.txt。 URL列表文件中的URL需确保可通过HEAD和GET请求正常访问。 失败对象列表文件 单个任务失败对象列表最多记录10万个失败对象。 说明： 失败对象超过10万个的场景，建议基于已有失败对象列表，分析处理后重新迁移。

前提条件 已 注册华为账号 并开通华为云，完成实名认证。 已创建URL列表文件并上传至OBS，确保URL列表文件中的URL可通过HEAD请求和GET请求正常访问。 如果URL列表文件中的URL无法通过HEAD请求和GET请求正常访问，则该场景不适合HTTP/HTTPS方式迁移，建议通过桶迁移方式迁移或者咨询OBS其他方案。 已获取目的端账号的AK/SK并授予相关权限。 目的端桶需要的权限包括：列举桶，获取桶位置，列举对象，获取对象元数据，获取对象内容，上传对象，列举已上传段，取回归档存储对象。获取方式参见目的端桶权限获取。 已在OBS服务中创建桶。 您过去24小时内已创建的迁移任务未满1000000个。 您名下处于“等待中”状态的迁移任务未满1000000个。

请求参数 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateHttpDto 是 REFERENCE 详细请参见表4。 站点模板HTTP配置信息 - 表4 SiteTemplateHttpDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 enableHttp 是 boolean true false true HTTP使能开关。默认值为true。 true

URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/enablehttp 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板标识，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 isForceOverride 否 boolean true false - 是否强制覆盖 true

请求示例 HTTP的示例 PUT /controller/campus/v3/networkconfig/site-templates/fbde1c5d-5b94-49e3-a912-48641015e45c/enablehttp?isForceOverride=true HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy { "enableHttp" : true }

响应示例 返回状态码为200：站点模板HTTP配置结果。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "enableHttp" : true } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部服务错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 GET /controller/campus/v3/networkconfig/site-templates/fbde1c5d-5b94-49e3-a912-48641015e45c/enablehttp HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

响应参数 返回状态码为200：站点模板HTTP配置配置结果。 表2 SiteTemplateHttpResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~128个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data REFERENCE 详细请参见表3。 站点模板HTTP配置信息。 - 表3 SiteTemplateHttpDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 enableHttp boolean true false true HTTP使能开关。默认值为true。 true 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部服务错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：站点模板HTTP配置配置结果。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "enableHttp" : true } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部服务错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/enablehttp 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板标识，UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c"

配置参数 表1 请求配置参数 参数 说明 请求地址 请求地址为绝对地址或相对地址（如果在连接器中设置了基本地址）。绝对地址格式为http://example.com/v1 或 https://example.com/v1，相对地址格式为：/v1。 失败时停止 请求失败时，是否停止业务流任务并报错。 参数 配置请求参数。单击“添加”，以键值对的形式添加请求参数。参数包括以下三种类型： Query：附加在 URL 末尾，用于向服务器传递额外的信息。 Header：包含在 HTTP 请求头中，用于传递与请求相关的元数据或认证信息。 Path：直接嵌入在 URL 路径中的变量，用于指定资源的唯一标识或层级结构。在请求地址中设置格式为{Path}的路径，将自动添加Path类型的参数。 请求体类型 仅当HTTP请求的动作选择“POST”或“PUT”时需要配置。 选择API的请求Body体类型，包括raw/form-data/x-www-form-urlencoded三种类型。 请求体 仅当HTTP请求的动作选择“POST”或“PUT”时需要配置。 填写API的请求Body体内容。 响应头数据结构 返回json格式响应头数据。键表示Header字段名称，值表示Header字段值。每行数据以逗号拼接。Payload说明详见引用变量。 响应体数据结构 返回json格式响应体数据。键表示Body字段名称，值表示Body字段值。每行数据以逗号拼接。Payload说明详见引用变量。

创建HTTP请求连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“HTTP请求”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 基本地址 为所有请求设置基本地址，基本地址格式：http://example.com/v1 或 https://example.com/v1 安全认证 要调用API所使用的认证方式。 APP认证：使用API所授权集成应用的Key和Secret进行API请求的安全认证。 无认证：表示API请求不需要认证。 Client Credentials认证：通过Client ID和Client Secret来获取Access Token，并使用该Token进行 API 请求的认证。 Basic Auth认证：通过将用户名和密码进行 Base64 编码后放入 HTTP 请求头中进行认证；适用于对安全性要求不高的内部系统或测试环境。 Secret认证：通过预共享密钥进行 API 请求认证的方式。 APP Key 仅当“安全认证”选择“APP认证”时需要配置。 API所授权集成应用的Key。 APP Secret 仅当“安全认证”选择“APP认证”时需要配置。 API所授权集成应用的Secret。 AccessTokenUrl 仅当“安全认证”选择“Client Credentials认证”时需要配置。 获取访问令牌的地址（由 API 提供方提供）。 ClientId 仅当“安全认证”选择“Client Credentials认证”时需要配置。 API 提供方分配的客户端 ID。 ClientSecret 仅当“安全认证”选择“Client Credentials认证”时需要配置。 API 提供方分配的客户端 ID。 scope 仅当“安全认证”选择“Client Credentials认证”时需要配置。 API 访问权限范围，根据 API 提供方的要求填写。 用户名 仅当“安全认证”选择“Basic Auth认证”时需要配置。 API 认证的用户名。 密码 仅当“安全认证”选择“Basic Auth认证”时需要配置。 API 认证的密码。 Secret 仅当“安全认证”选择“Secret认证”时需要配置。 API 提供方分配的密钥。 描述 填写连接器的描述信息，用于识别不同的连接器。

支持的动作 GET：GET 请求用于从服务器获取资源。它将请求参数附加在 URL 中，适用于查询数据或获取资源的场景。 POST：POST 请求用于向服务器提交数据，通常用于创建新资源或执行操作。 PUT：PUT 请求用于更新服务器上的资源，适用于替换或更新整个资源的场景。 DELETE：DELETE 请求用于删除服务器上的资源。 HEAD：HEAD 请求与 GET 请求类似，但服务器只返回响应头，不返回响应体。它通常用于获取资源的元数据（如文件大小、修改时间等）。

创建HTTP请求连接 登录CodeArts Link控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“HTTP请求”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 描述 填写连接器的描述信息，用于识别不同的连接器。 基本地址 要调用API的请求地址。 安全认证 要调用API所使用的认证方式。 APP认证：使用API所授权集成应用的Key和Secret进行API请求的安全认证。 无认证：表示API请求不需要认证。 APP Key（APP认证） 仅当“安全认证”选择“APP认证”时需要配置。 API所授权集成应用的Key。 APP Secret（APP认证） 仅当“安全认证”选择“APP认证”时需要配置。 API所授权集成应用的Secret。

前提条件 已拥有华为云账号且已实名认证。 华为云账号未欠费，且有足够金额购买本案例所涉及的资源。 已创建OBS桶，用于存放打包好的依赖包文件，更多详情请参见创建桶。 开始使用本案例前请在本地安装好18.15.0版本的Node.js运行环境。 当前华为云 函数工作流 服务支持的Node.js运行时最高版本为18.15.0、Next.js支持最高版本为13.5.6，本案例将以Next.js版本为13.5.6举例介绍。