すべてのプロダクト
Search

このプロダクト

    Smart Access Gateway:CreateSmartAccessGateway

    ドキュメントセンター

    Smart Access Gateway:CreateSmartAccessGateway

    最終更新日:Dec 21, 2025

    Smart Access Gateway (SAG) CPE または vCPE インスタンスを作成します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    smartag:CreateSmartAccessGateway

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    SAG インスタンスをデプロイするリージョンの ID。

    最新のリージョンリストを照会するには、DescribeRegions 操作を呼び出します。

    cn-shanghai
    MaxBandWidth

    integer

    任意

    SAG インスタンスの帯域幅。

    • SAG CPE インスタンスを作成し、モデルが sag-100wm の場合、このパラメーターの有効値は 2～50 です。単位：Mbit/s。

    • SAG CPE インスタンスを作成し、モデルが sag-1000 の場合、このパラメーターの有効値は 10～500 です。単位：Mbit/s。

    • SAG vCPE インスタンスを作成する場合、このパラメーターの有効値は 10～1000 です。単位：Mbit/s。

    12
    Name

    string

    任意

    SAG インスタンスの名前。

    名前に使用できる文字数は 2～128 文字です。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字である必要があります。

    testname
    Description

    string

    任意

    SAG インスタンスの説明。

    説明に使用できる文字数は 2～256 文字です。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字である必要があります。

    testdesc
    Period

    integer

    必須

    SAG インスタンスのサブスクリプション期間。単位：月。

    有効値：1～9、12、24、36。

    12
    AutoPay

    boolean

    必須

    インスタンスの自動支払いを有効にするかどうかを指定します。有効値：

    • true：はい

    • false：いいえ

    パラメーターを false に設定した場合、この操作を呼び出した後、料金管理に移動して支払いを完了する必要があります。支払いが完了すると、インスタンスが作成されます。

    false
    HardWareSpec

    string

    必須

    SAG インスタンスのタイプ。有効値：

    • sag-100wm

    • sag-1000

    • sag-vcpe

    sag-100wm
    ReceiverCountry

    string

    必須

    受信者アドレスの国。

    China
    ReceiverState

    string

    必須

    受信者アドレスの都道府県。

    Zhejiang
    ReceiverCity

    string

    必須

    受信者アドレスの市区町村。

    Hangzhou
    ReceiverDistrict

    string

    必須

    受信者アドレスの区。

    West Lake
    ReceiverTown

    string

    必須

    受信者アドレスの町名・番地。

    Zhuan Tang
    ReceiverZip

    string

    必須

    受信者アドレスの郵便番号。

    310000
    ReceiverPhone

    string

    任意

    受信者の固定電話番号。

    8585****
    ReceiverMobile

    string

    必須

    受信者の携帯電話番号。

    1884085****
    ReceiverName

    string

    必須

    受信者の名前。

    Alice
    ReceiverEmail

    string

    必須

    受信者のメールアドレス。

    xx@example.com
    BuyerMessage

    string

    必須

    購入者が残した備考。

    Remarks
    ReceiverAddress

    string

    必須

    受信者の詳細な住所。

    No.XX
    HaType

    string

    必須

    デプロイモード。有効値：

    • no_backup：SAG デバイスを 1 台のみ購入して、プライベートネットワークを Alibaba Cloud に接続します。

    • cold_backup：アクティブ/スタンバイモードで 2 台の SAG デバイスを購入します。1 台の SAG デバイスがアクティブデバイスとして機能し、もう 1 台がスタンバイデバイスとして機能します。アクティブデバイスのみが Alibaba Cloud に接続されます。アクティブデバイスが正常に動作しない場合は、手動でスイッチオーバーを実行する必要があります。

    • warm_backup：アクティブ/アクティブモードで 2 台の SAG デバイスを購入します。両方の SAG デバイスが Alibaba Cloud に接続されます。アクティブデバイスが正常に動作しない場合、フェイルオーバーが自動的に実行されます。

    説明

    SAG vCPE インスタンスを作成する場合は、値を warm_backup に設定します。

    no_backup
    ChargeType

    string

    必須

    SAG インスタンスの課金方法。

    値を PREPAY に設定します。これはサブスクリプション課金方法を指定します。

    PREPAY
    AlreadyHaveSag

    boolean

    任意

    すでに SAG デバイスを所有しているかどうかを指定します。有効値：

    • true：はい

    • false (デフォルト)：いいえ

    false
    CPEVersion

    string

    任意

    SAG vCPE インスタンスを作成するときの SAG のエディション。

    値を basic に設定します。これは Basic Edition を指定します。

    basic

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Description

    string

    SAG インスタンスの説明。

    testdesc
    RequestId

    string

    リクエスト ID。

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

    string

    注文 ID。

    20337777****
    SmartAGId

    string

    SAG インスタンスの ID。

    sag-nylv14tghsk26c*****
    Name

    string

    SAG インスタンスの名前。

    testname
    ResourceGroupId

    string

    SAG インスタンスが属するリソースグループの ID。

    rg-acfm2iu4fnc****

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。