All Products
Search

This Product

    Object Storage Service:DescribeJob

    Document Center

    Object Storage Service:DescribeJob

    Last Updated:Nov 09, 2025

    Anda dapat memanggil operasi DescribeJob untuk mengkueri detail dan status eksekusi dari pekerjaan operasi Batch tertentu.

    Izin

    Secara default, Akun Alibaba Cloud memiliki semua izin. Pengguna Manajemen Akses Sumber Daya (RAM) dan Peran RAM tidak memiliki izin apa pun secara default. Administrator harus memberikan izin menggunakan Kebijakan RAM atau Kebijakan bucket.

    API

    Aksi

    Deskripsi

    DescribeJob

    oss:DescribeJob

    Mengambil detail pekerjaan operasi batch.

    Sintaksis permintaan

    GET /?batchJob&batchJobId=xxx HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

    Parameter permintaan

    Nama

    Tipe

    Diperlukan

    Contoh

    Deskripsi

    batchJobId

    String

    Ya

    MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

    ID pekerjaan operasi batch. ID ini terdiri dari 44 karakter yang mencakup huruf dan angka. Tidak mengandung tanda hubung (-) atau garis bawah (_).

    Node anak: Tidak ada

    Node induk: Tidak ada

    Header permintaan

    Operasi ini hanya menggunakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

    Elemen respons

    Nama

    Tipe

    Contoh

    Deskripsi

    DescribeJobResult

    Kontainer

    Tidak ada

    Node root dari respons.

    Node anak: Job

    Node induk: Tidak ada

    Job

    Kontainer

    Tidak ada

    Kontainer untuk detail pekerjaan.

    Node anak: ConfirmationRequired, CreationTime, FailureReasons, JobId, Operation, Report, Manifest, Description, Priority, RoleArn, StatusUpdateReason, KeyPrefixManifestGenerator, ProgressSummary, Status, dan TerminationDate

    Node induk: DescribeJobResult

    ConfirmationRequired

    Boolean

    false

    Menunjukkan apakah pekerjaan memerlukan konfirmasi sebelum dijalankan.

    Node anak: Tidak ada

    Node induk: Job

    CreationTime

    Timestamp

    1749983400

    Waktu ketika pekerjaan dibuat.

    Node anak: Tidak ada

    Node induk: Job

    FailureReasons

    Kontainer

    Tidak ada

    Alasan mengapa pekerjaan gagal. Node ini dikembalikan bahkan jika pekerjaan berhasil. Dalam hal ini, node JobFailure kosong. Kesalahan dalam satu operasi tidak menyebabkan pekerjaan gagal.

    Node anak: JobFailure

    Node induk: Job

    JobFailure

    Kontainer

    Tidak ada

    Detail tentang kegagalan pekerjaan.

    Node anak: FailureCode dan FailureReason

    Node induk: FailureReasons

    FailureCode

    String

    InternalError

    Kode kesalahan.

    Node anak: Tidak ada

    Node induk: JobFailure

    FailureReason

    String

    Internal service error

    Pesan kesalahan.

    Node anak: Tidak ada

    Node induk: JobFailure

    JobId

    String

    MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=

    ID pekerjaan yang dihasilkan OSS untuk pekerjaan tersebut.

    Node anak: Tidak ada

    Node induk: Job

    Operation

    Kontainer

    Tidak ada

    Detail tentang operasi yang akan dilakukan.

    Node anak: RestoreObject

    Node induk: Job

    RestoreObject

    Kontainer

    Tidak ada

    Detail tentang operasi untuk memulihkan objek Arsip.

    Node anak: Days dan Tier

    Node induk: Operation

    Days

    Integer

    7

    Jumlah hari objek yang dipulihkan tetap dapat diakses.

    Node anak: Tidak ada

    Node induk: RestoreObject

    Tier

    String

    Standard

    Prioritas Pemulihan

    Node anak: Tidak ada

    Node induk: RestoreObject

    Report

    Kontainer

    Tidak ada

    Konfigurasi laporan.

    Node anak: Bucket, Enabled, Prefix, dan ReportScope

    Node induk: Job

    Bucket

    String

    report-bucket

    Bucket tempat laporan disimpan.

    Node anak: Tidak ada

    Node induk: Report

    Enabled

    Boolean

    true

    Menunjukkan apakah laporan dihasilkan.

    Node anak: Tidak ada

    Node induk: Report

    Prefix

    String

    reports/

    Awalan laporan.

    Node anak: Tidak ada

    Node induk: Report

    ReportScope

    String

    AllTasks

    Ruang lingkup laporan.

    Node anak: Tidak ada

    Node induk: Report

    Manifest

    Kontainer

    Tidak ada

    Informasi manifes. Anda dapat menentukan parameter ini atau KeyPrefixManifestGenerator.

    Node anak: Location dan Spec

    Node induk: Job

    Location

    Kontainer

    Tidak ada

    Lokasi manifes. Bucket yang menyimpan file manifes harus berada di wilayah yang sama dengan pekerjaan operasi batch.

    Node anak: Bucket, ETag, Object, dan VersionId

    Node induk: Manifest

    Bucket

    String

    manifest-bucket

    Bucket tempat file manifes disimpan.

    Node anak: Tidak ada

    Node induk: Location

    ETag

    String

    d41d8cd98f00b204e9800998ecf8427e

    ETag file manifes.

    Node anak: Tidak ada

    Node induk: Location

    Object

    String

    manifest.csv

    Objek yang sesuai dengan file manifes.

    Node anak: Tidak ada

    Node induk: Location

    VersionId

    String

    3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo

    ID versi objek yang sesuai dengan file manifes.

    Node anak: Tidak ada

    Node induk: Location

    Spec

    Kontainer

    Tidak ada

    Deskripsi format manifes.

    Node anak: Fields dan Format

    Node induk: Manifest

    Fields

    String

    Bucket,Key

    Bidang dalam manifes.

    Node anak: Tidak ada

    Node induk: Spec

    Format

    String

    OSS_BatchOperations_CSV_20250611

    Format. Ini menunjukkan bahwa keluaran berasal dari laporan inventaris.

    Node anak: Tidak ada

    Node induk: Spec

    Description

    String

    Batch restore archive objects job

    Deskripsi pekerjaan.

    Node anak: Tidak ada

    Node induk: Job

    Priority

    Integer

    10

    Prioritas pekerjaan.

    Node anak: Tidak ada

    Node induk: Job

    RoleArn

    String

    arn:acs:ram::uid:role/BatchOperationRole

    Peran IAM

    Node anak: Tidak ada

    Node induk: Job

    StatusUpdateReason

    String

    Task completed successfully

    Alasan pembaruan status.

    Node anak: Tidak ada

    Node induk: Job

    KeyPrefixManifestGenerator

    Kontainer

    Tidak ada

    Konfigurasi untuk menghasilkan manifes secara otomatis. Anda dapat menentukan parameter ini atau Manifest.

    Node anak: SourceBucket dan Prefix

    Node induk: Job

    SourceBucket

    String

    source-bucket

    Bucket sumber.

    Node anak: Tidak ada

    Node induk: KeyPrefixManifestGenerator

    Prefix

    String

    data/

    Awalan.

    Node anak: Tidak ada

    Node induk: KeyPrefixManifestGenerator

    ProgressSummary

    Kontainer

    Tidak ada

    Ringkasan kemajuan pekerjaan.

    Node anak: NumberOfTasksFailed, NumberOfTasksSucceeded, Timers, dan TotalNumberOfTasks

    Node induk: Job

    NumberOfTasksFailed

    Long

    0

    Jumlah tugas yang gagal.

    Node anak: Tidak ada

    Node induk: ProgressSummary

    NumberOfTasksSucceeded

    Long

    1.000

    Jumlah tugas yang berhasil.

    Node anak: Tidak ada

    Node induk: ProgressSummary

    Timers

    Kontainer

    Tidak ada

    Informasi tentang waktu eksekusi.

    Node anak: ElapsedTimeInActiveSeconds

    Node induk: ProgressSummary

    ElapsedTimeInActiveSeconds

    Long

    3.600

    Waktu yang berlalu untuk pekerjaan, dalam detik.

    Node anak: Tidak ada

    Node induk: Timers

    TotalNumberOfTasks

    Long

    1.000

    Jumlah total tugas.

    Node anak: Tidak ada

    Node induk: ProgressSummary

    Status

    String

    Complete

    Status saat ini dari pekerjaan. Nilai valid:

    • New: Pekerjaan baru dibuat dan belum dipersiapkan.

    • Preparing: Sistem sedang mengurai file manifes, mengotentikasi izin, dan menginisialisasi sumber daya eksekusi.

    • Ready: Pekerjaan telah dipersiapkan dan menunggu untuk dijadwalkan eksekusinya.

    • Suspended: Pekerjaan memerlukan konfirmasi eksplisit dari pengguna untuk melanjutkan. Ini terjadi jika Anda menetapkan ConfirmationRequired ke true saat membuat pekerjaan.

    • Active: Pekerjaan sedang memproses objek. Anda dapat melihat kemajuan secara real-time di ProgressSummary.

    • Pausing: Sistem sedang menjeda pekerjaan. Jeda hanya berlaku untuk pekerjaan ini.

    • Paused: Pekerjaan dijeda. Layanan OSS secara otomatis melanjutkan pekerjaan.

    • Completing: Semua objek telah diproses. Sistem sedang menghasilkan laporan eksekusi dan membersihkan sumber daya.

    • Complete: Pekerjaan berhasil diselesaikan. Ini adalah status akhir.

    • Cancelling: Sistem sedang membatalkan pekerjaan.

    • Cancelled: Pekerjaan dibatalkan oleh pengguna. Ini adalah status akhir.

    • Failing: Pekerjaan mengalami kesalahan kritis dan sistem menghentikan eksekusinya.

    • Failed: Pekerjaan dihentikan karena kesalahan tingkat sistem. Untuk informasi lebih lanjut, lihat bidang FailureReasons. Ini adalah status akhir.

    Node anak: Tidak ada

    Node induk: Job

    TerminationDate

    Timestamp

    1749987000

    Waktu ketika pekerjaan berakhir.

    Node anak: Tidak ada

    Node induk: Job

    Header respons

    Operasi ini hanya menggunakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

    Contoh

    • Contoh Permintaan

      GET /?batchJob&batchJobId=MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU= HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

    • Contoh Respons

      HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<DescribeJobResult>
  <Job>
    <ConfirmationRequired>false</ConfirmationRequired>
    <CreationTime>1749983400</CreationTime>
    <JobId>MzRjZGU2NGQ3YTY5NGRhMTkxZmZhYzY5OTM5YTcxYWU=</JobId>
    <Operation>
      <RestoreObject>
        <Days>7</Days>
        <Tier>Standard</Tier>
      </RestoreObject>
    </Operation>
    <Report>
      <Bucket>report-bucket</Bucket>
      <Enabled>true</Enabled>
      <Prefix>reports/</Prefix>
      <ReportScope>AllTasks</ReportScope>
    </Report>
    <Manifest>
      <Location>
        <ETag>d41d8cd98f00b204e9800998ecf8427e</ETag>
        <Bucket>manifest-bucket</Bucket>
        <Object>manifest.csv</Object>
        <VersionId>3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo</VersionId>
      </Location>
      <Spec>
        <Fields>Bucket,Key</Fields>
        <Format>OSS_BatchOperations_CSV_20250611</Format>
      </Spec>
    </Manifest>
    <Description>Batch restore archive objects job</Description>
    <Priority>10</Priority>
    <RoleArn>arn:acs:ram::uid:role/BatchOperationRole</RoleArn>
    <StatusUpdateReason>Task completed successfully</StatusUpdateReason>
    <ProgressSummary>
      <NumberOfTasksFailed>0</NumberOfTasksFailed>
      <NumberOfTasksSucceeded>1000</NumberOfTasksSucceeded>
      <Timers>
        <ElapsedTimeInActiveSeconds>3600</ElapsedTimeInActiveSeconds>
      </Timers>
      <TotalNumberOfTasks>1000</TotalNumberOfTasks>
    </ProgressSummary>
    <Status>Complete</Status>
    <TerminationDate>1749987000</TerminationDate>
  </Job>
</DescribeJobResult>