全部產品
Search

搜尋本產品

    API Gateway：CreateService

    文件中心

    API Gateway：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***"
    ]
  }
}

    錯誤碼

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

    變更歷史

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