Tüm Ürünler
Search
Belge Merkezi

:ModifyDiskAttribute

Son Güncelleme:Sep 29, 2026

Blok depolama aygıtlarının adları, açıklamaları ve ilişkili örneklerle birlikte serbest bırakılıp bırakılmayacağı dahil olmak üzere niteliklerini değiştirir.

Kullanım notları

  • Bu işlemi çağırarak bir diskin niteliklerini değiştirdiğinizde, DeleteWithInstance parametresini false olarak ayarlarsanız ve diskin bağlı olduğu örnek güvenlik nedeniyle kilitlenmişse diskin DeleteWithInstance ayarı yoksayılır; disk, ilişkili örnekle birlikte serbest bırakılır. Bir örnek hakkında bilgi sorguladığınızda yanıtta "LockReason" : "security" ifadesi görüntüleniyorsa örnek güvenlik nedeniyle kilitlenmiştir.

  • DiskIds.N parametresini kullanarak birden çok blok depolama aygıtı belirtebilir; bu sayede ad, açıklama ve ilişkili örneklerle birlikte serbest bırakma durumu dahil olmak üzere aygıtların niteliklerini tek seferde değiştirebilirsiniz.

Hata ayıklama

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

İstek parametreleri

Parametre

Tür

Zorunlu

Örnek

Açıklama

Action Dize Evet ModifyDiskAttribute

Gerçekleştirmek istediğiniz işlem. Değeri ModifyDiskAttribute olarak ayarlayın.

DiskId Dize Hayır d-bp1famypsnar20bv****

Diskin kimliği.

Not DiskId ve DiskIds.N parametreleri birbirini dışlar. İş gereksinimlerinize göre bu parametrelerden birini belirtin.
DiskName Dize Hayır MyDiskName

Diske verilecek ad. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Ad bir harfle başlamalı ve http:// veya https:// ile başlayamaz. Ad harf, rakam, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

Description Dize Hayır TestDescription

Diskin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

DeleteWithInstance Boolean Hayır false

Diskin, ilişkili örnekle birlikte serbest bırakılıp bırakılmayacağını belirtir. Bu parametre varsayılan olarak boştur; bu durum, mevcut değerin değişmediği anlamına gelir.

Aşağıdaki durumlardan birinde DeleteWithInstance parametresini false olarak ayarlarsanız hata döndürülür:

  • Disk yerel bir disk ise.
  • Disk temel düzeyde bir diskse ve çıkarılamıyorsa. Bir diskin Portable niteliği false olarak ayarlanmışsa disk çıkarılamaz.
DeleteAutoSnapshot Boolean Hayır false

Disk serbest bırakıldığında diske ait otomatik anlık görüntülerin silinip silinmeyeceğini belirtir. Bu parametre varsayılan olarak boştur; bu durum, mevcut değerin değişmediği anlamına gelir.

EnableAutoSnapshot Boolean Hayır true

Cloud disk için otomatik anlık görüntü ilkesi özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true
  • false

Bu parametre varsayılan olarak boştur; bu durum, mevcut değerin değişmediği anlamına gelir.

Not Varsayılan olarak cloud diskler için otomatik anlık görüntü ilkesi özelliği etkindir. İlkeyi kullanabilmeniz için öncelikle bir otomatik anlık görüntü ilkesini cloud diske ilişkilendirmeniz gerekir.
RegionId Dize Evet cn-hangzhou

Diskin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

DiskIds.N Dize Hayır d-bp1famypsnar20bv****

N. diskin kimliği. N için geçerli değer aralığı: 0 ila 100.

Not DiskId ve DiskIds.N parametreleri birbirini dışlar. İş gereksinimlerinize göre bu parametrelerden birini belirtin.
BurstingEnabled Boolean Hayır false

Performans patlaması özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true
  • false

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

RequestId

Dize

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

İsteğin kimliği.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=ModifyDiskAttribute
&RegionId=cn-hangzhou
&DiskId=d-bp1famypsnar20bv****
&DiskName=MyDiskName
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<ModifyDiskAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyDiskAttributeResponse>

JSON biçimi

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

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

Hata kodları

HTTP durum kodu

Hata kodu

Hata iletisi

Açıklama

400

InvalidDiskName.Malformed

The specified disk name is wrongly formed.

Geçersiz DiskName biçimi. Ad 2 ila 128 karakter uzunluğunda olmalı ve harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Ad bir harfle başlamalı ve http:// veya https:// ile başlayamaz.

400

NoAttributeToModify

No attribute to be modified in this request.

Blok depolama aygıtının hiçbir niteliği değiştirilmedi.

400

IncompleteParamter

Some fields can not be null in this request.

Bazı zorunlu parametreler belirtilmedi.

400

InvalidRegionId.MalFormed

The specified RegionId is not valid.

Geçersiz RegionId değeri.

400

BurstingEnabledForDiskCategoryUnsupported

The specified disk category does not support bursting enabled.

Disk kategorisi performans patlaması özelliğini desteklemiyor.

400

BurstingEnabledForMultiAttachDiskUnsupported

The multi attach disk does not support bursting enabled.

Çoklu ek özelliği etkinleştirilmiş diskler performans patlaması özelliğini desteklemez.

400

BurstingEnabledForModifyingDiskUnsupported

The modifying disk does not support bursting enabled.

Yapılandırması değiştirilen bir disk için performans patlaması özelliği değiştirilemez.

403

QuotaExceed.Snapshot

The snapshot quota exceeds.

Maksimum anlık görüntü sayısına ulaşıldı. Yeni anlık görüntüler depolamak için artık ihtiyaç duymadığınız anlık görüntüleri silin.

403

DiskNotPortable

The specified disk is not a portable disk.

Belirtilen disk çıkarılamaz.

403

IncorrectDiskStatus

The operation is not supported in this status.

Disk mevcut durumda bu işlem gerçekleştirilemez. Diskin kullanılabilir olduğundan ve disk için ödemesiz faturanızın bulunmadığından emin olun.

403

UserNotInTheWhiteList

The user is not in disk white list.

Diski yönetme yetkiniz yok. Yetkilendirildikten sonra tekrar deneyin.

403

DeleteWithInstance.Conflict

Multi attach disk cannot be set to DeleteWithInstance attribute.

Çoklu ek özelliği etkinleştirilmiş diskler DeleteWithInstance niteliğini desteklemez.

404

InvalidDiskId.NotFound

The specified disk does not exist.

Bu disk bulunamadı. Disk kimliğinin geçerli olup olmadığını kontrol edin.

404

InvalidDescription.Malformed

The specified description is wrongly formed.

Geçersiz Description biçimi. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

404

InvalidInstanceId.NotFound

Specified attached instance does not exist.

Belirtilen örnek bulunamadı. Örnek kimliğinin doğru olup olmadığını kontrol edin.

Hata kodlarının listesi için bkz. Hizmet hata kodları.