Melacak status tugas dan laporan penyelesaian - Amazon Simple Storage Service
Status tugasMemperbarui status tugasNotifikasi dan pencatatanMelacak kegagalan pekerjaanLaporan penyelesaian

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Melacak status tugas dan laporan penyelesaian

Dengan Operasi Batch S3, Anda dapat melihat dan memperbarui status tugas, menambahkan notifikasi dan pencatatan, melacak kegagalan tugas, dan menghasilkan laporan penyelesaian.

Topik

Status tugas

Setelah Anda membuat dan menjalankan tugas, tugas tersebut akan berjalan melalui serangkaian status. Tabel berikut ini menjelaskan status dan transisi yang mungkin terjadi di antara keduanya.

Status Deskripsi Transisi
New Tugas dimulai dengan status New saat Anda membuatnya. Tugas secara otomatis akan berpindah ke status Preparing saat Amazon S3 mulai memproses objek manifes.
Preparing Amazon S3 memproses objek manifes dan parameter tugas lainnya untuk menyiapkan dan menjalankan tugas. Tuagas secara otomatis akan berpindah ke status Ready setelah Amazon S3 selesai memproses manifes dan parameter lainnya. Pekerjaan ini kemudian siap untuk mulai menjalankan operasi yang ditentukan pada objek yang tercantum dalam manifes.

Jika tugas memerlukan konfirmasi sebelum dijalankan, seperti saat Anda membuat tugas menggunakan konsol Amazon S3, maka tugas tersebut akan bertransisi dari Preparing ke Suspended. Tugas akan tetap di status Suspended sampai Anda mengonfirmasi untuk menjalankannya.
Suspended Pekerjaan itu membutuhkan konfirmasi, tetapi Anda belum memastikan bahwa Anda ingin menjalankannya. Hanya tugas yang Anda buat menggunakan konsol Amazon S3 yang memerlukan konfirmasi. Pekerjaan yang dibuat menggunakan konsol memasuki Suspended status segera setelahnyaPreparing. Setelah Anda mengonfirmasi untuk menjalankan tugas dan tugas tersebut telah menjadi Ready, tugas itu tidak pernah kembali ke status Suspended. Setelah Anda mengonfirmasi untuk menjalankan tugas, statusnya berubah menjadi Ready.
Ready Amazon S3 siap untuk mulai menjalankan pengoperasian objek yang diminta. Tugas secara otomatis berpindah ke status Active saat Amazon S3 mulai menjalankannya. Lama waktu yang diperlukan tugas untuk tetap berada dalam status Ready tergantung pada apakah Anda sudah memiliki tugas dengan prioritas yang lebih tinggi dan berapa lama tugas tersebut harus diselesaikan.
Active Amazon S3 menjalankan operasi yang diminta pada objek yang tercantum dalam manifes. Sementara pekerjaan adalahActive, Anda dapat memantau kemajuannya menggunakan konsol Amazon S3 atau DescribeJob operasi melalui RESTAPI, AWS CLI, atau. AWS SDKs Sebuah pekerjaan bergerak keluar dari Active keadaan ketika pekerjaan tidak lagi menjalankan operasi pada objek. Perilaku ini dapat terjadi secara otomatis, seperti ketika pekerjaan selesai dengan sukses atau gagal. Atau perilaku ini dapat terjadi sebagai akibat dari tindakan pengguna, seperti membatalkan pekerjaan. Status perpindahan tugas tergantung pada alasan transisi.
Pausing Tugas bertransisi ke Paused dari status lain. Tugas secara otomatis berpindah ke Paused saat tahap Pausing selesai.
Paused Tugas dapat menjadi Paused jika Anda mengirimkan tugas lain dengan prioritas yang lebih tinggi ketika tugas saat ini sedang berjalan. Tugas Paused secara otomatis kembali ke Active setelah tugas dengan prioritas yang lebih tinggi yang menghalangi eksekusi tugas telah selesai, gagal, atau ditangguhkan.
Complete Tugas telah selesai melakukan operasi yang diminta pada semua objek dalam manifes. Operasi mungkin telah berhasil atau gagal untuk setiap objek. Jika Anda mengonfigurasi tugas untuk membuat laporan penyelesaian, laporan tersebut akan tersedia segera setelah tugas Complete. Complete adalah status terminal. Setelah pekerjaan tercapaiComplete, itu tidak bertransisi ke keadaan lain.
Cancelling Tugas bertransisi ke status Cancelled. Tugas secara otomatis berpindah ke Cancelled saat tahap Cancelling selesai.
Cancelled Anda meminta agar pekerjaan dibatalkan, dan Operasi Batch S3 telah berhasil membatalkan pekerjaan. Pekerjaan tidak akan mengirimkan permintaan baru ke Amazon S3. Cancelled adalah status terminal. Setelah pekerjaan tercapaiCancelled, pekerjaan tidak akan beralih ke keadaan lain.
Failing tugas beralih ke status Failed. Tugas secara otomatis berpindah ke Failed setelah tahap Failing selesai.
Failed Tugas gagal dan tidak lagi berjalan. Untuk informasi selengkapnya tentang kegagalan tugas, lihat Melacak kegagalan pekerjaan. Failed adalah status terminal. Setelah pekerjaan tercapaiFailed, itu tidak akan beralih ke keadaan lain.

Memperbarui status tugas

Berikut AWS CLI dan AWS SDK for Java contoh memperbarui status pekerjaan Operasi Batch. Untuk informasi selengkapnya tentang menggunakan konsol Amazon S3 untuk mengelola pekerjaan Operasi Batch, lihat. Menggunakan konsol Amazon S3 untuk mengelola tugas Operasi Batch S3

Untuk menggunakan perintah contoh berikut, ganti placeholder masukan pengguna dengan informasi Anda sendiri.

  • Jika Anda tidak menentukan --no-confirmation-required parameter dalam create-job perintah Anda, pekerjaan tetap dalam status ditangguhkan sampai Anda mengonfirmasi pekerjaan dengan menyetel statusnyaReady. Amazon S3 kemudian membuat tugas yang memenuhi syarat untuk dijalankan.

    aws s3control update-job-status \
    --region us-west-2 \
    --account-id 123456789012 \
    --job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c \
    --requested-job-status 'Ready'

  • Batalkan tugas dengan mengatur status tugas menjadi Cancelled.

    aws s3control update-job-status \
     --region us-west-2 \
     --account-id 123456789012 \
     --job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c \
     --status-update-reason "No longer needed" \
     --requested-job-status Cancelled

Contoh berikut memperbarui status pekerjaan Operasi Batch S3 dengan menggunakan. AWS SDK for Java

Untuk informasi selengkapnya tentang status tugas, lihat Melacak status tugas dan laporan penyelesaian.


package aws.example.s3control;


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.UpdateJobStatusRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class UpdateJobStatus {
    public static void main(String[] args) {
        String accountId = "Account ID";
        String jobId = "00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.updateJobStatus(new UpdateJobStatusRequest()
                    .withAccountId(accountId)
                    .withJobId(jobId)
                    .withRequestedJobStatus("Ready"));

        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

Notifikasi dan pencatatan

Selain meminta laporan penyelesaian, Anda juga dapat menangkap, meninjau, dan mengaudit aktivitas Operasi Batch dengan menggunakan AWS CloudTrail. Karena Operasi Batch menggunakan operasi Amazon S3 API yang ada untuk melakukan tugas, tugas tersebut juga memancarkan peristiwa yang sama jika Anda memanggilnya secara langsung. Oleh karena itu, Anda dapat melacak dan merekam kemajuan pekerjaan Anda dan semua tugasnya dengan menggunakan alat dan proses notifikasi, pencatatan, dan audit yang sama yang sudah Anda gunakan dengan Amazon S3. Untuk informasi selengkapnya, lihat contoh di bagian berikut.

catatan

Operasi Batch menghasilkan peristiwa manajemen dan data CloudTrail selama pelaksanaan pekerjaan. Volume skala peristiwa ini dengan jumlah kunci dalam manifes setiap pekerjaan. Untuk informasi selengkapnya, lihat halaman CloudTrail harga, yang mencakup contoh perubahan harga tergantung pada jumlah jejak yang telah Anda konfigurasikan di akun Anda. Untuk mempelajari cara mengonfigurasi dan mencatat peristiwa agar sesuai dengan kebutuhan, lihat Buat jejak pertama Anda di Panduan Pengguna AWS CloudTrail .

Untuk informasi selengkapnya tentang peristiwa Amazon S3, lihat Notifikasi Peristiwa Amazon S3.

Melacak kegagalan pekerjaan

Jika tugas Operasi Batch S3 mengalami masalah yang membuatnya mengalami kegagalan, seperti tidak dapat membaca manifes yang ditentukan, maka tugas tersebut akan gagal. Saat mengalami kegagalan, tugas akan menghasilkan satu atau beberapa kode kegagalan atau alasan kegagalan. Operasi Batch S3 menyimpan kode kegagalan dan alasan dengan pekerjaan sehingga Anda dapat melihatnya dengan meminta detail pekerjaan. Jika Anda meminta laporan penyelesaian untuk tugas tersebut, kode dan alasan kegagalan juga akan muncul di sana.

Agar tugas tidak menjalankan banyak operasi yang gagal, Amazon S3 memberlakukan ambang batas kegagalan tugas pada setiap tugas Operasi Batch. Ketika pekerjaan telah menjalankan setidaknya 1.000 tugas, Amazon S3 memantau tingkat kegagalan tugas. Jika tingkat kegagalan (jumlah tugas yang gagal sebagai proporsi dari jumlah total tugas yang telah berjalan) melebihi 50 persen, maka pekerjaan tersebut gagal. Jika pekerjaan gagal karena melebihi ambang batas kegagalan tugas, Anda dapat mengidentifikasi penyebab kegagalan. Misalnya, Anda mungkin tidak sengaja memasukkan beberapa objek dalam manifes yang tidak ada dalam bucket tertentu. Setelah memperbaiki kesalahan, Anda dapat mengirim ulang tugas tersebut.

catatan

Operasi Batch S3 beroperasi secara asinkron dan tugas tidak selalu berjalan dalam urutan bahwa objek terdaftar dalam manifes. Oleh karena itu, Anda tidak dapat menggunakan urutan manifes untuk menentukan tugas objek yang berhasil maupun yang gagal. Sebagai gantinya, Anda dapat memeriksa laporan penyelesaian pekerjaan (jika Anda memintanya) atau melihat log AWS CloudTrail peristiwa Anda untuk membantu menentukan sumber kegagalan.

Laporan penyelesaian

Saat Anda membuat tugas, Anda dapat meminta laporan penyelesaian. Selama Operasi Batch S3 berhasil memanggil setidaknya satu tugas, Amazon S3 menghasilkan laporan penyelesaian setelah pekerjaan selesai menjalankan tugas, gagal, atau dibatalkan. Anda dapat mengonfigurasi laporan penyelesaian untuk menyertakan semua tugas atau hanya tugas yang gagal.

Laporan penyelesaian mencakup konfigurasi pekerjaan, status, dan informasi untuk setiap tugas, termasuk kunci objek dan versi, status, kode kesalahan, dan deskripsi kesalahan apa pun. Laporan penyelesaian memberikan cara mudah untuk melihat hasil tugas Anda dalam format terkonsolidasi tanpa perlu pengaturan tambahan. Laporan penyelesaian dienkripsi dengan menggunakan enkripsi sisi server dengan kunci terkelola Amazon S3 (-S3). SSE Untuk contoh laporan penyelesaian, lihat Contoh: Laporan penyelesaian Operasi Batch S3.

Jika Anda tidak mengonfigurasi laporan penyelesaian, Anda masih dapat memantau dan mengaudit pekerjaan Anda dan tugasnya dengan menggunakan CloudTrail dan Amazon CloudWatch. Untuk informasi selengkapnya, lihat topik berikut.

Topik