全部产品
Search

搜索本产品

    ：GetService - 获取服务信息

    文档中心

    ：GetService - 获取服务信息

    更新时间：Sep 09, 2026

    查询指定的服务信息。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    fc:GetService

    get

    *全部资源

    *

    		 无 无

    请求语法

    GET /2021-04-06/services/{serviceName} HTTP/1.1

    路径参数

    名称

    类型

    必填

    描述

    示例值
    serviceName

    string

    是

    服务的名称。

    demo-service

    请求参数

    名称

    类型

    必填

    描述

    示例值
    qualifier

    string

    否

    服务的版本或别名。

    test
    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

    服务定义。

    createdTime

    string

    服务的创建时间。

    2020-04-03T05:57:28Z
    description

    string

    服务的描述。

    demo-service-test
    internetAccess

    boolean

    是否允许函数访问公网：

    • true：允许函数访问公网。

    • false：不允许函数访问公网。

    true
    lastModifiedTime

    string

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

    2020-04-03T05:57:28Z
    logConfig LogConfig

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

    nasConfig NASConfig

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

    role

    string

    服务中函数所使用的角色，使函数可以获得角色所拥有的权限，实现跨产品访问。使用场景包含：

    • 把函数产生的日志发送到您的 Logstore 中。

    • 为函数在执行中访问其他云资源生成 Token。

    acs:ram::1234567890:role/fc-test
    serviceId

    string

    系统生成的服务 ID，全网唯一。

    2d28e0e9-9ba5-4eed-8b1a-d3d9cd24e737
    serviceName

    string

    服务的名称。

    demo-service
    vpcConfig VPCConfig

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

    tracingConfig TracingConfig

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

    ossMountConfig OSSMountConfig

    OSS 挂载配置。

    useSLRAuthentication

    boolean

    服务是否使用服务关联角色授权模式：

    • true：使用服务关联角色授权模式。

    • false：未使用服务关联角色授权模式。

    true

    示例

    正常返回示例

    JSON格式

    {
  "createdTime": "2020-04-03T05:57:28Z",
  "description": "demo-service-test",
  "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::1234567890:role/fc-test",
  "serviceId": "2d28e0e9-9ba5-4eed-8b1a-d3d9cd24e737",
  "serviceName": "demo-service",
  "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
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。