使用CreateService建立服務-Function Compute-阿里雲

建立服務。

介面說明

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

fc:CreateService

create

*Service

acs:fc:{#regionId}:{#accountId}:services/{#serviceName}

fc:EnableServiceSLSLogging
fc:EnableServiceInternetAccess

無

請求文法

POST /2021-04-06/services HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
body	object	否	服務定義。
description	string	否	服務的描述。	service_description
internetAccess	boolean	否	是否允許函數訪問公網： true：允許函數訪問公網，預設值。 false：不允許函數訪問公網。	true
logConfig	LogConfig	否	日誌配置。函數產生的日誌會被寫入到配置的日誌庫中。
nasConfig	NASConfig	否	NAS 配置。配置此參數後，函數可以訪問指定的 NAS 資源。
role	string	否	授予Function Compute要求的權限的 RAM 角色，使用情境包含：把函數產生的日誌發送到您的日誌庫中。為函數在執行過程中訪問其他雲資源產生的臨時存取權杖。	acs:ram::188077086902****:role/fc-test
serviceName	string	是	服務的名稱。只能包含字母、數字、底線（_）和短劃線（-）。不能以數字、短劃線（-）開頭。長度範圍為 1~128 個字元。	service_Name
vpcConfig	VPCConfig	否	VPC 配置。配置此參數後，函數可以訪問指定的 VPC 資源。
tracingConfig	TracingConfig	否	鏈路追蹤配置。當Function Compute與鏈路追蹤整合後，您可以記錄請求在Function Compute的耗時時間、查看函數的冷啟動時間、記錄函數內部時間的消耗等。更多資訊，請參見鏈路追蹤。
ossMountConfig	OSSMountConfig	否	OSS 掛載配置。
X-Fc-Account-Id	string	否	您的阿里雲帳號（主帳號）ID。	188077086902****
X-Fc-Date	string	否	函數的調用開始日期，格式為EEE,d MMM yyyy HH:mm:ss GMT。	Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-Id	string	否	自訂請求 ID。	asdf****

返回參數

名稱	類型	描述	樣本值
	object	建立服務要求的傳回值。
createdTime	string	服務的建立時間。	2016-08-15T16:06:05.000+0000
description	string	服務的描述。	service_description
internetAccess	boolean	是否允許函數訪問公網： true：允許函數訪問公網。 false：不允許函數訪問公網。	true
lastModifiedTime	string	服務上一次被更新的時間。	2016-08-15T16:06:05.000+0000
logConfig	LogConfig	日誌配置。函數產生的日誌會被寫入到配置的日誌庫中。
nasConfig	NASConfig	NAS 配置。配置此參數後，函數可以訪問指定的 NAS 資源。
role	string	授予Function Compute要求的權限的 RAM 角色，使用情境包含：把函數產生的日至發送到您的日誌庫中。為函數在執行過程中訪問其他雲資源產生的臨時存取權杖。	acs:ram::188077086902****:role/fc-test
serviceId	string	系統為服務產生的 ID，全網唯一。	2d28e0e9-9ba5-4eed-8b1a-d3d9cd24e737
serviceName	string	服務的名稱。	service_Name
vpcConfig	VPCConfig	VPC 配置。配置此參數後，函數可以訪問指定的 VPC 資源。
tracingConfig	TracingConfig	鏈路追蹤配置。當Function Compute與鏈路追蹤整合後，您可以記錄請求在Function Compute的耗時時間、查看函數的冷啟動時間、記錄函數內部時間的消耗等。更多資訊，請參見鏈路追蹤。
ossMountConfig	OSSMountConfig	OSS 掛載配置。
useSLRAuthentication	boolean	服務是否使用服務關聯角色授權模式： true：使用服務關聯角色授權模式。 false：未使用服務關聯角色授權模式。	true

樣本

正常返回樣本

JSON格式

{
  "createdTime": "2016-08-15T16:06:05.000+0000",
  "description": "service_description",
  "internetAccess": true,
  "lastModifiedTime": "2016-08-15T16:06:05.000+0000",
  "logConfig": {
    "logstore": "test-prj",
    "project": "test-logstore",
    "enableRequestMetrics": true,
    "enableInstanceMetrics": true,
    "logBeginRule": "DefaultRegex"
  },
  "nasConfig": {
    "groupId": 100,
    "mountPoints": [
      {
        "mountDir": "/home/test",
        "serverAddr": "***-uni85.cn-hangzhou.nas.aliyuncs.com:/",
        "enableTLS": false
      }
    ],
    "userId": 100
  },
  "role": "acs:ram::188077086902****:role/fc-test",
  "serviceId": "2d28e0e9-9ba5-4eed-8b1a-d3d9cd24e737",
  "serviceName": "service_Name",
  "vpcConfig": {
    "securityGroupId": "sg-bp18hj1wtxgy3b0***",
    "vSwitchIds": [
      "vsw-bp1ozpcrdc6r****"
    ],
    "vpcId": "vpc-***",
    "role": "acs:ram::1234567890:role/fc-test"
  },
  "tracingConfig": {
    "type": "Jaeger",
    "params": {
      "key": "{\"endpoint\": \"tracing_analysis_jaeger_endpoint\"}"
    }
  },
  "ossMountConfig": {
    "mountPoints": [
      {
        "bucketName": "my-bucket",
        "mountDir": "/mnt/dir",
        "readOnly": true,
        "endpoint": "http://oss-cn-shanghai.aliyuncs.com",
        "bucketPath": "/my-dir"
      }
    ]
  },
  "useSLRAuthentication": true
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。