全部产品
Search

搜索本产品

    API 网关：CreateService - 创建服务

    文档中心

    API 网关：CreateService - 创建服务

    更新时间：Jul 09, 2026

    创建服务。

    接口说明

    接口支持创建多个服务。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    apig:CreateService

    none

    *Service

    acs:apig:{#regionId}:{#accountId}:service/*

    		 无 无

    请求语法

    POST /v1/services HTTP/1.1

    请求参数

    名称

    类型

    必填

    描述

    示例值
    body

    object

    否

    请求 Body。

    gatewayId

    string

    否

    网关 ID。

    gw-cq7l5s5lhtg***
    sourceType

    string

    否

    服务来源：

    • MSE_NACOS: MSE Nacos 里的服务。

    • K8S: 容器服务里 K8S 集群里的服务。

    • VIP: 固定地址服务。

    • DNS: DNS 域名服务。

    • FC3: 函数计算里的服务。

    • SAE_K8S_SERVICE: SAE K8S 服务

    • AI: AI 服务

    • AGENT: Agent 服务

    枚举值：

    • AGENT :

      Agent 服务

    • SAE_K8S_SERVICE :

      SAE_K8S_SERVICE

    • K8S :

      容器服务

    • FC3 :

      函数计算服务

    • DNS :

      DNS 域名

    • AI :

      AI 服务

    • VIP :

      固定地址

    • MSE_NACOS :

      MSE Nacos

    MSE_NACOS
    serviceConfigs

    array<object>

    否

    服务配置列表，至少包含一个服务配置

    array<object>

    否

    服务配置信息。

    name

    string

    否

    服务名。

    user-service
    namespace

    string

    否

    服务的命名空间:

    • sourceType 为 K8S 时,表示是 K8S 服务所在的命名空间。

    • sourceType 为 MSE_NACOS 时, 表示是 Nacos 里的命名空间。

    当 sourceType 为 K8S 和 MSE_NACOS 时, 需要指定。

    PUBLIC
    groupName

    string

    否

    服务分组名。 当 sourceType 为 MSE_NACOS 时, 需要指定。

    DEFAULT_GROUP
    addresses

    array

    否

    域名或固定地址列表。

    string

    否

    域名或固定地址。

    dev.com:8080
    qualifier

    string

    否

    函数版本或别名。

    LATEST
    aiServiceConfig AiServiceConfig

    否

    AI 服务配置。

    agentServiceConfig AgentServiceConfig

    否

    Agent 服务配置，当sourceType为AGENT时必填

    modelProviderId

    string

    否

    模型供应商 ID

    mp-xxx****
    dnsServers

    array

    否

    dns 服务地址列表

    string

    否

    DNS 服务地址

    100.100.1.156:53
    sourceId

    string

    否

    服务来源 ID，多 Nacos 实例场景下必填

    nacos-instance-001
    validationOptions

    object

    否

    验证选项，服务验证相关配置选项

    skipVerifyAIChatCompletion

    boolean

    否

    是否跳过 AI 聊天完成验证

    expressType

    string

    否

    服务表达类型，标识服务的特殊类型或模式

    Standard
    resourceGroupId

    string

    否

    资源组 ID。

    rg-xxx
    clientToken

    string

    否

    客户端令牌

    xxx

    返回参数

    名称

    类型

    描述

    示例值

    object

    响应体

    requestId

    string

    请求 ID。

    C67DED2B-F19B-5BEC-88C1-D6EB854CD0D4
    code

    string

    响应状态码。

    Ok
    message

    string

    响应消息。

    success
    data

    object

    响应数据。

    serviceIds

    array

    服务 ID 列表。

    string

    服务 ID。

    svc-crbgq0dlhtgrdb***

    示例

    正常返回示例

    JSON格式

    {
  "requestId": "C67DED2B-F19B-5BEC-88C1-D6EB854CD0D4",
  "code": "Ok",
  "message": "success",
  "data": {
    "serviceIds": [
      "svc-crbgq0dlhtgrdb***"
    ]
  }
}

    错误码

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

    变更历史

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