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 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, 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 pengunggahan multipart yang sedang berlangsung di Amazon S3 menggunakan, REST API AWS Command Line Interface, atau AWS SDK.

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

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

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

Untuk informasi selengkapnya tentang menggunakan REST API untuk menghentikan upload multipart, lihat [ AbortMultipartUpload ](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html) Refer * ensi API Layanan * Penyimpanan Sederhana Amazon.

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

------
#### [ 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. | 

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

Untuk contoh cara membatalkan upload multipart dengan AWS SDK untuk Java, lihat Mem [ batalkan upload multipart ](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_AbortMultipartUpload_section.html) 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 ](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) 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);
            }
        } 
    }
}
```

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

------

## Menggunakan AWS SDK (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 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.

**catatan**  
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)](#abort-mpu-high-level).

Untuk contoh cara membatalkan unggahan multipart tertentu dengan AWS SDK untuk Java, lihat Mem [ batalkan unggahan multipart ](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 SDK (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 SDK (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 untuk Ruby API, buka [AWS SDK untuk Ruby - Versi 2](https://docs.aws.amazon.com/sdkforruby/api/index.html). Contoh metode `abortMultipartUpload()`. 

Untuk informasi selengkapnya tentang AWS SDK untuk Ruby API, buka [AWS SDK untuk Ruby - Versi 2](https://docs.aws.amazon.com/sdkforruby/api/index.html).

```
 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,
]);
```

------