全部產品
Search

搜尋本產品

    Smart Access Gateway：CreateSmartAccessGateway - Smart Access Gateway執行個體

    文件中心

    Smart Access Gateway：CreateSmartAccessGateway - Smart Access Gateway執行個體

    更新時間：Dec 21, 2025

    建立Smart Access Gateway執行個體。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    smartag:CreateSmartAccessGateway

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    Smart Access Gateway執行個體的地區 ID。

    您可以通過調用 DescribeRegions 介面擷取地區 ID。

    cn-shanghai
    MaxBandWidth

    integer

    否

    Smart Access Gateway執行個體的頻寬。

    • 如果要建立Smart Access Gateway硬體版執行個體，且Smart Access Gateway裝置規格為sag-100wm，頻寬取值範圍為 2~50 Mbps。

    • 如果要建立Smart Access Gateway硬體版執行個體，且Smart Access Gateway裝置規格為sag-1000，頻寬取值範圍為 10~500 Mbps。

    • 如果要建立Smart Access Gateway vCPE 版執行個體，頻寬取值範圍為 10~1000 Mbps。

    12
    Name

    string

    否

    Smart Access Gateway執行個體名稱。

    名稱長度為 2~128 個字元，以大小寫字母或中文開頭，可包含數字、半形句號（.）、底線（_）或短劃線（-）。

    testname
    Description

    string

    否

    Smart Access Gateway執行個體的描述資訊。

    描述長度為 2~256 個字元，以大小寫字母或中文開頭，可包含數字、半形句號（.）、底線（_）或短劃線（-）。

    testdesc
    Period

    integer

    是

    Smart Access Gateway執行個體的購買時間長度，單位：月。

    取值：1~9、12、24、36。

    12
    AutoPay

    boolean

    是

    是否自動支付預付費執行個體的賬單。取值：

    • true：是。

    • false（預設值）：否。

    如果您選擇不自動支付賬單，在您調用本介面後，請前往控制台的訂單中心完成支付，執行個體才能建立成功。

    false
    HardWareSpec

    string

    是

    Smart Access Gateway執行個體類型。取值：

    • sag-100wm。

    • sag-1000。

    • sag-vcpe。

    sag-100wm
    ReceiverCountry

    string

    是

    Smart Access Gateway裝置收貨國家。

    中國
    ReceiverState

    string

    是

    Smart Access Gateway裝置收貨省份。

    浙江
    ReceiverCity

    string

    是

    Smart Access Gateway裝置收貨城市。

    杭州
    ReceiverDistrict

    string

    是

    Smart Access Gateway裝置收貨街區。

    西湖
    ReceiverTown

    string

    是

    Smart Access Gateway裝置收貨鄉鎮。

    轉塘
    ReceiverZip

    string

    是

    Smart Access Gateway裝置收貨省份郵編。

    310000
    ReceiverPhone

    string

    否

    Smart Access Gateway裝置收件者電話。

    8585****
    ReceiverMobile

    string

    是

    Smart Access Gateway裝置收件者手機號。

    1884085****
    ReceiverName

    string

    是

    Smart Access Gateway裝置收件者姓名。

    張三
    ReceiverEmail

    string

    是

    Smart Access Gateway裝置收貨人的電子郵箱。

    xx@example.com
    BuyerMessage

    string

    是

    買家留言資訊。

    留言
    ReceiverAddress

    string

    是

    Smart Access Gateway裝置收貨詳細地址。

    XX號
    HaType

    string

    是

    選擇一種使用方式。取值：

    • no_backup：只購買一台Smart Access Gateway裝置接入阿里雲。

    • cold_backup：購買兩台Smart Access Gateway裝置共用頻寬，僅主裝置線上。當主裝置發生故障時，需手動切換至備裝置。

    • warm_backup：購買兩台Smart Access Gateway裝置共用頻寬，兩台裝置同時線上。當主裝置故障時自動切換到備裝置。

    說明

    在您建立Smart Access Gateway vCPE 執行個體時，本參數僅取值warm_backup。

    no_backup
    ChargeType

    string

    是

    Smart Access Gateway執行個體的計費類型。

    取值： PREPAY，預付費。

    PREPAY
    AlreadyHaveSag

    boolean

    否

    是否已擁有Smart Access Gateway裝置。取值：

    • true：是。

    • false（預設值）：否。

    false
    CPEVersion

    string

    否

    在建立Smart Access Gateway vCPE 執行個體時的版本。

    取值：basic，基礎版。

    basic

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Smart Access Gateway執行個體資訊。

    Description

    string

    Smart Access Gateway執行個體的描述資訊。

    testdesc
    RequestId

    string

    請求 ID。

    A6B9EB0F-57DB-4843-A372-04678ABF490E
    OrderId

    string

    訂單 ID。

    20337777****
    SmartAGId

    string

    Smart Access Gateway執行個體 ID。

    sag-nylv14tghsk26c*****
    Name

    string

    Smart Access Gateway執行個體的名稱。

    testname
    ResourceGroupId

    string

    Smart Access Gateway執行個體所屬的資源群組 ID。

    rg-acfm2iu4fnc****

    樣本

    正常返回樣本

    JSON格式

    {
  "Description": "testdesc",
  "RequestId": "A6B9EB0F-57DB-4843-A372-04678ABF490E",
  "OrderId": "20337777****",
  "SmartAGId": "sag-nylv14tghsk26c*****",
  "Name": "testname",
  "ResourceGroupId": "rg-acfm2iu4fnc****"
}

    錯誤碼

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

    變更歷史

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