全部產品
Search

搜尋本產品

    API Gateway：建立服務

    文件中心

    API Gateway：建立服務

    更新時間：Sep 10, 2025

    您需要將已有的服務添加到網關中，登記為路由備選服務，以便網關擷取服務地址。AI 網關支援以Container Service、固定地址、DNS網域名稱和FCFunction Compute等幾種形式添加服務。

    操作步驟

    說明

    AI 網關不會修改您的請求，當請求被轉寄到後端網域名稱服務 (DNS)時，Host不會被重寫為您配置的網域名稱。

    網關通過服務動態感知後端資源變化，實現流量路由、治理和安全防護的統一管理。AI網關支援建立AI 服務、Agent服務、DNS 網域名稱、固定地址、Container Service、SAE Kubernetes服務、Function ComputeFC 和 MSE Nacos。

    AI 服務

    1. 登入AI網關控制台，在網關列表頁，選擇您執行個體所在的地區，並單擊目標執行個體ID。單擊左側導覽列的服務，單擊建立服務。

    2. 在建立服務面板中，配置以下參數：

      • 服務來源：選擇AI 服務。

      • 服務名稱：自訂服務名稱。

      • 大模型供應商：支援阿里雲百鍊、PAI-EAS、Deepseek、OpenAI相容（OpenAI Compatible）、OpenAI、Azure、Gemini、Bedrock、Claude、月之暗面、百川智能、零一萬物、智譜AI、混元、階躍星辰、星火、豆包、MiniMax。

        重要

        本AI服務所提供的大模型能力並非由AI網關直接提供。在使用前，請您自行評估該服務的適用性和可靠性，並確保您的使用行為完全符合相關法律法規及產品使用協議的要求。對於因違反上述規定而產生的一切後果，我們將不承擔任何責任。

      • 服務地址（base_url）：大模型服務的BaseURL。格式為：https://{domain}/v1。

        Azure服務提供者服務地址：https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version={api-version}。

      • API-KEY：訪問大模型需要的API-KEY憑證。如果使用阿里雲百鍊，請在阿里雲百鍊API-KEY擷取。其他大模型供應商，請諮詢對應的服務提供者。

    3. 配置完成後單擊確定，完成建立。

    Agent服務

    1. 登入AI網關控制台，在網關列表頁，選擇您執行個體所在的地區，並單擊目標執行個體ID。單擊左側導覽列的服務，單擊建立服務。

    2. 在建立服務面板中，配置以下參數：

      • 服務來源：選擇Agent 服務。

      • 服務名稱：自訂服務名稱。

      • 服務供應商：支援選擇阿里雲百鍊、Dify、自訂。

        重要

        請注意，本Agent服務所提供的智能體相關能力並非由雲原生API Gateway直接提供。在使用前，請您自行評估該服務的適用性和可靠性，並確保您的使用行為完全符合相關法律法規及產品使用協議的要求。對於因違反上述規定而產生的一切後果，我們將不承擔任何責任。

        阿里雲百鍊

        Dify

        • API地址：輸入Agent服務的存取點地址。預設為：https://api.dify.ai/v1。

        • 應用類型：支援選擇Agent或Workflow。

          • Agent：智能體類型。

          • Workflow：工作流程類型。

        • API KEY：請諮詢服務供應商擷取。

        自訂

        • API地址：輸入Agent服務的存取點地址。

        • API KEY：請諮詢服務供應商擷取。

    3. 配置完成後單擊確定，完成建立。

    DNS 網域名稱

    說明

    AI 網關支援根據DNS解析的結果作為後端服務地址。

    1. 登入AI網關控制台，在網關列表頁，選擇您執行個體所在的地區，並單擊目標執行個體ID。單擊左側導覽列的服務，單擊建立服務。

    2. 在建立服務面板中，配置以下參數：

      • 服務來源：選擇DNS 網域名稱。

      • 服務名稱：自訂服務名稱。

      • 服務地址：服務的後端節點地址，不同來源的服務，後端節點有所不同。格式為<DNS網域名稱>:<服務連接埠>，支援填寫多個，以英文,分隔。

        重要

        如果指定的是外網地址，需要配置NAT Gateway。

      • TLS模式：預設關閉。

        • 關閉：訪問服務時，無需開啟TLS。

        • 單向TLS：需要使用HTTPS訪問服務時開啟單向TLS。

        • 雙向TLS（mTLS）：需要做雙向認證時開啟mTLS。

    3. 配置完成後單擊確定，完成建立。

    固定地址

    說明

    如果該服務沒有服務發現機制，需要手動添加服務的後端節點地址。

    1. 登入AI網關控制台，在網關列表頁，選擇您執行個體所在的地區，並單擊目標執行個體ID。單擊左側導覽列的服務，單擊建立服務。

    2. 在建立服務面板中，配置以下參數：

      • 服務來源：選擇固定地址。

      • 服務名稱：自訂服務名稱。

      • 服務地址：服務的後端節點地址，不同來源的服務，後端節點有所不同。格式為<IP>:<服務連接埠>，支援填寫多個，以英文,分隔。

        重要

        如果指定的是外網地址，需要配置NAT Gateway。

      • TLS模式：預設關閉。

        • 關閉：訪問服務時，無需開啟TLS。

        • 單向TLS：需要使用HTTPS訪問服務時開啟單向TLS。

        • 雙向TLS（mTLS）：需要做雙向認證時開啟mTLS。

    3. 配置完成後單擊確定，完成建立。

    Container Service

    說明

    如果在網關中添加了Container Service作為服務來源，網關會從ACK/ACK Serverless叢集擷取服務列表，將服務列表中的服務及其後端節點地址添加到網關中。

    1. 登入AI網關控制台。選擇您執行個體所在的地區，並單擊目標執行個體ID。在左側導覽列單擊服務。

    2. 建立來源

      1. 單擊來源頁簽，然後單擊建立來源，在建立來源面板中，配置以下參數：

        • 來源類型：選擇Container Service，通過K8s Server發現後端服務。

        • ACK/ACS/ACK Serverless 叢集：選擇後端服務所在的叢集。

          重要

          • 如當前VPC下不存在 ACK/ACS/ACK Serverless 叢集，則需要建立ACK託管叢集，再選擇該叢集。

          • 如果需要添加其他VPC下的服務來源，請重新建立指定VPC下的網關執行個體後，再選擇該叢集。

          • 單個網關執行個體最多隻能關聯3個ACKContainer Service。

          • 雲原生API Gateway只能添加同VPC內的Nacos或者ACK，不支援跨VPC添加服務來源。

      2. 配置完成後單擊確定，完成建立。

    3. 建立服務

      1. 單擊服務頁簽，然後單擊建立服務，在建立服務面板中，配置以下參數：

        • 服務來源：選擇Container Service。

          網關會從ACK/ACK Serverless叢集擷取服務列表，將服務列表中的服務及其後端節點地址添加到網關中。

        • 命名空間：選擇叢集的命名空間。預設不展示arms-prom、kube-system和mse-pilot命名空間的服務。

        • 服務列表：在服務列表中選擇服務。預設不展示以consumers開頭的服務。

      2. 配置完成後單擊確定，完成建立。

    SAE Kubernetes服務

    重要

    添加SAE Kubernetes作為服務來源時，SAE應用需要開啟K8s Service服務註冊發現。

    1. 登入AI網關控制台，在網關列表頁，選擇您執行個體所在的地區，並單擊目標執行個體ID。單擊左側導覽列的服務，單擊建立服務。

    2. 在建立服務面板中，配置以下參數：

      • 服務來源：SAE Kubernetes服務。SAE應用需要開啟基於K8s ServiceName配置應用服務訪問。

      • 命名空間：選擇叢集的命名空間。預設不展示arms-prom、kube-system和mse-pilot命名空間的服務。

      • 服務列表：在服務列表中選擇服務。預設不展示以consumers:開頭的服務。

    3. 配置完成後單擊確定，完成建立。

    Function ComputeFC

    重要

    支援Function Compute3.0，暫不支援Function Compute2.0的服務來源。

    1. 登入AI網關控制台，在網關列表頁，選擇您執行個體所在的地區，並單擊目標執行個體ID。單擊左側導覽列的服務，單擊建立服務。

    2. 在建立服務面板中，配置以下參數：

      • 服務來源：Function Compute FC。

      • 函數列表：在函數列表中選擇函數。

      • 版本或別名：選擇函數的版本或別名。

    3. 配置完成後單擊確定，完成建立。

    MSE Nacos

    1. 登入AI網關控制台。選擇您執行個體所在的地區，並單擊目標執行個體ID。在左側導覽列單擊服務。

    2. 建立來源

      1. 單擊來源頁簽，然後單擊建立來源，在建立來源面板中，配置以下參數：

        • 來源類型：選擇MSE Nacos，通過 MSE Nacos 註冊中心發現後端服務。

        • Nacos 叢集：選擇Nacos 叢集。

          重要

          • 如果當前VPC下不存在MSE Nacos叢集，則需要先建立MSE Nacos叢集，再選擇該Nacos叢集。

          • 如果需要添加其他VPC下的服務來源，請重新建立指定VPC下的網關執行個體，再選擇該Nacos叢集。

          • 叢集列表僅展示MCPEnabled = true的MSE Nacos執行個體，可在MSE Nacos參數設定中更改。

          • 單個網關執行個體最多隻能關聯1個Nacos執行個體。

      2. 配置完成後單擊確定，完成建立。

    3. 建立服務

      1. 單擊服務頁簽，然後單擊建立服務，在建立服務面板中，配置以下參數：

        • 服務來源：選擇MSE Nacos。

          網關會從Nacos 叢集擷取服務列表，將服務列表中的服務及其後端節點地址添加到網關中。

        • 命名空間：選擇命名空間。預設不展示arms-prom、kube-system和mse-pilot命名空間的服務。

        • 服務列表：在服務列表中選擇服務。預設不展示以consumers:開頭的服務。

      2. 配置完成後單擊確定，完成建立。