华为云用户手册

  • 响应示例 状态码: 202 Accepted { "id" : "0eacda0b-9422-4535-8b62-537d1833638b", "status" : "pending" } 状态码: 400 Bad Request { "error_code" : "DRS.10000010", "error_msg" : "Job does not exist, please check job id." }
  • 响应参数 状态码: 202 表4 响应Body参数 参数 参数类型 描述 id String 查询结果ID。 status String 查询状态。 枚举值: pending failed success 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:1 最大长度:512
  • 请求参数 表2 请求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 表3 请求Body参数 参数 是否必选 参数类型 描述 reset_position_time 是 String 重置位点时间,使用UTC时间 示例:2023-09-19 15:00:00,UTC时间是2023-09-19T07:00:00Z。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。 X-Language 否 String 请求语言类型。 缺省值:en-us 枚举值: en-us zh-cn Content-Type 是 String Content-Type,指定类型为application/json。 缺省值:application/json 表3 请求Body参数 参数 是否必选 参数类型 描述 jobs 是 Array of objects 任务信息。 详情请参见表4。 alarm_notify_info 是 Object 收件方式与信息。 详情请参见表5。 表4 jobs字段数据结构说明 参数 是否必选 参数类型 描述 job_id 是 String 任务ID。 status 是 String 任务状态。 engine_type 是 String DRS任务引擎类型,取值: mysql:MySQL到MySQL迁移,MySQL到MySQL同步 mongodb:MongoDB到DDS迁移 cloudDataGuard-mysql:MySQL到MySQL灾备 gaussdbv5:GaussDB同步 mysql-to-kafka:MySQL到Kafka同步 taurus-to-kafka:GaussDB(for MySQL)到Kafka同步 gaussdbv5ha-to-kafka:GaussDB主备版到Kafka同步 postgresql:PostgreSQL到PostgreSQL同步 详细取值可参考引擎类型说明。 表5 alarm_notify_info字段数据结构说明 参数 是否必选 参数类型 描述 subscriptions 否 Array of objects 手动输入手机号、邮箱模式时填写。 详情请参见表6。 topic_urn 否 String 主题资源标识。 delay_time 否 Long 订阅延迟时间。 rto_delay 否 Long RTO延迟时间。 rpo_delay 否 Long RPO延迟时间。 alarm_to_user 否 Boolean 异常告警是否通知用户,不填默认为false。 表6 subscriptions字段数据结构说明 参数 是否必选 参数类型 描述 endpoints 否 Array of strings 短信或者邮件列表。 protocol 否 String 收件方式,sms:短信,email:邮件。 枚举值: sms email
  • 请求示例 配置中的MySQL任务通过关联已有的SMN主题方式配置异常通知 https://{endpoint}/v3/0ac6eb2c8000d2ee2fd9c006dededbe6/jobs/batch-set-smn { "jobs" : [ { "job_id" : "c7296a3b-0d9f-424c-8d74-816ca62jb2a2", "status" : "CONFIGURATION", "engine_type" : "mysql" } ], "alarm_notify_info" : { "topic_urn" : "urn:smn:cn-north-7:04f9aca88c00d3202fd4c01ed679daf0:drs-zw", "delay_time" : 1200 } } 增量中的任务通过手动输入手机号、邮箱方式配置异常通知 https://{endpoint}/v3/0ac6eb2c8000d2ee2fd9c006dededbe6/jobs/batch-set-smn { "jobs" : [ { "job_id" : "2b36da5c-44a7-41af-8889-247b14djb2a2", "status" : "INCRE_TRANSFER_STARTED", "engine_type" : "oracle-to-dws" } ], "alarm_notify_info" : { "subscriptions" : [ { "protocol" : "sms", "endpoints" : [ "12345678910" ] }, { "protocol" : "email", "endpoints" : [ "123456@abc.com" ] } ], "delay_time" : 100 } }
  • 响应参数 状态码: 200 表7 响应Body参数 参数 参数类型 描述 results Array of objects 录入SMN返回体。 详情请参见表8。 count Integer 录入SMN总数。 表8 results字段数据结构说明 参数 参数类型 描述 id String 任务ID。 status String 状态。 error_code String 错误码。 error_msg String 错误信息。
  • SAP最佳实践汇总 本文汇总了基于华为云SAP常见应用场景的操作实践,每个实践我们提供详细的方案描述和操作指导,帮助您轻松应用华为云SAP。 表1 SAP最佳实践一览表 最佳实践 说明 华为云SAP on DB2安装最佳实践 本章节用于指导租户在华为云平台上准备资源(云服务器、网络资源等)并进行SAP on DB2的安装。 华为云SAP on SQL Server安装最佳实践 本章节用于指导租户在公有云平台上准备资源(云服务器、网络资源等)并进行SAP on SQL Server的安装。 SAP S4HANA1809同可用区高可用部署最佳实践 本章节用于指导租户在公有云平台上准备资源(云服务器、网络资源等)并进行SAP S/4HANA 1809高可用的部署。 华为云SAP Business One on HANA安装最佳实践 本章节用于指导租户在公有云平台上准备资源(云服务器、网络资源等)并进行SAP Business One on HANA的安装。 企业项目管理应用在SAP的最佳实践 本章节主要介绍企业管理服务中的企业项目管理的功能,通过创建企业项目、模板管理、创建应用、纳管应用为场景,对应用和资源进行管理和监控,并针对不同方式提供了对应操作流程及指导。 SAP监控最佳实践 本章节用于指导租户在公有云平台上部署SAP监控大屏,用于对SAP系统进行监控,实时了解各应用资源使用情况、告警情况以及SAP系统运行情况。 SAP迁移上华为云最佳实践 本章节主要介绍SAP系统迁移上华为云的具体操作及其指导,华为云提供完善的云上部署方案,帮助客户提高效率、降低成本。 使用SMS Linux块迁移SAP应用与数据库最佳实践 本章节用于指导租户在公有云平台上使用SMS Linux块迁移SAP应用与数据库操作及其指导,帮助客户提高效率、降低成本。 SAP由XEN往KVM平台迁移最佳实践 本章节介绍如何将SAP系统从华为云旧的XEN平台迁移到KVM平台,以满足业务的发展扩容需求。 华为云SAP SDRS容灾最佳实践 本章节用于指导租户在公有云平台上对SAP使用SDRS容灾的具体操作及其指导,帮助客户提高效率、降低成本。 SAP应用RSYNC容灾方案最佳实践 本章节用于指导租户在公有云平台上对SAP应用进行RSYNC容灾操作及其指导,帮助客户提高效率、降低成本。 SAP Backint安装指南 本章节用于指导用户安装适用于华为OBS存储的Backint Agent,以Backint方式对HANA数据库进行备份、恢复、删除等操作。 SAP备份上传OBS最佳实践 本章节主要通过脚本调用obsutil将本地文件备份到OBS,且在本地保留一定时间内的副本,并针对不同方式提供了对应操作流程及指导。 SAP ASE最佳实践 本章节主要介绍华为云SAP ASE解决方案,主要涵盖资源选择、系统备份、高可用、容灾以及线下系统迁移等方面。华为云提供的众多云服务使SAP ASE系统能够稳定、安全地运行。 SAP系统扩容最佳实践 本章节主要介绍扩容SAP系统中云服务器和云硬盘的操作流程及指导,满足您的业务需求。
    SAP
  • 修订记录 修订记录 发布日期 第十五次正式发布,进行了以下变更: 刷新SAP S4HANA1809同可用区高可用部署最佳实践 移除基于obsfs的HANA备份最佳实践 2023-11-06 第十四次正式发布,进行了以下变更: 刷新SAP S4HANA1809同可用区高可用部署最佳实践 2022-12-01 第十三次正式发布,进行了以下变更: 刷新SAP Backint安装指南和SAP监控最佳实践 2022-06-24 第十二次正式发布,进行了以下变更: 新增SAP Backint安装指南 2021-12-31 第十一次正式发布,进行了以下变更: 新增SAP由XEN往KVM平台迁移最佳实践 2021-10-08 第十次正式发布,进行了以下变更: 新增华为云SAP on Oracle安装最佳实践 新增华为云SAP Business One on HANA安装最佳实践 新增使用SMS Linux块迁移SAP应用与数据库最佳实践 新增SAP应用RSYNC容灾方案最佳实践 2021-08-31 第九次正式发布,进行了以下变更: 新增华为云基于obsfs的HANA备份最佳实践 2021-08-04 第八次正式发布。进行了以下变更: 新增华为云SAP监控最佳实践 2021-06-30 第七次正式发布。进行了以下变更: 新增SAP S4HANA1809同可用区高可用部署最佳实践 新增华为云SAP on DB2安装最佳实践 新增华为云SAP on SQL Server安装最佳实践 新增华为云SAP SDRS容灾最佳实践 2021-06-07 第六次正式发布。进行了以下变更: 新增SAP系统迁移上华为云最佳实践。 2019-11-05 第五次正式发布。进行了以下变更: 增加变更规格的两种扩展方法,具体如变更规格及AZ/Region和变更规格及AZ/Region(低RTO)所示。 增加SAP ASE最佳实践。 2019-09-30 第四次正式发布。进行了以下变更: 刷新了SAP备份上传OBS最佳实践中适配obsutil工具的内容。 增加SAP系统扩容最佳实践。 2019-07-12 第三次正式发布。进行了以下变更: 刷新了应用容灾内容。 2019-05-27 第二次正式发布。进行了以下变更: 刷新了示例模板及其监控插件等内容。 2019-03-30 第一次正式发布。 2019-01-30
    SAP
  • 语法格式 CREATE DATABASE name [ [ WITH ] [ OWNER [=] user_name ] [ TEMPLATE [=] template ] [ ENCODING [=] encoding ] [ LC_COLLATE [=] lc_collate ] [ LC_CTYPE [=] lc_ctype ] [ TABLESPACE [=] tablespace_name ] [ ALLOW_CONNECTIONS [=] allowconn ] [ CONNECTION LIMIT [=] connlimit ] [ IS_TEMPLATE [=] istemplate ] ]
  • 参数使用方式 通过TEMPLATE指定数据库模板 使用 template1 模板库建库时不可指定新的字符集和本地化collate属性,collate属性请参见▪设置数据库的本土化信息(collate)。 CREATE DATABASE my_db WITH TEMPLATE template1 ; 使用template0可指定字符集和本地化collate属性,collate属性请参见▪设置数据库的本土化信息(collate)。 CREATE DATABASE my_db WITH ENCODING = 'UTF8' LC_COLLATE ='zh_CN.utf8' LC_CTYPE ='zh_CN.utf8' TEMPLATE = template0 ; 创建数据库时不指定模板,则默认模板为template1。用户也可以指定其他的自定义模板创建数据库。 CREATE DATABASE my_db WITH TEMPLATE = mytemplate; 通过WITH ENCODING指定字符集 CREATE DATABASE my_db WITH ENCODING 'UTF8'; LC_COLLATE和LC_CTYPE 查询字符集支持的LC_COLLATE和LC_CTYPE信息 SELECT pg_encoding_to_char(collencoding) AS encoding,collname,collcollate AS "LC_COLLATE",collctype AS "LC_CTYPE" FROM pg_collation; encoding为空时,表示当前LC_COLLATE支持所有的字符集。 设置数据库的本土化信息(collate) 执行如下命令,创建一个 LC_COLLATE 和 LC_CTYPE 分别为 zh_CN.utf8 的数据库。 CREATE DATABASE my_db WITH ENCODING = 'UTF8' LC_COLLATE ='zh_CN.utf8' LC_CTYPE ='zh_CN.utf8' TEMPLATE = template0 ; 如果指定的LC_COLLATE与字符集不兼容,则会报如下错误信息。 指定的LC_COLLATE和LC_CTYPE必须与目标字符集兼容,参考▪查询字符集支持的LC_COLLATE和LC_C...查询出的字符集,否则会报错。 目前无法直接通过ALTER DATABASE命令修改已有数据库的LC_COLLATE和LC_CTYPE信息,但可以通过创建新的数据库,然后导出再导入数据的方式进行修改。
  • 安装Discuz! 下载Discuz!软件。 使用数据传输工具将安装包上传到ECS。 执行以下命令,解压Discuz!安装包。 unzip Discuz_X3.3_SC_UTF8.zip 执行以下命令,将解压后的“upload”中的所有文件,复制到“/var/www/html/”目录。 cp -R upload/* /var/www/html/ 执行以下命令,将写入权限赋予给其他用户。 chmod -R 777 /var/www/html 在本地windows浏览器里输入地址:http://弹性IP地址/install,进入安装界面,按照Discuz!安装向导进行安装。 其中,弹性IP地址为购买弹性云服务器时所创建的弹性IP地址,“install”必须小写。 确认协议,并单击“我同意”。 开始安装后,检查安装环境并单击“下一步”。 设置运行环境,并单击“下一步”。 安装数据库,填写数据库信息,单击“下一步”完成安装。 数据库服务器地址即为“rds-01”的私有IP地址。 数据库密码是“rds-01”配置的数据库管理员root帐号对应的密码。 自定义管理员信息。 Discuz!安装完成后,在浏览器中输入http://弹性IP地址/forum.php,可登录论坛主页,则说明网站搭建成功。
  • 搭建LAMP环境 下载PuTTY客户端。 解压文件后,双击“putty”,显示配置界面。 选择“Session”,配置相关信息后,如图3,单击“Open”。 在“Host Name (or IP address)”输入ECS弹性IP地址,其他配置均保持默认值。 在“Saved Sessions”中输入名称,此处以“Discuz”为例,单击“Save”,保存会话配置。 图3 配置PuTTY 在登录界面中,输入ECS的用户名和密码,即可登录ECS。 安装Apache、MySQL或PHP等软件。 通过PuTTY登录云服务器,直接获取root权限,可以直接在PuTTY内输入命令。 请输入软件安装命令,此处以PHP为例。 yum install -y httpd php php-fpm php-server php-mysql mysql 结果显示如下,表明安装完成。 Complete 安装完成后,依次启动相关服务。 systemctl start httpd.service systemctl start php-fpm.service
  • 创建RDS for MySQL实例 进入购买云数据库RDS页面。 选择区域“华东-上海一”。填选实例信息后,单击“立即购买”。 图1 选择引擎版本信息 图2 选择规格信息 图3 选择已规划的网络信息 图4 设置管理员密码 进行规格确认。 如果需要重新选择实例规格,单击“上一步”,回到上个页面修改实例信息。 如果规格确认无误,单击“提交”,完成购买实例的申请。 参考如下步骤,在RDS实例管理界面,为3创建的RDS实例绑定弹性公网IP。 在“实例管理”页面,选择指定的实例,单击实例名称,进入实例基本信息页面。 图5 实例管理 选择“连接管理”页签,单击“公网地址”处的“绑定”。 在弹出框中,显示“未绑定”状态的弹性公网IP,选择已规划的弹性公网IP,单击“是”,提交绑定任务。 图6 绑定弹性公网IP
  • 安装WordPress 单击弹性云服务器实例列表“操作”列下的“远程登录”,远程登录弹性云服务器。 在本地windows浏览器里输入地址:http://弹性IP地址/wordpress,访问WordPress,单击“现在就开始!”。 其中,弹性IP地址为购买弹性云服务器时所创建的弹性IP地址。 图6 访问 输入连接数据库的相关信息,单击“提交”。 数据库名为之前创建的“wordpress”数据库。 用户名为之前创建的“tony”数据库帐号。 密码为创建“tony”帐号时,您设置的密码。 数据库主机为数据库实例“rds-01”的内网IP。 图7 输入连接信息 数据库配置正确,通过验证后,单击“现在安装”。 图8 数据库配置验证通过 设置博客登录的“站点标题”、“用户名”和“密码”。 图9 设置基本信息 安装成功后,单击“登录”。 图10 安装成功 在登录页面,输入用户名和密码,单击“登录”。 图11 登录 您的WordPress搭建成功。 图12 结果验证
  • 购买并配置RDS 请根据具体需求购买华为云RDS for MySQL数据库实例。 选择MySQL 5.6或MySQL 5.7版本,创建以“rds-01”为例的数据库实例。 确保RDS和ECS使用同一个安全组,以便用户正常访问数据库。 设置root用户对应的密码,并妥善管理您的密码,因为系统将无法获取您的密码信息。 进入RDS console,在“实例管理”页面,单击实例名称“rds-01”,进入实例的“基本信息”页签。 选择“数据库管理”页签,单击“创建数据库”,在弹出框中输入数据库名称,以“wordpress”为例,选择字符集并授权数据库帐号,单击“确定”。 图4 创建数据库 选中“帐号管理”页签,单击“创建帐号”。在“创建帐号”弹出框中,输入数据库帐号,以“tony”为例,授权数据库选择步骤3中创建的“wordpress”数据库,并输入密码和确认密码,单击“确定”。 图5 创建帐号
  • 搭建LAMP环境 下载PuTTY客户端。 解压文件后,双击“putty”,显示配置界面。 选择“Session”,配置相关信息后,如图3,单击“Open”。 在“Host Name (or IP address)”下的输入框中输入ECS的弹性IP地址,其他配置均保持默认值。 在“Saved Sessions”中输入名称,此处以Wordpress为例,单击“Save”,保存会话配置。 图3 配置PuTTY 在登录界面中,输入ECS的用户名和密码,即可登录ECS。 通过PuTTY登录云服务器,直接获取root权限,可以直接在PuTTY内输入命令。 请输入MySQL或PHP等软件安装命令,此处以安装PHP为例: yum install -y httpd php php-fpm php-server php-mysql mysql 结果显示如下,表明安装完成。 Complete 安装解压软件。 yum install -y unzip 下载并解压WordPress安装文件。 wget -c https://cn.wordpress.org/wordpress-4.9.1-zh_CN.tar.gz tar xzf wordpress-4.9.1-zh_CN.tar.gz -C /var/www/html chmod -R 777 /var/www/html 安装完成后,依次启动相关服务。 systemctl start httpd.service systemctl start php-fpm.service 设置服务开机自启动。 systemctl enable httpd.service
  • 创建RDS for MySQL实例 本章节介绍创建RDS for MySQL实例。 进入购买云数据库RDS页面。 配置实例名称和实例基本信息。选择区域“华南-广州”。 选择实例规格。 选择实例所属的VPC和安全组、配置数据库端口。 VPC和安全组已在创建VPC和安全组中准备好。 配置实例密码。 单击“立即购买”。 进行规格确认。 如果需要重新选择实例规格,单击“上一步”,回到上个页面修改实例信息。 如果规格确认无误,单击“提交”,完成购买实例的申请。 返回云数据库实例列表。当RDS实例运行状态为“正常”时,表示实例创建完成。 父主题: 其他云MySQL迁移到云数据库 RDS for MySQL
  • URI GET /v2/{project_id}/fgs/functions/{func_urn}/slareports/{period} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目 ID,获取方式请参见获取项目ID。 func_urn 是 String 函数的URN,详细解释见FunctionGraph函数模型的描述。 period 是 String 时间间隔(单位:min)
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 concurrency_num Array of SlaReportsValue objects 并发数 count Array of SlaReportsValue objects 调用次数 duration Array of SlaReportsValue objects 平均时延,单位毫秒 fail_count Array of SlaReportsValue objects 错误次数 function_error_count Array of SlaReportsValue objects 函数错误次数 system_error_count Array of SlaReportsValue objects 系统错误次数 instance_num Array of SlaReportsValue objects 弹性实例数 max_duration Array of SlaReportsValue objects 最大时延,单位毫秒 min_duration Array of SlaReportsValue objects 最小时延,单位毫秒 reject_count Array of SlaReportsValue objects 被拒绝次数 reserved_instance_num Array of SlaReportsValue objects 预留实例数 表4 SlaReportsValue 参数 参数类型 描述 timestamp Integer 时间戳 value Double 值 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息
  • 响应示例 状态码: 200 ok { "concurrency_num" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 2 } ], "count" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "duration" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "fail_count" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "function_error_count" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "instance_num" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "max_duration" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "min_duration" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "reject_count" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "reserved_instance_num" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ], "system_error_count" : [ { "timestamp" : 1596679200000, "value" : -1 }, { "timestamp" : 1596682800000, "value" : 950 } ] }
  • 请求示例 创建名为xxx的python2.7函数,内存大小为128MB,超时时间3s。 POST https://{Endpoint}/v2/{project_id}/fgs/functions { "func_name" : "xxx", "package" : "xxx", "runtime" : "Python2.7", "handler" : "index.py", "memory_size" : 128, "code_type" : "inline", "timeout" : 3, "func_code" : { "file" : "xxxxx", "link" : "" } }
  • 响应示例 状态码: 200 ok { "func_urn" : "urn:fss:xxxxxxxxx:c3b2459a6d5e4b548e6777e57852692d:function:default:TestCreateFunctionInPythonSdk:latest", "func_name" : "TestCreateFunctionInPythonSdk", "domain_id" : "14ee2e3501124efcbca7998baa24xxxx", "namespace" : "46b6f338fc3445b8846c71dfb1fbxxxx", "project_name" : "xxxxxxxxxx", "package" : "default", "runtime" : "Python3.6", "timeout" : 3, "handler" : "index.handler", "memory_size" : 128, "cpu" : 300, "code_type" : "inline", "code_filename" : "index.py", "code_size" : 100, "digest" : "1c8610d1870731a818a037f1d2adf3223e8ac351aeb293fb1f8eabd2e9820069a61ed8b5d38182e760adc33a307d0e957afc357f415cd8c9c3ff6f0426fd85cd", "version" : "latest", "image_name" : "latest-191025153727@zehht", "last_modified" : "2019-10-25 15:37:27", "strategy_config" : { "concurrency" : 0 } } 状态码: 400 Bad Request 请求错误。 { "error_code" : "FSS.0401", "error_msg" : "not permit" } 状态码: 401 Unauthorized 鉴权失败。 { "error_code" : "FSS.0401", "error_msg" : "not permit" } 状态码: 403 Forbidden 没有操作权限。 { "error_code" : "FSS.0401", "error_msg" : "not permit" }
  • 响应参数 状态码: 200 表10 响应Body参数 参数 参数类型 描述 func_urn String 函数的URN(Uniform Resource Name),唯一标识函数。 func_name String 函数名称。 domain_id String 域名id。 namespace String 租户的project id。 project_name String 租户的project name。 package String 函数所属的分组Package,用于用户针对函数的自定义分组。 runtime String FunctionGraph函数的执行环境 Python2.7: Python语言2.7版本。 Python3.6: Pyton语言3.6版本。 Python3.9: Python语言3.9版本。 Go1.8: Go语言1.8版本。 Go1.x: Go语言1.x版本。 Java8: Java语言8版本。 Java11: Java语言11版本。 Node.js6.10: Nodejs语言6.10版本。 Node.js8.10: Nodejs语言8.10版本。 Node.js10.16: Nodejs语言10.16版本。 Node.js12.13: Nodejs语言12.13版本。 Node.js14.18: Nodejs语言14.18版本。 C#(.NET Core 2.0): C#语言2.0版本。 C#(.NET Core 2.1): C#语言2.1版本。 C#(.NET Core 3.1): C#语言3.1版本。 Custom: 自定义运行时。 PHP7.3: Php语言7.3版本。 http: HTTP函数。 枚举值: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http timeout Integer 函数执行超时时间,超时函数将被强行停止,范围3~900秒,可以通过白名单配置延长到12小时,具体可以咨询客服进行配置 handler String 函数执行入口 规则:xx.xx,必须包含“. ” 举例:对于node.js函数:myfunction.handler,则表示函数的文件名为myfunction.js,执行的入口函数名为handler。 memory_size Integer 函数消耗的内存。 单位M。 取值范围为:128、256、512、768、1024、1280、1536、1792、2048、2560、3072、3584、4096。 最小值为128,最大值为4096。 gpu_memory Integer 函数消耗的显存,只支持自定义运行时与自定义镜像函数配置GPU。 单位MB。 取值范围为:1024、2048、3072、4096、5120、6144、7168、8192、9216、10240、11264、12288、13312、14336、15360、16384。 最小值为1024,最大值为16384。 cpu Integer 函数占用的cpu资源。 单位为millicore(1 core=1000 millicores)。 取值与MemorySize成比例,默认是128M内存占0.1个核(100 millicores)。 code_type String 函数代码类型,取值有4种。 inline: UI在线编辑代码。 zip: 函数代码为zip包。 obs: 函数代码来源于obs存储。 jar: 函数代码为jar包,主要针对Java函数。 枚举值: inline zip obs jar code_url String 当CodeType为obs时,该值为函数代码包在OBS上的地址,CodeType为其他值时,该字段为空。 code_filename String 函数的文件名,当CodeType为jar/zip时必须提供该字段,inline和obs不需要提供。 code_size Long 函数大小,单位:字节。 user_data String 用户自定义的name/value信息。 在函数中使用的参数。 举例:如函数要访问某个主机,可以设置自定义参数:Host={host_ip},最多定义20个,总长度不超过4KB。 encrypted_user_data String 用户自定义的name/value信息,用于需要加密的配置。 digest String 函数代码SHA512 hash值,用于判断函数是否变化。 version String 函数版本号,由系统自动生成,规则:vYYYYMMDD-HHMMSS(v+年月日-时分秒)。 image_name String 函数版本的内部标识。 xrole String 函数使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 app_xrole String 函数app使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 description String 函数描述。 last_modified String 函数最后一次更新时间。 func_vpc FuncVpc object 函数vpc配置。 mount_config MountConfig object 函数挂载配置。 depend_list Array of strings 依赖id列表 depend_version_list Array of strings 依赖版本id列表 strategy_config StrategyConfig object 函数策略配置。 extend_config String 函数扩展配置。 initializer_handler String 函数初始化入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.initializer,则表示函数的文件名为myfunction.js,初始化的入口函数名为initializer。 initializer_timeout Integer 初始化超时时间,超时函数将被强行停止,范围1~300秒。 pre_stop_handler String 函数预停止函数的入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.pre_stop_handler,则表示函数的文件名为myfunction.js,初始化的入口函数名为pre_stop_handler。 pre_stop_timeout Integer 初始化超时时间,超时函数将被强行停止,范围1~90秒。 enterprise_project_id String 企业项目ID,在企业用户创建函数时必填。 enable_dynamic_memory Boolean 是否启动动态内存配置 is_stateful_function Boolean 是否支持有状态,如果需要支持,需要固定传参为true,v2版本支持 enable_auth_in_header Boolean 是否允许在请求头中添加鉴权信息 custom_image CustomImage object 用户容器镜像。 表11 FuncVpc 参数 参数类型 描述 vpc_name String 虚拟私有云名称。 vpc_id String 虚拟私有云唯一标识。 subnet_name String 子网名称。 subnet_id String 子网编号。 cidr String 子网掩码。 gateway String 网关。 security_groups Array of strings 安全组 表12 MountConfig 参数 参数类型 描述 mount_user MountUser object 挂载用户信息。 func_mounts Array of FuncMount objects 函数挂载列表。 表13 MountUser 参数 参数类型 描述 user_id String 用户ID(-1~65534的非0整数) user_group_id String 用户组ID(-1~65534的非0整数) 表14 FuncMount 参数 参数类型 描述 mount_type String 挂载类型(sfs/sfsTurbo/ecs),func_mounts非空时必选。 mount_resource String 挂载资源ID(对应云服务ID),func_mounts非空时必选。 mount_share_path String 远端挂载路径(例如192.168.0.12:/data),如果mount_type为ecs,必选。 local_mount_path String 函数访问路径,func_mounts非空时必选。 表15 StrategyConfig 参数 参数类型 描述 concurrency Integer 单函数最大实例数,v1取值0和-1,v2取值-1到1000 -1代表该函数实例数无限制 0代表该函数被禁用 concurrent_num Integer 单实例最大并发数,v2版本才支持,取值-1到1000 表16 CustomImage 参数 参数类型 描述 enabled Boolean 是否启用 image String 镜像地址 command String 启动容器镜像的命令 args String 启动容器镜像的命令行参数 working_dir String 镜像容器工作目录 uid String 镜像容器的用户id gid String 镜像容器的用户组id 状态码: 400 表17 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 401 表18 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 403 表19 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 404 表20 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 500 表21 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 503 表22 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 func_name 是 String 函数名称。 package 是 String 函数所属的分组Package,用于用户针对函数的自定义分组。 runtime 是 String FunctionGraph函数的执行环境 Python2.7: Python语言2.7版本。 Python3.6: Pyton语言3.6版本。 Python3.9: Python语言3.9版本。 Go1.8: Go语言1.8版本。 Go1.x: Go语言1.x版本。 Java8: Java语言8版本。 Java11: Java语言11版本。 Node.js6.10: Nodejs语言6.10版本。 Node.js8.10: Nodejs语言8.10版本。 Node.js10.16: Nodejs语言10.16版本。 Node.js12.13: Nodejs语言12.13版本。 Node.js14.18: Nodejs语言14.18版本。 C#(.NET Core 2.0): C#语言2.0版本。 C#(.NET Core 2.1): C#语言2.1版本。 C#(.NET Core 3.1): C#语言3.1版本。 Custom: 自定义运行时。 PHP7.3: Php语言7.3版本。 http: HTTP函数。 枚举值: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http timeout 是 Integer 函数执行超时时间,超时函数将被强行停止,范围3~900秒,可以通过白名单配置延长到12小时,具体可以咨询客服进行配置 handler 是 String 函数执行入口 规则:xx.xx,必须包含“. ”;自定义镜像函数handler为“-” 举例:对于node.js函数:myfunction.handler,则表示函数的文件名为myfunction.js,执行的入口函数名为handler。 depend_version_list 否 Array of strings 依赖版本id列表 func_vpc 否 FuncVpc object 函数vpc配置。 memory_size 是 Integer 函数消耗的内存。 单位M。 取值范围为:128、256、512、768、1024、1280、1536、1792、2048、2560、3072、3584、4096。 最小值为128,最大值为4096。 gpu_memory 否 Integer 函数消耗的显存,只支持自定义运行时与自定义镜像函数配置GPU。 单位MB。 取值范围为:1024、2048、3072、4096、5120、6144、7168、8192、9216、10240、11264、12288、13312、14336、15360、16384。 最小值为1024,最大值为16384。 code_type 是 String 函数代码类型,取值有4种。 inline: UI在线编辑代码。 zip: 函数代码为zip包。 obs: 函数代码来源于obs存储。 jar: 函数代码为jar包,主要针对Java函数。 枚举值: inline zip obs jar Custom-Image-Swr code_url 否 String 当CodeType为obs时,该值为函数代码包在OBS上的地址,CodeType为其他值时,该字段为空。 code_filename 否 String 函数的文件名,当CodeType为jar/zip时必须提供该字段,CodeType为其他值时不需要提供。 custom_image 否 CustomImage object 用户容器镜像,当CodeType为Custom-Image-Swr时必须提供该字段,CodeType为其他值时不需要提供。 user_data 否 String 用户自定义的name/value信息。 在函数中使用的参数。 举例:如函数要访问某个主机,可以设置自定义参数:Host={host_ip},最多定义20个,总长度不超过4KB。 xrole 否 String 函数使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 app_xrole 否 String 函数app使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 description 否 String 函数描述。 func_code 否 FuncCode object FuncCode结构返回体。 initializer_handler 否 String 函数初始化入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.initializer,则表示函数的文件名为myfunction.js,初始化的入口函数名为initializer。 initializer_timeout 否 Integer 初始化超时时间,超时函数将被强行停止,范围1~300秒。 pre_stop_handler 否 String 函数预停止函数的入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.pre_stop_handler,则表示函数的文件名为myfunction.js,初始化的入口函数名为pre_stop_handler。 pre_stop_timeout 否 Integer 初始化超时时间,超时函数将被强行停止,范围1~90秒。 enterprise_project_id 否 String 企业项目ID,在企业用户创建函数时必填。 type 否 String 函数版本;部分局点只支持v1函数,缺省值则为v1 缺省值:v2 枚举值: v1 v2 log_config 否 FuncLogConfig object 函数绑定日志配置。 network_controller 否 NetworkControlConfig object 函数网络配置。 表4 FuncVpc 参数 是否必选 参数类型 描述 vpc_name 是 String 虚拟私有云名称。 vpc_id 是 String 虚拟私有云唯一标识。 subnet_name 是 String 子网名称。 subnet_id 是 String 子网编号。 cidr 是 String 子网掩码。 gateway 是 String 网关。 security_groups 否 Array of strings 安全组 表5 CustomImage 参数 是否必选 参数类型 描述 enabled 否 Boolean 是否启用 image 否 String 镜像地址 command 否 String 启动容器镜像的命令 args 否 String 启动容器镜像的命令行参数 working_dir 否 String 镜像容器工作目录 uid 否 String 镜像容器的用户id gid 否 String 镜像容器的用户组id 表6 FuncCode 参数 是否必选 参数类型 描述 file 否 String 函数代码,如果不为空必须进行base64编码,为空时使用默认的代码。 link 否 String 函数代码链接。 表7 FuncLogConfig 参数 是否必选 参数类型 描述 group_name 否 String 函数绑定日志组名。 group_id 否 String 函数绑定日志组ID。 stream_name 否 String 函数绑定日志流名。 stream_id 否 String 函数绑定日志流ID。 表8 NetworkControlConfig 参数 是否必选 参数类型 描述 disable_public_network 否 Boolean 禁止公网访问开关。 trigger_access_vpcs 否 Array of VpcConfig objects 指定触发函数vpc配置。 表9 VpcConfig 参数 是否必选 参数类型 描述 vpc_name 否 String vpc名称。 vpc_id 否 String vpc ID。
  • 响应示例 状态码: 200 ok { "tags" : [ { "key" : "xxx", "value" : "yyy" } ], "sys_tags" : [ { "key" : "_sys_enterprise_project_id", "value" : "5aa119a8-d25b-45a7-8d1b-88e127885635" } ] }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 tags Array of KvItem objects 标签列表 sys_tags Array of KvItem objects 系统标签列表 表4 KvItem 参数 参数类型 描述 key String 键 value String 值 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息
  • 响应示例 状态码: 200 OK { "func_id" : "0d075978-5a54-4ee1-8e24-ff5bd070xxxx", "resource_id" : "0d075978-5a54-4ee1-8e24-ff5bd070xxxx:test", "func_urn" : "urn:fss:xxxxxxxx:7aad83af3e8d42e99ac194e8419e2c9b:function:default:test", "func_name" : "test", "domain_id" : "14ee2e3501124efcbca7998baa24xxxx", "namespace" : "46b6f338fc3445b8846c71dfb1fbxxxx", "project_name" : "xxxxxx", "package" : "default", "runtime" : "Node.js6.10", "timeout" : 3, "handler" : "fssExampleCsharp2.1::fssExampleCsharp21.Program::MyFunc", "memory_size" : 128, "cpu" : 300, "code_type" : "inline", "code_filename" : "index.js", "code_size" : 272, "digest" : "faa825575c45437cddd4e369bea69893bcbe195d478178462ad90984fe72993f3f59d15f41c5373f807f3e05fb9af322c55dabeb16565c386e402413458e6068", "version" : "latest", "ephemeral_storage" : 512, "image_name" : "latest-191025153727@zehht", "last_modified" : "2019-10-25 15:37:27", "strategy_config" : { "concurrency" : 0 } }
  • 请求示例 修改名为fgsTest的Nodejs函数配置信息,将内存大小改为768MB,超时时间设为40s。 PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/config { "func_name" : "fgsTest", "handler" : "index.handler", "memory_size" : 768, "runtime" : "Node.js6.10", "timeout" : 40 } 修改自定义运行时函数GPU配置,将GPU显存设置为1GB,内存大小设置为4GB。 PUT https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/config { "func_name" : "test_GPU", "handler" : "bootstrap", "memory_size" : 4096, "runtime" : "Custom", "timeout" : 40, "gpu_memory" : 1024 }
  • 响应参数 状态码: 200 表12 响应Body参数 参数 参数类型 描述 func_id String 函数id,唯一标识函数。 resource_id String 函数资源id。 func_urn String 函数的URN(Uniform Resource Name),唯一标识函数。 func_name String 函数名称。 domain_id String 域名id。 namespace String 租户的project id。 project_name String 租户的project name。 package String 函数所属的分组Package,用于用户针对函数的自定义分组。 runtime String FunctionGraph函数的执行环境 Python2.7: Python语言2.7版本。 Python3.6: Pyton语言3.6版本。 Python3.9: Python语言3.9版本。 Go1.8: Go语言1.8版本。 Go1.x: Go语言1.x版本。 Java8: Java语言8版本。 Java11: Java语言11版本。 Node.js6.10: Nodejs语言6.10版本。 Node.js8.10: Nodejs语言8.10版本。 Node.js10.16: Nodejs语言10.16版本。 Node.js12.13: Nodejs语言12.13版本。 Node.js14.18: Nodejs语言14.18版本。 C#(.NET Core 2.0): C#语言2.0版本。 C#(.NET Core 2.1): C#语言2.1版本。 C#(.NET Core 3.1): C#语言3.1版本。 Custom: 自定义运行时。 PHP7.3: Php语言7.3版本。 http: HTTP函数。 枚举值: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http timeout Integer 函数执行超时时间,超时函数将被强行停止,范围3~900秒,可以通过白名单配置延长到12小时,具体可以咨询客服进行配置 handler String 函数执行入口 规则:xx.xx,必须包含“. ” 举例:对于node.js函数:myfunction.handler,则表示函数的文件名为myfunction.js,执行的入口函数名为handler。 memory_size Integer 函数消耗的内存。 单位M。 取值范围为:128、256、512、768、1024、1280、1536、1792、2048、2560、3072、3584、4096。 最小值为128,最大值为4096。 gpu_memory Integer 函数消耗的显存,只支持自定义运行时与自定义镜像函数配置GPU。 单位MB。 取值范围为:1024、2048、3072、4096、5120、6144、7168、8192、9216、10240、11264、12288、13312、14336、15360、16384。 最小值为1024,最大值为16384。 cpu Integer 函数占用的cpu资源。 单位为millicore(1 core=1000 millicores)。 取值与MemorySize成比例,默认是128M内存占0.1个核(100 millicores)。 code_type String 函数代码类型,取值有4种。 inline: UI在线编辑代码。 zip: 函数代码为zip包。 obs: 函数代码来源于obs存储。 jar: 函数代码为jar包,主要针对Java函数。 枚举值: inline zip obs jar code_url String 当CodeType为obs时,该值为函数代码包在OBS上的地址,CodeType为其他值时,该字段为空。 code_filename String 函数的文件名,当CodeType为jar/zip时必须提供该字段,inline和obs不需要提供。 code_size Long 函数大小,单位:字节。 user_data String 用户自定义的name/value信息。 在函数中使用的参数。 举例:如函数要访问某个主机,可以设置自定义参数:Host={host_ip},最多定义20个,总长度不超过4KB。 encrypted_user_data String 用户自定义的name/value信息,用于需要加密的配置。 digest String 函数代码SHA512 hash值,用于判断函数是否变化。 version String 函数版本号,由系统自动生成,规则:vYYYYMMDD-HHMMSS(v+年月日-时分秒)。 image_name String 函数版本的内部标识。 xrole String 函数使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 app_xrole String 函数app使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 description String 函数描述。 last_modified String 函数最后一次更新时间。 ephemeral_storage Integer 临时存储大小。 枚举值: 512 10240 func_vpc FuncVpc object 函数vpc配置。 mount_config MountConfig object 函数挂载配置。 strategy_config StrategyConfig object 函数策略配置。 dependencies Array of Dependency objects 函数依赖代码包列表。 initializer_handler String 函数初始化入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.initializer,则表示函数的文件名为myfunction.js,初始化的入口函数名为initializer。 initializer_timeout Integer 初始化超时时间,超时函数将被强行停止,范围1~300秒。 pre_stop_handler String 函数预停止函数的入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.pre_stop_handler,则表示函数的文件名为myfunction.js,初始化的入口函数名为pre_stop_handler。 pre_stop_timeout Integer 初始化超时时间,超时函数将被强行停止,范围1~90秒。 enterprise_project_id String 企业项目ID,在企业用户创建函数时必填。 long_time Boolean 是否允许进行长时间超时设置。 log_group_id String 自定义日志查询组id log_stream_id String 自定义日志查询流id type String v2表示为公测版本,v1为原来版本。 枚举值: v1 v2 enable_dynamic_memory Boolean 是否启动动态内存配置 is_stateful_function Boolean 是否支持有状态,如果需要支持,需要固定传参为true,v2版本支持 domain_names String 函数配置的需要支持域名解析的内网域名。 enable_auth_in_header Boolean 是否允许在请求头中添加鉴权信息 custom_image CustomImage object 用户容器镜像。 表13 FuncVpc 参数 参数类型 描述 vpc_name String 虚拟私有云名称。 vpc_id String 虚拟私有云唯一标识。 subnet_name String 子网名称。 subnet_id String 子网编号。 cidr String 子网掩码。 gateway String 网关。 security_groups Array of strings 安全组 表14 MountConfig 参数 参数类型 描述 mount_user MountUser object 挂载用户信息。 func_mounts Array of FuncMount objects 函数挂载列表。 表15 MountUser 参数 参数类型 描述 user_id String 用户ID(-1~65534的非0整数) user_group_id String 用户组ID(-1~65534的非0整数) 表16 FuncMount 参数 参数类型 描述 mount_type String 挂载类型(sfs/sfsTurbo/ecs),func_mounts非空时必选。 mount_resource String 挂载资源ID(对应云服务ID),func_mounts非空时必选。 mount_share_path String 远端挂载路径(例如192.168.0.12:/data),如果mount_type为ecs,必选。 local_mount_path String 函数访问路径,func_mounts非空时必选。 表17 StrategyConfig 参数 参数类型 描述 concurrency Integer 单函数最大实例数,v1取值0和-1,v2取值-1到1000 -1代表该函数实例数无限制 0代表该函数被禁用 concurrent_num Integer 单实例最大并发数,v2版本才支持,取值-1到1000 表18 Dependency 参数 参数类型 描述 owner String 依赖包属主的domainId。 link String 依赖包在OBS上的链接。 runtime String FunctionGraph函数的执行环境 Python2.7: Python语言2.7版本。 Python3.6: Pyton语言3.6版本。 Python3.9: Python语言3.9版本。 Go1.8: Go语言1.8版本。 Go1.x: Go语言1.x版本。 Java8: Java语言8版本。 Java11: Java语言11版本。 Node.js6.10: Nodejs语言6.10版本。 Node.js8.10: Nodejs语言8.10版本。 Node.js10.16: Nodejs语言10.16版本。 Node.js12.13: Nodejs语言12.13版本。 Node.js14.18: Nodejs语言14.18版本。 C#(.NET Core 2.0): C#语言2.0版本。 C#(.NET Core 2.1): C#语言2.1版本。 C#(.NET Core 3.1): C#语言3.1版本。 Custom: 自定义运行时。 PHP7.3: Php语言7.3版本。 http: HTTP函数。 枚举值: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http etag String 依赖包的md5值 size Long 依赖包大小。 name String 依赖包名称。 description String 依赖包描述。 file_name String 依赖包文件名,如果创建方式为zip时。 表19 CustomImage 参数 参数类型 描述 enabled Boolean 是否启用 image String 镜像地址 command String 启动容器镜像的命令 args String 启动容器镜像的命令行参数 working_dir String 镜像容器工作目录 uid String 镜像容器的用户id gid String 镜像容器的用户组id 状态码: 400 表20 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 401 表21 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 403 表22 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 404 表23 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码: 500 表24 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息
  • 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 func_name 是 String 函数名称。 runtime 是 String FunctionGraph函数的执行环境 Python2.7: Python语言2.7版本。 Python3.6: Pyton语言3.6版本。 Python3.9: Python语言3.9版本。 Go1.8: Go语言1.8版本。 Go1.x: Go语言1.x版本。 Java8: Java语言8版本。 Java11: Java语言11版本。 Node.js6.10: Nodejs语言6.10版本。 Node.js8.10: Nodejs语言8.10版本。 Node.js10.16: Nodejs语言10.16版本。 Node.js12.13: Nodejs语言12.13版本。 Node.js14.18: Nodejs语言14.18版本。 C#(.NET Core 2.0): C#语言2.0版本。 C#(.NET Core 2.1): C#语言2.1版本。 C#(.NET Core 3.1): C#语言3.1版本。 Custom: 自定义运行时。 PHP7.3: Php语言7.3版本。 http: HTTP函数。 枚举值: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Python3.9 http timeout 是 Integer 函数执行超时时间,超时函数将被强行停止,范围3~900秒,可以通过白名单配置延长到12小时,具体可以咨询客服进行配置 handler 是 String 函数执行入口 规则:xx.xx,必须包含“. ” 举例:对于node.js函数:myfunction.handler,则表示函数的文件名为myfunction.js,执行的入口函数名为handler。 memory_size 是 Integer 函数消耗的内存。 单位M。 取值范围为:128、256、512、768、1024、1280、1536、1792、2048、2560、3072、3584、4096。 最小值为128,最大值为4096。 gpu_memory 否 Integer 函数消耗的显存,只支持自定义运行时与自定义镜像函数配置GPU。 单位MB。 取值范围为:1024、2048、3072、4096、5120、6144、7168、8192、9216、10240、11264、12288、13312、14336、15360、16384。 最小值为1024,最大值为16384。 user_data 否 String 用户自定义的name/value信息。 在函数中使用的参数。 举例:如函数要访问某个主机,可以设置自定义参数:Host={host_ip},最多定义20个,总长度不超过4KB。 encrypted_user_data 否 String 用户自定义的name/value信息,用于需要加密的配置。 xrole 否 String 函数使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 app_xrole 否 String 函数app使用的权限委托名称,需要IAM支持,并在IAM界面创建委托,当函数需要访问其他服务时,必须提供该字段。 description 否 String 函数描述。 func_vpc 否 FuncVpc object 函数vpc配置。 mount_config 否 MountConfig object 函数挂载配置。 strategy_config 否 StrategyConfig object 函数策略配置。 custom_image 否 CustomImage object 用户容器镜像。 extend_config 否 String 函数扩展配置。 initializer_handler 否 String 函数初始化入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.initializer,则表示函数的文件名为myfunction.js,初始化的入口函数名为initializer。 initializer_timeout 否 Integer 初始化超时时间,超时函数将被强行停止,范围1~300秒。 pre_stop_handler 否 String 函数预停止函数的入口,规则:xx.xx,必须包含“. ”。 举例:对于node.js函数:myfunction.pre_stop_handler,则表示函数的文件名为myfunction.js,初始化的入口函数名为pre_stop_handler。 pre_stop_timeout 否 Integer 初始化超时时间,超时函数将被强行停止,范围1~90秒。 ephemeral_storage 否 Integer 临时存储大小, 默认512M, 支持配置10G。 枚举值: 512 10240 enterprise_project_id 否 String 企业项目ID,在企业用户创建函数时必填。 log_config 否 FuncLogConfig object 函数绑定日志配置。 network_controller 否 NetworkControlConfig object 函数网络配置。 is_stateful_function 否 Boolean 是否支持有状态,如果需要支持,需要固定传参为true,v2版本支持 enable_dynamic_memory 否 Boolean 是否启动动态内存配置 enable_auth_in_header 否 Boolean 是否允许在请求头中添加鉴权信息 domain_names 否 String 内网域名配置。 restore_hook_handler 否 String 函数快照式冷启动Restore Hook入口,仅支持Java,规则:xx.xx,必须包含“. ”。如:com.xxx.demo.Test.restoreHook restore_hook_timeout 否 Integer 快照冷启动Restore Hook的超时时间,超时函数将被强行停止,范围1~300秒。 表3 FuncVpc 参数 是否必选 参数类型 描述 vpc_name 是 String 虚拟私有云名称。 vpc_id 是 String 虚拟私有云唯一标识。 subnet_name 是 String 子网名称。 subnet_id 是 String 子网编号。 cidr 是 String 子网掩码。 gateway 是 String 网关。 security_groups 否 Array of strings 安全组 表4 MountConfig 参数 是否必选 参数类型 描述 mount_user 是 MountUser object 挂载用户信息。 func_mounts 是 Array of FuncMount objects 函数挂载列表。 表5 MountUser 参数 是否必选 参数类型 描述 user_id 是 String 用户ID(-1~65534的非0整数) user_group_id 是 String 用户组ID(-1~65534的非0整数) 表6 FuncMount 参数 是否必选 参数类型 描述 mount_type 是 String 挂载类型(sfs/sfsTurbo/ecs),func_mounts非空时必选。 mount_resource 是 String 挂载资源ID(对应云服务ID),func_mounts非空时必选。 mount_share_path 否 String 远端挂载路径(例如192.168.0.12:/data),如果mount_type为ecs,必选。 local_mount_path 是 String 函数访问路径,func_mounts非空时必选。 表7 StrategyConfig 参数 是否必选 参数类型 描述 concurrency 是 Integer 单函数最大实例数,v1取值0和-1,v2取值-1到1000 -1代表该函数实例数无限制 0代表该函数被禁用 concurrent_num 是 Integer 单实例最大并发数,v2版本才支持,取值-1到1000 表8 CustomImage 参数 是否必选 参数类型 描述 enabled 否 Boolean 是否启用 image 否 String 镜像地址 command 否 String 启动容器镜像的命令 args 否 String 启动容器镜像的命令行参数 working_dir 否 String 镜像容器工作目录 uid 否 String 镜像容器的用户id gid 否 String 镜像容器的用户组id 表9 FuncLogConfig 参数 是否必选 参数类型 描述 group_name 否 String 函数绑定日志组名。 group_id 否 String 函数绑定日志组ID。 stream_name 否 String 函数绑定日志流名。 stream_id 否 String 函数绑定日志流ID。 表10 NetworkControlConfig 参数 是否必选 参数类型 描述 disable_public_network 否 Boolean 禁止公网访问开关。 trigger_access_vpcs 否 Array of VpcConfig objects 指定触发函数vpc配置。 表11 VpcConfig 参数 是否必选 参数类型 描述 vpc_name 否 String vpc名称。 vpc_id 否 String vpc ID。
共100000条