Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Membatalkan unggahan multibagian
Setelah memulai unggahan multibagian, Anda memulai pengunggahan bagian. Amazon S3 menyimpan bagian-bagian ini, dan hanya membuat objek setelah Anda mengunggah semua bagian dan mengirim permintaan untuk menyelesaikan unggahan multipart. Setelah menerima keseluruhan permintaan unggahan multibagian, Amazon S3 akan menyusun bagian-bagiannya, dan membuat sebuah objek. Jika Anda tidak berhasil mengirim permintaan unggahan multipart lengkap, S3 tidak merakit bagian dan tidak membuat objek apa pun. Jika Anda tidak ingin menyelesaikan unggahan multipart setelah mengunggah bagian, Anda harus membatalkan unggahan multipart.
Anda akan ditagih untuk semua penyimpanan yang terkait dengan bagian yang diunggah. Disarankan untuk selalu menyelesaikan unggahan multipart atau menghentikan unggahan multipart untuk menghapus bagian yang diunggah. Untuk informasi selengkapnya tentang harga, lihatUnggahan multibagian dan harga.
Anda juga dapat menghentikan unggahan multibagian yang tidak lengkap menggunakan konfigurasi siklus hidup bucket. Untuk informasi selengkapnya, lihat Mengonfigurasi siklus hidup bucket untuk menghapus unggahan multibagian yang tidak lengkap.
Bagian berikut menunjukkan cara menghentikan pengunggahan multipart yang sedang berlangsung di Amazon S3 menggunakan, REST API AWS Command Line Interface, atau AWS SDK.
Untuk informasi selengkapnya tentang menggunakan AWS CLI untuk menghentikan upload multipart, lihat abort-multipart-upload di Referensi Perintah. AWS CLI
Untuk informasi selengkapnya tentang menggunakan REST API untuk menghentikan upload multipart, lihat AbortMultipartUpload Refer ensi API Layanan Penyimpanan Sederhana Amazon.
- Java
-
Untuk menghentikan upload multipart yang sedang berlangsung menggunakan AWS SDK untuk Java, Anda dapat membatalkan upload yang dimulai sebelum tanggal tertentu dan masih dalam proses. Pengunggahan dianggap sedang berlangsung setelah Anda memulainya, dan hingga Anda menyelesaikan atau menghentikannya.
Untuk menghentikan upload multipart, Anda dapat:
1 |
Buat instance S3Client. |
2 |
Gunakan metode aborsi klien dengan meneruskan nama bucket dan parameter lain yang diperlukan. |
Untuk contoh cara membatalkan upload multipart dengan AWS SDK untuk Java, lihat Mem batalkan upload multipart di Referensi API Amazon S3.
- .NET
-
Contoh C# berikut menghentikan semua unggahan multibagian yang sedang berlangsung yang dimulai pada bucket tertentu lebih dari seminggu yang lalu. Untuk informasi tentang menyiapkan dan menjalankan contoh kode, lihat Mem ulai dengan AWS SDK untuk.NET di Panduan Pengembang AWS SDK untuk.NET.
using Amazon;
using Amazon.S3;
using Amazon.S3.Transfer;
using System;
using System.Threading.Tasks;
namespace Amazon.DocSamples.S3
{
class AbortMPUUsingHighLevelAPITest
{
private const string bucketName = "*** provide bucket name ***";
// Specify your bucket region (an example region is shown).
private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2;
private static IAmazonS3 s3Client;
public static void Main()
{
s3Client = new AmazonS3Client(bucketRegion);
AbortMPUAsync().Wait();
}
private static async Task AbortMPUAsync()
{
try
{
var transferUtility = new TransferUtility(s3Client);
// Abort all in-progress uploads initiated before the specified date.
await transferUtility.AbortMultipartUploadsAsync(
bucketName, DateTime.Now.AddDays(-7));
}
catch (AmazonS3Exception e)
{
Console.WriteLine("Error encountered on server. Message:'{0}' when writing an object", e.Message);
}
catch (Exception e)
{
Console.WriteLine("Unknown encountered on server. Message:'{0}' when writing an object", e.Message);
}
}
}
}
Anda dapat menghentikan unggahan multibagian yang sedang berlangsung dengan memanggil metode AmazonS3.abortMultipartUpload. Metode ini menghapus semua bagian yang diunggah pada Amazon S3, dan mengosongkan sumber daya. Anda harus menyediakan ID unggahan, nama bucket, dan nama kunci. Contoh kode Java berikut menunjukkan cara menghentikan sebuah unggahan multibagian yang sedang berlangsung.
Untuk menghentikan unggahan multibagian, Anda harus memberikan ID unggahan, dan bucket serta nama kunci yang digunakan dalam unggahan tersebut. Setelah Anda menghentikan unggahan multibagian, Anda tidak dapat menggunakan ID unggahan untuk mengunggah bagian tambahan. Untuk informasi selengkapnya tentang unggahan multibagian Amazon S3, lihat Mengunggah dan menyalin objek menggunakan unggahan multipart di Amazon S3.
- Java
-
Untuk menghentikan pengunggahan multipart tertentu yang sedang berlangsung menggunakan AWS SDK untuk Java, Anda dapat menggunakan API tingkat rendah untuk membatalkan unggahan dengan memberikan nama bucket, kunci objek, dan ID unggahan.
Alih-alih membatalkan upload multipart tertentu, Anda dapat menghentikan semua upload multipart yang dimulai sebelum waktu tertentu yang masih berlangsung. Operasi pembersihan ini berguna untuk menghentikan unggahan multibagian lama yang Anda mulai tetapi tidak diselesaikan atau dihentikan. Untuk informasi selengkapnya, lihat Menggunakan AWS SDK (API tingkat tinggi).
Untuk contoh cara membatalkan unggahan multipart tertentu dengan AWS SDK untuk Java, lihat Mem batalkan unggahan multipart di Referensi API Amazon S3.
- .NET
-
Contoh C# berikut menunjukkan cara untuk menghentikan unggahan multibagian. Untuk keseluruhan sampel C# yang mencakup kode berikut, lihat Menggunakan AWS SDK (API tingkat rendah).
AbortMultipartUploadRequest abortMPURequest = new AbortMultipartUploadRequest
{
BucketName = existingBucketName,
Key = keyName,
UploadId = initResponse.UploadId
};
await AmazonS3Client.AbortMultipartUploadAsync(abortMPURequest);
Anda juga dapat membatalkan semua unggahan multibagian yang sedang berlangsung, yang dimulai sebelum waktu tertentu. Operasi pembersihan ini berguna untuk membatalkan unggahan multibagian yang tidak selesai atau dibatalkan. Untuk informasi selengkapnya, lihat Menggunakan AWS SDK (API tingkat tinggi).
- PHP
-
Contoh ini menunjukkan cara menggunakan kelas dari versi 3 AWS SDK untuk PHP
untuk membatalkan unggahan multibagian yang sedang berlangsung. Untuk informasi selengkapnya tentang AWS SDK untuk Ruby API, buka AWS SDK untuk Ruby - Versi 2. Contoh metode abortMultipartUpload().
Untuk informasi selengkapnya tentang AWS SDK untuk Ruby API, buka AWS SDK untuk Ruby - Versi 2.
require 'vendor/autoload.php';
use Aws\S3\S3Client;
$bucket = '*** Your Bucket Name ***';
$keyname = '*** Your Object Key ***';
$uploadId = '*** Upload ID of upload to Abort ***';
$s3 = new S3Client([
'version' => 'latest',
'region' => 'us-east-1'
]);
// Abort the multipart upload.
$s3->abortMultipartUpload([
'Bucket' => $bucket,
'Key' => $keyname,
'UploadId' => $uploadId,
]);
