ModifyDiskDeployment - - Alibaba Cloud Dokümantasyon Merkezi

Bir diski özel blok depolama kümesine veya kümesinden geçirir ya da farklı özel blok depolama kümeleri arasında disk geçişi yapar.

Operation description

Not

Özel blok depolama kümesi özelliği şu anda China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Heyuan), Indonesia (Jakarta), Germany (Frankfurt) ve China South 1 Finance bölgelerinde kullanılabilir.

Bu işlemi çağırmadan önce, disklerin ve özel blok depolama kümelerinin faturalandırma yöntemlerini ve fiyatlarını tam olarak anladığınızdan, özel blok depolama kümesinin süresinin dolmadığından ve hesabınızda vadesi geçmiş ödeme bulunmadığından emin olun. Daha fazla bilgi için Özel blok depolama faturalandırması ve Blok depolama faturalandırması konularına bakın.

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

Disk ve özel blok depolama kümesi aynı bölgede olmalıdır.
Yalnızca kullandıkça öde diskler desteklenir. Abonelik diskleri önce kullandıkça öde disklerine dönüştürülmelidir. Daha fazla bilgi için Disk faturalandırma yöntemleri arasında geçiş yapma konusuna bakın.
Disk teknik özellikleri, geçiş sırasında hedef küme tarafından desteklenen disk teknik özellikleriyle uyumlu olmalıdır. Farklı özel blok depolama kümeleri arasında geçiş sırasında, disk teknik özelliklerini hedef küme tarafından desteklenenlerle eşleşecek şekilde değiştirebilirsiniz.
Disk Kullanımda (In_use) veya etkin (Available) durumunda olmalıdır.
Disk bir ECS örneğine bağlıysa, örnek Çalışıyor (Running) veya Durduruldu (Stopped) durumunda olmalı ve ECS örneğinin süresi dolmamış olmalıdır.
ESSD performans seviyesi kapasitesiyle sınırlı olduğundan, performans seviyesini yükseltemiyorsanız kapasite artırımı yaparak tekrar deneyebilirsiniz. Daha fazla bilgi için ResizeDisk ve ESSD konularına bakın.
Tek bir hesap, aynı bölgede eşzamanlı olarak en fazla beş disk geçişi görevi çalıştırabilir.
Geçiş işlemi sırasında, geçişi iptal etme, anlık görüntü oluşturma, yükseltme/düşürme, kapasite artırma, diski bağlama, bağlantısını kesme ve diski yeniden başlatma gibi işlemlere izin verilmez.

Not

Disk geçişinden sonra, disk hedef kümenin faturalandırma yöntemlerini, disk teknik özelliklerini ve yeteneklerini takip eder. Değişiklikler işlem çağrıldıktan hemen sonra yürürlüğe girer ve Alibaba Cloud diski yeni disk türüne ve disk performans seviyesine göre faturalandırır. Daha fazla bilgi için Özel blok depolama faturalandırması ve Blok depolama faturalandırması konularına 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

ecs:ModifyDiskDeployment

update

*Disk.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

None

Request parameters

Parameter	Type	Required	Description	Example
DiskId	string	Yes	Disk kimliği.	d-bp131n0q38u3a4zi****
DiskCategory	string	No	Hedef disk kategorisi. Bu parametre yalnızca farklı özel blok depolama kümeleri arasındaki geçiş sırasında geçerlidir. Şu anda yalnızca cloud_essd (ESSD) desteklenmektedir. Varsayılan değer: Boş, bu da disk için teknik özellik değişikliği yapılmadığını gösterir.	cloud_essd
PerformanceLevel	string	No	Yeni ESSD performans seviyesi. Bu parametre yalnızca farklı özel blok depolama kümeleri arasındaki geçiş sırasında geçerlidir. Geçerli değerler: PL0: Tek bir disk, 10.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir. PL1: Tek bir disk, 50.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir. Varsayılan değer: Boş, bu da performans seviyesinin değişmeden kaldığını gösterir.	PL1
StorageClusterId	string	No	Özel blok depolama kümesi kimliği. Bir diski özel blok depolama kümesine geçirmeden önce kümeyi satın alıp oluşturmalı ve disk ile hedef kümenin aynı bölgede olduğundan emin olmalısınız. Özel blok depolama kümesine geçiş yaparken `StorageClusterId` parametresini belirtmelisiniz. Genel bulut blok depolama kümesine geçiş yaparken `StorageClusterId` boş olmalıdır. Varsayılan değer: Boş, bu da diskin genel bulut blok depolama kümesine geçirildiğini gösterir.	dbsc-cn-c4d2uea****
DryRun	boolean	No	Yalnızca isteğin ön kontrolünün yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Bir kontrol isteği gönderir. Kontrol öğeleri, gerekli parametrelerin belirtilip belirtilmediğini, istek biçimini, hizmet sınırlarını ve ECS envanterini içerir. Kontrol başarısız olursa, ilgili hata döndürülür. Kontrol başarılı olursa, DryRunOperation hata kodu döndürülür. false: Normal bir istek gönderir. Kontrol başarılı olduktan sonra, 2XX HTTP durum kodu döndürülür ve disk doğrudan geçirilir. Varsayılan değer: false.	false

Response elements

Element	Type	Description	Example
	object	Yanıt şeması.
RequestId	string	İstek kimliği.	D69846D9-F17F-51C0-8AC6-B4B71777****
TaskId	string	Disk geçişi görevinin kimliği.	t-bp67acfmxazb4p****

Examples

Success response

JSON format

{
  "RequestId": "D69846D9-F17F-51C0-8AC6-B4B71777****",
  "TaskId": "t-bp67acfmxazb4p****"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidDiskSpec.Malformed	The specified parameter DiskCategory or PerformanceLevel is not supported.	Belirtilen DiskCategory veya PerformanceLevel parametresi desteklenmez.
400	AccountInArrears	The account is in arrears.	Hesabınızda vadesi geçmiş ödemeler bulunmaktadır.
400	InvalidStorageClusterId.DiskAlreadyInDestination	The specified disk is already in destination.	Belirtilen disk zaten hedeftir.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	InvalidOperation.DiskTypeUnsupported	The type of the disk does not support this operation.	Disk türü bu işlemi desteklemez.
403	InvalidOperation.DiskCategoryUnsupported	The current category of the disk does not support this operation.
403	InvalidOperation.ChargeTypeUnsupported	The charge type of the disk does not support this operation.	Diskin faturalandırma yöntemi bu işlemi desteklemez.
403	InvalidPerformanceLevel.DiskSizeUnsupported	The specified parameter PerformanceLevel does not match the disk size.	Belirtilen PerformanceLevel parametresi disk boyutuyla eşleşmez.
403	DiskLimitExceeded	The number of migrated disks at the same time exceeds the limit.	Aynı anda geçişi yapılan disk sayısı sınırı aşmaktadır.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Belirtilen disk kategorisi belirtilen bölge veya kümede mevcut değil ya da belirtilen bölge kümeyle eşleşmiyor.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Çoklu bağlama etkinleştirilmiş diskler bu işlemi desteklemez.
403	InvalidDisk.DetachedSystemDisk	The specified resource is/has a detached system disk %s , not support current operation.	Belirtilen disk ayrılmış bir sistem diskidir ve mevcut işlemi desteklemez.
403	InvalidOperation.NoPermission	You are not authorized to do this action.	Mevcut işlemi gerçekleştirme yetkiniz yoktur. Yardım için bir talep gönderin.
403	InvalidOperation.LimitQosUnsupported	The specified disk has performance limits on bps or iops. This operation is not supported.
403	InvalidOperation.AcrossRegionsOrZonesUnsupported	Migration across regions or available zones is not supported.	Bölgeler arası veya kullanılabilirlik bölgeleri arası geçiş desteklenmez.
403	InvalidOperation.AttachedShareDisk	Attached share disk does not support this operation.	Bu işlem, bağlanmış paylaşımlı diskler için desteklenmez.
403	InvalidDiskCategory.NotSupported	The specified storage category is not supported. Please choose a category such as cloud_essd PL0 or PL1 and try again.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Belirtilen disk mevcut değildir. Disk kimliğinin doğru olup olmadığını kontrol edin.
404	InvalidStorageClusterId.CategoryNotMatch	The current dedicated storage cluster cannot create this category of disk.
404	InvalidStorageClusterId.NotFound	The specified dedicated block storage cluster does not exist.	Belirtilen özel blok depolama kümesi bulunmamaktadır.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.