全部產品
Search
文件中心

:ListServices - 擷取服務列表

更新時間:Feb 26, 2026

擷取服務列表。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

fc:ListServices

get

*Service

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

請求文法

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

請求參數

名稱

類型

必填

描述

樣本值

limit

integer

限定此次返回資源的數量。如果不設定,預設返回 20,最大不能超過 100。返回結果可以小於指定的數量,但不會多於指定的數量。

20

nextToken

string

用來標記當前開始讀取的位置,置空表示從頭開始。第一次查詢不需要提供這個參數,後續查詢的 Token 從返回結果中擷取。

caeba0****be03f84eb48b699f0a4883

prefix

string

限定返回的資源名稱,名稱必須以 Prefix 作為首碼,例如 Prefix 是 a,則返回的資源名均是以 a 開始的。

prefix_text

startKey

string

設定結果從 startKey 之後(包括 startKey)按字母排序的第一個開始返回。

nextService

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。

rid281s******

返回參數

名稱

類型

描述

樣本值

object

服務的定義。

nextToken

string

用來表示當前調用返回讀取到的位置,空代表資料已經讀取完畢。

caeba0****be03f84eb48b699f0a4883

services

array<object>

服務列表。

object

服務資訊。

createdTime

string

服務的建立時間。

2020-04-03T05:57:28Z

description

string

服務的描述。

test_description

internetAccess

boolean

是否允許函數訪問公網:

  • true:允許函數訪問公網。

  • false:不允許函數訪問公網。

true

lastModifiedTime

string

服務上一次被更新的時間。

2020-04-03T05:57:28Z

logConfig LogConfig

日誌配置,函數產生的日誌會寫入這裡配置的 Logstore。

nasConfig NASConfig

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

role

string

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

  • 把函數產生的日誌發送到您的 Logstore 中。

  • 為函數在執行中訪問其他雲資源產生 Token。

acs:ram::198613743****:role/fc-public-test

serviceId

string

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

c910061f-****-44e6-b659-***c

serviceName

string

服務的名稱。

service_name

vpcConfig VPCConfig

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

tracingConfig TracingConfig

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

ossMountConfig OSSMountConfig

OSS 掛載配置。

useSLRAuthentication

boolean

服務是否使用服務關聯角色授權模式:

  • true:使用服務關聯角色授權模式。

  • false:未使用服務關聯角色授權模式。

true

樣本

正常返回樣本

JSON格式

{
  "nextToken": "caeba0****be03f84eb48b699f0a4883",
  "services": [
    {
      "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,
        "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::198613743****:role/fc-public-test",
      "serviceId": "c910061f-****-44e6-b659-***c",
      "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
    }
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情