全部產品
Search

搜尋本產品

    API Gateway：CreateService - 建立服務

    文件中心

    API Gateway：CreateService - 建立服務

    更新時間：Mar 30, 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: Container Service裡 K8S 叢集裡的服務。

    • VIP: 固定地址服務。

    • DNS: DNS 網域名稱服務 (DNS)。

    • FC3: Function Compute裡的服務。

    • SAE_K8S_SERVICE: SAE K8S 服務

    • AI: AI 服務

    • AGENT: Agent 服務

    枚舉值：

    • AGENT :

      Agent 服務

    • SAE_K8S_SERVICE :

      SAE_K8S_SERVICE

    • K8S :

      Container Service

    • FC3 :

      Function Compute服務

    • 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時必填

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

    錯誤碼

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

    變更歷史

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