ModifyInstanceSpec - - Alibaba Cloud Dokümantasyon Merkezi

Bir ApsaraDB Tair (Redis OSS Uyumlu) örneğinin teknik özelliklerini değiştirir.

Operation description

Not

Örnek teknik özelliklerini değiştirmenin işlem süreci, etkileri, özellik sınırları ve faturalandırması hakkında bilgi için Örnek yapılandırmalarını değiştirme konusuna bakın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

kvstore:ModifyInstanceSpec

update

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	No	Bölge kimliği. Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. Değiştirmek istediğiniz örneğin bölgesini belirtmek için bu parametreyi kullanın.	cn-hangzhou
InstanceId	string	Yes	Örnek kimliği. Örnek kimliğini almak için DescribeInstances işlemini çağırabilirsiniz.	r-bp1zxszhcgatnx****
InstanceClass	string	No	Değişiklikten sonraki örnek türü kodu. Örneğin ait olduğu bölgede değişiklik için kullanılabilir olan örnek türlerini sorgulamak için DescribeAvailableResource işlemini çağırabilirsiniz. Not Örnek türleri hakkında daha fazla bilgi için Örnek türüne genel bakış konusuna bakın.	redis.master.small.default
BusinessInfo	string	No	Etkinlik kimliği ve iş bilgileri.	000000001
CouponNo	string	No	Kupon kodu. Varsayılan değer: `youhuiquan_promotion_option_id_for_blank`.	youhuiquan_promotion_option_id_for_blank
ForceUpgrade	boolean	No	Teknik özelliklerin zorla değiştirilip değiştirilmeyeceğini belirtir. Geçerli değerler: false: Hayır. true: Evet. Bu varsayılan değerdir.	true
EffectiveTime	string	No	Değişikliğin yürürlüğe girme zamanı. Geçerli değerler: Immediately: Değişiklik hemen yürürlüğe girer. Bu varsayılan değerdir. MaintainTime: Değişiklik, örneğin bakım penceresi sırasında yürürlüğe girer. Bakım penceresini değiştirmek için ModifyInstanceMaintainTime işlemini çağırabilirsiniz.	Immediately
AutoPay	boolean	No	Otomatik ödemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true: Otomatik ödeme etkinleştirilir. Bu varsayılan değerdir. false: Manuel ödeme etkinleştirilir. Bu parametre false olarak ayarlanırsa, örnek sona ermeden önce örneği konsolda manuel olarak yenilemeniz gerekir. Daha fazla bilgi için Manuel yenileme konusuna bakın.	true
OrderType	string	No	Değişiklik türü. Bu parametre, abonelik örneğinin teknik özelliklerini değiştirirken gereklidir. Geçerli değerler: UPGRADE: Yapılandırmaları yükseltir. Bu varsayılan değerdir. DOWNGRADE: Yapılandırmaları düşürür. Not Bir abonelik örneğinin yapılandırmalarını düşürürken, bu parametreyi DOWNGRADE olarak ayarlamanız gerekir. Hedef örnek türünün fiyatı mevcut örnek türünün fiyatından yüksekse yapılandırmalar yükseltilir. Aksi takdirde, yapılandırmalar düşürülür. Örneğin, 8 GB okuma/yazma bölme sürümünün (5 salt okunur düğüm) fiyatı 16 GB küme sürümünün fiyatından yüksektir. Örnek türünü ikincisinden birincisine değiştirmek bir yükseltme olarak kabul edilir. Valid values: DOWNGRADE : DOWNGRADE. UPGRADE : UPGRADE.	DOWNGRADE
MajorVersion	string	No	Klasik bir örneği yükseltmek istediğiniz ana motor sürümü. Geçerli değerler: 2.8, 4.0 ve 5.0. Not Ana motor sürümünü yükselttiğinizde InstanceClass parametresi gereklidir. Bu, bu işlemin yalnızca örnek teknik özelliklerini güncellerken ana motor sürümünü yükseltmeyi desteklediğini gösterir. Yalnızca ana motor sürümünü yükseltmeniz gerekiyorsa ModifyInstanceMajorVersion işlemini çağırın. Valid values: 4.0 : Sürüm 4.0 5.0 : Sürüm 5.0 2.8 : Sürüm 2.8	5.0
ClientToken	string	No	İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Değeri oluşturmak için istemciyi kullanabilirsiniz, ancak farklı istekler arasında benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.	ETnLKlblzczshOTUbOCz****
SourceBiz	string	No	Çağrının kaynağı. Bu parametre yalnızca dahili bakım için kullanılır ve belirtilmesine gerek yoktur.	SDK
ShardCount	integer	No	Parça sayısı. Bu parametre yalnızca bulut yerlisi küme örnekleri için geçerlidir. Özel bir parça sayısı belirtmek için bu parametreyi kullanabilirsiniz. Not Bulut yerlisi bir küme örneğini standart bir örneğe değiştirmek için ShardCount değerini açıkça 1 olarak ayarlamanız ve standart bir örnek türü belirtmeniz gerekir. Bulut yerlisi standart bir örneği bir küme örneğine değiştirmek için ShardCount değerini açıkça 1'den büyük bir değer olarak ayarlamanız ve bir küme örnek türü belirtmeniz gerekir.	8
ReplicaCount	integer	No	Birincil bölgedeki ikincil düğüm sayısı. Bu parametre yalnızca bulut yerlisi çok kopyalı küme örnekleri için geçerlidir. Özel bir ikincil düğüm sayısı belirtmek için bu parametreyi kullanabilirsiniz. Geçerli değerler: 1 ile 4 arası. Not Örnek birden fazla bölgeye dağıtılmışsa, birincil ve ikincil bölgelerdeki ikincil düğüm sayısını belirtmek için bu parametreyi ve SlaveReplicaCount parametresini kullanabilirsiniz. Bu parametre ile SlaveReplicaCount parametresinin toplamı 4'ü aşamaz.	1
SlaveReplicaCount	integer	No	İkincil bölgedeki ikincil düğüm sayısı.	1
ReadOnlyCount	integer	No	Birincil bölgedeki salt okunur düğüm sayısı. Bu parametre yalnızca bulut yerlisi bir okuma/yazma bölme örneği oluştururken geçerlidir. Örnek standart mimariyi kullanıyorsa, geçerli değerler 0 ile 9 arasıdır. 0 değeri, okuma/yazma bölmenin kapatıldığını ve örneğin standart mimariye geçtiğini gösterir. Örnek küme mimarisini kullanıyorsa, geçerli değerler 1 ile 4 arasıdır ve bu değer parça başına düşen salt okunur düğüm sayısını gösterir. Not Çok bölgeli bir örnek oluşturursanız, birincil ve ikincil bölgelerdeki salt okunur düğüm sayısını belirtmek için bu parametreyi ve SlaveReadOnlyCount parametresini kullanabilirsiniz. Örnek standart mimariyi kullanıyorsa, bu parametre ile SlaveReadOnlyCount parametresinin toplamı 9'dan büyük olamaz. Örnek küme mimarisini kullanıyorsa, bu parametre ile SlaveReadOnlyCount parametresinin toplamı 4'ten büyük olamaz.	5
SlaveReadOnlyCount	integer	No	İkincil bölgedeki salt okunur düğüm sayısı.	2
ForceTrans	boolean	No	Zorla aktarımın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: false (varsayılan): Teknik özellik değişikliğinden önce sistem, örneğin mevcut alt motor sürümünü kontrol eder. Alt motor sürümü çok düşükse bir hata bildirilir. Alt motor sürümünü yükseltmeniz ve yeniden denemeniz gerekir. true: Kontrol atlanır ve sistem doğrudan teknik özellik değişikliğini yürütür.	false
NodeType	string	No	Düğüm türü. Geçerli değerler: MASTER_SLAVE: yüksek kullanılabilirlik (çift kopyalı) STAND_ALONE: tek kopyalı double: çift kopyalı single: tek kopyalı Not Bulut yerlisi örnekler için MASTER_SLAVE veya STAND_ALONE seçin, klasik örnekler için ise double veya single seçin. Valid values: single : Tek kopyalı. STAND_ALONE : Tek kopyalı. double : Çift kopyalı. MASTER_SLAVE : Yüksek kullanılabilirlikli çift kopyalı.	MASTER_SLAVE
StorageType	string	No	Depolama türü. Geçerli değerler: essd_pl1, essd_pl2 ve essd_pl3. Not Bu parametre yalnızca InstanceType değeri tair_essd olarak ayarlandığında ve örnek bir Tair ESSD örneği olduğunda gereklidir. Valid values: essd_pl2 : ESSD PL2 essd_pl3 : ESSD PL3 essd_pl1 : ESSD PL1	essd_pl1
Storage	integer	No	Disk örneğinin depolama kapasitesi. Değer aralığı örnek türüne göre değişir. Daha fazla bilgi için Disk örnek türleri konusuna bakın. Not Bu parametre yalnızca InstanceType değeri tair_essd olarak ayarlandığında ve bir Tair ESSD örneği oluşturduğunuzda gereklidir. Bir Tair SSD örneği oluşturduğunuzda, kapasite alanı farklı örnek türlerine göre farklı sabit değerler olarak tanımlanır ve bu alanı belirtmenize gerek yoktur.	60
SecondaryZoneId	string	No	İkincil bölgenin kimliği. Bu parametre, tek bölgeli bir örneğin teknik özelliklerini değiştirip onu birden fazla bölgeye taşıdığınızda gereklidir. Bölge kimliğini sorgulamak için DescribeZones işlemini çağırabilirsiniz. Not Bu parametrenin değeri ZoneId parametresinin değeriyle aynı olamaz ve çok bölgeli bir dağıtımın kimliğini belirtemezsiniz.	cn-hangzhou-h

Response elements

Element	Type	Description	Example
	object	Nesne.
OrderId	string	Sipariş kimliği.	20722623431****
RequestId	string	İstek kimliği.	0DA1D7EF-C80D-432C-8758-7D225182626B

Examples

Success response

JSON format

{
  "OrderId": "20722623431****",
  "RequestId": "0DA1D7EF-C80D-432C-8758-7D225182626B"
}

Error codes

HTTP status code	Error code	Error message	Description
400	PaymentMethodNotFound	No payment method has been registered on the account.
400	HasRenewChangeOrder	This instance has a renewChange order.
400	%s	Warn: {%s} are not supported after upgraded. you can set forceUpgrade=true to force upgrade.
400	GdcInstanceNotSupport	The gdc custins trans not support.
400	AbnormalResourceStatusForRenew	Abnormal resource status for renew.
400	MissingRedisShardingUnsupportPerfItem	The metadb is missing redis sharding unsupoort command perf item.
400	IllegalParamError	Action or resource must not be null.
400	IncorrectTargetMajorVersion	Current target majorversion does not support this operation.	Belirtilen hedef ana sürüm mevcut işlem için desteklenmez. Belirtilen hedef ana sürümün örneğin mevcut ana sürümünden daha yeni olduğundan emin olun.
400	IncorrectMinorVersion	Current engine minor version does not support operations.	Örneğin mevcut ara sürümü bu işlemi desteklemez. En son ara sürüme yükseltin ve tekrar deneyin.
400	DirectTargetLevelNotSupport	The direct custins tranfer target instance level does not support.
400	DirectTransPreCheckError	The direct custins trans pre check IsAddReduceNodes error.
400	DtsOpendNotSupportTrans	The custins DtsSyncStatus opend does not support trans.
400	DirectTransNodeDoubleLevelError	The direct custins tranfer node double target level error.	Doğrudan bağlantı örnekleri ve aktif coğrafi yedeklilik örnekleri için yalnızca shard sayısı ayarlandığında, belirtilen sayı orijinal shard sayısının 2 katı veya 0,5 katı olmalıdır.
400	DirectTransUpgradeMajorVersionNotSupport	The direct custins tranfer does not support upgrade major version.
403	TargetMemoryLessThanCurrentUsed	The target instance memory size below the current instance used memory.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.