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

# GetObject (API SABUN)
<a name="SOAPGetObject"></a>

**catatan**  
 SOAP API untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDK. 

`GetObject`Operasi mengembalikan versi objek saat ini. Jika Anda mencoba ke `GetObject` objek yang memiliki penanda hapus sebagai versi saat ini, S3 mengembalikan kesalahan 404. Anda tidak dapat menggunakan SOAP API untuk mengambil versi objek tertentu. Untuk melakukannya, gunakan REST API. Untuk informasi selengkapnya, lihat Pem [ buatan versi. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html) Untuk opsi lainnya, gunakan [GetObjectExtended (API SABUN)](SOAPGetObjectExtended.md) operasi.

**catatan**  
Nama kunci objek dengan nilai “soap” tidak didukung untuk [permintaan bergaya yang dihosting virtual](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access). Untuk nilai nama kunci objek di mana “soap” digunakan, [URL bergaya jalur](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access) harus digunakan sebagai gantinya.

**Example**  
Contoh ini mendapatkan objek “Nelson” dari bucket “quote”.  
`Sample Request`  

```
 1. <GetObject xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2.   <Bucket>quotes</Bucket>
 3.   <Key>Nelson</Key>
 4.   <GetMetadata>true</GetMetadata>
 5.   <GetData>true</GetData>
 6.   <InlineData>true</InlineData>
 7.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
 8.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
 9.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
10. </GetObject>
```
`Sample Response`  

```
 1. <GetObjectResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
 2.   <GetObjectResponse>
 3.     <Status>
 4.       <Code>200</Code>
 5.       <Description>OK</Description>
 6.     </Status>
 7.     <Metadata>
 8.       <Name>Content-Type</Name>
 9.       <Value>text/plain</Value>
10.     </Metadata>
11.     <Metadata>
12.       <Name>family</Name>
13.       <Value>Muntz</Value>
14.     </Metadata>
15.     <Data>aGEtaGE=</Data>
16.     <LastModified>2006-01-01T12:00:00.000Z</LastModified>
17.     <ETag>&quot;828ef3fdfa96f00ad9f27c383fc9ac7f&quot;</ETag>
18.   </GetObjectResponse>
19. </GetObjectResponse>
```

## Elemen
<a name="SOAPGetObjectElements"></a>
+ `Bucket:`Ember dari mana untuk mengambil objek.
+ `Key:`Kunci yang mengidentifikasi objek.
+ `GetMetadata:`Metadata dikembalikan dengan objek jika ini benar.
+ `GetData:`Data objek dikembalikan jika ini benar.
+ `InlineData:`Jika ini benar, maka data dikembalikan, basis 64 dikodekan, sebagai bagian dari badan SOAP dari respons. Jika salah, maka data dikembalikan sebagai lampiran SOAP. InlineData Opsi ini tidak cocok untuk digunakan dengan benda besar. Sistem membatasi operasi ini untuk bekerja dengan 1MB data atau kurang. Per GetObject mintaan dengan set InlineData bendera akan gagal dengan kode `InlineDataTooLargeError` status jika parameter Data yang dihasilkan akan dikodekan lebih dari 1MB. Untuk mengunduh objek besar, pertimbangkan untuk memanggil GetObject tanpa menyet InlineData el flag, atau gunakan REST API sebagai gantinya.

## Elemen yang dikembalikan
<a name="SOAPGetObjectReturnedElements"></a>
+ `Metadata:`Metadata berpasangan nama-nilai disimpan dengan objek.
+ `Data:`Jika InlineData benar dalam permintaan, ini berisi data objek yang dikodekan basis 64.
+ `LastModified:`Waktu objek disimpan di Amazon S3.
+ `ETag:`Tag entitas objek. Ini adalah hash dari objek yang dapat digunakan untuk melakukan perolehan bersyarat. ETag hanya mencerminkan perubahan pada konten objek, bukan metadatanya.

## Kontrol Akses
<a name="SOAPGetObjectAccessControl"></a>

Anda dapat membaca objek hanya jika Anda telah diberikan `READ` akses ke objek.

## UNDUHAN SOAP Terpotong dan Dapat Dilanjutkan
<a name="SOAPResumableDownloads"></a>

Untuk memberikan `GET` fleksibilitas, Amazon S3 mendukung unduhan yang dipotong dan dapat dilanjutkan.

Pilih dari yang berikut ini:
+ Untuk unduhan objek besar, Anda mungkin ingin memecahnya menjadi potongan-potongan yang lebih kecil. Untuk informasi selengkapnya, lihat [Rentang GET](#SOAPRangeGETs) 
+ Untuk `GET` operasi yang gagal, Anda dapat merancang aplikasi Anda untuk mengunduh sisanya, bukan seluruh file. Untuk informasi selengkapnya, lihat [REST GET Pemulihan Kesalahan](#SOAPGETErrorRecovery)

### Rentang GET
<a name="SOAPRangeGETs"></a>

Untuk beberapa klien, Anda mungkin ingin memecah unduhan besar menjadi unduhan yang lebih kecil. Untuk memecah GET menjadi unit yang lebih kecil, gunakan Range. 

Sebelum Anda dapat memecah GET menjadi unit yang lebih kecil, Anda harus menentukan ukurannya. Misalnya, permintaan berikut mendapatkan ukuran objek bigfile. 

```
1. <ListBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
2.   <Bucket>bigbucket</Bucket>
3.   <Prefix>bigfile</Prefix>
4.   <MaxKeys>1</MaxKeys>
5.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
6.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
7.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
8. </ListBucket>
```

Amazon S3 mengembalikan respons berikut.

```
 1. <ListBucketResult xmlns="https://s3.amazonaws.com/doc/2006-03-01">
 2.   <Name>quotes</Name>
 3.   <Prefix>N</Prefix>
 4.   <MaxKeys>1</MaxKeys>
 5.   <IsTruncated>false</IsTruncated>
 6.   <Contents>
 7.     <Key>bigfile</Key>
 8.     <LastModified>2006-01-01T12:00:00.000Z</LastModified>
 9.     <ETag>&quot;828ef3fdfa96f00ad9f27c383fc9ac7f&quot;</ETag>
10.     <Size>2023276</Size>
11.     <StorageClass>STANDARD</StorageClass>
12.     <Owner>
13.       <ID>bcaf1ffd86f41161ca5fb16fd081034f</ID>
14.       <DisplayName>bigfile</DisplayName>
15.      </Owner>
16.   </Contents>
17. </ListBucketResult>
```

Berikut ini adalah permintaan yang mengunduh megabyte pertama dari objek bigfile. 

```
 1. <GetObject xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2.   <Bucket>bigbucket</Bucket>
 3.   <Key>bigfile</Key>
 4.   <GetMetadata>true</GetMetadata>
 5.   <GetData>true</GetData>
 6.   <InlineData>true</InlineData>
 7.   <ByteRangeStart>0</ByteRangeStart>
 8.   <ByteRangeEnd>1048576</ByteRangeEnd>
 9.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
10.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
11.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
12. </GetObject>
```

Amazon S3 mengembalikan megabyte pertama dari file dan Etag file.

```
 1. <GetObjectResponse xmlns="http://s3.amazonaws.com/doc/2006-03-01">
 2.   <GetObjectResponse>
 3.     <Status>
 4.       <Code>200</Code>
 5.       <Description>OK</Description>
 6.     </Status>
 7.     <Metadata>
 8.       <Name>Content-Type</Name>
 9.       <Value>text/plain</Value>
10.     </Metadata>
11.     <Metadata>
12.       <Name>family</Name>
13.       <Value>Muntz</Value>
14.     </Metadata>
15.     <Data>--first megabyte of bigfile--</Data>
16.     <LastModified>2006-01-01T12:00:00.000Z</LastModified>
17.     <ETag>"828ef3fdfa96f00ad9f27c383fc9ac7f"</ETag>
18.   </GetObjectResponse>
19. </GetObjectResponse>
```

Untuk memastikan file tidak berubah sejak bagian sebelumnya diunduh, tentukan IfMatch elemen. Meskipun IfMatch elemen tidak diperlukan, disarankan untuk konten yang cenderung berubah. 

Berikut ini adalah permintaan yang mendapatkan sisa file, menggunakan header IfMatch permintaan.

```
 1. <GetObject xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2.   <Bucket>bigbucket</Bucket>
 3.   <Key>bigfile</Key>
 4.   <GetMetadata>true</GetMetadata>
 5.   <GetData>true</GetData>
 6.   <InlineData>true</InlineData>
 7.   <ByteRangeStart>10485761</ByteRangeStart>
 8.   <ByteRangeEnd>2023276</ByteRangeEnd>
 9.   <IfMatch>"828ef3fdfa96f00ad9f27c383fc9ac7f"</IfMatch>
10.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
11.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
12.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
13. </GetObject>
```

Amazon S3 mengembalikan respons berikut dan sisa file.

```
 1. <GetObjectResponse xmlns="http://s3.amazonaws.com/doc/2006-03-01">
 2.   <GetObjectResponse>
 3.     <Status>
 4.       <Code>200</Code>
 5.       <Description>OK</Description>
 6.     </Status>
 7.     <Metadata>
 8.       <Name>Content-Type</Name>
 9.       <Value>text/plain</Value>
10.     </Metadata>
11.     <Metadata>
12.       <Name>family</Name>
13.       <Value>>Muntz</Value>
14.     </Metadata>
15.     <Data>--remainder of bigfile--</Data>
16.     <LastModified>2006-01-01T12:00:00.000Z</LastModified>
17.     <ETag>"828ef3fdfa96f00ad9f27c383fc9ac7f"</ETag>
18.   </GetObjectResponse>
19. </GetObjectResponse>
```

### Berversi GetObject
<a name="SOAPResumableDownloads-versioned-getobject"></a>

Permintaan berikut mengembalikan versi objek yang ditentukan dalam bucket. 

```
 1. <GetObject xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2. <Bucket>quotes</Bucket>
 3. <Key>Nelson</Key>
 4. <GetMetadata>true</GetMetadata>
 5. <GetData>true</GetData>
 6. <InlineData>true</InlineData>
 7. <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
 8. <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
 9. <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
10. </GetObject>
```

Contoh Respons

```
 1. <GetObjectResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
 2. <GetObjectResponse>
 3. <Status>
 4. <Code>200</Code>
 5. <Description>OK</Description>
 6. </Status>
 7. <Metadata>
 8. <Name>Content-Type</Name>
 9. <Value>text/plain</Value>
10. </Metadata>
11. <Metadata>
12. <Name>family</Name>
13. <Value>Muntz</Value>
14. </Metadata>
15. <Data>aGEtaGE=</Data>
16. <LastModified>2006-01-01T12:00:00.000Z</LastModified>
17. <ETag>&quot;828ef3fdfa96f00ad9f27c383fc9ac7f&quot;</ETag>
18. </GetObjectResponse>
19. </GetObjectResponse>
```

### REST GET Pemulihan Kesalahan
<a name="SOAPGETErrorRecovery"></a>

Jika objek GET gagal, Anda bisa mendapatkan sisa file dengan menentukan rentang untuk diunduh. Untuk melakukannya, Anda harus mendapatkan ukuran objek menggunakan `ListBucket` dan melakukan rentang `GET` pada sisa file. Untuk informasi selengkapnya, lihat [GetObjectExtended (API SABUN)](SOAPGetObjectExtended.md).

### Sumber Daya Terkait
<a name="SOAPGettingObjectsRelatedTopics"></a>

[Operasi pada Objek (SOAP API)](SOAPObjectsOps.md)