Örnek parametrelerini değiştirme - - Alibaba Cloud Dokümantasyon Merkezi

Parametreleri doğrudan veya bir parametre şablonu kullanarak değiştirebilirsiniz. Parametre değişikliği isteğini gönderdikten sonra ApsaraDB RDS, yeni parametre değerlerini örneğe uygulamak için bir görev başlatır. Yeni bir parametre değeri yalnızca örnek yeniden başlatıldıktan sonra etkili oluyorsa ApsaraDB RDS örneği yeniden başlatır. Yapılandırılabilir parametreler hakkında bilgi için bkz. ApsaraDB RDS for MySQL örneğinin parametrelerini yapılandırma.

Not

ApsaraDB RDS, parametre değişikliği görevini çalıştırmadan önce parametrelerin varlığını, yapılandırılabilir olup olmadıklarını ve yeni parametre değerlerinin geçerliliğini kontrol eder.

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 işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyParameter	Gerçekleştirmek istediğiniz işlem. Değeri ModifyParameter olarak ayarlayın.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılan istemci belirteci. Değeri istemci üzerinden üretebilirsiniz; ancak üretilen belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	Örneğin ID'si.
Parameters	String	Yes	{"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}	Parametrelerin ve değerlerinin JSON dizeleri. Tüm parametre değerleri dize türündedir. Biçim: {"Parametre adı 1":"Parametre değeri 1","Parametre adı 2":"Parametre değeri 2"...}. Parametre adlarını ve değerlerini sorgulamak için DescribeParameterTemplates işlemini çağırabilirsiniz. Not Bu parametreyi belirtirseniz ParameterGroupId parametresini belirtmeniz gerekmez.
Forcerestart	Boolean	No	false	Yeni bir parametre değerinin etkili olması için örneğin yeniden başlatılıp başlatılmayacağını belirtir. Geçerli değerler: true: Sistem örneği zorla yeniden başlatır. Yeni bir parametre değeri yalnızca örnek yeniden başlatıldıktan sonra etkili oluyorsa bu parametreyi true olarak ayarlamanız gerekir. Aksi takdirde yeni parametre değeri etkili olmaz. false: Sistem örneği zorla yeniden başlatmaz. Varsayılan değer: false
ParameterGroupId	String	No	rpg-xxxxxxxxx	Parametre şablonunun ID'si. Not Bu parametreyi belirtirseniz Parameters parametresini belirtmeniz gerekmez. Parametre şablonu yalnızca örnek yeniden başlatıldıktan sonra uygulanabiliyorsa Forcerestart parametresini belirtmeniz gerekir.
SwitchTimeMode	String	No	ScheduleTime	Değişikliğin etkili olacağı zaman. Geçerli değerler: Immediately: Parametreyi hemen değiştirir. Bu varsayılan değerdir. MaintainTime: Parametreyi örneğin bakım penceresi sırasında değiştirir. Örneğin bakım penceresini değiştirmek için ModifyDBInstanceMaintainTime işlemini çağırabilirsiniz. ScheduleTime: Değişiklik, belirttiğiniz zamanda etkili olur. Bu değeri belirtirseniz SwitchTime parametresini de belirtmeniz gerekir.
SwitchTime	String	No	2022-05-06T09:24:00Z	Değişikliğin etkili olacağı zaman. Zamanı, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardına göre belirtin. Saat UTC cinsinden olmalıdır. Not Bu zaman, bu işlemi çağırdığınız zamandan sonra olmalıdır.

Yanıt parametreleri

Parameter	Type	Example	Description
RequestId	String	542BB8D6-4268-45CC-A557-B03EFD7AB30A	İsteğin ID'si.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=ModifyParameter
&DBInstanceId=rm-uf6wjk5xxxxxxx
&Parameters={"delayed_insert_timeout":"600","max_length_for_sort_data":"2048"}
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

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

<ModifyParameterResponse>
       <RequestId>542BB8D6-4268-45CC-A557-B03EFD7AB30A</RequestId>
</ModifyParameterResponse>

JSON biçimi

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

{
  "RequestId" : "542BB8D6-4268-45CC-A557-B03EFD7AB30A"
}

Hata kodları

HTTP status code	Error code	Error message	Description
400	PendingActionOverdue	the action execution time is already overdue	Değişikliğin etkili olması için belirttiğiniz zamanın geçmiş olması nedeniyle dönen hata mesajı.
400	InvalidParameters.Format	Specified parameters is not valid.	Belirtilen bir parametrenin değeri geçersiz olduğu için dönen hata mesajı.
400	InvalidParameters.Format	The format of the specified parameter is invalid.	Belirtilen bir parametrenin biçimi geçersiz olduğu için dönen hata mesajı.
400	Invalid.ParamGroupDBCategory	ParamGroup category is basic, not standard.	Belirtilen parametre şablonunun kategorisi standard yerine basic olduğu için dönen hata mesajı.
403	IncorrectDBInstanceType	The current database instance type does not support the operation.	Örneğin yapılandırması bu işlemi desteklemediği için dönen hata mesajı.
403	IncorrectDBInstanceState	The current database status does not support the operation.	Örneğin durumu bu işlemi desteklemediği için dönen hata mesajı. Örneğin Running durumunda olduğunu kontrol edin.
403	Invalid.Parameter	Specified parameters is not valid.	Belirtilen bir parametre geçersiz olduğu için dönen hata mesajı.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	Belirtilen örnek bulunamadığı için dönen hata mesajı. Örneğin ID'sini kontrol edin.

Hata kodlarının listesi için API Error Center adresini ziyaret edin.