全部產品
Search
文件中心

Function Compute:CreateService

更新時間:Aug 20, 2025

調用CreateService介面建立服務。

調試

您可以在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

授予Function Compute要求的權限的RAM角色,使用情境包含:

  • 把函數產生的日誌發送到您的Logstore中。
  • 為函數在執行中訪問其他雲資源產生Token。
serviceName String Body service_name

服務的名稱。服務名稱只能包含字母、數字、底線(_)和短劃線(-),不能以數字、短劃線(-)開頭,長度為1~128個字元。

vpcConfig VPCConfig Body

VPC配置,配置後Function Compute可以訪問指定VPC資源。

tracingConfig TracingConfig Body

鏈路追蹤配置。當Function Compute與鏈路追蹤整合後,您可以記錄請求在Function Compute的耗時時間、查看函數的冷啟動時間、記錄函數內部時間的消耗等,更多資訊,請參見鏈路追蹤

返回資料

名稱 類型 樣本值 描述
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

授予Function Compute要求的權限的RAM角色,使用情境包含:

  • 把函數產生的日誌發送到您的Logstore中。
  • 為函數在執行中訪問其他雲資源產生Token。
serviceId String c910061f-****-44e6-b659-***c

系統為服務產生的ID,全網唯一。

serviceName String service_name

服務的名稱。

vpcConfig VPCConfig

VPC配置,配置後函數可以訪問指定VPC資源。

tracingConfig TracingConfig

鏈路追蹤配置。當Function Compute與鏈路追蹤整合後,您可以記錄請求在Function Compute的耗時時間、查看函數的冷啟動時間、記錄函數內部時間的消耗等,更多資訊,請參見鏈路追蹤

樣本

請求樣本

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。