调用UpdateService接口更新服务信息。

请求头

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

请求语法

PUT /services/{serviceName} 

请求参数

名称 类型 位置 是否必选 示例值 描述
If-Match String Header e19d5cd5af0378da05f63f891c7467af

服务的名称。

serviceName String Path service_name

服务的名称。

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::19861****3743:role/fc-public-test

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

  • 把函数产生的日志发送到您的Logstore中。
  • 为函数在执行中访问其他云资源生成Token。
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-03T07:57:33Z

服务上一次被更新的时间。

logConfig LogConfig

日志配置。函数产生的日志会写入这里配置的Logstore。

nasConfig NASConfig

NAS配置,配置后函数可以访问指定NAS资源。

role String acs:ram::19861****3743:role/fc-public-test

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

  • 把函数产生的日志发送到您的Logstore中。
  • 为函数在执行中访问其他云资源生成Token。
serviceId String c910061f-f6fa-44e6-b659-56***

系统为每个服务生成的唯一ID。

serviceName String service_name

服务的名称。

vpcConfig VPCConfig

VPC配置,配置后函数可以访问指定VPC资源。

tracingConfig TracingConfig

链路追踪配置。当函数计算与链路追踪集成后,您可以记录请求在函数计算的耗时时间、查看函数的冷启动时间、记录函数内部时间的消耗等,更多信息,请参见链路追踪

示例

请求示例

PUT /2016-08-15/services/service_name HTTP/1.1
公共请求头
{
    "role":"acs:ram::19861****3743:role/fc-public-test",
    "logConfig":{
        "enableRequestMetrics":"true",
        "project":"test_project",
        "logstore":"test_logstore"
    },
    "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***"
    },
    "nasConfig":{
        "userId":100,
        "groupId":100,
        "mountPoints":[
            {
                "serverAddr":"***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
                "mountDir":"/home/test"
            }
        ]
    }
}

正常返回示例

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-56***",
  "createdTime": "2020-04-03T05:57:28Z",
  "lastModifiedTime": "2020-04-03T07:57:33Z",
  "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***"
  },
  "internetAccess": true,
  "nasConfig": {
    "userId": 100,
    "groupId": 100,
    "mountPoints": [
      {
        "serverAddr": "***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
        "mountDir": "/home/test"
      }
    ]
  }
}