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

# GetItem
<a name="API_GetItem_v20111205"></a>

**penting**  
***This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.***  
 **Untuk dokumentasi tentang API tingkat rendah saat ini, lihat [Referensi API Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**

## Deskripsi
<a name="API_GetItem_Description"></a>

Operasi `GetItem` mengembalikan sekumpulan `Attributes` untuk item yang cocok dengan kunci primer. Jika tidak ada item yang cocok, `GetItem` tidak mengembalikan data apa pun.

Operasi `GetItem` menyediakan bacaan akhir konsisten secara default. Jika bacaan akhir konsisten tidak dapat diterima untuk aplikasi Anda, gunakan `ConsistentRead`. Meskipun operasi ini mungkin memakan waktu lebih lama dari baca standar, operasi ini selalu mengembalikan nilai yang terakhir diperbarui. Untuk informasi selengkapnya, lihat [DynamoDB membaca konsistensi](HowItWorks.ReadConsistency.md).

## Permintaan
<a name="API_GetItem_RequestParameters"></a>

### Sintaks
<a name="API_GetItem_RequestParameters.syntax"></a>

```
// This header is abbreviated.
// For a sample of a complete header, see API tingkat rendah DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.GetItem
content-type: application/x-amz-json-1.0 

{"TableName":"Table1",
 	"Key": 
		{"HashKeyElement": {"S":"AttributeValue1"},
		"RangeKeyElement": {"N":"AttributeValue2"} 
	},
	"AttributesToGet":["AttributeName3","AttributeName4"],
	"ConsistentRead":Boolean
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang berisi item yang diminta.  Jenis: String  |  Ya  | 
|  Key  | Nilai kunci primer yang menentukan item. Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Jenis: Peta `HashKeyElement` ke nilainya dan `RangeKeyElement` ke nilainya. | Ya | 
| AttributesToGet  | Array Nama atribut. Jika nama atribut tidak ditentukan, semua atribut akan dikembalikan. Jika beberapa atribut tidak ditemukan, atribut tersebut tidak akan muncul dalam hasil.Jenis: Array | Tidak | 
| ConsistentRead  | Jika diatur ke `true`, bacaan yang konsisten akan diterbitkan. Jika tidak, bacaan akhir konsisten akan digunakan.Jenis: Boolean | Tidak | 

## Respons
<a name="API_GetItem_ResponseElements"></a>

### Sintaks
<a name="API_GetItem_ResponseElements.syntax"></a>

```
HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0
content-length: 144

{"Item":{
	"AttributeName3":{"S":"AttributeValue3"},
	"AttributeName4":{"N":"AttributeValue4"},
	"AttributeName5":{"B":"dmFsdWU="}
	},
"ConsumedCapacityUnits": 0.5
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Item  | Berisi atribut yang diminta.Jenis: Peta pasangan nama-nilai atribut. | 
| ConsumedCapacityUnits | Jumlah unit kapasitas baca yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Permintaan untuk item yang tidak ada yang mengonsumsi unit kapasitas baca minimum, tergantung jenis baca. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Angka | 

## Kesalahan khusus
<a name="API_GetItem_SpecialErrors"></a>

Tidak ada kesalahan khusus untuk operasi ini.

## Contoh
<a name="API_GetItem_Examples"></a>

 Untuk contoh menggunakan AWS SDK, lihat[Bekerja dengan item dan atribut di DynamoDB](WorkingWithItems.md).

### Permintaan sampel
<a name="API_GetItem_Examples_Request"></a>

```
// This header is abbreviated.
// For a sample of a complete header, see API tingkat rendah DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.GetItem
content-type: application/x-amz-json-1.0 

{"TableName":"comptable",
	"Key":
		{"HashKeyElement":{"S":"Julie"},
		"RangeKeyElement":{"N":"1307654345"}},
	"AttributesToGet":["status","friends"],
	"ConsistentRead":true
}
```

### Respons sampel
<a name="API_GetItem_Examples_Response"></a>

Perhatikan ConsumedCapacityUnits nilainya adalah 1, karena parameter opsional `ConsistentRead` diatur ke`true`. Jika `ConsistentRead` disetel ke `false` (atau tidak ditentukan) untuk permintaan yang sama, respons pada akhirnya konsisten dan ConsumedCapacityUnits nilainya akan menjadi 0,5.

```
HTTP/1.1 200 
x-amzn-RequestId: 8966d095-71e9-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0
content-length: 72

{"Item":
	{"friends":{"SS":["Lynda, Aaron"]},
	"status":{"S":"online"}
	},
"ConsumedCapacityUnits": 1
}
```