调用CreateService接口创建服务。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

POST /services

请求参数

名称 类型 位置 是否必选 示例值 描述
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::19861****3743:role/fc-public-test

授予函数计算所需权限的RAM角色，使用场景包含：

  • 把函数产生的日志发送到您的Logstore中。
  • 为函数在执行中访问其他云资源生成Token。
serviceName String Body 是 service_name

服务的名称。
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::19861****3743: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
公共请求头
{
    "serviceName":"service_name",
    "description":"test_description",
    "role":"acs:ram::19861****3743:role/fc-public-test",
    "logConfig":{
        "enableRequestMetrics":"true",
        "project":"test_project",
        "logstore":"test_logstore"
    },
    "serviceId":"c910061f-f6fa-44e6-b659-***c",
    "createdTime":"2020-04-03T05:57:28Z",
    "lastModifiedTime":"2020-04-03T05:57:28Z",
    "tracingConfig":{
        "params":{
            "endpoint":"http://tracing-*********-dc-sh-internal.aliyuncs.com/*****_iioe7jcnuk@***************_iioe7*****@******d2afe****/api/traces"
        },
        "type":"Jaeger"
    },
    "vpcConfig":{
        "vpcId":"vpc_***",
        "vSwitchIds":[
            "vsw_***"
        ],
        "securityGroupId":"sg-bp18hj1wtxgy3***",
        "role":"acs:ram::19861****3743:role/fc-public-test"
    },
    "internetAccess":true,
    "nasConfig":{
        "userId":100,
        "groupId":100,
        "mountPoints":[
            {
                "serverAddr":"***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
                "mountDir":"/home/test"
            }
        ]
    },
    "vendorConfig":null
}

正常返回示例

JSON格式 

HTTP/1.1 200
ETag:e19d5cd5af0378da05f63f891c7467af
Content-Type:application/json
HTTP/1.1 200 OK
公共响应头
{
  "serviceName": "service_name",
  "description": "test_description",
  "role": "acs:ram::19861****3743:role/fc-public-test",
  "logConfig": {
    "enableRequestMetrics": "true",
    "project": "test_project",
    "logstore": "test_logstore"
  },
  "serviceId": "c910061f-f6fa-44e6-b659-***c",
  "createdTime": "2020-04-03T05:57:28Z",
  "lastModifiedTime": "2020-04-03T05:57:28Z",
  "tracingConfig": {
    "params": {
      "endpoint": "http://tracing-*********-dc-sh-internal.aliyuncs.com/*****_iioe7jcnuk@***************_iioe7*****@******d2afe****/api/traces"
    },
    "type": "Jaeger"
  },
  "vpcConfig": {
    "vpcId": "vpc_***",
    "vSwitchIds": [
      "vsw_***"
    ],
    "securityGroupId": "sg-bp18hj1wtxgy3***",
    "role": "acs:ram::19861****3743:role/fc-public-test"
  },
  "internetAccess": true,
  "nasConfig": {
    "userId": 100,
    "groupId": 100,
    "mountPoints": [
      {
        "serverAddr": "***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
        "mountDir": "/home/test"
      }
    ]
  },
  "vendorConfig": null
}