All Products
Search

This Product

    Key Management Service:ScheduleKeyDeletion

    Document Center

    Key Management Service:ScheduleKeyDeletion

    Last Updated:Dec 21, 2025

    Menghapus kunci master pelanggan (CMK) yang ditentukan.

    Deskripsi operasi

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

    Setelah CMK dihapus, CMK tersebut tidak dapat dipulihkan. Data yang telah dienkripsi serta kunci data yang dihasilkan menggunakan CMK tersebut juga tidak dapat didekripsi. Untuk mencegah penghapusan CMK secara tidak sengaja, Key Management Service (KMS) hanya memungkinkan Anda menjadwalkan penghapusan kunci—Anda tidak dapat langsung menghapus CMK. Jika ingin menonaktifkan CMK, panggil operasi DisableKey.

    Saat memanggil operasi ini, Anda harus menentukan periode penjadwalan antara 7 hingga 366 hari. Periode penjadwalan dimulai sejak waktu permintaan diajukan. Anda dapat membatalkan penghapusan kunci kapan saja sebelum periode tersebut berakhir dengan memanggil operasi CancelKeyDeletion.

    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 dari customer master key (CMK). ID tersebut harus unik secara global.

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

    integer

    Yes

    Periode penjadwalan setelahnya CMK akan dihapus. Selama periode ini, CMK berada dalam status PendingDeletion. Setelah periode berakhir, Anda tidak dapat membatalkan task penghapusan kunci.

    Nilai yang valid: 7 hingga 366.

    Unit: hari.

    7

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan, yang digunakan untuk melacak 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.