CreateService API参考-函数计算-阿里云

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口无特殊请求头，关于公共请求头信息，请参见公共参数。

请求语法

POST /services HTTP/1.1

请求参数

名称	类型	位置	是否必选	示例值	描述
	Object	Body	否		服务定义。
description	String	Body	否	test_description	服务的描述。
internetAccess	Boolean	Body	否	true	是否允许函数访问公网： true：默认值，允许函数访问公网。 false：不允许函数访问公网。
logConfig	LogConfig	Body	否		日志配置，函数产生的日志会写入这里配置的Logstore中。
nasConfig	NASConfig	Body	否		NAS配置，配置后函数可以访问指定NAS资源。
role	String	Body	否	acs:ram::198613743****:role/fc-public-test	授予函数计算所需权限的RAM角色，使用场景包含：把函数产生的日志发送到您的Logstore中。为函数在执行中访问其他云资源生成Token。
serviceName	String	Body	是	service_name	服务的名称。服务名称只能包含字母、数字、下划线（_）和短划线（-），不能以数字、短划线（-）开头，长度为1~128个字符。
vpcConfig	VPCConfig	Body	否		VPC配置，配置后函数计算可以访问指定VPC资源。
tracingConfig	TracingConfig	Body	否		链路追踪配置。当函数计算与链路追踪集成后，您可以记录请求在函数计算的耗时时间、查看函数的冷启动时间、记录函数内部时间的消耗等，更多信息，请参见链路追踪。

返回数据

名称	类型	示例值	描述
ETag	String	e19d5cd5af0378da05f63f891c7467af	确保实际修改的服务和期望修改的服务是一致的。
createdTime	String	2020-04-03T05:57:28Z	服务的创建时间。
description	String	test_description	服务的描述。
internetAccess	Boolean	true	是否允许函数访问公网： true：允许函数访问公网。 false：不允许函数访问公网。
lastModifiedTime	String	2020-04-03T05:57:28Z	服务上一次被更新的时间。
logConfig	LogConfig		日志配置。函数产生的日志会写入这里配置的Logstore。
nasConfig	NASConfig		NAS配置，配置后函数可以访问指定NAS资源。
role	String	acs:ram::198613743****:role/fc-public-test	授予函数计算所需权限的RAM角色，使用场景包含：把函数产生的日志发送到您的Logstore中。为函数在执行中访问其他云资源生成Token。
serviceId	String	c910061f-**-44e6-b659-*c	系统为服务生成的ID，全网唯一。
serviceName	String	service_name	服务的名称。
vpcConfig	VPCConfig		VPC配置，配置后函数可以访问指定VPC资源。
tracingConfig	TracingConfig		链路追踪配置。当函数计算与链路追踪集成后，您可以记录请求在函数计算的耗时时间、查看函数的冷启动时间、记录函数内部时间的消耗等，更多信息，请参见链路追踪。

示例

请求示例

POST /2016-08-15/services HTTP/1.1
公共请求头
{
  "description" : "test_description",
  "internetAccess" : true,
  "logConfig" : {
    "logstore" : "test-prj",
    "project" : "test-logstore",
    "enableRequestMetrics" : true,
    "logBeginRule" : "DefaultRegex"
  },
  "nasConfig" : {
    "groupId" : "100",
    "mountPoints" : [ {
      "mountDir" : "/home/test",
      "serverAddr" : "***-uni85.cn-hangzhou.nas.aliyuncs.com:/"
    } ],
    "userId" : "100"
  },
  "role" : "acs:ram::198613743****:role/fc-public-test",
  "serviceName" : "service_name",
  "vpcConfig" : {
    "securityGroupId" : "sg-bp18hj1wtxgy3b0***",
    "vSwitchIds" : [ "vsw-bp1ozpcrdc6r****" ],
    "vpcId" : "vpc-***"
  },
  "tracingConfig" : {
    "type" : "Jaeger"
  }
}

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "createdTime" : "2020-04-03T05:57:28Z",
  "description" : "test_description",
  "internetAccess" : true,
  "lastModifiedTime" : "2020-04-03T05:57:28Z",
  "logConfig" : {
    "logstore" : "test-prj",
    "project" : "test-logstore",
    "enableRequestMetrics" : true,
    "logBeginRule" : "DefaultRegex"
  },
  "nasConfig" : {
    "groupId" : "100",
    "mountPoints" : [ {
      "mountDir" : "/home/test",
      "serverAddr" : "***-uni85.cn-hangzhou.nas.aliyuncs.com:/"
    } ],
    "userId" : "100"
  },
  "role" : "acs:ram::198613743****:role/fc-public-test",
  "serviceId" : "c910061f-****-44e6-b659-***c",
  "serviceName" : "service_name",
  "vpcConfig" : {
    "securityGroupId" : "sg-bp18hj1wtxgy3b0***",
    "vSwitchIds" : [ "vsw-bp1ozpcrdc6r****" ],
    "vpcId" : "vpc-***"
  },
  "tracingConfig" : {
    "type" : "Jaeger"
  }
}

错误码

访问错误中心查看更多错误码。