华为云用户手册

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-1", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

Token认证 Token的有效期为24小时，需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。 获取Token 后，再调用其他接口时，需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFG....”，则调用接口时将“X-Auth-Token: ABCDEFG....”加到请求消息头即可，如下所示。 GET https://mssi.cn-north-4.myhuaweicloud.com/v1/{project_id}/flows/running-history Content-Type: application/json X-Auth-Token: ABCDEFG.... 还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。 还可以参考华为云 IAM 认证服务了解如何获取IAM用户Token。

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

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

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

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 需要添加到请求中的公共消息头如表3所示。 表3 公共请求消息头 参数名 说明 是否必选 示例 Content-type 消息体的类型（格式），默认取值为“application/json”。 是 application/json X-Auth-Token 用户Token，也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 否，使用Token认证时该字段必选。 - X-Sdk-Date 请求的发生时间，格式为(YYYYMMDD'T'HHMMSS'Z')。 取值为当前系统的GMT时间。 否，如果使用AK/SK做接口认证的时候，那么此字段必须设置；如果使用PKI token的时候，不必设置。 20190307T101459Z Authorization 签名认证信息。 该值来源于请求签名结果，使用AK/SK进行加密签名的时候需要。 类型：字符串 默认值：无 否，使用AK/SK认证时必选。 SDK-HMAC-SHA256 Credential=ZIRRKMTWPTQFQI1WKNKB/20150907//ec2/sdk_request, SignedHeaders=content-type;host;x-sdk-date, Signature=55741b610f3c9fa3ae40b5a8021ebf7ebc2a28a603fc62d25cb3bfe6608e1994 Host 请求的服务器信息，从服务API的URL中获取。 值为hostname[:port]。 端口缺省时使用默认的端口，https的默认端口为443。 否，使用AK/SK认证时必选。 code.test.com 或者 code.test.com:443 API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。AK/SK认证的详细说明请参见API签名指南。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://mssi.cn-north-4.myhuaweicloud.com/v1/{project_id}/flows/{flow_id}/run Content-Type: application/json

请求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-1.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-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议不要直接使用账号进行日常管理工作，而是创建并使用用户进行日常管理工作。 IAM用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区 可用区是同一服务区内，电力和网络互相独立的地理区域，一般是一个独立的物理机房，这样可以保证可用区的独立性。 一个区域内有多个可用区，一个可用区发生故障后不会影响同一区域内下的其它可用区。 可用区间通过内网访问。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问账号中该区域的所有资源。如果希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 同样在我的凭证下，可以查看项目ID。 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理服务用户指南》。 父主题： 使用前必读

概述 欢迎使用开天 集成工作台 （MacroVerse SmartStage for Integrators，MSSI），开天集成工作台是一个助力企业应用创新的开放的集成平台。基于元数据、可配置的集成框架，汇聚丰富的集成资产以及开发工具，帮助企业实现业务流程的自动化，连通企业内的应用孤岛，以及创新应用的高效（低代码）开发。 您可以使用本文档提供的API对MSSI服务进行相关操作，如查询、提交、启用流。MSSI服务支持的全部操作请参见API概览。 在调用开天集成工作台API之前，请确保已经充分了解开天集成工作台相关概念，详细信息请参见《产品介绍》。 父主题： 使用前必读

响应示例 状态码： 200 请求成功。 { "count" : 1438, "histories" : [ { "id" : "df00b54a-7765-4ed9-98fe-1504119841e4", "flow_id" : "55e42ede-25dd-4f79-9aa4-842e1ba435a1", "flow_name" : "业务对象测试", "flow_version_id" : "55e42ede-25dd-4f79-9aa4-842e1ba435a1", "run_model" : "auto", "status" : "fail", "icon" : null, "start_time" : "2022-02-28T06:24:04.022Z", "end_time" : "2022-02-28T06:24:04.022Z", "exec_time" : 0, "running_times" : null, "last_time" : null, "message" : "trigger action running fail." } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total Long 历史记录总数。 histories Array of histories objects 所有历史记录的信息。 表4 histories 参数 参数类型 描述 id String 流运行记录ID。 flow_id String 流ID。 flow_name String 流名称。 flow_version_id String 流运行版本ID。 run_model String 流运行模式，通常有手动、自动、测试这几种。手动方式需要用户在页面点击运行流，自动方式会按照触发器的类型自动运行流，测试方式用户在创建流的时候可以测试流的功能。 status String 最后一次运行，流运行状态。 success: 流运行成功 fail: 流运行失败 icon String 流图标。 start_time String 开始时间。 end_time String 结束时间。 exec_time Long 执行时间，单位毫秒。 running_times Long 运行次数。 last_time String 最后一次运行时间。 message String 最后一次运行，输出的错误信息。 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

URI GET /v2/{project_id}/flows/{flow_id}/running-history 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id，用于资源隔离。获取方法请参考获取项目ID。 flow_id 是 String 流id。 表2 Query参数 参数 是否必选 参数类型 描述 time_range 否 String 时间筛选范围，查询该范围内的流运行记录。UTC时间格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'toyyyy-MM-dd'T'HH:mm:ss.SSS'Z'如：2020-11-10T00:00:00Zto2020-11-12T00:00:00。 status 否 String 流运行状态，枚举值。 success: 流运行成功 fail: 流运行失败 offset 否 Integer 当前页，起始页数应大于等于0。 最小值：1 limit 否 Integer 每页记录数，每页记录数应大于等于1。 最小值：1

响应示例 状态码： 200 请求成功。 { "id" : "d96ba061-3caf-49cb-8950-4dac97a8f082", "flow_id" : "cfdcacae-a44f-4827-8ad9-db47ad2a8b41", "flow_name" : "遍历集合元素测试", "run_model" : "manual", "status" : "success", "icon" : "https://connector-icon.obs.cn-north-7.ulanqab.huawei.com/icon/c9710579264845c6a5339fd738e66fd6/155e6930bdb24d9d95b5d3c636e133eb.png", "start_time" : 1655881122470, "end_time" : 1655881126839, "exec_time" : 4369, "message" : null, "steps" : [ { "stepId" : "05778538-83a6-467b-bb92-738d9049bb3c", "actionName" : "手动触发器触发事件", "actionType" : null, "call" : { "connectorRef" : "ManualTrigger", "triggerRef" : { "refName" : "手动触发器触发事件", "refId" : "ManualTrigger", "type" : "instant", "authentication" : { "connectionId" : null, "schema" : null }, "input" : { "body" : { } }, "config" : null, "customFunctionMap" : null }, "actionRef" : null, "connectorVersion" : "1" }, "transmit" : [ "bc744b98-007f-496e-bd10-ed460548f7de" ], "icon" : "https://connector-icon.obs.cn-north-7.ulanqab.huawei.com/icon/c9710579264845c6a5339fd738e66fd6/155e6930bdb24d9d95b5d3c636e133eb.png", "name" : "手动触发流", "lastRunningStatus" : "success", "cost" : 354 } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total Long 历史记录总数。 histories Array of histories objects 所有历史记录的信息。 表4 histories 参数 参数类型 描述 id String 流运行记录ID。 flow_id String 流ID。 flow_name String 流名称。 flow_version_id String 流运行版本ID。 run_model String 流运行模式，通常有手动、自动、测试这几种。手动方式需要用户在页面点击运行流，自动方式会按照触发器的类型自动运行流，测试方式用户在创建流的时候可以测试流的功能。 status String 最后一次运行，流运行状态。 success: 流运行成功 fail: 流运行失败 icon String 流图标。 start_time String 开始时间。 end_time String 结束时间。 exec_time Long 执行时间，单位毫秒。 running_times Long 运行次数。 last_time String 最后一次运行时间。 message String 最后一次运行，输出的错误信息。 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

URI GET /v2/{project_id}/flows/running-history 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id，用于资源隔离。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 time_range 否 String 时间筛选范围，查询该范围内的流运行记录。UTC时间格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'toyyyy-MM-dd'T'HH:mm:ss.SSS'Z'如：2020-11-10T00:00:00Zto2020-11-12T00:00:00。 name 否 String 流的名称。 status 否 String 流运行状态，枚举值。 success: 流运行成功 fail: 流运行失败 offset 否 Integer 当前页，起始页数应大于等于0。 最小值：1 limit 否 Integer 每页记录数，每页记录数应大于等于1。 最小值：1

响应示例 状态码： 200 请求成功。 { "count" : 5, "histories" : [ { "id" : "f4ce35fd-5e33-4d9e-b7e1-63f3a07d74ce", "flow_id" : "55e42ede-25dd-4f79-9aa4-842e1ba435a1", "flow_name" : "业务对象测试", "flow_version_id" : null, "run_model" : null, "status" : "fail", "icon" : "data:image/png;base64,iVBORw0KGgoAAA...", "start_time" : "2022-02-28T03:34:04.025Z", "end_time" : null, "exec_time" : 0, "running_times" : 1438, "last_time" : "2022-02-28T03:34:04.025Z", "message" : "trigger action running fail." }, "..." ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 success Boolean 响应是否成功，默认为true。 状态码： 403 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 running_id String 流记录id。 flow_id String 流id。 success Boolean 流运行状态 success: 流运行成功 fail: 流运行失败 flow_name String 流名称。 message String 返回信息。 状态码： 403 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

错误码 状态码 错误码 错误信息 描述 处理措施 400 MSSI.00010001 connector is not found 连接器不存在 请检查填写的连接器。 400 MSSI.00010002 icon not found 图片资源不存在 请检查填写的图片资源。 400 MSSI.00010003 swagger data not found swagger资源不存在 请检查填写的swagger资源。 400 MSSI.00010004 connector can not delete 内置连接器无法删除 请正确选择要删除的连接器，内置连接器无法删除。 400 MSSI.00010005 connector was used in flow or template can not delete 该连接器已在流中使用，请删除流后再进行此操作 请先删除使用该连接器的流。 400 MSSI.00010006 connector name can not be null 创建连接器，名称不可为空字符串 请填写连接器名称。 400 MSSI.00011001 flow not found 流不存在 请检查填写的流。 400 MSSI.00011002 flowConnector not found 流对应的连接器找不到 请选择其他连接器。 400 MSSI.00011003 flowRepository not found 流对应的仓库找不到 请选择其他仓库。 400 MSSI.00011004 duplicate flowName 流名称重复 请重命名重复的流名称。 400 MSSI.00012001 template not found 模板不存在 请检查填写的模板。 400 MSSI.00012002 cooperation not found 模板供应商不存在 请选择其他模板供应商。 400 MSSI.00013001 gateway not found 网关不存在 请选择其他网关。 400 MSSI.00014001 share not found 共享数据不存在 请选择其他共享数据。 400 MSSI.00015001 connect not found 连接不存在 请检查填写的连接。 400 MSSI.00015002 connectionName repeat 连接名称重复 请更换重复的名称。 400 MSSI.00016001 function not found 函数找不到 请检查填写的函数。 400 MSSI.00017001 data format is incorrect 数据格式不正确 请检查填写的数据格式。 400 MSSI.00017002 no permission 无权限操作该资源 请添加操作该资源的权限。 400 MSSI.00017003 no certification 无认证方式 请添加认证方式。 400 MSSI.00017004 batch operate apic failed 批量操作APIC失败 请稍后重试，或者联系技术支持人员。 400 MSSI.00017005 operate swagger failed 批量操作SWAGGER失败 请稍后重试，或者联系技术支持人员。 400 MSSI.00017006 to bean failed JsonUtils 请检查JSON格式的合法性。 400 MSSI.00017007 is not a pic 导入不是图片文件 请导入图片文件。 400 MSSI.00017008 is not a swagger 导入文件不符合Swagger标准 请检查导入的文件是否符合Swagger标准。 400 MSSI.00017010 param is invalid 连接正在使用，无法删除 请先停止正在使用的流程，再删除。 400 MSSI.00017011 flow is enable 流正在使用，无法删除 请先停止正在使用的流，再删除。 400 MSSI.00020001 flow is not exist 流程不存在 请检查填写的流程。 400 MSSI.00020002 connector is not exist 连接器不存在 请检查填写的连接器。 400 MSSI.00020003 connect is not exist 连接不存在（认证连接） 请核对鉴权信息。 400 MSSI.00020005 time_range is invalid, example:2020-11-10T00:00:00.000Zto2022-23-10T00:00:00.000Z 无效的时间范围格式 请更改时间格式为统一UTC时区。 400 MSSI.00020006 decrypt database password error 数据库密码错误 请检查填写的数据库密码。 400 MSSI.00020007 trigger type is invalid. 无效的触发器类型 请检查触发器类型是否符合规范。 400 MSSI.00020008 flow has no trigger step. Please check flow step config. 不存在FLowStep 请检查FLowStep配置信息。 400 MSSI.00020009 connector is not exist or deploy_url is empty. 连接器不存在或部署地址为空 请检查填写的连接器是否规范，或者是否填写部署地址。 400 MSSI.00020011 param is invalid. 参数无效 请检查填写的参数。 400 MSSI.00020012 running history is not exist. 流运行历史不存在 请检查填写的流。 400 MSSI.00020015 time_range exceeds 30 days. 时间范围超过30天 请检查选择的时间区间 400 MSSI.00020016 connector release version not exits. 连接器发布版本不存在 请检查连接器版本 400 MSSI.00020017 connector invoke record not exits. 连接器调用记录不存在 请检查填写的连接器 400 MSSI.00020018 flow status is disable 流被禁用 请检查流的状态 400 MSSI.00020019 action in not exist 连接器执行动作不存在 请检查执行动作 400 MSSI.00020020 action is not belong to connector 执行动作不属于连接器 请检查执行动作 403 MSSI.00020004 forbidden operation. concat the project owner 操作越权，禁止操作。 操作了其他租户的资源 请检查权限信息。 500 MSSI.00029999 unknown error 未知的异常，一般来说是系统内部超出预期的异常 系统错误，请联系技术支持人员。 500 MSSI.00050001 Internal Server Error 未知的异常，一般来说是系统内部超出预期的异常 系统错误，请联系技术支持人员 500 MSSI.00050002 Failed to connection DataSource 连接数据源失败 请检查数据源连接信息 500 MSSI.00050004 Unsupported datasource type 不支持的数据源类型 请检查数据源类型 500 MSSI.00050005 MetaModel adapter is not found 元模型适配器未找到 请检查元模型适配器 500 MSSI.00050013 Task not found 采集任务未找到 请检查采集任务 500 MSSI.00050015 MetaData adapter failed 元数据采集适配器失败 请检查元模型适配器 400 MSSI.00050018 Some params are invalid 参数不合法 请检查参数 400 MSSI.00050019 Resource count over limit 资源超限 请检查资源配额 404 MSSI.00050021 Resource not exist 资源不存在 请检查资源是否存在 403 MSSI.00050022 No permission 没有权限访问 请检查权限 500 MSSI.00050024 Schedule log aspect record schedule log failed 审计日志记录失败 系统错误，请联系技术支持人员 400 MSSI.00050025 Unsupported adapter type 不支持的适配器类型 请检查适配器类型 403 MSSI.00050027 Taskcollector's parameter has modify failed, task maybe in the status of starting, executing and stopfailed. 任务采集失败 请检查采集任务 父主题： 附录

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 success Boolean 响应是否成功，默认为true。 状态码： 403 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

创建执行动作 连接器需要添加执行动作（连接器具有的功能）并发布后，才能被使用。 在连接器详情界面，在“执行动作”页签，单击“创建执行动作”。 配置执行动作基本信息，如图3所示，请参考表2。 图3 配置执行动作基本信息 表2 执行动作基本信息说明 参数 说明 示例 名称 必填项。 执行动作的名称，根据规划自定义。建议您按照一定的命名规则填写执行动作的名称，方便您快速识别和查找。 IP地址查询 类型 必选项。 API：通过调用API的方式创建执行动作。 函数：通过自定义函数的方式创建执行动作。函数类型支持 CDM 集成。 流：通过编排流的方式创建执行动作。 API 可见性 必选项。 可见：在流编排中该执行动作可见。缺省值为“可见”。 隐藏：在流编排中该执行动作不可见。 可见 描述 选填项。 连接器的描述信息，该描述将显示在连接器的详情中，帮助用户了解连接器。 IP地址查询 单击“下一步”。 配置执行动作输入信息，如图4所示，请参考表3。 根据被调用的接口请求信息配置参数。 图4 配置执行动作输入信息 表3 执行动作输入信息说明 参数 说明 示例 接口路径 请求方式：被调用API的请求方式。 请求路径：被调用API的请求路径。 GET /lundear/qryip 输入参数 请求头（Header） HTTP请求消息的组成部分之一，请求头负责通知服务器有关于客户端请求的信息。 - 请求体（Body） 当请求方式为“GET”或“DELETE”时，此参数不可配置。 HTTP请求消息的组成部分之一，请求体呈现发送给服务器的数据。 - 查询参数（Query） 查询参数会追加到URL。 参数名称：ip 显示字段：ip地址 必填：勾选 参数类型：string 路径参数（Path） 路径与路径模板一起使用，其中参数值实际上是操作URL的一部分。 - 单击“下一步”。 配置输出信息。 根据被调用的接口响应信息配置参数。 如图5所示，请参考表4。 单击“确定”，在批量导入的参数中填写显示字段别名方便阅读。如图6所示。 图5 配置执行动作输出信息1 图6 配置执行动作输出信息2 表4 执行动作输出信息说明 参数 说明 示例 添加响应 被调用API的响应码信息。缺省值为“200（请求成功）”。 200（请求成功） 输出参数 响应体（Body） HTTP响应消息的组成部分之一，响应体呈现发送给服务器的数据。 说明： 如果响应体使用XML格式，XML header参数必须配置。 { "status": 0, "message": "Success", "request_id": "2dd71feb-2f7a-4426-b905-4c3ff4dcceb4", "result": { "ip": "112.36.236.188", "location": { "lat": 36.68013, "lng": 117.06533 }, "ad_info": { "nation": "中国", "province": "山东省", "city": "济南市", "district": "历城区", "adcode": 370112 } } } 响应头（Header） HTTP响应消息的组成部分之一，响应头负责通知服务器有关于客户端请求的信息。 - 单击“保存”。 创建执行动作后，系统自动返回至连接器详情页面，执行动作显示在“执行动作”页签列表中。连接器“状态”变为“待发布”。

使用限制 单账号跟踪的事件可以通过 云审计 控制台查询。多账号的事件只能在账号自己的事件列表页面去查看，或者到组织追踪器配置的OBS桶中查看，也可以到组织追踪器配置的 CTS /system日志流下面去查看。 用户通过云审计控制台只能查询最近7天的操作记录。如果需要查询超过7天的操作记录，您必须配置转储到 对象存储服务 （OBS）或 云日志 服务（LTS），才可在OBS桶或LTS日志组里面查看历史事件信息。否则，您将无法追溯7天以前的操作记录。 云上操作后，1分钟内可以通过云审计控制台查询管理类事件操作记录，5分钟后才可通过云审计控制台查询数据类事件操作记录。 CTS新版事件列表不显示数据类审计事件，您需要在旧版事件列表查看数据类审计事件。 云审计控制台对用户的操作事件日志保留7天，过期自动删除，不支持人工删除。

支持共享的资源 表1 支持共享的云服务和资源类型 云服务 资源类型 是否支持主动退出共享 应用场景 虚拟私有云 VPC vpc:subnet（子网） 是 共享VPC功能支持多个账号在一个集中管理、共享的VPC内创建云资源，比如E CS 、ELB、RDS等。VPC的所有者可以将VPC内的子网共享给一个或者多个账号使用。通过共享VPC功能，可以简化网络配置，帮助您统一配置和运维多个账号下的资源，有助于提升资源的管控效率，降低运维成本。 更多信息请参见共享VPC。 云解析服务 DNS dns:zone（内网域名） 是 基于 资源访问管理 （Resource Access Manager，简称 RAM ）服务，云解析服务可以实现跨账号共享内网域名，资源所有者将内网域名同时共享给多个其他账号使用，资源使用者接受共享邀请后就可以访问和使用共享的内网域名。 更多信息请参见共享内网域名。 dns:resolverRule（解析器规则） 是 基于资源访问管理（Resource Access Manager，简称RAM）服务，云解析服务可以实现跨账号共享转发规则，资源所有者将转发规则同时共享给多个其他账号使用，资源使用者接受共享邀请后就可以访问和使用共享的转发规则。 更多信息请参见共享转发规则。 SSL证书管理 SCM scm:cert（证书） 是 云证书管理服务 提供共享功能，用户可以将SSL证书同时共享给同一组织单元内的所有成员账号，这些账号可以将共享证书部署到ELB、WAF和CDN等服务，以启用HTTPS协议。 更多信息请参见共享证书。 私有证书管理 PCA pca:ca（私有CA） 是 云证书管理 服务私有证书管理提供共享功能，用户可以将私有CA同时共享给同一组织单元内的所有成员账号，这些账号可以使用共享CA来签发证书。 更多信息请参见共享私有CA。 企业路由器 ER er:instances（实例） 是 基于资源访问管理（Resource Access Manager，简称RAM）服务，可以实现跨账号共享企业路由器，您可以将账号A所属的企业路由器同时共享给多个其他账号，比如账号B、账号C以及账号D等。通过共享功能，可以在同一个企业路由器中接入不同账号下的虚拟私有云，构建云上同区域组网。 更多信息请参见共享概述。 函数工作流 FunctionGraph functiongraph:function（函数） 是 基于资源访问管理（Resource Access Manager，简称RAM）服务，函数工作流服务可以实现跨账号共享函数，资源所有者将函数同时共享给多个其他账号使用，资源使用者接受共享邀请后就可以访问和使用共享的函数。 更多信息请参见共享函数。 云原生应用网络 ANC anc:service（服务） 是 基于资源访问管理（Resource Access Manager，简称RAM），可以实现跨账号共享ANC的服务，您可以将账号A所属的ANC的服务同时共享给多个其他账号，比如账号B、账号C等。通过共享功能，共享ANC的服务可以接收不同账号下VPC内客户端的访问请求，有助于管理多账号下的资源，提升资源的管控效率。 anc:anc（云原生应用网络） 是 基于资源访问管理（Resource Access Manager，简称RAM），可以实现跨账号共享云原生应用网络，您可以将账号A所属的云原生应用网络同时共享给多个其他账号，比如账号B、账号C等。通过共享功能，VPC内客户端可以访问不同账号下ANC的服务，实现统一管理多账号下的资源。 NAT网关 NAT nat:transitSubnet 是 基于资源访问管理（Resource Access Manager，简称RAM）服务，可以实现跨账号共享中转子网，资源所有者将中转子网同时共享给多个其他账号使用，资源使用者接受共享邀请后就可以在中转子网下创建中转IP用于打通跨租户VPC网络。 数据加密 服务 DEW kms:KeyId（密钥） 是 要共享您拥有的KMS资源给其他账号使用时，请创建共享。创建共享的流程分为指定共享资源、权限配置、指定使用者以及配置确认。 共享KMS可以用于DEW服务的凭据实例加密、密钥对加密等，也可以用于创建RDS、DDS、OBS实例加密。 更多信息请参见共享概述。 父主题： 附录

欠费后，数据会被删除吗？ 当用户账号产生欠费后，用户需在约定时间内支付欠款，以防止账号冻结、相关服务资源停止或者释放对自身业务产生影响，具体操作请参见欠费还款。 欠费后，如果没有及时续费或充值，将进入宽限期。如宽限期满仍未续费或充值，将进入保留期。在保留期内资源将停止服务。保留期满仍未续费或充值，存储在云服务中的数据将被删除，云服务资源将被释放。详细说明请参见资源停止服务或逾期释放说明。宽限期与保留期的具体规则请参见宽限期保留期。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

到期后影响 图1描述了包年/包月云空间服务各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图1 包年/包月云空间服务生命周期 到期预警 包年/包月云空间服务在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年/包月云空间服务到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访问云服务器，但部分操作将受到限制，如退订、扩容容量大小、扩容用户数量等。退订：单击“退订”，提示“退订条件异常：已过期云服务不允许退订”。 如果您在宽限期内仍未续费包年/包月云空间服务，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，若包年/包月云空间服务仍未续费，将会自动退订，那么该资源会被删除，且不能再找回，也不能再续费。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费。

适用计费项 云空间服务的以下计费项支持包年/包月。 表1 适用计费项 计费项 说明 套餐规格 基础版 现有两种套餐：基础版与基础版（轻量型），两者均提供不同档位的用户数及存储空间组合。目前，这两种套餐在功能上没有区别。 “基础版（轻量型）”是基于华为云高可靠存储及高安全防护能力，提供企业组织空间及成员管理、文件管理与传输、文件分享、权限管控等常用操作。 “基础版”在轻量型能力基础上，增加大文件传输、文件分片传输、文件秒传、断点续传、三方App鉴权等增强能力，进一步提升企业用户的文件管理及使用体验。 订购完成后，两种套餐均支持在“套餐规格扩容”中切换或升级已购套餐。请注意，目标套餐的规格（即用户数或存储空间）不能小于当前规格，不满足条件的规格选项将被置灰，无法选择。 基础版（轻量型） 规格扩容 用户扩容包 可选，云空间用户人数扩展。已订购扩容包时，可单击“变更扩容包”“删除扩容包”进行扩容包的增减。未订购扩容包时，可单击“增配扩容包”进行扩容包的增加。用户数上限为20000人（套餐加扩容包）。 存储扩容包 可选，云空间存储空间扩展。已订购扩容包时，可单击“变更扩容包”“删除扩容包”进行扩容包的增减。未订购扩容包时，可单击“增配扩容包”进行扩容包的增加。存储空间上限95PB（套餐加扩容包）。

计费示例（无扩容包） 以下案例中出现的费用价格仅供参考，实际价格请参见各服务价格详情。 假设您在2023/03/08 15:50:04购买了基础版套餐（规格：5人/200GB）。购买时长为一个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/03/08 15:50:04 ~ 2023/04/08 23:59:59 第二个计费周期为：2023/04/08 23:59:59 ~ 2023/05/08 23:59:59 费用计算过程如下： 首次订购费用：180元 手动续费费用：180元 综上，2个月的费用 = 360元

计费示例（包含扩容包） 以下案例中出现的费用价格仅供参考，实际价格请参见各服务价格详情。 假设您在2023/03/08 15:50:04购买了基础版套餐（规格：5人/200GB）。购买时长为一个月，同时订购了5人的用户扩容包，那么1个月的费用计算过程如下： 基础版套餐费用：180元 * 1个月 =180元 用户扩容包费用：2.75元 * 5人 * 1个月 = 13.75元 综上，1个月的费用 = 基础版套餐费用 + 用户扩容包费用 = 180 + 13.75 = 193.75元

计费说明 KooDrive服务的计费项由套餐规格、存储扩容包、用户扩容包、用户数、存储空间组成。具体内容如表1所示。 表1 KooDrive计费项 计费项 计费项说明 适用的计费模式 套餐规格 现有两种套餐：基础版与基础版（轻量型），两者均提供不同档位的用户数及存储空间组合。 “基础版（轻量型）”是基于华为云高可靠存储及高安全防护能力，提供企业组织空间及成员管理、文件管理与传输、文件分享、权限管控等常用操作。 “基础版”在轻量型能力基础上，增加大文件传输、文件分片传输、文件秒传、断点续传、三方App鉴权等增强能力，进一步提升企业用户的文件管理及使用体验。 订购完成后，两种套餐均支持在“套餐规格扩容”中切换或升级已购套餐。请注意，目标套餐的规格（即用户数或存储空间）不能小于当前规格，不满足条件的规格选项将被置灰，无法选择。 包年/包月 存储空间扩容包 可选，云空间存储空间扩展。已订购扩容包时，可单击“变更扩容包”“删除扩容包”进行扩容包的增减。未订购扩容包时，可单击“增配扩容包”进行扩容包的增加。存储空间上限95PB（套餐加扩容包）。 包年/包月 用户数扩容包 可选，云空间用户人数扩展。已订购扩容包时，可单击“变更扩容包”“删除扩容包”进行扩容包的增减。未订购扩容包时，可单击“增配扩容包”进行扩容包的增加。用户数上限为20000人（套餐加扩容包）。 包年/包月 用户数 必选，软件服务用户数，最小配置为1人，最大支持20000人，按实际使用计费。 按需计费 存储空间 必选，用户数据存储空间，按实际使用计费。 按需计费