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