All Products
Search

This Product

    Key Management Service:ScheduleKeyDeletion

    Document Center

    Key Management Service:ScheduleKeyDeletion

    Last Updated:Jun 10, 2026

    Menghapus kunci utama pelanggan (CMK) yang ditentukan.

    Deskripsi operasi

    Selama periode terjadwal, CMK berada dalam status PendingDeletion dan tidak dapat digunakan untuk mengenkripsi data, mendekripsi data, atau membuat kunci data.

    Setelah CMK dihapus, kunci tersebut tidak dapat dipulihkan. Data yang dienkripsi dan kunci data yang dibuat menggunakan CMK tidak dapat didekripsi. Untuk mencegah penghapusan CMK secara tidak sengaja, Key Management Service (KMS) hanya mengizinkan Anda menjadwalkan tugas penghapusan kunci. Anda tidak dapat menghapus CMK secara langsung. Jika Anda ingin menghapus CMK, panggil operasi DisableKey untuk menonaktifkan CMK.

    Saat Anda memanggil operasi ini, Anda harus menentukan periode terjadwal antara 7 hari hingga 366 hari. Periode terjadwal dimulai dari waktu Anda mengirimkan permintaan. Anda dapat memanggil operasi CancelKeyDeletion untuk membatalkan tugas penghapusan kunci sebelum periode terjadwal berakhir.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    KeyId

    string

    Yes

    ID kunci utama pelanggan (CMK). ID harus unik secara global.

    7906979c-8e06-46a2-be2d-68e3ccbc****
    PendingWindowInDays

    integer

    Yes

    Periode terjadwal setelah CMK dihapus. Selama periode ini, CMK berada dalam status PendingDeletion. Setelah periode ini berakhir, Anda tidak dapat membatalkan tugas penghapusan kunci.

    Nilai yang valid: 7 hingga 366.

    Satuan: hari.

    7

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan, yang digunakan untuk menemukan dan memecahkan masalah.

    3da5b8cc-8107-40ac-a170-793cd181d7b7

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "3da5b8cc-8107-40ac-a170-793cd181d7b7"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
    404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.