Tüm Ürünler
Search

Bu Ürün

    :ModifyDiskSpec

    Belge Merkezi

    :ModifyDiskSpec

    Son Güncelleme:Sep 30, 2026

    Bir diskin kategorisini değiştirir veya geliştirilmiş SSD (ESSD) performans seviyesini ayarlar.

    Kullanım notları

    Aşağıdaki hususlara dikkat edin:

    • ESSD'nin performans seviyesini değiştirmek için aşağıdakilere dikkat edin:

      • Abonelik tabanlı bir ESSD için yalnızca performansı yükseltebilirsiniz.

      • Kullandıkça öde ESSD için performansı hem yükseltebilir hem de düşürebilirsiniz. Ancak, performans seviyesini PL0'a düşüremezsiniz.

      • ESSD, Kullanımda (In_Use) veya Bağlı Değil (Available) durumunda olmalıdır.

      • ESSD bir Elastic Compute Service (ECS) örneğine bağlıysa, örneğin Çalışıyor (Running) veya Durduruldu (Stopped) durumunda olması gerekir. Örnek, Süresi Dolmuş durumda olmamalı veya geciken ödeme nedeniyle durdurulmamış olmalıdır.

      • Kapasite sınırı nedeniyle ESSD'nin performans seviyesini yükseltemiyorsanız ResizeDisk işlemini çağırarak ESSD'yi yeniden boyutlandırın ve tekrar deneyin. Daha fazla bilgi için bkz. ESSD'ler.

    • Bir diskin kategorisini değiştirmeyle ilgili sınırlamalar hakkında bilgi için Disk türünü değiştirme konusundaki "Sınırlamalar" bölümüne bakın.

    Yeni disk kategorisi veya performans seviyesi, bu işlem tamamlandıktan hemen sonra geçerli olur. Alibaba Cloud, faturalandırmayı yeni disk kategorisi ve performans seviyesine göre hesaplar.

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

    İstek parametreleri

    Parametre

    Tür

    Zorunlu

    Örnek

    Açıklama
    Action String Evet ModifyDiskSpec

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

    DiskId String Evet d-bp131n0q38u3a4zi****

    Diske ait kimlik.

    PerformanceLevel String Hayır PL2

    ESSD'nin yeni performans seviyesi. Geçerli değerler:

    • PL0: Tek bir ESSD, en fazla 10000 rastgele okuma/yazma IOPS sağlayabilir.
    • PL1: Tek bir ESSD, en fazla 50.000 rastgele okuma/yazma IOPS sağlayabilir.
    • PL2: Tek bir ESSD, en fazla 100000 rastgele okuma/yazma IOPS sağlayabilir.
    • PL3: Tek bir ESSD, en fazla 1000000 rastgele okuma/yazma IOPS sağlayabilir.

    Varsayılan değer: PL1.

    DiskCategory String Hayır cloud_essd

    Diske ait yeni kategori. Geçerli değerler:

    • cloud_essd: ESSD
    • cloud_auto: ESSD AutoPL disk

    • cloud_ssd: standart SSD

    • cloud_efficiency: ultra disk

    Bu parametre varsayılan olarak boştur; bu, disk kategorisinin değiştirilmediğini gösterir.

    Not

    • Yukarıdaki değerler, disk performansına göre azalan sırada listelenmiştir. Abonelik tabanlı disklerin performansı düşürülemez.

    DryRun Boolean Hayır false

    İsteğin gerçekten gönderilmeden sadece deneme amaçlı çalıştırılıp çalıştırılmayacağını belirtir. Geçerli değerler:

    • true: Sadece deneme çalıştırması yapılır. Sistem, eksik parametre değerleri, hatalı istek sözdizimi, hizmet sınırları ve yetersiz Elastic Compute Service (ECS) kaynakları dahil olmak üzere isteği potansiyel sorunlara karşı kontrol eder. İstek deneme testinden başarısız olursa bir hata mesajı döndürülür. İstek başarılı olursa DryRunOperation hata kodu döndürülür.
    • false: Hem deneme çalıştırması yapılır hem de gerçek istek gerçekleştirilir. İstek deneme testinden başarıyla geçerse 2xx HTTP durum kodu döndürülür ve işlem yürütülür.

    Varsayılan değer: false.

    ProvisionedIops Long Hayır 50000

    ESSD AutoPL diski için sağlanan okuma/yazma IOPS değeri. Geçerli değerler: 0 ile min{50.000, 1.000 × Kapasite - Temel Çizgi IOPS} arası.

    Temel Çizgi IOPS = min{1.800 + 50 × Kapasite, 50.000}.

    Not Bu parametre yalnızca DiskCategory değeri cloud_auto olarak ayarlandığında kullanılabilir. Daha fazla bilgi için bkz. ESSD AutoPL diskleri ve ESSD AutoPL diskinin performans yapılandırmasını değiştirme.
    PerformanceControlOptions.IOPS Integer Hayır 2000

    Diske ait yeni IOPS değeri. Yalnızca özel blok depolama kümelerindeki disklerin IOPS değerlerini değiştirebilirsiniz.

    Geçerli değerler: 900 ile disk başına maksimum IOPS arasında (100'er artışlarla).

    Daha fazla bilgi için bkz. Blok depolama performansı.

    PerformanceControlOptions.Throughput Integer Hayır 200

    Diske ait yeni aktarım hızı. Yalnızca özel blok depolama kümelerindeki disklerin aktarım hızını değiştirebilirsiniz. Birim: MB/sn.

    Geçerli değerler: 60 ile disk başına maksimum aktarım hızı arasında.

    Daha fazla bilgi için bkz. Blok depolama performansı.

    PerformanceControlOptions.Recover String Hayır All

    Diske ait IOPS ve aktarım hızının sıfırlanıp sıfırlanmayacağını belirtir. Bu parametre yalnızca disk özel bir blok depolama kümesinde olduğunda geçerlidir.

    Bu parametreyi belirttiğinizde PerformanceControlOptions.IOPS ve PerformanceControlOptions.Throughput parametreleri dikkate alınmaz.

    Değeri All olarak ayarlayın; bu, diske ait IOPS ve aktarım hızının başlangıç değerlerine sıfırlanacağını gösterir.

    Yanıt parametreleri

    Parametre

    Tür

    Örnek

    Açıklama
    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    İsteğe ait kimlik.

    TaskId String t-bp67acfmxazb4p****

    Disk kategorisi değiştirme görevine ait kimlik.

    Not Yalnızca bir ESSD'nin performans seviyesini değiştiriyorsanız bu parametre döndürülmez.
    OrderId String 20413515388****

    Siparişe ait kimlik.

    Not Bu parametre yalnızca abonelik tabanlı bir diskin kategorisi veya abonelik tabanlı bir ESSD'nin performans seviyesi değiştirildiğinde döndürülür.

    Örnekler

    Örnek istekler

    http(s)://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&ResourceOwnerId=123
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&DiskCategory=cloud_essd
&DryRun=false
&ProvisionedIops=50000
&<Common request parameters>

    Başarılı yanıt örnekleri

    XML biçimi

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

<ModifyDiskSpecResponse>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RequestId>5B38289D-88AB-42BD-B021-12FC6942F099</RequestId>
    <OrderId>20413515388****</TaskId>
</ModifyDiskSpecResponse>

    JSON biçimi

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

{
  "TaskId" : "t-bp67acfmxazb4p****",
  "RequestId" : "5B38289D-88AB-42BD-B021-12FC6942F099",
  "OrderId" : "20413515388****"
}

    Hata kodları

    HTTP durum kodu

    Hata kodu

    Hata mesajı

    Açıklama

    400

    InvalidPerformanceLevel.Malformed

    The specified parameter PerformanceLevel is not valid.

    Geçersiz PerformanceLevel değeri.

    400

    ProvisionedIopsForDiskCategoryUnsupported

    The specified disk category does not support provisioned iops.

    Disk kategorisi sağlanan IOPS değerini desteklemiyor.

    400

    QuotaExceed.DiskCapacity

    The used capacity of disk type has exceeded the quota in the zone, %s.

    Belirtilen disk kategorisine ait disklerin kapasitesi, alan için belirlenen kota sınırını aşıyor. Kotayı görüntülemek ve artırmak için Kota Merkezi'ne gidebilirsiniz.

    400

    MalformedParameter.PerformanceControlOptions

    Parameter invalid, %s.

    Geçersiz parametre değeri.

    400

    InvalidPerformanceControlOptions.ModifyOperationUnsupported

    The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS.

    PerformanceControlOptions ön ekli parametreler, disk kategorisi, performans seviyesi veya sağlanan IOPS ile çakışıyor.

    400

    InvalidOperation.InstanceRenewWithDowngradeInPlan

    The operation is denied due to the specified instance has renew with downgrade record in plan.

    Yenileme ve yapılandırma düşürme siparişleri henüz etkili değil. Siparişler etkili olmadan bu işlem gerçekleştirilemez.

    403

    DiskInArrears

    The specified operation is denied as your disk owing fee.

    Belirtilen disk için geciken ödemeniz var.

    403

    InstanceExpiredOrInArrears

    The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).

    Örneğin süresi dolmuş veya geciken ödemesi var. Örneği yenileyin veya ödemeyi tamamlayıp tekrar deneyin.

    403

    IncorrectDiskStatus

    The current disk status does not support this operation.

    Disk mevcut durumda bu işlem gerçekleştirilemez. Diske ait durumun Available (Mevcut) olduğunu ve disk için geciken ödeme bulunmadığını doğrulayın.

    403

    DiskCreatingSnapshot

    The operation is denied due to a snapshot of the specified disk is not completed yet.

    Belirtilen disk için bir anlık görüntü oluşturuluyor.

    403

    OperationDenied

    The type of the disk does not support the operation.

    Belirtilen disk kategorisi bu işlemi desteklemiyor.

    403

    OperationDenied.PerformanceLevelNotMatch

    The specified PerformanceLevel and disk size do not match.

    Belirtilen performans seviyesi ile disk boyutu birbirine uymuyor.

    403

    InvalidInstanceType.NotSupportDiskCategory

    The instanceType of the specified instance does not support this disk category.

    InstanceType ile belirtilen örnek türü, örneğe ait disk kategorisini desteklemiyor. Farklı bir örnek türü deneyin. Örnek türlerinin desteklediği disk kategorileri hakkında bilgi için örnek ailesi belgelerine bakın.

    403

    ModifyingDiskCategoryLimitExceed

    The amount of modifying disk category exceeds the limit.

    Bölgede yapılandırması değiştirilen disk sayısı üst sınıra ulaştı.

    403

    DiskInCoolingPeriod

    There is a cooling period after the disk is successfully modified.

    Disk, yapılandırma değişikliği kısıtlama döneminde olduğu için bu süre içinde yapılandırması değiştirilemez.

    403

    NoChangeInDiskCategoryAndPerformanceLevel

    There is no change between the parameters transmitted and the current.

    Belirtilen disk kategorisi ve performans seviyesi, mevcut disk kategorisi ve performans seviyesi ile aynı.

    403

    OperationDenied.NoStock

    The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.

    İstenen kaynaklar belirtilen alanda kullanılamıyor. Farklı bir örnek türü veya alan deneyin. Kullanılabilir kaynakları sorgulamak için DescribeZones işlemini çağırabilirsiniz.

    403

    InvalidOperation.MultiAttachDisk

    Multi attach disk does not support this operation.

    Çoklu ek özelliği etkinleştirilmiş disk bu işlemi desteklemiyor.

    403

    InvalidDiskCategory.NotSupported

    The specified disk category is not supported.

    Belirtilen disk kategorisi işlemi desteklemiyor.

    403

    InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster

    The specified disk not in dedicated storage cluster, can not modify performance control options.

    Özel blok depolama kümelerinde olmayan diskler, PerformanceControlOptions ön ekli parametreleri desteklemez.

    403

    InvalidStatus.DiskUnderPerformanceControl

    The specified disk is under performance control, any modifications to the category or performance level of the specified disk are unsupported..

    PerformanceControlOptions ön ekli parametreler belirtildiğinde disk kategorisi ve performans seviyesi değiştirilemez.

    403

    InvalidStatus.DiskNotReady

    This specified disk is not ready, status needs to be either In_use or Available.

    Belirtilen disk In_use veya Available durumunda olmalıdır.

    404

    InvalidDiskId.NotFound

    The specified disk does not exist.

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

    404

    InvalidInstanceId.NotFound

    The specified InstanceId does not exist.

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

    500

    InternalError

    The request processing has failed due to some unknown error, exception or failure.

    Dahili bir hata oluştu. Daha sonra tekrar deneyin.

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