Tüm Ürünler
Search

Bu Ürün

    :Bir örneğin teknik özelliklerini değiştirin

    Belge Merkezi

    :Bir örneğin teknik özelliklerini değiştirin

    Son Güncelleme:Oct 02, 2026

    Bir örneğin örnek türünü veya depolama kapasitesini değiştirmek için ModifyDBInstanceSpec işlemini çağırabilirsiniz. Bu işlem, birincil örnekler ve salt okunur örnekler için desteklenir. Olağanüstü durum kurtarma örnekleri veya geçici örnekler için bu işlem desteklenmez.

    Bu işlemi çağırmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

    • Örnek Çalışıyor durumundadır.

    • Örnek üzerinde devam eden yedekleme görevi yoktur.

    • İstek içinde DBInstanceClass ve DBInstanceStorage parametrelerinden en az biri belirtilmiştir.

    • Depolama kapasitesini azaltmak istiyorsanız belirttiğiniz yeni depolama kapasitesi, kullanılan depolama kapasitesinin 1,1 katına eşit veya bu değerden büyük olmalıdır.

    • Örnek bir birincil veya salt okunur örnektir.

    Not

    Örneğin RDS sürümünü yükseltmek istiyorsanız yalnızca yeni RDS sürümünü destekleyen bir örnek türü seçmeniz gerekir. Örneğin, örneğin RDS sürümünü RDS Basic Edition'dan RDS High-availability Edition'a yükseltmek istiyorsanız yalnızca RDS High-availability Edition'ı destekleyen bir örnek türü seçmeniz yeterlidir.

    Hata ayıklama

    OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodunu dinamik olarak oluşturur.

    İstek parametreleri

    Parametre Tür Gerekli Örnek Açıklama
    Action String Evet ModifyDBInstanceSpec

    Gerçekleştirmek istediğiniz işlem. Değeri ModifyDBInstanceSpec olarak ayarlayın.

    DBInstanceId String Evet rm-uf6wjk5*******

    Örneğin kimliği.

    DBInstanceClass String Hayır rds.mys2.small

    Örneğin yeni örnek türü. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri. Bir bölgede kullanılabilen örnek türlerini sorgulamak için DescribeAvailableClasses işlemini çağırabilirsiniz.

    Not
    • DBInstanceClass ve DBInstanceStorage parametrelerinden en az birini belirtmelisiniz.
    • Örneğin kullanımdaki örnek türünü sorgulamak için DescribeDBInstanceAttribute işlemini çağırabilirsiniz.
    DBInstanceStorage Integer Hayır 20

    Örneğin yeni depolama kapasitesi. Birim: GB. Depolama kapasitesini 5 GB'lık adımlarla artırabilirsiniz. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri. Bir örnek türünün desteklediği depolama kapasitesi aralığını sorgulamak için DescribeAvailableClasses işlemini çağırabilirsiniz.

    Not
    • DBInstanceStorage ve DBInstanceClass parametrelerinden en az birini belirtmelisiniz.
    • Örnek RDS High-availability Edition üzerinde MySQL çalıştırıyor ve yerel SSD'ler kullanıyorsa depolama kapasitesini 5 GB'lık adımlarla azaltabilirsiniz.
    • Örneğin mevcut depolama kapasitesini sorgulamak için DescribeDBInstanceAttribute işlemini çağırabilirsiniz.
    PayType String Evet Postpaid

    Örneğin faturalama yöntemi. Geçerli değerler:

    • Postpaid: kullandıkça öde
    • Prepaid: abonelik
    EffectiveTime String Hayır MaintainTime

    Değişikliğin yürürlüğe girmesini istediğiniz zaman. Geçerli değerler:

    • Immediate: Değişiklik hemen yürürlüğe girer.
    • MaintainTime: Değişiklik belirtilen bakım penceresi sırasında yürürlüğe girer. Daha fazla bilgi için bkz. ModifyDBInstanceMaintainTime.
    Not Varsayılan değer: Immediate.
    EngineVersion String Hayır 5,6

    Örneğin veritabanı altyapısı sürümü.

    • Engine parametresini MySQL olarak ayarladığınızda geçerli değerler: 5,5, 5,6, 5,7 ve 8,0
    • Engine parametresini SQLServer olarak ayarladığınızda geçerli değerler: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha ve 2019_ent
    • Engine parametresini PostgreSQL olarak ayarladığınızda geçerli değerler: 10,0, 11,0, 12,0, 13,0, 14,0 ve 15,0
    • Engine parametresini MariaDB olarak ayarladığınızda geçerli değerler: 10,3
    DBInstanceStorageType String Hayır local_ssd

    Örneğin depolama türü. Geçerli değerler:

    • local_ssd: yerel SSD.
    • cloud_ssd: standart SSD. Bu depolama türü önerilmez ve bazı Alibaba Cloud bölgelerinde kullanılamaz.
    • cloud_essd: performans düzeyi 1 (PL1) olan gelişmiş SSD (ESSD).
    • cloud_essd2: PL2 ESSD.
    • cloud_essd3: PL3 ESSD.

    Depolama türünü değiştirmek için aşağıdaki öğelere dikkat edin:

    • Örnek PostgreSQL çalıştırıyorsa örneğin depolama türünü standart SSD'den ESSD'ye yükseltebilirsiniz. Ancak örneğin depolama türünü ESSD'den standart SSD'ye düşüremezsiniz. ESSD'ler aşağıdaki performans düzeylerini (PL) sunar: PL1 ESSD'ler, PL2 ESSD'ler ve PL3 ESSD'ler. PL1 ESSD, PL2 ESSD ve PL3 ESSD arasında depolama türünü yükseltebilir veya düşürebilirsiniz. Daha fazla bilgi için bkz. Yapılandırma öğeleri.
    Direction String Hayır Up

    Örnek üzerinde gerçekleştirmek istediğiniz değişikliğin türü. Geçerli değerler:

    • Up: Abonelik örneğini yükseltir veya kullandıkça öde örneğini yükseltir ya da düşürür.
    • Down: Abonelik örneğini düşürür.
    • TempUpgrade: Abonelik örneğinde esnek teknik özellik değişiklikleri gerçekleştirir. Esnek teknik özellik değişiklikleri için bu değer gereklidir.
    Not
    • Varsayılan değer: Up.
    • Yalnızca DBInstanceStorageType parametresini belirtiyorsanız Direction parametresini boş bırakabilirsiniz. Örneğin, örneğin depolama türünü yalnızca standart SSD'den ESSD'ye değiştirmek istiyorsanız Direction parametresini belirtmeniz gerekmez.
    SourceBiz String Hayır N/A

    Kullanımdan kaldırılmış bir parametre.

    DedicatedHostGroupId String Hayır dhg-7a9********

    Örneğin ait olduğu özel kümenin kimliği.

    ZoneId String Hayır cn-hangzhou-b

    Örneğin alan kimliği.

    SwitchTime String Hayır 2019-07-10T13:15:12Z

    Teknik özellikleri değiştirmek istediğiniz zaman. Teknik özellikleri yoğun olmayan saatlerde değiştirmenizi öneririz. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardına göre belirtin. Saat UTC cinsinden olmalıdır.

    Not
    • Mevcut zamandan daha ileri bir zaman noktası belirtmelisiniz. Aksi takdirde teknik özellik değiştirme görevi başarısız olur. Mevcut zaman, bu işlemi çağırma zamanını ifade eder. Teknik özellik değiştirme görevi başarısız olursa siparişin otomatik olarak iptal edilmesini beklemeniz ve ardından bu işlemi yeniden çağırmanız gerekir.
    • Depolama kapasitesini artırmak veya ESSD depolama türünü farklı PL'ler arasında değiştirmek istiyorsanız teknik özellik değişikliği hemen yürürlüğe girer ve iş yüklerinizi etkilemez. Bu parametreyi yapılandırmanız gerekmez.
    ResourceGroupId String Hayır rg-acfmy**********

    Örneğin ait olduğu kaynak grubunun kimliği.

    UsedTime Long Hayır 3

    ApsaraDB RDS for SQL Server örneğindeki teknik özellik değişikliklerinin geçerlilik süresi. Birim: gün.

    MaxCapacity double Hayır 8

    Maksimum RDS Kapasite Birimi (RCU) sayısı.

    MinCapacity double Hayır 0,5

    Minimum RCU sayısı.

    AutoPause Boolean Hayır true

    Otomatik askıya almayı destekleyip desteklemediğini belirtir.

    SwitchForce Boolean Hayır false

    Sunucusuz örnek için zorunlu ölçeklendirme özelliğini etkinleştirip etkinleştirmediğinizi belirtir. Geçerli değerler:

    • true: özelliği etkinleştirir.
    • false: özelliği devre dışı bırakır. Bu, varsayılan değerdir.
    Category String Hayır HighAvailability

    Örneğin RDS sürümü. Geçerli değerler:

    • Basic: RDS Basic Edition.
    • HighAvailability: RDS High-availability Edition.

    • AlwaysOn: SQL Server için RDS Cluster Edition

    • Finance: RDS Enterprise Edition. Bu sürüm yalnızca China site (aliyun.com) üzerinde kullanılabilir.
    Not EngineVersion parametresini bir SQL Server sürümüne ayarlarsanız bu parametreyi de belirtmeniz gerekir.

    Yanıt parametreleri

    Parametre

    Tür

    Örnek

    Açıklama

    DBInstanceId

    String

    rm-uf6wjk5***

    Örneğin kimliği.

    RequestId

    String

    3C5CFDEE-F774-4DED-89A2-1D76EC63C575

    İsteğin kimliği.

    OrderId

    Long

    20793850608****

    Siparişin kimliği.

    Örnekler

    Örnek istekler

    http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=rm-uf6wjk5*******
&PayType=Postpaid
&DBInstanceClass=rds.mys2.small
&<Common request parameters>

    Başarılı yanıt örnekleri

    XML biçimi

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

<ModifyDBInstanceSpecResponse>
    <RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <OrderId>20793850608****</OrderId>
</ModifyDBInstanceSpecResponse>

    JSON biçimi

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

{
  "RequestId" : "3C5CFDEE-F774-4DED-89A2-1D76EC63C575",
  "DBInstanceId" : "rm-uf6wjk5*******",
  "OrderId" : "20793850608****"
}

    Hata kodları

    Http durum kodu

    Hata kodu

    Hata mesajı

    Açıklama

    400

    CannotDecreaseEssdPerfLevel

    cannot decrease cloud essd performance level.

    Depolama türü değişikliğine izin verilmediği için döndürülen hata mesajı. Standart SSD'lerle SQL Server çalıştıran bir örneğin depolama türü yalnızca ESSD'lere değiştirilebilir. Yerel SSD'lerle SQL Server çalıştıran bir örneğin depolama türü standart SSD'lere veya ESSD'lere değiştirilebilir.

    400

    InvalidEssdStorageSize

    invalid cloud essd storage size.

    Belirtilen örnek türü geçersiz olduğu için döndürülen hata mesajı. Geçerli bir örnek türü seçip tekrar deneyin.

    400

    NotSupportReduceDiskSize

    Not support reduce disk size.

    Örneğin depolama kapasitesi azaltılamadığı için döndürülen hata mesajı.

    400

    InvalidDBInstanceClass.NotFound

    Specified DB instance class is not found.

    Yeni örnek türü bulunamadığı veya artık satın alınamadığı için döndürülen hata mesajı. Kullanılabilir bir örnek türü seçmeniz gerekir.

    400

    InvalidAvZone.Format

    Specified AvZone is not valid.

    ZoneID parametresinin değeri geçersiz olduğu için döndürülen hata mesajı.

    400

    OperationDenied.OrderUnPaid

    The operation is not permitted due to the wrong Order status (Unpaid).

    Ödenmemiş siparişleriniz olduğu için döndürülen hata mesajı. Bu işlemi çağırmadan önce siparişler için ödeme yapmanız gerekir.

    400

    OperationDenied.InvalidStorageSize

    The storage size limit is exceeded.

    Depolama kullanımı üst sınırı aştığı için döndürülen hata mesajı. Depolama kapasitesini temizlemeniz veya genişletmeniz gerekir.

    400

    InsufficientResourceCapacity

    The instance cluster does not support this operation.

    İşlem örneğin ait olduğu özel kümede desteklenmediği için döndürülen hata mesajı.

    400

    InvalidUsedTime

    The parameter usedTime is invalid.

    UsedTime parametresinin değeri geçersiz olduğu için döndürülen hata mesajı.

    400

    CannotChangeStorageType

    Temp upgrade does not support changing storage type.

    Esnek yükseltmeler depolama türü değişikliklerini desteklemediği için döndürülen hata mesajı.

    400

    TempUpgrade.NotSupport

    The instance does not support temp upgrade.

    Örnek esnek yükseltmeleri desteklemediği için döndürülen hata mesajı.

    400

    EngineNotSupported

    Engine specified cannot be supported the operation.

    Bu işlem örnekte çalışan veritabanı altyapısı için desteklenmediği için döndürülen hata mesajı. Küçük altyapı sürümünü güncellemeniz gerekir.

    400

    MaxscaleNotSupport

    Maxscale not supported

    Örnek veritabanı proxy özelliğini desteklemediği için döndürülen hata mesajı. Belirttiğiniz veritabanı proxy yapılandırmasını kontrol edin.

    400

    ADInstanceNotSupportThisOperation

    The AD instance is not supported this operation

    İşlem Active Directory (AD) etki alanına eklenen bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    BYOKInstanceNotSupportThisOperation

    The BYOK instance is not supported this operation

    İşlem disk şifrelemenin etkinleştirildiği bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    BYOLInstanceNotSupportThisOperation

    The BYOL instance is not supported this operation

    İşlem Bring Your Own License (BYOL) kullanan bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    SSLInstanceNotSupportThisOperation

    The instance opened SSL, upgrade is not this operation

    İşlem SSL şifreleme özelliğinin etkinleştirildiği bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    TDEInstanceNotSupportThisOperation

    The instance opened TDE, this operation is not supported

    İşlem Şeffaf Veri Şifreleme (TDE) özelliğinin etkinleştirildiği bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    InstanceIsSnapshotBackupNotSupportThisOperation

    The instance backup method is snapshot backup, this operation is not supported

    İşlem anlık görüntü yedekleme özelliğinin etkinleştirildiği bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    InstanceHasReadOnlyInstanceNotSupportThisOperation

    The instance has read-only instance or is read-only instance, this operation is not supported

    İşlem salt okunur bir örnek veya salt okunur örneklerin bağlı olduğu bir örnek için desteklenmediği için döndürülen hata mesajı.

    400

    BackupReadInstanceModifyNotAllowed

    Modify Backup Read Instance Is Not Allowed.

    Yedeğin alındığı örneği değiştirmenize izin verilmediği için döndürülen hata mesajı.

    400

    MinorVersionNotSupport

    The current database minor version does not support the operation.

    İşlem örneğin mevcut küçük altyapı sürümü tarafından desteklenmediği için döndürülen hata mesajı.

    400

    LX.ARGUMENT.ILLEGAL

    The parameters that you specified for the specification change are invalid.

    Teknik özellik değişikliği için belirttiğiniz parametreler geçersiz olduğu için döndürülen hata mesajı.

    400

    ORD.S.QUERY.PROD.ERROR

    An error occurred while querying the ordering information

    Sipariş bulunamadığı için döndürülen hata mesajı.

    403

    IncorrectDBInstanceType

    The database instance type does not support the operation.

    İşlem örnekte çalışan veritabanı altyapısı tarafından desteklenmediği için döndürülen hata mesajı.

    403

    OperationDenied.NotSupportedBackupMethod

    When the storage is larger than 4000 GB, only snapshot backup is supported.

    Depolama kapasitesi 4.000 GB'tan büyük olduğu ve yalnızca anlık görüntü yedeklemelerin desteklendiği için döndürülen hata mesajı.

    403

    IncorrectReadDBInstanceDisksize

    Read instance disk size must be equal or higher than primary instance.

    Salt okunur örneğin depolama kapasitesi birincil örneğin depolama kapasitesinden düşük olduğu için döndürülen hata mesajı. Salt okunur örneğin depolama kapasitesinin birincil örneğin depolama kapasitesine eşit veya ondan büyük olduğundan emin olun.

    403

    GroupReplicationNotSupport.InvalidEngineVersion

    Group Replication requires the instance engine version to be 8.0.

    Örneğin ana altyapı sürümü MySQL 8.0 olmadığı ve MySQL grup çoğaltmasının (MGR) desteklenmediği için döndürülen hata mesajı.

    403

    GroupReplicationNotSupport.InvalidNodeClassCode

    Group Replication requires the ClassCode of each node to be consistent.

    Örnekteki düğümlerin teknik özellikleri farklı olduğu ve MGR'nin desteklenmediği için döndürülen hata mesajı.

    403

    GroupReplicationNotSupport.InvalidNodeNum

    Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.

    Örnekteki düğüm sayısı 3'e eşit veya 3'ten büyük tek sayı olmadığı ve MGR'nin desteklenmediği için döndürülen hata mesajı.

    403

    GroupReplicationNotSupport.InvalidXengine

    Group Replication is not supported because the instance has xengine tables.

    Örnekte X-Engine tabloları bulunduğu ve MGR'nin desteklenmediği için döndürülen hata mesajı.

    403

    GroupReplicationNotSupport.MemoryTooSmall

    Group Replication is not supported because the memory is too small.

    Örneğin bellek kapasitesi küçük olduğu ve MGR'nin desteklenmediği için döndürülen hata mesajı.

    403

    ARMNotSupport

    ARM arch does not support this operation.

    Bu işlem ARM mimarisi tarafından desteklenmediği için döndürülen hata mesajı.

    403

    HostTypeNotSupport

    Host type is inconsistent, please check that the original host type is the same as the target host type.

    Teknik özellik değişikliğinden önceki ve sonraki ana bilgisayar türleri farklı olduğu için döndürülen hata mesajı.

    403

    CloudSSDNotSupport

    Cloud ssd does not support this operation, please upgrade to essd.

    İşlem standart SSD depolama türü tarafından desteklenmediği için döndürülen hata mesajı. Örneğin depolama türünü ESSD'ye yükseltmeniz gerekir.

    403

    MaxscaleInstanceNotSupport

    Instances with maxscale instance do not support this operation.

    İşlem MaxScale'in etkinleştirildiği örnek tarafından desteklenmediği için döndürülen hata mesajı.

    403

    ReadInstanceNotSupport

    Instances with read-only do not support this operation.

    İşlem salt okunur örneklerin bağlı olduğu örnek tarafından desteklenmediği için döndürülen hata mesajı.

    404

    InvalidClusterKms

    The current instance does not authorized to access the Key Management Service.

    Örnek Key Management Service (KMS) erişim iznine sahip olmadığı için döndürülen hata mesajı.

    Hata kodlarının listesi için bkz. Hizmet hata kodları.