调用CreateService接口创建服务。

请求头

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

请求语法

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"
  }
}