ModifyDiskAttribute - - Alibaba Cloud Dokümantasyon Merkezi

Bir veya daha fazla blok depolama aygıtının adını, açıklamasını, serbest bırakma davranışını, otomatik anlık görüntü silme politikasını, otomatik anlık görüntü politikasını, performans artışı ayarlarını ve diğer özniteliklerini değiştirir.

Operation description

Tek bir blok depolama aygıtının adını, açıklamasını, serbest bırakma davranışını ve diğer özniteliklerini değiştirmek için DiskId parametresini belirtebilir veya birden fazla blok depolama aygıtının özniteliklerini toplu olarak değiştirmek için DiskIds.N parametresini belirtebilirsiniz.

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:ModifyDiskAttribute

update

*Disk

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

None

Request parameters

Parameter	Type	Required	Description	Example
DiskId	string	No	Özniteliklerini değiştirmek istediğiniz diskin kimliği. Not DiskId ve DiskIds.N parametreleri aynı anda belirtilemez. Gerektiğinde bunlardan birini belirtin.	d-bp1famypsnar20bv****
DiskName	string	No	Diskin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır ve harfler, rakamlar ile Çince karakterler dahil Unicode'da harf olarak sınıflandırılan karakterleri içerebilir. Ad iki nokta üst üste (:), alt çizgi (_), nokta (.) ve tire (-) karakterlerini içerebilir.	MyDiskName
Description	string	No	Diskin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz.	TestDescription
DeleteWithInstance	boolean	No	İlişkili örnek serbest bırakıldığında diskin serbest bırakılıp bırakılmayacağını belirtir. Varsayılan değer: null; bu, mevcut değerin değişmeden kalacağını gösterir. Aşağıdaki durumlarda DeleteWithInstance değerini false olarak ayarlarsanız bir hata döndürülür: Diskin kategorisi yerel disk (ephemeral) ise. Diskin kategorisi temel disk (cloud) ise ve disk ayrılabilir değilse (Portable=false). Uyarı DeleteWithInstance değerini false olarak ayarlarsanız ve diskin bağlı olduğu ECS örneği OperationLocks içinde "LockReason" : "security" ile güvenlik nedeniyle kilitlenmişse, DeleteWithInstance ayarı yok sayılır ve disk örnekle birlikte serbest bırakılır.	false
DeleteAutoSnapshot	boolean	No	Disk silindiğinde diskin otomatik anlık görüntülerinin silinip silinmeyeceğini belirtir. Geçerli değerler: true: Etkin. false: Devre dışı. Varsayılan değer: null; bu, mevcut değerin değişmeden kalacağını gösterir.	false
EnableAutoSnapshot	boolean	No	Disk için otomatik anlık görüntü politikasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true: Etkin. false: Devre dışı. Varsayılan değer: null; bu, mevcut değerin değişmeden kalacağını gösterir. Not [Kullanımdan Kaldırıldı] Bu parametre kullanımdan kaldırılmıştır. Otomatik anlık görüntü politikası özelliği, diskler oluşturulduktan sonra varsayılan olarak etkinleştirilir. Yalnızca otomatik anlık görüntü politikasını diskle ilişkilendirmeniz yeterlidir.	true
RegionId	string	No	Bölge kimliği. En son bölge listesini sorgulamak için DescribeRegions(~~25609~~) çağrısı yapabilirsiniz. DescribeRegions	cn-hangzhou
DiskIds	array	No	Özniteliklerini değiştirmek istediğiniz disklerin kimlikleri. N için geçerli değerler: 0 ila 100. Not DiskId ve DiskIds.N parametreleri aynı anda belirtilemez. Gerektiğinde bunlardan birini belirtin.	d-bp1famypsnar20bv****
	string	No	Özniteliklerini değiştirmek istediğiniz diskin kimliği. N için geçerli değerler: 0 ila 100. Not DiskId ve DiskIds.N parametreleri aynı anda belirtilemez. Gerektiğinde bunlardan birini belirtin.	d-bp1famypsnar20bv****
BurstingEnabled	boolean	No	Performans artışını destekleyen diskler için performans artışı özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true: Etkin. false: Devre dışı. Not Performans artışı özelliğini desteklemeyen bir disk için herhangi bir değer belirtirseniz bir hata döndürülür.	false

Response elements

Element	Type	Description	Example
	object
RequestId	string	İstek kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HTTP status code	Error code	Error message
400	InvalidDiskName.Malformed	The specified disk name is malformed.
400	NoAttributeToModify	No attribute to be modified in this request.
400	IncompleteParamter	Some fields can not be null in this request.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	MissingParameter.DiskIdOrDiskIds	Specified parameter DiskId or DiskIds is missing.
400	ParameterConflict.DiskIdAndDiskIds	The parameters DiskId and DiskIds are mutually exclusive. Please specify only one.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.
400	InvalidBurstingEnabled.DiskSizeTooSmall	The disk size must be greater than 3 GiB to enable burst.
400	InvalidParameter.DeleteWithInstance	The specified disk is an elastic ephemeral disk. Set "DeleteWithInstance" to true and try again.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.
403	DiskNotPortable	The specified disk is not a portable disk.
403	IncorrectDiskStatus	The operation is not supported in this status.
403	UserNotInTheWhiteList	The user is not in disk white list.
403	DeleteWithInstance.Conflict	The specified image is from the image market. You cannot set the DeleteWithInstance attribute to false.
404	InvalidDiskId.NotFound	The specified disk does not exist.
404	InvalidDescription.Malformed	The specified description is malformed.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.