Mengelola permintaan operasi sumber daya

Karena operasi sumber daya bersifat asinkron, permintaan sumber daya seperti create-resource dan update-resource mengembalikan ProgressEvent objek yang berisi informasi tentang status saat ini dari sumber daya Anda membuat atau memperbarui permintaan.

Misalnya, permintaan pembuatan sumber daya mungkin awalnya mengembalikan ProgressEvent objek berikut.

{
    "ProgressEvent": {
        "EventTime": "2021-08-09T18:17:15.219Z",
        "TypeName": "AWS::Logs::LogGroup",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "CREATE",
        "Identifier": "LogGroupResourceExample",
        "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
    }
}

Informasi yang dikembalikan dalam ProgressEvent objek termasuk token permintaan yang kemudian dapat Anda gunakan untuk melacak atau membatalkan permintaan operasi sumber daya.

catatan

Permintaan operasi sumber daya kedaluwarsa setelah tujuh hari.

Daftar permintaan operasi sumber daya aktif

Gunakan list-resource-requests perintah untuk mengembalikan daftar permintaan operasi sumber daya aktif untuk Akun AWS dan Wilayah AWS. Anda dapat memfilter daftar berdasarkan jenis permintaan dan status.

Permintaan operasi sumber daya kedaluwarsa setelah tujuh hari.

Contoh berikut mengembalikan permintaan operasi sumber daya aktif, tetapi menyaring permintaan pembuatan sumber daya apa pun yang masih berlangsung.

$ aws cloudcontrol list-resource-requests --resource-request-status-filter \
    Operations=CREATE,OperationStatuses=IN_PROGRESS

Informasi yang dikembalikan untuk setiap operasi sumber daya mencakup token permintaan yang kemudian dapat Anda gunakan untuk melacak atau membatalkan permintaan operasi sumber daya.

{
    "ResourceRequestStatusSummaries": [
        {
            "EventTime": "2021-08-09T18:17:16.591Z",
            "TypeName": "AWS::Logs::LogGroup",
            "OperationStatus": "SUCCESS",
            "Operation": "CREATE",
            "Identifier": "LogGroupResourceExample",
            "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
        }
    ]
}

Melacak kemajuan permintaan operasi sumber daya

Gunakan get-resource-request-status perintah untuk melacak kemajuan permintaan operasi sumber daya Anda. Perintah ini mengambil token permintaan yang disertakan dalam ProgressEvent objek yang dihasilkan selama permintaan operasi sumber daya awal. (Anda juga dapat mengambil token permintaan untuk permintaan operasi sumber daya menggunakan list-resource-requests perintah.) get-resource-request-statusPerintah mengembalikan ProgressEvent objek diperbarui yang berisi informasi tentang keadaan permintaan saat ini.

Lihat contoh berikut ini.

$ aws cloudcontrol get-resource-request-status \
    --request-token 5f40c577-3534-4b20-9599-0b0123456789

Membatalkan permintaan operasi sumber daya

Gunakan cancel-resource-request perintah untuk membatalkan permintaan operasi sumber daya yang sedang berlangsung. Karena Anda hanya dapat melakukan satu operasi pada sumber daya tertentu pada satu waktu, mungkin ada kasus di mana Anda perlu membatalkan operasi sumber daya saat ini untuk membuat sumber daya tersedia sehingga operasi lain dapat dilakukan di atasnya.

Membatalkan permintaan sumber daya tidak menjamin bahwa Cloud Control API dapat segera membatalkan semua operasi sumber daya. Sebaliknya, Cloud Control API akan berhenti melakukan panggilan lebih lanjut ke event handler resource. Permintaan operasi sumber daya tunggal ke Cloud Control API mungkin sebenarnya terdiri dari beberapa panggilan ke layanan dasar yang menyediakan sumber daya. Karena itu, membatalkan permintaan operasi sumber daya mungkin membuat permintaan selesai sebagian, sehingga hanya beberapa perubahan yang diminta diterapkan ke sumber daya. Cloud Control API tidak memutar kembali sumber daya ke status sebelumnya.

Hanya permintaan operasi sumber daya dengan status PENDING atau IN_PROGRESS dapat dibatalkan.

catatan

Meskipun CancelResourceRequest pemanggilan membatalkan operasi yang dilakukan oleh Cloud Control API, panggilan tidak menghentikan operasi asinkron apa pun yang mungkin sudah dimulai pada layanan hilir.