Tüm Ürünler
Search

Bu Ürün

    :AttachDisk

    Belge Merkezi

    :AttachDisk

    Son Güncelleme:Sep 29, 2026

    Kullandıkça öde bir veri diskini veya sistem diskini bir örneğe ekler. Örnek ve disk aynı alanda bulunmalıdır.

    Açıklama

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

    • Diskin durumu Eklenmemiş (Available) olmalıdır.

    • Disk bir veri diski olarak eklendiğinde aşağıdaki hususlara dikkat edin:

      • Örnek Çalışıyor (Running) veya Durduruldu (Stopped) durumunda olmalıdır.

      • Disk ayrı olarak satın alındıysa faturalama yöntemi kullandıkça öde olmalıdır.

      • Disk bir örnekten çıkarılan sistem diski ise faturalama yöntemi için herhangi bir sınırlama uygulanmaz.

    • Disk bir sistem diski olarak eklendiğinde aşağıdaki hususlara dikkat edin:

      • Örnek, sistem diskinin çıkarıldığı orijinal örnek olmalıdır.

      • Örnek Durduruldu (Stopped) durumunda olmalıdır.

      • Oturum açma kimlik bilgileri yapılandırılmış olmalıdır.

    • Örnek bilgilerini sorguladığınızda yanıtlar {"OperationLocks": {"LockReason" : "security"}} içeriyorsa örnek güvenlik nedenleriyle kilitlenir ve örnekte hiçbir işlem gerçekleştirilemez.

    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şleme ait örnek kodları dinamik olarak oluşturur.

    İstek parametreleri

    ParametreTürZorunluÖrnekAçıklama
    ActionStringEvetAttachDisk

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

    DiskIdStringEvetd-bp1j4l5axzdy6ftk****

    Eklenecek diskin ID'si. DiskId parametresiyle belirtilen disk ile InstanceId parametresiyle belirtilen örnek aynı alanda bulunmalıdır.

    Not Veri diski ve sistem diski ekleme sınırlamaları hakkında daha fazla bilgi için "Açıklama" bölümüne bakın.
    InstanceIdStringEveti-bp1dq5lozx5f4pmd****

    Diske eklenecek örneğin ID'si.

    DeviceStringHayırtestDeviceName

    Diskin adı.

    Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak amacıyla diğer parametreleri kullanmanızı öneririz.
    DeleteWithInstanceBooleanHayırfalse

    Disken örnekle birlikte serbest bırakılıp bırakılmayacağını belirtir. Geçerli değerler:

    • true: Disk örnekle birlikte serbest bırakılır.
    • false: Disk örnekle birlikte serbest bırakılmaz. Kullandıkça öde bir veri diski olarak korunur.

    Varsayılan değer: false.

    Bu parametreyi belirtirken aşağıdaki hususlara dikkat edin:

    • Bir örneğin OperationLocks değeri "LockReason" : "security" içeriyorsa örnek güvenlik nedeniyle kilitlenir. Ekli disklerin DeleteWithInstance değeri false olarak ayarlansa bile DeleteWithInstance parametresi yok sayılır ve diskler örnekle birlikte serbest bırakılır.
    • Bu parametre çoklu ekleme özelliği etkinleştirilmiş diskler için kullanılamaz.
    BootableBooleanHayırfalse

    Diskin sistem diski olarak eklenip eklenmeyeceğini belirtir.

    Varsayılan değer: false.

    Not Bootable parametresi true olarak ayarlanırsa örnek Sistem Disksiz durumunda olmalıdır.
    PasswordStringHayırEcsV587!

    Sistem diskini eklerken ayarladığınız parola. Parola yalnızca yönetici ve kök kullanıcılar için geçerlidir. Parola 8 ila 30 karakter uzunluğunda olmalıdır. Büyük harfler, küçük harfler, rakamlar ve özel karakterler olmak üzere aşağıdaki karakter türlerinden en az üçünü içermelidir. Aşağıdaki özel karakterler kullanılabilir:

    
()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

    Windows örneklerinde parola eğik çizgi (/) ile başlayamaz.

    Not Password parametresi belirtilirse parolaların sızmasını önlemek amacıyla istekleri HTTPS üzerinden göndermenizi öneririz.
    KeyPairNameStringHayırKeyPairTestName

    Sistem diskini eklerken Linux örneğine bağladığınız SSH anahtar çiftinin adı.

    • Windows örnekleri SSH anahtar çiftlerine dayalı oturum açmayı desteklemez. KeyPairName parametresi belirtilse bile Password parametresi etkili olur.
    • Linux örneklerinde parolaya dayalı oturum açma yöntemi varsayılan olarak devre dışı bırakılır.

    Yanıt parametreleri

    Parametre Tür Örnek Açıklama
    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E


    İsteğin ID'si.

    Örnekler

    Örnek istekler

    https://ecs.aliyuncs.com/?Action=AttachDisk
&DiskId=d-bp1j4l5axzdy6ftk****
&InstanceId=i-bp1dq5lozx5f4pmd****
&DeleteWithInstance=false
&<Common request parameters>

    Başarılı yanıt örnekleri

    XML biçimi

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

    JSON biçimi

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

    Hata kodları

    HTTP durum kodu Hata kodu Hata mesajı Açıklama
    400 InvalidDevice.Malformed The specified device is not valid. Belirtilen Device parametresi mevcut olmadığından dönen hata mesajı.
    400 IncorrectInstanceStatus The current status of the resource does not support this operation. Kaynak mevcut durumdayken işlem desteklenmediğinden dönen hata mesajı.
    400 InvalidParameter The input parameter is mandatory for processing this request is empty. Gerekli bir parametre belirtilmediğinden dönen hata mesajı.
    400 InvalidRegionId.MalFormed The specified RegionId is not valid Belirtilen RegionId parametresi geçersiz olduğundan dönen hata mesajı.
    400 InvalidOperation.InstanceTypeNotSupport The instance type of the specified instance does not support hot attach disk. Diske eklenen örnek disklerin sıcak takılmasını desteklemediğinden dönen hata mesajı.
    400 DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category Belirtilen disk kategorisi işlemi desteklemediğinden dönen hata mesajı.
    400 InvalidOperation.InstanceTypeNotSupport The specified disk which has kms key should only attach to ioOptimized instance. Belirtilen örnek desteklenmiyor. Yalnızca G/Ç optimize edilmiş örnekler için Key Management Service (KMS) anahtarlarını ayarlayabilirsiniz.
    400 InvalidParameter.AllEmpty %s Gerekli parametreler belirtilmediğinden dönen hata mesajı.
    403 InstanceDiskLimitExceeded The amount of the disk on instance in question reach its limits. Belirtilen örneğe eklenebilecek maksimum disk sayısına ulaşıldığından dönen hata mesajı.
    403 InvalidDevice.InUse The specified device has been occupied. Belirtilen cihazda zaten ekli bir disk bulunduğundan dönen hata mesajı.
    403 DiskNotPortable The specified disk is not a portable disk. Belirtilen disk çıkarılabilir olmadığından dönen hata mesajı.
    403 InstanceLockedForSecurity The instance is locked due to security. Kaynak güvenlik nedenleriyle kilitliyken işlem desteklenmediğinden dönen hata mesajı.
    403 ResourcesNotInSameZone The specified instance and disk are not in the same zone. Belirtilen örnek ve disk aynı alanda olmadığından dönen hata mesajı.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). Abonelik tabanlı örneğin süresi dolduğundan dönen hata mesajı. Örneği yenileyin ve tekrar deneyin.
    403 DiskInArrears The specified operation is denied as your disk owing fee. Disk için ödemesi geciken tutarlarınız bulunduğundan dönen hata mesajı.
    403 DiskError IncorrectDiskStatus. Belirtilen diskin durumu geçersiz olduğundan dönen hata mesajı.
    403 DiskId.ValueNotSupported The specified parameter diskid is not supported. Belirtilen Elastic Block Storage (EBS) cihazının kategorisi bu işlemi desteklemediğinden dönen hata mesajı.
    403 DiskId.StatusNotSupported The specified disk status is not supported. Disk mevcut durumdayken bu işlem desteklenmediğinden dönen hata mesajı.
    403 IncorrectDiskStatus The operation is not supported in this status. Disk mevcut durumdayken işlem desteklenmediğinden dönen hata mesajı. Diskin kullanılabilir durumda olduğundan ve ödeme gecikmesi olmadığından emin olun.
    403 UserNotInTheWhiteList The user is not in disk white list. Diski yönetme yetkiniz olmadığından dönen hata mesajı. Yetkilendirildikten sonra tekrar deneyin.
    403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled. Bir disk için KMS anahtar ID'si belirtildiğinde müşteri anahtarı (CMK) etkinleştirilmediğinden dönen hata mesajı. Belirtilen CMK hakkındaki bilgileri sorgulamak için KMS'in DescribeKey işlemini çağırabilirsiniz.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS. Elastic Compute Service (ECS) KMS kaynaklarınıza erişim iznine sahip olmadığından dönen hata mesajı.
    403 InvalidInstanceType.NotSupportDiskCategory The instanceType of the specified instance does not support this disk category. InstanceType parametresiyle belirtilen örnek türü örneğin disk kategorisini desteklemediğinden dönen hata mesajı. Başka bir örnek türü deneyin. Örnek türlerinin desteklediği disk kategorileri hakkında bilgi için örnek ailesi belgelerine bakın.
    403 InvalidInstanceType.NvmeRequired The instanceType of the specified instance requires nvme protocol. Belirtilen örneğin örnek türü NVMe protokolünü kullanmadığından dönen hata mesajı.
    403 InvalidInstanceType.NvmeUnsupported The instanceType of the specified instance does not support nvme protocol. Belirtilen örneğin örnek türü NVMe protokolünü desteklemediğinden dönen hata mesajı.
    403 InvalidInstanceType.NotSupportMultiAttachDisk The instanceType of the specified instance does not support multi attach disk. Çoklu ekleme özelliği etkinleştirilen diskler belirtilen örnek türündeki örneklere eklenemediğinden dönen hata mesajı.
    403 DiskAttachedNumberExceeded The attaching times of the specified disk exceeded. Belirtilen diskin eklenebileceği maksimum örnek sayısına ulaşıldığından dönen hata mesajı.
    403 InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk Multi attach disk can not be attached as system disk. Çoklu ekleme özelliği etkinleştirilen diskler sistem diski olarak eklenemediğinden dönen hata mesajı.
    403 DeleteWithInstance.Conflict Multi attach disk cannot be set to DeleteWithInstance attribute. DeleteWithInstance niteliği çoklu ekleme özelliği etkinleştirilmiş diskler için geçersiz olduğundan dönen hata mesajı.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist. Belirtilen InstanceId parametresi mevcut olmadığından dönen hata mesajı. Örnek ID'sinin doğru olup olmadığını kontrol edin.
    404 InvalidDiskId.NotFound The specified disk does not exist. Belirtilen disk mevcut olmadığından dönen hata mesajı. Disk ID'sinin doğru olup olmadığını kontrol edin.
    404 InvalidDisk.InUse The specified disk has been occupied. Belirtilen disk kullanımda olduğundan dönen hata mesajı.
    500 InternalError The request processing has failed due to some unknown error. Dahili bir hata oluştuğundan dönen hata mesajı. Daha sonra tekrar deneyin.
    500 InternalError The request processing has failed due to some unknown error, exception or failure. Dahili bir hata oluştuğundan dönen hata mesajı. Daha sonra tekrar deneyin.

    Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.