ApsaraDB RDS for PostgreSQL örneğinin ana motor sürümünü yükseltin -

Hata Ayıklama

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

Yükseltme sırasında ApsaraDB RDS özgün örneği korur ve yeni ana motor sürümünü çalıştıran bir örnek oluşturur. Yeni örnek oluşturulduktan sonra bu örnek için kullandıkça öde faturalama yöntemine göre ücretlendirilmeye başlarsınız. Yeni örnek özgün örnek için sunulan indirimli fiyattan yararlanmaz. Bu işlemi çağırmadan önce ApsaraDB RDS'nin faturalama yöntemlerini ve fiyatlandırmasını tam olarak anladığınızdan emin olun. İş gereksinimlerinize göre ana motor sürümünü yükseltip yükseltmemeye karar verebilirsiniz. Daha fazla bilgi için bkz. Faturalandırılan öğeler, faturalama yöntemleri ve fiyatlandırma.

Ana motor sürümünü yükseltmeden önce yükseltme kontrolü yapmak için UpgradeDBInstanceMajorVersionPrecheck işlemini, ardından yükseltme kontrol raporunu sorgulamak için DescribeUpgradeMajorVersionPrecheckTask işlemini çağırmanız gerekir. UpgradeDBInstanceMajorVersion işlemini yalnızca kontrol sonucu Success olduğunda çağırabilirsiniz.

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

Özgün örnek PostgreSQL 14, PostgreSQL 13, PostgreSQL 12, PostgreSQL 11, PostgreSQL 10 veya PostgreSQL 9.4 çalıştırıyor olmalıdır.
Özgün örnek RDS High-availability Edition veya RDS Basic Edition çalıştırıyor olmalıdır.
Özgün örnek bir sanal özel cloud (VPC) içinde bulunmalıdır. Özgün örnek klasik ağda bulunuyorsa bu işlemi çağırmadan önce örneği bir VPC'ye geçirmeniz gerekir. Bir örneğin ağ türünü görüntüleme veya değiştirme hakkında daha fazla bilgi için bkz. ApsaraDB RDS for PostgreSQL örneğinin ağ türünü değiştirin.
Özgün örnek salt okunur bir örnek olmamalı ve özel bir kümede oluşturulmamış olmalıdır.

Yükseltme birkaç dakika süren geçici bir bağlantı kesintisi gibi etkilere neden olur. Yükseltmeyi yoğun olmayan saatlerde yapmanızı öneririz. Yükseltme yapmadan önce ApsaraDB RDS for PostgreSQL örneğinin ana motor sürümünü yükseltin bölümündeki açıklamayı okumanızı öneririz.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	UpgradeDBInstanceMajorVersion	Gerçekleştirmek istediğiniz işlem. Değeri UpgradeDBInstanceMajorVersion olarak ayarlayın.
DBInstanceClass	String	Hayır	pg.n2.medium.2c	Yeni örneğin örnek türü. Yeni örneğin vCPU ve bellek teknik özellikleri, özgün örneğin vCPU ve bellek teknik özelliklerine eşit veya onlardan yüksek olmalıdır. Örneğin, özgün örneğin örnek türü 1 çekirdek ve 2 GB bellek sağlayan `pg.n2.small.2c` ise yeni örneğin örnek türü 2 çekirdek ve 4 GB bellek sağlayan `pg.n2.medium.2c` olabilir. Not Desteklenen örnek türleri hakkında daha fazla bilgi için bkz. Birincil ApsaraDB RDS for PostgreSQL örnek türleri.
DBInstanceStorage	Integer	Hayır	20	Yeni örneğin depolama kapasitesi. Birim: GB. Performans düzeyi 1 (PL1) geliştirilmiş SSD'ler (ESSD) kullanıyorsanız geçerli değerler: 20 ila 3.200 PL2 ESSD kullanıyorsanız geçerli değerler: 500 ila 3.200 PL3 ESSD kullanıyorsanız geçerli değerler: 1.500 ila 3.200 Not Özgün örnek yerel SSD'ler kullanıyorsa örneğin ana motor sürümünü yükseltirken örneğin depolama kapasitesini azaltabilirsiniz. Minimum depolama kapasitesi hakkında daha fazla bilgi için bkz. ApsaraDB RDS for PostgreSQL örneğinin ana motor sürümünü yükseltin.
PayType	String	Evet	Postpaid	Yeni örneğin faturalama yöntemi. Değer Postpaid olarak sabittir. Not Yükseltmeden sonra yeni örneğin faturalama yöntemini değiştirmek hakkında daha fazla bilgi için bkz. ApsaraDB RDS for PostgreSQL örneğinin faturalama yöntemini kullandıkça ödeden aboneliğe değiştirin.
InstanceNetworkType	String	Hayır	VPC	Yeni örneğin ağ türü. Değer VPC olarak sabittir. Ana motor sürümü yükseltme özelliği yalnızca VPC'lerde bulunan örnekler için desteklenir. Özgün örnek klasik ağda bulunuyorsa bu işlemi çağırmadan önce örneği bir VPC'ye geçirmeniz gerekir. Bir örneğin ağ türünü görüntüleme veya değiştirme hakkında daha fazla bilgi için bkz. ApsaraDB RDS for PostgreSQL örneğinin ağ türünü değiştirin.
SwitchTimeMode	String	Hayır	Immediate	ApsaraDB RDS'nin iş yüklerinizi yeni örneğe ne zaman geçireceğini belirtir. Bu parametre SwitchOver parametresi ile birlikte kullanılır ve yalnızca SwitchOver parametresini true olarak ayarladığınızda etkili olur. Geçerli değerler: Immediate: Veriler yeni örneğe aktarıldıktan sonra ApsaraDB RDS iş yüklerinizi hemen yeni örneğe geçirir. MaintainTime: Veriler yeni örneğe aktarıldıktan sonra ApsaraDB RDS iş yüklerinizi belirttiğiniz bakım penceresi sırasında yeni örneğe geçirir. Bir örneğin bakım penceresini değiştirmek için ModifyDBInstanceMaintainTime işlemini çağırabilirsiniz.
SwitchTime	String	Hayır	2021-07-10T13:15:12Z	Ayrılmış bir parametredir. Bu parametreyi belirtmeniz gerekmez.
SwitchOver	String	Hayır	false	ApsaraDB RDS'nin veriler yeni örneğe aktarıldıktan sonra iş yüklerinizi otomatik olarak yeni örneğe geçirip geçirmeyeceğini belirtir. Geçerli değerler: true: ApsaraDB RDS iş yüklerini otomatik olarak yeni örneğe geçirir. false: ApsaraDB RDS iş yüklerinizi otomatik olarak yeni örneğe geçirmez. Yükseltme yapmadan önce yeni ana motor sürümünün iş yüklerinizle uyumlu olup olmadığını test etmek için bu parametreyi false olarak ayarlamanızı öneririz. Not Bu parametreyi true olarak ayarlarsanız aşağıdaki bilgilere dikkat etmelisiniz: Geçiş tamamlandıktan sonra iş yüklerinizi özgün RDS örneğine geri döndüremezsiniz. Dikkatli ilerleyin. Geçiş sırasında özgün örnek yalnızca okuma isteklerini işler. Geçişi yoğun olmayan saatlerde yapmanızı öneririz. Özgün örneğe bağlı salt okunur örnekler varsa bu parametreyi yalnızca false olarak ayarlayabilirsiniz. Bu durumda özgün örneğe bağlı salt okunur örnekler klonlanamaz. Yükseltme tamamlandıktan sonra yeni örnek için salt okunur örnekler oluşturmanız gerekir. Bu parametreyi false olarak ayarlarsanız aşağıdaki bilgilere dikkat etmelisiniz: Veri aktarımı özgün örnekteki iş yüklerinizi kesintiye uğratmaz. Veriler yeni örneğe aktarıldıktan sonra uygulamanızdaki uç nokta yapılandırmasını güncellemelisiniz. Bu güncelleme özgün örneğin uç noktasını yeni örneğin uç noktasıyla değiştirmenizi gerektirir. Bir örneğin uç noktasını görüntüleme hakkında daha fazla bilgi için bkz. ApsaraDB RDS for PostgreSQL örneğinin dahili ve genel uç noktalarını ve bağlantı noktası numaralarını görüntüleyin ve değiştirin.
CollectStatMode	String	Hayır	After	ApsaraDB RDS'nin yeni örneğin istatistiklerini topladığı zaman. Geçerli değerler: Before: ApsaraDB RDS hizmet kararlılığını sağlamak için geçişten önce yeni örneğin istatistiklerini toplar. Özgün örnek büyük miktarda veri içeriyorsa yükseltme uzun sürebilir. After: ApsaraDB RDS yükseltmeyi hızlandırmak için geçişten sonra yeni örneğin istatistiklerini toplar. İstatistik oluşturulmamış tablolara erişirseniz belirttiğiniz yürütme planları yanlış olabilir. Ayrıca veritabanı hizmetiniz yoğun saatlerde kullanılamayabilir. Not SwitchOver parametresini false olarak ayarlarsanız Before değeri ApsaraDB RDS'nin yeni örnek okuma ve yazma isteklerini işlemeye başlamadan önce yeni örneğin istatistiklerini topladığını; After değeri ise ApsaraDB RDS'nin yeni örnek okuma ve yazma isteklerini işlemeye başladıktan sonra yeni örneğin istatistiklerini topladığını belirtir.
TargetMajorVersion	String	Hayır	13,0	Yeni örneğin ana motor sürümü. Bu parametrenin değeri yükseltme kontrolünün yapıldığı ana motor sürümü olmalıdır. Not Bir ana motor sürümü üzerinde yükseltme kontrolü yapmak için UpgradeDBInstanceMajorVersionPrecheck işlemini çağırabilirsiniz.
DBInstanceId	String	Hayır	pgm-bp1gm3yh0ht1****	Özgün örneğin kimliği.
VPCId	String	Hayır	vpc-bp1opxu1zkhn00gzv****	Özgün örneğin bulunduğu VPC'nin kimliği. Örneğin VPC kimliğini sorgulamak için DescribeDBInstanceAttribute işlemini çağırabilirsiniz.
VSwitchId	String	Hayır	vsw-bp10aqj6o4lclxdrm**,vsw-bp10aqj6o4lclxdrm**	Özgün örnek RDS Basic Edition çalıştırıyorsa yeni örneğin vSwitch kimliğini girmeniz gerekir. Özgün örnek RDS High-availability Edition çalıştırıyorsa yeni örneğin vSwitch kimliğini ve yeni örneğin ikincil örneğinin vSwitch kimliğini girmeniz gerekir. vSwitch kimliklerini virgülle (,) ayırdığınızdan emin olun. Not Belirttiğiniz vSwitch'ler özgün örnekle aynı alanda bulunmalıdır. vSwitch kimliklerini sorgulamak için DescribeVSwitches işlemini çağırabilirsiniz.
PrivateIpAddress	String	Hayır	172,16.XX.XX	Yeni örneğin dahili IP adresi. Bu parametreyi belirtmeniz gerekmez. ApsaraDB RDS VPCId ve VSwitchId parametrelerinin değerlerine göre otomatik olarak bir dahili IP adresi atar.
UsedTime	String	Hayır	1	Ayrılmış bir parametredir. Bu parametreyi belirtmeniz gerekmez.
Period	String	Hayır	Month	Ayrılmış bir parametredir. Bu parametreyi belirtmeniz gerekmez.
DBInstanceStorageType	String	Hayır	cloud_essd	Yeni örneğin depolama türü. Geçerli değerler: cloud_ssd: standart SSD cloud_essd: PL1 ESSD cloud_essd2: PL2 ESSD cloud_essd3: PL3 ESSD Ana motor sürümü yükseltme özelliği SSD anlık görüntülerine dayanır. Depolama türünü aşağıdaki koşullara göre seçebilirsiniz: Özgün örnek standart SSD'ler kullanıyorsa bu parametreyi cloud_ssd olarak ayarlayabilirsiniz. Özgün örnek ESSD'ler kullanıyorsa bu parametreyi cloud_essd, cloud_essd2 veya cloud_essd3 olarak ayarlayabilirsiniz. Özgün örnek yerel SSD'ler kullanıyorsa bu parametreyi cloud_essd, cloud_essd2 veya cloud_essd3 olarak ayarlayabilirsiniz.
ZoneId	String	Hayır	cn-hangzhou-h	Yeni örneğin alan kimliği. Alan kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. Özgün örneğin bulunduğu bölgeye ait bir alan seçebilirsiniz. Seçilen alan özgün örneğin alanından farklı olabilir.
ZoneIdSlave1	String	Hayır	cn-hangzhou-h	Yeni örnek için ikincil örneğin alan kimliği. Bu parametreyi yalnızca özgün örnek RDS High-availability Edition çalıştırdığında belirtebilirsiniz. Özgün örneğin bulunduğu bölgeye ait bir alan seçebilirsiniz. Seçilen alan özgün örneğin alanından farklı olabilir. Alan kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
ZoneIdSlave2	String	Hayır	cn-hangzhou-h	Ayrılmış bir parametredir. Bu parametreyi belirtmeniz gerekmez.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
DBInstanceId	String	pgm-bp1gm3yh0ht1****	Örneğin kimliği.
RequestId	String	006729E5-2A33-5955-89E3-651D3F44EBE6	İsteğin kimliği.
OrderId	String	21128667463****	Siparişin kimliği.
TaskId	Long	416980000	Ayrılmış bir parametredir.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceMajorVersion
&PayType=Postpaid
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<UpgradeDBInstanceMajorVersion>
    <RequestId>006729E5-2A33-5955-89E3-651D3F44EBE6</RequestId>
    <DBInstanceId>pgm-bp1gm3yh0ht1****</DBInstanceId>
    <OrderId>21128667463****</OrderId>
</UpgradeDBInstanceMajorVersion>

JSON biçimi

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

{
  "RequestId" : "006729E5-2A33-5955-89E3-651D3F44EBE6",
  "DBInstanceId" : "pgm-bp1gm3yh0ht1****",
  "OrderId" : "21128667463****"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidUpgradePrecheckResult	The upgrade precheck failed. No successful precheck task found in the past 7 days	Yükseltme kontrolünün başarısız olması ve son yedi gün içinde başarılı hiçbir yükseltme kontrolü bulunmaması nedeniyle döndürülen hata mesajı.
400	TargetEngineVersion.Parameters.NotFound	targetEngineVersion is missing in the request.	TargetMajorVersion parametresinin belirtilmemesi nedeniyle döndürülen hata mesajı.
400	InvalidDBInstanceStorageType	The specified DBInstanceStorageType is invalid.	DBInstanceStorageType parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidInstanceNetworkType	The specified InstanceNetworkType is invalid.	InstanceNetworkType parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidVPCId	The specified VPCId is invalid.	VPCId parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidDedicatedHostGroupId	The specified DedicatedHostGroupId is invalid.	Geçersiz bir özel küme kimliği belirtilmesi nedeniyle döndürülen hata mesajı.
400	InvalidPayType	The specified PayType is invalid.	PayType parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidEngineVersion	The specified EngineVersion is invalid.	TargetMajorVersion parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidDBInstanceStorage	The specified DBInstanceStorage is invalid.	DBInstanceStorage parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidSwitchOver	The specified SwitchOver is invalid.	SwitchOver parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	PrimaryInstanceWithReadonlyNotSupport	The specified primary instance with the read-only instance does not support the operation.	Özgün örneğe bağlı salt okunur örnekler olması nedeniyle döndürülen hata mesajı. Salt okunur örneklerin bağlı olduğu örnekler için bu işlem desteklenmez.
400	InvalidSwitchTimeMode	The specified SwitchTimeMode is invalid.	SwitchTimeMode parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidSwitchTime	The specified SwitchTime is invalid.	SwitchTime parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	InvalidCollectStats	The specified CollectStats is invalid.	CollectStatMode parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
400	IncorrectDBInstanceState	The current instance state does not support this operation.	Örneğin bulunduğu durum için bu işlemin desteklenmemesi nedeniyle döndürülen hata mesajı.
400	InvalidDBinstanceClass.ValueNotSupported	The specified parameter DBinstanceClass is invalid.	DBInstanceClass parametresinin değerinin geçersiz olması nedeniyle döndürülen hata mesajı.
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	Özgün örneğin adının bulunamaması nedeniyle döndürülen hata mesajı. Adın doğru olup olmadığını kontrol edin.
404	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Örneğin kilitli olması nedeniyle döndürülen hata mesajı.

Hata kodlarının listesi için Hizmet hata kodları sayfasını ziyaret edin.