All Products
Search

This Product

    :ModifySmartAccessGateway

    Document Center

    :ModifySmartAccessGateway

    Last Updated:May 26, 2026

    Memodifikasi konfigurasi instance Smart Access Gateway (SAG).

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    Parameter Type Required Contoh Deskripsi
    SmartAGId String Yes sag-0ovhf732a9j0******

    ID instans SAG.

    Name String No SAG

    Nama instans SAG.

    Nama harus terdiri dari 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), serta tanda hubung (-). Nama harus dimulai dengan huruf.

    Description String No SAG instance description

    Deskripsi instans SAG.

    Deskripsi harus terdiri dari 2 hingga 256 karakter. Deskripsi harus dimulai dengan huruf, tetapi tidak boleh dimulai dengan http:// atau https://.

    CidrBlock String No 172.16.0.0/24

    Blok CIDR terminal dalam jaringan pribadi. Pastikan blok CIDR tersebut tidak saling tumpang tindih.

    Jika port LAN terminal menggunakan perutean dinamis, alamat IP dalam blok CIDR pribadi pertama dialokasikan ke terminal yang telah mengaktifkan Dynamic Host Configuration Protocol (DHCP).

    RegionId String Yes cn-hangzhou

    ID wilayah tempat instans SAG dideploy.

    Action String Yes ModifySmartAccessGateway

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifySmartAccessGateway.

    SecurityLockThreshold Integer No 3

    Durasi waktu instans SAG yang terputus tetap terkunci. Nilai valid: bilangan bulat yang lebih besar dari atau sama dengan 0.

    Unit: detik.

    RoutingStrategy String No static

    Kebijakan yang digunakan untuk mengiklankan rute ke Alibaba Cloud. Nilai yang valid:

    • static: perutean statis
    • dynamic: perutean dinamis
    Position String No [ { "adcode":"", "label":"No. xx, xx Street, xx District, Hangzhou, Zhejiang", "value":"B0FFGxxxx", "center":"120.190xxxx, 30.182xxxx", "_new":"true" } ]

    Lokasi tempat instans SAG dideploy.

    EnableSoftwareConnectionAudit Boolean No. true

    Menentukan apakah akan diaudit log koneksi jaringan instans aplikasi SAS.

    • true: ya
    • false: tidak

    Parameter respons

    Parameter Type Contoh Deskripsi
    RequestId String CE6642D4-21EB-4168-9BF9-F217953F9892

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://[Endpoint]/?SmartAGId=sag-0ovhf732a9j0******
&Name=SAG
&Description=SAG description
&CidrBlock=172.16.0.0/24
&RegionId=cn-hangzhou
&Action=ModifySmartAccessGateway
&SecurityLockThreshold=3
&RoutingStrategy=static
[     {         "adcode":"",         "label":"No. xx, xx Street, xx District, Hangzhou, Zhejiang",         "value":"B0FFGxxxx",         "center":"120.190xxxx, 30.182xxxx",         "_new":"true"     } ]
&EnableSoftwareConnectionAudit=true
&Common request parameters

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifySmartAccessGatewayResponse>
    <RequestId>CE6642D4-21EB-4168-9BF9-F217953F9892</RequestId>
</ModifySmartAccessGatewayResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CE6642D4-21EB-4168-9BF9-F217953F9892"
}

    Kode kesalahan

    HttpCode Kode kesalahan Pesan kesalahan Deskripsi
    400 SAG.IpCountTooLittle The number of available IP addresses of the CIDR block is fewer than the number of SslConnectionSpec. Pesan kesalahan yang dikembalikan karena jumlah alamat IP yang tersedia dalam blok CIDR yang ditentukan lebih sedikit daripada jumlah koneksi.
    400 SAG.SslConnectionSpecInvalid The number of SslConnectionSpec is invalid. Pesan kesalahan yang dikembalikan karena jumlah koneksi yang ditentukan tidak valid.
    400 SAG.CcnCidrNoConfig You must configure the CIDR block of CCN. Pesan kesalahan yang dikembalikan karena blok CIDR instans Cloud Connect Network (CCN) yang terkait belum ditentukan.
    400 SAG.CidrEmpty You must specify the CIDR blocks of SAG. Pesan kesalahan yang dikembalikan karena blok CIDR instans SAG belum ditentukan.
    400 SAG.ConflictCidr.CcnSnatCidr The SAG CIDR block is in conflict with the CCN CIDR block. Pesan kesalahan yang dikembalikan karena blok CIDR instans SAG tumpang tindih dengan blok CIDR instans CCN.
    400 SAG.ConflictSnatIp The specified SNAT IP address is invalid. Pesan kesalahan yang dikembalikan karena alamat IP yang ditentukan dalam entri source network address translation (SNAT) bertentangan dengan alamat lainnya.
    400 SAG.InstanceIdEmpty You must specify the SAG instance ID. Pesan kesalahan yang dikembalikan karena ID instans aplikasi SAG belum ditentukan.
    400 SAG.InstanceNoFound The specified SAG instance does not exist. Pesan kesalahan yang dikembalikan karena instans SAG yang ditentukan tidak ada.
    400 SAG.InvalidCidr The specified CIDR block is invalid. Pesan kesalahan yang dikembalikan karena blok CIDR instans SAG yang ditentukan tidak valid.
    400 SAG.InvalidCidr.NoBelongCcnCidr The specified SAG CIDR block does not belong to the CCN CIDR block. Pesan kesalahan yang dikembalikan karena blok CIDR instans SAG tidak termasuk dalam blok CIDR instans CCN.
    400 SAG.InvalidSnatCidr The specified SNAT CIDR block is invalid. Pesan kesalahan yang dikembalikan karena blok CIDR yang ditentukan dalam entri SNAT yang terkait dengan instans SAG tidak valid.
    400 SAG.InvalidSnatIp The specified SNAT IP address is invalid. Pesan kesalahan yang dikembalikan karena alamat IP yang ditentukan dalam entri SNAT yang terkait dengan instans SAG tidak valid.
    400 CCN.CidrEmpty You must specify the CCN CIDR block. Pesan kesalahan yang dikembalikan karena blok CIDR instans CCN belum ditentukan.
    400 CCN.SnatCidrConflict The specified SNAT CIDR block is invalid. Pesan kesalahan yang dikembalikan karena blok CIDR SNAT yang ditentukan bertentangan dengan blok lainnya.
    400 ActionNotSupport The specified instance does not support this action. Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak mendukung fitur ini.
    400 CCN.SnatCidrNoConfig You must configure the SNAT CIDR block of the CCN. Pesan kesalahan yang dikembalikan karena blok CIDR entri SNAT yang terkait dengan instans CCN belum ditentukan.
    400 SAG.CidrUsedByRoutableAddress A routable internal IP address belongs to the specified internal CIDR block. You cannot modify this CIDR block. Pesan kesalahan yang dikembalikan karena blok CIDR pribadi yang ingin Anda modifikasi sudah digunakan sebagai alamat IP yang dapat dirutekan dan tidak dapat dimodifikasi.
    400 InvalidName The specified name is invalid. Pesan kesalahan yang dikembalikan karena nama yang ditentukan tidak valid.
    400 SAG.CidrAmountLimit The maximum number of static routes for the SAG instance is exceeded. Pesan kesalahan yang dikembalikan karena jumlah route statis yang ditentukan untuk instans SAG telah mencapai batas maksimum.
    400 SAG.InvalidCidrFormat The specified CIDR format is invalid. Pesan kesalahan yang dikembalikan karena format blok CIDR pribadi tidak valid.
    400 SAG.CidrOverlap The specified CIDR overlaps with an existing CIDR. Pesan kesalahan yang dikembalikan karena blok CIDR pribadi saling tumpang tindih.
    400 SAG.Arrearage The specified SAG instance has overdue payments. Renew the instance first. Pesan kesalahan yang dikembalikan karena instans SAG yang ditentukan memiliki pembayaran tertunda. Lunasi pembayaran tertunda terlebih dahulu.
    400 SAG.NoActive The specified SAG instance has not been activated. Pesan kesalahan yang dikembalikan karena instans SAG yang ditentukan belum diaktifkan. Aktifkan instans SAG terlebih dahulu.
    400 SAG.NotAllowConfigCidr You cannot specify a static CIDR block when the dynamic routing strategy is used. Pesan kesalahan yang dikembalikan karena mode perutean dinamis tidak mendukung blok CIDR statis.
    403 MissingParameter The input parameter is missing, please check your input. Pesan kesalahan yang dikembalikan karena satu atau beberapa parameter yang diperlukan belum ditentukan. Periksa apakah Anda telah menentukan semua parameter yang diperlukan.
    403 InvalidId.SMARTAG The specified smart access gateway instance id is invalid. Pesan kesalahan yang dikembalikan karena ID instans SAG yang ditentukan tidak valid.
    403 InvalidCidr Cidr is illegal, please check your input. Pesan kesalahan yang dikembalikan karena blok CIDR yang ditentukan tidak valid. Periksa blok CIDR yang ditentukan.
    403 Forbidden User not authorized to operate on the specified resource. Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk mengelola resource yang ditentukan.
    403 VbrConflict.ChangeSubnet The subnet of the gateway conflicts with the VBR. Modify the subnet first. Pesan kesalahan yang dikembalikan karena blok CIDR subnet instans SAG yang ditentukan tumpang tindih dengan blok CIDR Virtual Border Router (VBR) yang ditentukan. Modifikasi blok CIDR subnet tersebut.
    403 VbrConflict.CreateBackup The subnet of the gateway conflicts with the VBR. Create a backup relationship first. Pesan kesalahan yang dikembalikan karena blok CIDR subnet instans SAG yang ditentukan tumpang tindih dengan blok CIDR VBR yang ditentukan. Deploy instans SAG sebagai cadangan dari sirkuit Express Connect.
    403 SmartAccessGatewayNotBind The instance has not yet been bound. Pesan kesalahan yang dikembalikan karena instans SAG yang ditentukan belum memiliki asosiasi.
    403 FeatureNotSupport The current edition of the smart access gateway does not support this feature. Pesan kesalahan yang dikembalikan karena versi perangkat SAG yang ditentukan saat ini tidak mendukung fitur ini.
    500 SmartAccessGatewayInArrears The specified Smart Access Gateway has expired. Pesan kesalahan yang dikembalikan karena instans SAG yang ditentukan telah kedaluwarsa dan ditangguhkan. Perpanjang instans SAG tersebut.
    500 SmartAccessGatewayNotActivated The specified Smart Access Gateway has not been activated. Pesan kesalahan yang dikembalikan karena instans SAG yang ditentukan belum diaktifkan. Aktifkan instans SAG terlebih dahulu.
    500 InternalError An error occurred while processing your request. Pesan kesalahan yang dikembalikan karena terjadi kesalahan yang tidak diketahui.

    Untuk daftar kode kesalahan lengkap, lihat Kode kesalahan layanan.