

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

# Membatalkan unggahan multibagian
<a name="abort-mpu"></a>

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 multibagian lengkap, S3 tidak merakit komponen dan tidak membuat objek apa pun. Jika Anda ingin tidak 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 multibagian atau menghentikan unggahan multibagian untuk menghapus bagian yang diunggah. Untuk informasi lebih lanjut tentang harga, lihat[Unggahan multibagian dan harga](mpuoverview.md#mpuploadpricing).

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](mpu-abort-incomplete-mpu-lifecycle-config.md).

Bagian berikut menunjukkan cara menghentikan unggahan multipart yang sedang berlangsung di Amazon S3 menggunakan AWS Command Line Interface, REST API, atau. AWS SDKs

## Menggunakan AWS CLI
<a name="abort-mpu-cli"></a>

Untuk informasi selengkapnya tentang penggunaan AWS CLI untuk menghentikan unggahan multibagian, lihat [abort-multipart-upload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/abort-multipart-upload.html)di *Referensi AWS CLI Perintah*.

## Penggunaan API REST
<a name="abort-mpu-rest"></a>

Untuk informasi selengkapnya tentang penggunaan REST API untuk menghentikan unggahan multibagian, lihat [AbortMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)di *Referensi API Amazon Simple Storage Service*.

## Menggunakan AWS SDKs (API tingkat tinggi)
<a name="abort-mpu-high-level"></a>

------
#### [ Java ]

Untuk menghentikan unggahan multibagian yang sedang berlangsung menggunakan AWS SDK for Java, Anda dapat membatalkan unggahan yang dimulai sebelum tanggal yang ditentukan dan masih dalam proses. Pengunggahan dianggap sedang berlangsung setelah Anda memulainya, dan hingga Anda menyelesaikan atau menghentikannya.

Untuk menghentikan unggahan multipart, Anda dapat:


|  |  | 
| --- |--- |
| 1 | Buat instance S3Client. | 
| 2 | Gunakan metode abort klien dengan meneruskan nama bucket dan parameter lain yang diperlukan. | 

**catatan**  
Anda juga dapat menghentikan unggahan multibagian tertentu. Untuk informasi selengkapnya, lihat [Menggunakan AWS SDKs (API tingkat rendah)](#abort-mpu-low-level).

*Untuk contoh cara membatalkan unggahan multipart dengan SDK for AWS Java, [lihat Membatalkan unggahan multibagian di Referensi](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_AbortMultipartUpload_section.html) 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 [Memulai SDK for .NET di AWSAWS SDK for](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) .NET *Developer Guide*. 

```
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);
            }
        } 
    }
}
```

**catatan**  
Anda juga dapat menghentikan unggahan multibagian tertentu. Untuk informasi selengkapnya, lihat [Menggunakan AWS SDKs (API tingkat rendah)](#abort-mpu-low-level). 

------

## Menggunakan AWS SDKs (API tingkat rendah)
<a name="abort-mpu-low-level"></a>

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](mpuoverview.md).

------
#### [ Java ]

Untuk menghentikan unggahan multibagian tertentu yang sedang berlangsung menggunakan AWS SDK for Java, Anda dapat menggunakan API tingkat rendah untuk membatalkan unggahan dengan memberikan nama bucket, kunci objek, dan ID unggah.

**catatan**  
Alih-alih membatalkan unggahan multibagian tertentu, Anda dapat menghentikan semua unggahan multibagian 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 SDKs (API tingkat tinggi)](#abort-mpu-high-level).

*Untuk contoh cara membatalkan unggahan multibagian tertentu dengan AWS SDK for Java, lihat [Membatalkan unggahan multibagian](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_AbortMultipartUpload_section.html) 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 SDKs (API tingkat rendah)](mpu-upload-object.md#mpu-upload-low-level).

```
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 SDKs (API tingkat tinggi)](#abort-mpu-high-level).

------
#### [ 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 for Ruby API, [AWS buka SDK for Ruby](https://docs.aws.amazon.com/sdkforruby/api/index.html) - Versi 2. Contoh metode `abortMultipartUpload()`. 

Untuk informasi selengkapnya tentang AWS SDK for Ruby API, [AWS buka SDK for Ruby](https://docs.aws.amazon.com/sdkforruby/api/index.html) - 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,
]);
```

------