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

# Versi API DynamoDB tingkat rendah sebelumnya (2011-12-05)
<a name="Appendix.APIv20111205"></a>

Bagian ini mendokumentasikan operasi yang tersedia dalam versi API tingkat rendah DynamoDB sebelumnya (2011-12-05). Versi API tingkat rendah ini dipertahankan untuk kompatibilitas mundur dengan aplikasi yang ada.

**Aplikasi baru harus menggunakan versi API terkini (2012-08-10)**. Untuk informasi selengkapnya, lihat [Referensi API DynamoDB](CurrentAPI.md).

**catatan**  
Sebaiknya Anda memigrasikan aplikasi Anda ke API versi terbaru (2012-08-10), karena fitur DynamoDB baru tidak akan di-backport ke versi API sebelumnya.

**Topics**
+ [BatchGetItem](API_BatchGetItem_v20111205.md)
+ [BatchWriteItem](API_BatchWriteItem_v20111205.md)
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DeleteItem](API_DeleteItem_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [GetItem](API_GetItem_v20111205.md)
+ [ListTables](API_ListTables_v20111205.md)
+ [PutItem](API_PutItem_v20111205.md)
+ [Kueri](API_Query_v20111205.md)
+ [Scan](API_Scan_v20111205.md)
+ [UpdateItem](API_UpdateItem_v20111205.md)
+ [UpdateTable](API_UpdateTable_v20111205.md)

# BatchGetItem
<a name="API_BatchGetItem_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_BatchGetItem_Description"></a>

Operasi `BatchGetItem` mengembalikan atribut untuk beberapa item dari sejumlah tabel menggunakan kunci primernya. Jumlah maksimum item yang dapat diambil untuk suatu operasi adalah 100. Selain itu, jumlah item yang diambil dibatasi pada ukuran 1 MB. Jika batas ukuran respons terlampaui atau hasil parsial dikembalikan karena throughput yang disediakan tabel terlampaui, atau karena kegagalan pemrosesan internal, DynamoDB mengembalikan nilai `UnprocessedKeys` agar Anda dapat mengulangi operasi, dimulai dengan item berikutnya untuk didapatkan. DynamoDB secara otomatis menyesuaikan jumlah item yang dikembalikan per halaman untuk memberlakukan batas ini. Misalnya, meskipun Anda meminta untuk mengambil 100 item, tetapi setiap item berukuran 50 KB, sistem akan mengembalikan 20 item dan nilai `UnprocessedKeys` yang sesuai agar Anda dapat memperoleh halaman hasil berikutnya. Jika diinginkan, aplikasi Anda dapat menyertakan logikanya sendiri untuk menyusun halaman hasil menjadi satu set.

Jika tidak ada item yang dapat diproses karena throughput yang disediakan tidak memadai pada setiap tabel yang terlibat dalam permintaan, DynamoDB akan mengembalikan kesalahan `ProvisionedThroughputExceededException`. 

**catatan**  
Secara default, `BatchGetItem` melakukan bacaan akhir konsisten di setiap tabel dalam permintaan. Anda dapat mengatur parameter `ConsistentRead` menjadi `true`, sesuai tiap tabelnya, jika Anda ingin pembacaan yang konsisten.  
`BatchGetItem` mengambil item secara paralel untuk meminimalkan latensi respons.  
Saat merancang aplikasi Anda, ingatlah bahwa DynamoDB tidak menjamin bahwa pengurutan atribut dilakukan sesuai respons yang dikembalikan. Sertakan nilai kunci primer di `AttributesToGet` untuk item dalam permintaan Anda guna membantu menguraikan respons berdasarkan item.   
Jika item yang diminta tidak ada, respons untuk item tersebut tidak mengembalikan apa pun. Permintaan untuk item yang tidak ada menggunakan unit kapasitas baca minimum sesuai dengan jenis pembacaan. Untuk informasi selengkapnya, lihat [Ukuran dan format item DynamoDB](CapacityUnitCalculations.md).

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

### Sintaks
<a name="API_BatchGetItem_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.BatchGetItem 
content-type: application/x-amz-json-1.0 

{"RequestItems":
    {"Table1": 
        {"Keys": 
            [{"HashKeyElement": {"S":"KeyValue1"}, "RangeKeyElement":{"N":"KeyValue2"}},
            {"HashKeyElement": {"S":"KeyValue3"}, "RangeKeyElement":{"N":"KeyValue4"}},
            {"HashKeyElement": {"S":"KeyValue5"}, "RangeKeyElement":{"N":"KeyValue6"}}],
        "AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]},
    "Table2": 
        {"Keys": 
            [{"HashKeyElement": {"S":"KeyValue4"}}, 
            {"HashKeyElement": {"S":"KeyValue5"}}],
        "AttributesToGet": ["AttributeName4", "AttributeName5", "AttributeName6"]
        }
    }
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  RequestItems  | Sebuah kontainer nama tabel dan item yang sesuai untuk mendapatkan kunci primer. Saat meminta item, setiap nama tabel hanya dapat diinvokasi sekali per operasi.Jenis: String Default: Tidak Ada  |  Ya | 
| Table |  Nama tabel yang berisi item untuk didapatkan. Entri hanyalah string yang menentukan tabel yang sudah ada tanpa label. Jenis: String  Default: Tidak Ada   | Ya | 
| Table:Keys  |  Nilai kunci primer yang menentukan item dalam tabel yang ditentukan. Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey). Jenis: Kunci   | Ya | 
| Table:AttributesToGet  |  Array Nama atribut dalam tabel yang ditentukan. Jika nama atribut tidak ditentukan, semua atribut akan dikembalikan. Jika beberapa atribut tidak ditemukan, atribut tersebut tidak akan muncul dalam hasil.  Jenis: Array   | Tidak | 
| Table:ConsistentRead  |  Jika diatur ke `true`, bacaan yang konsisten akan diterbitkan. Jika tidak, bacaan akhir konsisten akan digunakan. Jenis: Boolean   | Tidak | 

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

### Sintaks
<a name="API_BatchGetItem_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: 855

{"Responses":
    {"Table1":
        {"Items":
        [{"AttributeName1": {"S":"AttributeValue"},
        "AttributeName2": {"N":"AttributeValue"},
        "AttributeName3": {"SS":["AttributeValue", "AttributeValue", "AttributeValue"]}
        },
        {"AttributeName1": {"S": "AttributeValue"},
        "AttributeName2": {"S": "AttributeValue"},
        "AttributeName3": {"NS": ["AttributeValue", "AttributeValue", "AttributeValue"]}
        }],
    "ConsumedCapacityUnits":1},
    "Table2": 
        {"Items":
        [{"AttributeName1": {"S":"AttributeValue"},
        "AttributeName2": {"N":"AttributeValue"},
        "AttributeName3": {"SS":["AttributeValue", "AttributeValue", "AttributeValue"]}
        },
        {"AttributeName1": {"S": "AttributeValue"},
        "AttributeName2": {"S": "AttributeValue"},
        "AttributeName3": {"NS": ["AttributeValue", "AttributeValue","AttributeValue"]}
        }],
    "ConsumedCapacityUnits":1}
    },
    "UnprocessedKeys":
        {"Table3": 
        {"Keys": 
            [{"HashKeyElement": {"S":"KeyValue1"}, "RangeKeyElement":{"N":"KeyValue2"}},
            {"HashKeyElement": {"S":"KeyValue3"}, "RangeKeyElement":{"N":"KeyValue4"}},
            {"HashKeyElement": {"S":"KeyValue5"}, "RangeKeyElement":{"N":"KeyValue6"}}],
        "AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]}
        }
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
| Responses  | Nama tabel dan setiap atribut item dari tabel.Jenis: Peta  | 
| Table |  Nama tabel yang berisi item. Entri hanyalah string yang menentukan tabel tanpa label.Jenis: String  | 
| Items  | Kontainer untuk nama dan nilai atribut yang memenuhi parameter operasi.Jenis: Peta nama atribut serta nilai dan jenis data. | 
| ConsumedCapacityUnits | Jumlah unit kapasitas baca yang dikonsumsi, untuk setiap tabel. 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 | 
| UnprocessedKeys | Berisi array tabel dan masing-masing kuncinya yang tidak diproses dengan respons terkini, kemungkinan karena mencapai batas ukuran respons. Nilai `UnprocessedKeys` memiliki format yang sama dengan parameter `RequestItems` (sehingga nilai dapat diberikan langsung ke operasi `BatchGetItem` berikutnya). Untuk informasi selengkapnya, lihat parameter `RequestItems` di atas.Jenis: Array  | 
| UnprocessedKeys: Table: Keys  | Nilai atribut kunci primer yang menentukan item dan atribut yang terkait dengan item. Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Jenis: Array pasangan nama-nilai atribut.  | 
| UnprocessedKeys: Table: AttributesToGet  |  Nama atribut dalam tabel yang ditentukan. Jika nama atribut tidak ditentukan, semua atribut akan dikembalikan. Jika beberapa atribut tidak ditemukan, atribut tersebut tidak akan muncul dalam hasil.  Jenis: Array nama atribut.  | 
| UnprocessedKeys: Table: ConsistentRead  |  Jika diatur menjadi `true`, bacaan konsisten digunakan untuk tabel tertentu. Jika tidak, bacaan akhir konsisten akan digunakan. Jenis: Boolean.  | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
| ProvisionedThroughputExceededException  | Throughput tersedia maksimum milik Anda telah terlampaui.  | 

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

Contoh berikut menunjukkan permintaan HTTP POST dan respon menggunakan BatchGetItem operasi. Untuk contoh menggunakan AWS SDK, lihat[Bekerja dengan item dan atribut di DynamoDB](WorkingWithItems.md).

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

Contoh berikut meminta atribut dari dua tabel yang berbeda.

```
// 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.BatchGetItem 
content-type: application/x-amz-json-1.0 
content-length: 409

{"RequestItems":
    {"comp1":
        {"Keys":
            [{"HashKeyElement":{"S":"Casey"},"RangeKeyElement":{"N":"1319509152"}},
            {"HashKeyElement":{"S":"Dave"},"RangeKeyElement":{"N":"1319509155"}},
            {"HashKeyElement":{"S":"Riley"},"RangeKeyElement":{"N":"1319509158"}}],
        "AttributesToGet":["user","status"]},
    "comp2":
        {"Keys":
            [{"HashKeyElement":{"S":"Julie"}},{"HashKeyElement":{"S":"Mingus"}}],
        "AttributesToGet":["user","friends"]}
    }
}
```

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

Sampel berikut ini adalah responsnya.

```
HTTP/1.1 200 OK
x-amzn-RequestId: GTPQVRM4VJS792J1UFJTKUBVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0 
content-length: 373
Date: Fri, 02 Sep 2011 23:07:39 GMT

{"Responses":
    {"comp1":
        {"Items":
            [{"status":{"S":"online"},"user":{"S":"Casey"}},
            {"status":{"S":"working"},"user":{"S":"Riley"}},
            {"status":{"S":"running"},"user":{"S":"Dave"}}],
        "ConsumedCapacityUnits":1.5},
    "comp2":
        {"Items":
            [{"friends":{"SS":["Elisabeth", "Peter"]},"user":{"S":"Mingus"}},
            {"friends":{"SS":["Dave", "Peter"]},"user":{"S":"Julie"}}],
        "ConsumedCapacityUnits":1}
    },
    "UnprocessedKeys":{}
}
```

# BatchWriteItem
<a name="API_BatchWriteItem_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_BatchWriteItems_Description"></a>

Operasi ini memungkinkan Anda untuk menempatkan atau menghapus beberapa item di beberapa tabel dalam satu panggilan. 

Untuk mengunggah satu item, Anda dapat menggunakan `PutItem`, dan untuk menghapus satu item, Anda dapat menggunakan `DeleteItem`. Namun, jika Anda ingin mengunggah atau menghapus sejumlah besar data, seperti mengunggah sejumlah besar data dari Amazon EMR (Amazon EMR) atau memigrasi data dari basis data lain ke DynamoDB, `BatchWriteItem` menawarkan alternatif yang efisien. 

Jika Anda menggunakan bahasa seperti Java, Anda dapat menggunakan thread untuk mengunggah item secara paralel. Hal ini menambah kompleksitas dalam aplikasi Anda untuk menangani thread. Bahasa lain tidak mendukung threading. Misalnya, jika Anda menggunakan PHP, Anda harus mengunggah atau menghapus item satu per satu. Dalam kedua situasi tersebut, `BatchWriteItem` menyediakan alternatif, yaitu pemrosesan operasi penempatan dan penghapusan yang ditentukan dilakukan secara paralel, sehingga bisa melakukan pendekatan thread pool tanpa harus menambah kompleksitas dalam aplikasi Anda. 

Perhatikan bahwa setiap penempatan dan penghapusan individual yang ditentukan dalam operasi `BatchWriteItem` memiliki biaya yang sama dalam hal unit kapasitas yang dikonsumsi. Namun, karena `BatchWriteItem` melakukan operasi yang ditentukan secara paralel, Anda mendapatkan latensi yang lebih rendah. Operasi hapus pada item yang tidak ada mengonsumsi 1 unit kapasitas tulis. Untuk informasi selengkapnya tentang unit kapasitas yang dikonsumsi, lihat [Bekerja dengan tabel dan data di DynamoDB](WorkingWithTables.md).

Saat menggunakan `BatchWriteItem`, perhatikan batasan berikut:
+ **Operasi maksimum dalam satu permintaan—**Anda dapat menentukan total hingga 25 operasi penempatan atau penghapusan; tetapi, ukuran total permintaan tidak boleh melebihi 1 MB (payload HTTP). 
+ Anda dapat menggunakan operasi `BatchWriteItem` hanya untuk menempatkan dan menghapus item. Anda tidak dapat menggunakannya untuk memperbarui item yang ada.
+ **Bukan operasi atomik—**Operasi individual yang ditentukan dalam `BatchWriteItem` bersifat atomik; tetapi `BatchWriteItem` secara keseluruhan adalah operasi "upaya terbaik" dan bukan operasi atomik. Artinya, dalam permintaan `BatchWriteItem`, beberapa operasi mungkin berhasil dan yang lainnya mungkin gagal. Operasi yang gagal dikembalikan ke bidang `UnprocessedItems` dalam respons. Sejumlah kegagalan ini mungkin terjadi karena Anda melampaui throughput yang disediakan dan dikonfigurasi untuk tabel atau kegagalan sementara seperti kesalahan jaringan. Anda dapat menyelidiki dan mengirim ulang permintaan (opsional). Biasanya, Anda memanggil `BatchWriteItem` dalam satu loop serta di setiap pemeriksaan pengulangan untuk item yang belum diproses, dan mengirimkan permintaan `BatchWriteItem` baru dengan item yang belum diproses tersebut. 
+ **Tidak mengembalikan item apa pun—** `BatchWriteItem` dirancang untuk mengunggah data dalam jumlah besar secara efisien. Hal itu tidak menyediakan sejumlah kecanggihan yang ditawarkan oleh `PutItem` dan `DeleteItem`. Sebagai contoh, `DeleteItem` mendukung bidang `ReturnValues` dalam isi permintaan Anda untuk meminta item yang dihapus dalam respons. Operasi `BatchWriteItem` tidak mengembalikan item apa pun dalam respons.
+ Tidak seperti `PutItem` dan `DeleteItem`, `BatchWriteItem` tidak memungkinkan Anda untuk menentukan syarat pada permintaan tulis individu dalam operasi.
+ Nilai atribut tidak boleh null; atribut jenis string dan biner harus memiliki panjang lebih dari nol; dan atribut jenis set tidak boleh kosong. Permintaan yang memiliki nilai kosong akan ditolak dengan `ValidationException`.

DynamoDB menolak keseluruhan batch operasi penulisan jika salah satu dari yang berikut ini true: 
+ Jika satu atau beberapa tabel yang ditentukan dalam permintaan `BatchWriteItem` tidak ada.
+ Jika atribut kunci primer yang ditentukan pada item dalam permintaan tidak cocok dengan skema kunci primer dalam tabel yang sesuai.
+ Jika Anda mencoba untuk melakukan beberapa operasi pada item yang sama dalam permintaan `BatchWriteItem` yang sama. Misalnya, Anda tidak dapat menempatkan dan menghapus item yang sama dalam permintaan `BatchWriteItem` yang sama. 
+ Jika total ukuran permintaan melampaui batas ukuran permintaan 1 MB (payload HTTP).
+ Jika setiap item individu dalam suatu batch melampaui batas ukuran item 64 KB.

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

### Sintaks
<a name="API_BatchWriteItems_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.BatchGetItem 
content-type: application/x-amz-json-1.0 

{
  "RequestItems" :  RequestItems
} 

RequestItems
{
     "TableName1" :  [ Request, Request, ... ],
     "TableName2" :  [ Request, Request, ... ],
     ...
}

Request ::=
  PutRequest | DeleteRequest

PutRequest ::=
{
  "PutRequest" : {
     "Item" : {
        "Attribute-Name1" : Attribute-Value,
        "Attribute-Name2" : Attribute-Value,
         ...
     }
  }
}

DeleteRequest ::=
{
   "DeleteRequest" : {
      "Key" : PrimaryKey-Value
   }
}


PrimaryKey-Value ::= HashTypePK | HashAndRangeTypePK

HashTypePK ::=
{ 
   "HashKeyElement" : Attribute-Value
}

HashAndRangeTypePK
{ 
   "HashKeyElement" : Attribute-Value,
   "RangeKeyElement" : Attribute-Value, 
}

Attribute-Value ::= String | Numeric| Binary | StringSet | NumericSet | BinarySet 

Numeric ::=
{
   "N": "Number"
}

String ::=
{
   "S": "String"
}

Binary ::=
{
    "B": "Base64 encoded binary data"
}

StringSet ::=
{
   "SS": [ "String1", "String2", ... ]
}

NumberSet ::=
{
   "NS": [ "Number1", "Number2", ... ]
}  

BinarySet ::=
{
   "BS": [ "Binary1", "Binary2", ... ]
}
```

Dalam isi permintaan, objek JSON `RequestItems` menggambarkan operasi yang ingin Anda lakukan. Operasi dikelompokkan berdasarkan tabel. Anda dapat menggunakan `BatchWriteItem` untuk memperbarui atau menghapus beberapa item di beberapa tabel. Untuk setiap permintaan penulisan khusus, Anda harus mengidentifikasi jenis permintaan (`PutItem`, `DeleteItem`) diikuti dengan informasi terperinci tentang operasi tersebut. 
+ Untuk `PutRequest`, Anda memberikan item, yaitu daftar atribut dan nilai-nilainya.
+ Untuk `DeleteRequest`, Anda memberikan nama dan nilai kunci primernya. 

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

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

Berikut ini adalah sintaksis dari isi JSON yang dikembalikan dalam respons.

```
{
  "Responses" :         ConsumedCapacityUnitsByTable
  "UnprocessedItems" :  RequestItems
} 

ConsumedCapacityUnitsByTable
{
    "TableName1" : { "ConsumedCapacityUnits", : NumericValue },
    "TableName2" : { "ConsumedCapacityUnits", : NumericValue },
     ...
}

RequestItems
This syntax is identical to the one described in the JSON syntax in the request.
```

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

Tidak ada kesalahan khusus untuk operasi ini.

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

Contoh berikut menunjukkan permintaan HTTP POST dan respons operasi `BatchWriteItem`. Permintaan tersebut menentukan operasi berikut pada tabel Reply dan Thread:
+ Menempatkan item dan menghapus item dari tabel Reply
+ Menempatkan item ke dalam tabel Thread

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

### Permintaan sampel
<a name="API_BatchWriteItems_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.BatchGetItem 
content-type: application/x-amz-json-1.0 

{
  "RequestItems":{
    "Reply":[
      {
        "PutRequest":{
          "Item":{
            "ReplyDateTime":{
              "S":"2012-04-03T11:04:47.034Z"
            },
            "Id":{
              "S":"DynamoDB#DynamoDB Thread 5"
            }
          }
        }
      },
      {
        "DeleteRequest":{
          "Key":{
            "HashKeyElement":{
              "S":"DynamoDB#DynamoDB Thread 4"
            },
            "RangeKeyElement":{
              "S":"oops - accidental row"
            }
          }
        }
      }
    ],
    "Thread":[
      {
        "PutRequest":{
          "Item":{
            "ForumName":{
              "S":"DynamoDB"
            },
            "Subject":{
              "S":"DynamoDB Thread 5"
            }
          }
        }
      }
    ]
  }
}
```

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

Respons contoh berikut menunjukkan operasi penempatan pada tabel Thread dan Reply yang berhasil dan operasi penghapusan pada tabel Reply yang gagal (karena alasan seperti throttling yang disebabkan terlampauinya throughput yang disediakan di tabel). Perhatikan hal berikut dalam respons JSON:
+ Objek `Responses` menunjukkan satu unit kapasitas yang digunakan pada tabel `Thread` dan `Reply` sebagai hasil dari kesuksesan operasi penempatan pada setiap tabel ini. 
+ Objek `UnprocessedItems` menunjukkan kegagalan operasi penghapusan pada tabel `Reply`. Anda kemudian dapat mengeluarkan panggilan `BatchWriteItem` baru untuk mengatasi permintaan yang belum diproses ini.

```
HTTP/1.1 200 OK
x-amzn-RequestId: G8M9ANLOE5QA26AEUHJKJE0ASBVV4KQNSO5AEMVJF66Q9ASUAAJG
Content-Type: application/x-amz-json-1.0
Content-Length: 536
Date: Thu, 05 Apr 2012 18:22:09 GMT

{
   "Responses":{
      "Thread":{
         "ConsumedCapacityUnits":1.0
      },
      "Reply":{
         "ConsumedCapacityUnits":1.0
      }
   },
   "UnprocessedItems":{
      "Reply":[
         {
            "DeleteRequest":{
               "Key":{
                  "HashKeyElement":{
                     "S":"DynamoDB#DynamoDB Thread 4"
                  },
                  "RangeKeyElement":{
                     "S":"oops - accidental row"
                  }
               }
            }
         }
      ]
   }
}
```

# CreateTable
<a name="API_CreateTable_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_CreateTable_Description"></a>

Operasi `CreateTable` menambahkan tabel baru ke akun Anda.

Nama tabel harus unik di antara yang terkait dengan AWS Akun yang mengeluarkan permintaan, dan AWS wilayah yang menerima permintaan (seperti dynamodb.us-west-2.amazonaws.com). Setiap titik akhir DynamoDB bersifat independen sepenuhnya. Misalnya, jika Anda memiliki dua tabel yang disebut "MyTable,” satu di dynamodb.us-west-2.amazonaws.com dan satu di dynamodb.us-west-1.amazonaws.com, mereka sepenuhnya independen dan tidak berbagi data apa pun.

Operasi `CreateTable` memicu alur kerja asinkron untuk mulai membuat tabel. DynamoDB segera mengembalikan status tabel (`CREATING`) hingga tabel berada dalam status `ACTIVE`. Setelah tabel berada dalam status `ACTIVE`, Anda dapat melakukan operasi bidang data. 

Gunakan operasi [DescribeTables](API_DescribeTables_v20111205.md) untuk memeriksa status tabel. 

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

### Sintaks
<a name="API_CreateTable_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.CreateTable 
content-type: application/x-amz-json-1.0 

{"TableName":"Table1",
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang akan dibuat.Karakter yang diperbolehkan adalah a-z, A-Z, 0-9, '\$1' (garis bawah), '-' (tanda pisah), dan '.' (titik). Nama bisa berisi antara 3 dan 255 karakter. Jenis: String  |  Ya  | 
|  KeySchema  | Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk `HashKeyElement` diperlukan, dan pasangan nama-nilai untuk `RangeKeyElement` bersifat opsional (hanya diperlukan untuk kunci primer komposit). Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Nama elemen kunci primer dapat berisi antara 1 dan 255 karakter tanpa batasan karakter. Nilai yang mungkin untuk AttributeType adalah “S” (string), “N” (numerik), atau “B” (biner).Jenis: Peta `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | Ya | 
|  ProvisionedThroughput  | Throughput baru untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Untuk detailnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md).  Untuk nilai maksimum/minimum saat ini, lihat [Kuota di Amazon DynamoDB](ServiceQuotas.md). Jenis: Array  | Ya | 
| ProvisionedThroughput: ReadCapacityUnits |  Menetapkan jumlah minimum `ReadCapacityUnits` yang konsisten digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.  Operasi bacaan akhir konsisten memerlukan lebih sedikit usaha daripada operasi baca konsisten, jadi pengaturan 50 `ReadCapacityUnits` yang konsisten per detik akan menghasilkan 100 `ReadCapacityUnits` akhir konsisten per detik. Jenis: Angka  | Ya | 
| ProvisionedThroughput: WriteCapacityUnits | Menetapkan jumlah minimum WriteCapacityUnits yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya. Jenis: Angka  | Ya | 

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.310506263362E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"CREATING"
    }
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
| TableDescription  | Kontainer untuk properti tabel. | 
| CreationDateTime | Tanggal ketika tabel dibuat di [jangka waktu UNIX](http://www.epochconverter.com/).Jenis: Angka | 
| KeySchema  | Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk `HashKeyElement` diperlukan, dan pasangan nama-nilai untuk `RangeKeyElement` bersifat opsional (hanya diperlukan untuk kunci primer komposit). Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Jenis: Peta `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | 
| ProvisionedThroughput  |  Throughput untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk `ReadCapacityUnits` dan `WriteCapacityUnits`. Lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Array   | 
| ProvisionedThroughput :ReadCapacityUnits |  Jumlah minimum `ReadCapacityUnits` yang digunakan per detik sebelum DynamoDB menyeimbangkan beban dengan operasi lainnyaJenis: Angka  | 
| ProvisionedThroughput :WriteCapacityUnits |  Jumlah minimum `ReadCapacityUnits` yang digunakan per detik sebelum `WriteCapacityUnits` menyeimbangkan beban dengan operasi lainnyaJenis: Angka  | 
|  TableName  |  Nama tabel yang dibuat. Jenis: String  | 
|  TableStatus  | Status tabel saat ini (`CREATING`). Setelah tabel berada dalam status `ACTIVE`, Anda dapat menempatkan data di dalamnya.Gunakan API [DescribeTables](API_DescribeTables_v20111205.md) untuk memeriksa status tabel.Jenis: String | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
|  ResourceInUseException  | Mencoba untuk membuat kembali tabel yang sudah ada. | 
|  LimitExceededException  | Jumlah permintaan tabel simultan (jumlah kumulatif tabel dalam status `CREATING`, `DELETING` atau `UPDATING`) melampaui jumlah maksimum yang diizinkan. Untuk nilai maksimum/minimum saat ini, lihat [Kuota di Amazon DynamoDB](ServiceQuotas.md). .  | 

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

Contoh berikut membuat tabel dengan kunci primer komposit yang berisi string dan angka. Untuk contoh menggunakan AWS SDK, lihat[Bekerja dengan tabel dan data di DynamoDB](WorkingWithTables.md).

### Permintaan sampel
<a name="API_CreateTable_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.CreateTable 
content-type: application/x-amz-json-1.0


{"TableName":"comp-table",
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.310506263362E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
    "TableName":"comp-table",
    "TableStatus":"CREATING"
    }
}
```

## Tindakan terkait
<a name="API_CreateTable_Related_Actions"></a>
+  [DescribeTables](API_DescribeTables_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md)

# DeleteItem
<a name="API_DeleteItem_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_DeleteItem_Description"></a>

Menghapus satu item dalam tabel dengan kunci primer. Anda dapat melakukan operasi penghapusan bersyarat yang menghapus item jika ada, atau jika item memiliki nilai atribut yang diharapkan.

**catatan**  
Jika Anda menentukan `DeleteItem` tanpa atribut atau nilai, semua atribut untuk item tersebut akan dihapus.   
Kecuali jika Anda menentukan syarat, `DeleteItem` adalah operasi idempotensi; menjalankannya beberapa kali pada item atau atribut yang sama *tidak* menghasilkan respons kesalahan.  
Penghapusan bersyarat hanya berguna untuk menghapus item dan atribut jika syarat tertentu terpenuhi. Jika syarat terpenuhi, DynamoDB melakukan penghapusan. Jika tidak, item tersebut tidak akan dihapus.   
Anda dapat melakukan pemeriksaan bersyarat yang diharapkan pada satu atribut per operasi.

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

### Sintaks
<a name="API_DeleteItem_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.DeleteItem 
content-type: application/x-amz-json-1.0 

{"TableName":"Table1",
    "Key":
        {"HashKeyElement":{"S":"AttributeValue1"},"RangeKeyElement":{"N":"AttributeValue2"}},
    "Expected":{"AttributeName3":{"Value":{"S":"AttributeValue3"}}},
    "ReturnValues":"ALL_OLD"}
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang berisi item untuk dihapus. Jenis: String  |  Ya  | 
|  Key  | 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 | 
| Expected  | Menunjuk atribut untuk penghapusan bersyarat. Parameter `Expected` memungkinkan Anda untuk memberikan nama atribut, dan apakah DynamoDB harus memeriksa bahwa atribut memiliki nilai tertentu sebelum mengubahnya.Jenis: Peta nama atribut. | Tidak | 
| Expected:AttributeName  | Nama atribut untuk penempatan bersyarat. Jenis: String | Tidak | 
| Expected:AttributeName: ExpectedAttributeValue | Gunakan parameter ini untuk menentukan apakah nilai sudah ada atau belum untuk pasangan nama-nilai atribut. Notasi JSON berikut menghapus item jika atribut "Warna" tidak ada untuk item tersebut:<pre>"Expected" :<br />	{"Color":{"Exists":false}}</pre>Notasi JSON berikut memeriksa untuk melihat apakah atribut dengan nama "Warna" sudah memiliki nilai "Kuning" sebelum menghapus item tersebut: <pre>"Expected" : <br />	{"Color":{"Exists":true},{"Value":{"S":"Yellow"}}}</pre>Secara default, jika Anda menggunakan parameter `Expected` dan menyediakan `Value`, DynamoDB mengasumsikan bahwa atribut ada dan memiliki nilai terkini untuk diganti. Jadi Anda tidak perlu menentukan `{"Exists":true}`, karena hal tersebut sudah tersirat. Anda dapat mempersingkat permintaan untuk:<pre>"Expected" : <br />	{"Color":{"Value":{"S":"Yellow"}}}</pre> Jika Anda menentukan `{"Exists":true}` tanpa nilai atribut untuk diperiksa, DynamoDB mengembalikan kesalahan.  | Tidak | 
| ReturnValues  | Gunakan parameter ini jika Anda ingin mendapatkan pasangan nama-nilai atribut sebelum pasangan tersebut dihapus. Nilai parameter yang memungkinkan adalah `NONE` (default) atau `ALL_OLD`. Jika `ALL_OLD` ditentukan, isi item lama akan dikembalikan. Jika parameter ini tidak tersedia atau `NONE`, tidak ada yang dikembalikan.Jenis: String | Tidak | 

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 353
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"Attributes":
    {"AttributeName3":{"SS":["AttributeValue3","AttributeValue4","AttributeValue5"]},
    "AttributeName2":{"S":"AttributeValue2"},
    "AttributeName1":{"N":"AttributeValue1"}
    },
"ConsumedCapacityUnits":1
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Attributes  | Jika parameter `ReturnValues` disediakan sebagai `ALL_OLD` dalam permintaan, DynamoDB mengembalikan array pasangan nama-nilai atribut (pada dasarnya, item tersebut dihapus). Jika tidak, respons berisi sebuah set kosong. Jenis: Array pasangan nama-nilai atribut. | 
| ConsumedCapacityUnits | Jumlah unit kapasitas tulis yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Permintaan hapus pada item yang tidak ada mengonsumsi 1 unit kapasitas tulis. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Angka | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
|  ConditionalCheckFailedException  | Pemeriksaan bersyarat gagal. Nilai atribut yang diharapkan tidak ditemukan.  | 

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

### Permintaan sampel
<a name="API_DeleteItem_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.DeleteItem 
content-type: application/x-amz-json-1.0

{"TableName":"comp-table",
    "Key":
        {"HashKeyElement":{"S":"Mingus"},"RangeKeyElement":{"N":"200"}},
    "Expected":
        {"status":{"Value":{"S":"shopping"}}},
    "ReturnValues":"ALL_OLD"
}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: U9809LI6BBFJA5N2R0TB0P017JVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 353
Date: Tue, 12 Jul 2011 22:31:23 GMT

{"Attributes":
    {"friends":{"SS":["Dooley","Ben","Daisy"]},
    "status":{"S":"shopping"},
    "time":{"N":"200"},
    "user":{"S":"Mingus"}
    },
"ConsumedCapacityUnits":1
}
```

## Tindakan terkait
<a name="API_DeleteItem_Related_Actions"></a>
+  [PutItem](API_PutItem_v20111205.md) 

# DeleteTable
<a name="API_DeleteTable_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_DeleteTable_Description"></a>

Operasi `DeleteTable` menghapus tabel beserta semua itemnya. Setelah permintaan `DeleteTable`, tabel yang ditentukan berada dalam status `DELETING` hingga DynamoDB menyelesaikan penghapusan. Jika tabel berada dalam status `ACTIVE`, Anda dapat menghapusnya. Jika tabel berada dalam status `CREATING` atau `UPDATING`, DynamoDB mengembalikan kesalahan `ResourceInUseException`. Jika tabel yang ditentukan tidak ada, DynamoDB mengembalikan `ResourceNotFoundException`. Jika tabel sudah berada dalam status `DELETING`, tidak ada kesalahan yang dikembalikan. 

**catatan**  
DynamoDB dapat terus menerima permintaan operasi bidang data, seperti `GetItem` dan `PutItem`, pada tabel dalam status `DELETING` hingga penghapusan tabel selesai.

Tabel unik di antara yang terkait dengan AWS Akun yang mengeluarkan permintaan, dan AWS wilayah yang menerima permintaan (seperti dynamodb.us-west-1.amazonaws.com). Setiap titik akhir DynamoDB bersifat independen sepenuhnya. Misalnya, jika Anda memiliki dua tabel yang disebut "MyTable,” satu di dynamodb.us-west-2.amazonaws.com dan satu di dynamodb.us-west-1.amazonaws.com, mereka sepenuhnya independen dan tidak berbagi data apa pun; menghapus satu tidak menghapus yang lain.

Gunakan operasi [DescribeTables](API_DescribeTables_v20111205.md) untuk memeriksa status tabel. 

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

### Sintaks
<a name="API_DeleteTable_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.DeleteTable 
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |   Nama tabel yang akan dihapus.   Jenis: String   |  Ya  | 

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Sun, 14 Aug 2011 22:56:22 GMT

{"TableDescription":
    {"CreationDateTime":1.313362508446E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"DELETING"
    }
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
| TableDescription  | Kontainer untuk properti tabel. | 
| CreationDateTime | Tanggal ketika tabel dibuat.Jenis: Angka  | 
| KeySchema  | Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk `HashKeyElement` diperlukan, dan pasangan nama-nilai untuk `RangeKeyElement` bersifat opsional (hanya diperlukan untuk kunci primer komposit). Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Jenis: Peta `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | 
| ProvisionedThroughput  | Throughput untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk ReadCapacityUnits dan WriteCapacityUnits. Lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). | 
| ProvisionedThroughput: ReadCapacityUnits |  Jumlah minimum `ReadCapacityUnits` yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya. Jenis: Angka  | 
| ProvisionedThroughput: WriteCapacityUnits | Jumlah minimum `WriteCapacityUnits` yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.Jenis: Angka  | 
|  TableName  |  Nama tabel yang dihapus. Jenis: String   | 
|  TableStatus  | Status tabel saat ini (DELETING). Setelah tabel dihapus, permintaan berikutnya untuk tabel mengembalikan resource not found. Gunakan operasi [DescribeTables](API_DescribeTables_v20111205.md) untuk memeriksa status tabel. Jenis: String | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
|  ResourceInUseException  |  Tabel berada dalam status CREATING atau UPDATING dan tidak dapat dihapus.  | 

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

### Permintaan sampel
<a name="API_DeleteTable_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.DeleteTable
content-type: application/x-amz-json-1.0
content-length: 40

{"TableName":"favorite-movies-table"}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 160
Date: Sun, 14 Aug 2011 17:20:03 GMT

{"TableDescription":
    {"CreationDateTime":1.313362508446E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}},
    "TableName":"favorite-movies-table",
    "TableStatus":"DELETING"
}
```

## Tindakan terkait
<a name="API_DeleteTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md) 

# DescribeTables
<a name="API_DescribeTables_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_DescribeTables_Description"></a>

Mengembalikan informasi tentang tabel, termasuk status tabel saat ini, skema kunci utama dan kapan tabel dibuat. DescribeTable Hasilnya pada akhirnya konsisten. Jika Anda menggunakan DescribeTable terlalu dini dalam proses membuat tabel, DynamoDB mengembalikan sebuah. `ResourceNotFoundException` Jika Anda menggunakan DescribeTable terlalu dini dalam proses memperbarui tabel, nilai baru mungkin tidak segera tersedia.

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

### Sintaks
<a name="API_DescribeTables_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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"Table1"}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang akan dideskripsikan.  Jenis: String   |  Ya  | 

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

### Sintaks
<a name="API_DescribeTables_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: 543


{"Table":
    {"CreationDateTime":1.309988345372E9,
    ItemCount:1,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": Date, "LastDecreaseDateTime": Date, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableSizeBytes":1,
    "TableStatus":"ACTIVE"
    }
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Table  |  Kontainer untuk tabel yang sedang dideskripsikan. Jenis: String  | 
| CreationDateTime | Tanggal ketika tabel dibuat di [jangka waktu UNIX](http://www.epochconverter.com/). | 
|  ItemCount  |  Jumlah item dalam tabel yang ditentukan. DynamoDB memperbarui nilai ini kira-kira setiap enam jam. Perubahan terbaru mungkin tidak tercermin dalam nilai ini. Jenis: Angka  | 
|  KeySchema  | Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk HashKeyElement diperlukan, dan pasangan nama-nilai untuk RangeKeyElement bersifat opsional (hanya diperlukan untuk kunci primer komposit). Ukuran kunci hash maksimum adalah 2048 byte. Ukuran kunci rentang maksimum adalah 1024 byte. Kedua batas tersebut diberlakukan secara terpisah (yaitu Anda dapat memiliki kombinasi hash \$1 rentang 2048 \$1 1024 kunci). Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey). | 
| ProvisionedThroughput  | Throughput untuk tabel tertentu, yang terdiri dari nilai-nilai untuk LastIncreaseDateTime (jika berlaku), LastDecreaseDateTime (jika berlaku), ReadCapacityUnits, dan WriteCapacityUnits. Jika throughput untuk tabel tidak pernah meningkat atau berkurang, DynamoDB tidak mengembalikan nilai untuk elemen-elemen tersebut. Lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md).Jenis: Array  | 
|  TableName  |  Nama tabel yang diminta.  Jenis: String  | 
|  TableSizeBytes  |  Ukuran total tabel yang ditentukan, dalam byte. DynamoDB memperbarui nilai ini kira-kira setiap enam jam. Perubahan terbaru mungkin tidak tercermin dalam nilai ini. Jenis: Angka  | 
|  TableStatus  | Status tabel saat ini (CREATING, ACTIVE, DELETING, atau UPDATING). Setelah tabel berada dalam status ACTIVE, Anda dapat menambahkan data.  | 

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

Tidak ada kesalahan yang spesifik untuk operasi ini.

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

 Contoh berikut menunjukkan permintaan HTTP POST dan respon menggunakan DescribeTable operasi untuk tabel bernama “comp-table”. Tabel tersebut memiliki kunci primer komposit.

### Permintaan Sampel
<a name="API_DescribeTables_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.DescribeTable
content-type: application/x-amz-json-1.0

{"TableName":"users"}
```

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

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

{"Table":
    {"CreationDateTime":1.309988345372E9,
    "ItemCount":23,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":{"LastIncreaseDateTime": 1.309988345384E9, "ReadCapacityUnits":10,"WriteCapacityUnits":10},
    "TableName":"users",
    "TableSizeBytes":949,
    "TableStatus":"ACTIVE"
    }
}
```

## Tindakan terkait
<a name="API_DescribeTables_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md) 
+  [ListTables](API_ListTables_v20111205.md) 

# 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
}
```

# ListTables
<a name="API_ListTables_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_ListTables_Description"></a>

Mengembalikan array dari semua tabel yang terkait dengan akun dan titik akhir saat ini.

Setiap titik akhir DynamoDB bersifat independen sepenuhnya. Misalnya, jika Anda memiliki dua tabel yang disebut "MyTable,” satu di dynamodb.us-west-2.amazonaws.com dan satu di dynamodb.us-east-1.amazonaws.com, mereka sepenuhnya independen dan tidak berbagi data apa pun. ListTables Operasi mengembalikan semua nama tabel yang terkait dengan akun yang membuat permintaan, untuk titik akhir yang menerima permintaan.

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

### Sintaks
<a name="API_ListTables_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.ListTables
content-type: application/x-amz-json-1.0

{"ExclusiveStartTableName":"Table1","Limit":3}
```

 ListTables Operasi, secara default, meminta semua nama tabel yang terkait dengan akun yang membuat permintaan, untuk titik akhir yang menerima permintaan.


****  

|  Nama  |  Deskripsi  | Wajib | 
| --- | --- | --- | 
|  Limit  |  Jumlah maksimum nama tabel yang akan dikembalikan.  Jenis: Integer  | Tidak | 
| ExclusiveStartTableName  | Nama tabel yang memulai daftar. Jika Anda sudah menjalankan ListTables operasi dan menerima `LastEvaluatedTableName` nilai dalam respons, gunakan nilai itu di sini untuk melanjutkan daftar. Tipe: String | Tidak | 

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"TableNames":["Table1","Table2","Table3"], "LastEvaluatedTableName":"Table3"}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
|  TableNames  |  Nama-nama tabel yang terkait dengan akun saat ini pada titik akhir terkini.  Jenis: Array  | 
| LastEvaluatedTableName  | Nama tabel terakhir dalam daftar saat ini, hanya jika beberapa tabel untuk akun dan titik akhir belum dikembalikan. Nilai ini tidak ada dalam respons jika semua nama tabel sudah dikembalikan. Gunakan nilai ini sebagai `ExclusiveStartTableName` dalam permintaan baru untuk melanjutkan daftar hingga semua nama tabel dikembalikan.  Jenis: String  | 

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

Tidak ada kesalahan yang spesifik untuk operasi ini.

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

Contoh berikut menunjukkan permintaan HTTP POST dan respon menggunakan ListTables operasi.

### Permintaan sampel
<a name="API_ListTables_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.ListTables
content-type: application/x-amz-json-1.0

{"ExclusiveStartTableName":"comp2","Limit":3}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"LastEvaluatedTableName":"comp5","TableNames":["comp3","comp4","comp5"]}
```

## Tindakan terkait
<a name="API_ListTables_Related_Actions"></a>
+  [DescribeTables](API_DescribeTables_v20111205.md) 
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md) 

# PutItem
<a name="API_PutItem_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_PutItem_Description"></a>

Membuat item baru, atau menggantikan item lama dengan item baru (termasuk semua atributnya). Jika item sudah ada dalam tabel tertentu dengan kunci primer yang sama, item baru sepenuhnya menggantikan item yang ada. Anda dapat melakukan penempatan bersyarat (masukkan item baru jika salah satu dengan kunci primer yang ditentukan tidak ada), atau mengganti item yang ada jika memiliki nilai atribut tertentu. 

Nilai atribut tidak boleh null; atribut jenis string dan biner harus memiliki panjang lebih dari nol; dan atribut jenis set tidak boleh kosong. Permintaan dengan nilai kosong akan ditolak dengan `ValidationException`.

**catatan**  
Untuk memastikan bahwa item baru tidak menggantikan item yang ada, gunakan operasi penempatan bersyarat dengan mengatur `Exists` ke `false` untuk atribut kunci primer, atau atribut-atribut.

Untuk informasi selengkapnya tentang penggunaan `PutItem`, lihat [Bekerja dengan item dan atribut di DynamoDB](WorkingWithItems.md).

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

### Sintaks
<a name="API_PutItem_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.PutItem
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
    "Item":{
        "AttributeName1":{"S":"AttributeValue1"},
        "AttributeName2":{"N":"AttributeValue2"},
        "AttributeName5":{"B":"dmFsdWU="}
    },
    "Expected":{"AttributeName3":{"Value": {"S":"AttributeValue"}, "Exists":Boolean}},
    "ReturnValues":"ReturnValuesConstant"}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel untuk diisi item. Jenis: String  |  Ya  | 
|  Item  | Peta atribut untuk item, dan harus menyertakan nilai kunci primer yang menentukan item tersebut. Pasangan nama-nilai atribut lainnya dapat diberikan untuk item tersebut. Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Jenis: Peta nama atribut untuk nilai atribut. | Ya | 
| Expected  | Menunjuk atribut untuk penempatan bersyarat. Parameter `Expected` memungkinkan Anda untuk memberikan nama atribut, dan apakah DynamoDB harus memeriksa keberadaan nilai atribut; atau apakah nilai atribut ada dan memiliki nilai tertentu sebelum mengubahnya.Jenis: Peta nama atribut untuk nilai atribut, dan apakah nilai tersebut ada. | Tidak | 
| Expected:AttributeName  | Nama atribut untuk penempatan bersyarat.Jenis: String | Tidak | 
| Expected:AttributeName: ExpectedAttributeValue | Gunakan parameter ini untuk menentukan apakah nilai sudah ada atau belum untuk pasangan nama-nilai atribut. Notasi JSON berikut mengganti item jika atribut "Warna" tidak ada untuk item tersebut:<pre>"Expected" :<br />	{"Color":{"Exists":false}}</pre>Notasi JSON berikut memeriksa untuk melihat apakah atribut dengan nama "Warna" sudah memiliki nilai "Kuning" sebelum mengganti item tersebut: <pre>"Expected" : <br />	{"Color":{"Exists":true,{"Value":{"S":"Yellow"}}}</pre>Secara default, jika Anda menggunakan parameter `Expected` dan menyediakan `Value`, DynamoDB mengasumsikan bahwa atribut ada dan memiliki nilai terkini untuk diganti. Jadi Anda tidak perlu menentukan `{"Exists":true}`, karena hal tersebut sudah tersirat. Anda dapat mempersingkat permintaan untuk:<pre>"Expected" : <br />	{"Color":{"Value":{"S":"Yellow"}}}</pre> Jika Anda menentukan `{"Exists":true}` tanpa nilai atribut untuk diperiksa, DynamoDB mengembalikan kesalahan.  | Tidak | 
| ReturnValues  | Gunakan parameter ini jika Anda ingin mendapatkan pasangan nama-nilai atribut sebelum pasangan tersebut diperbarui dengan permintaan `PutItem`. Nilai parameter yang memungkinkan adalah `NONE` (default) atau `ALL_OLD`. Jika `ALL_OLD` ditentukan, dan `PutItem` menimpa pasangan nama-nilai atribut, isi dari item lama akan dikembalikan. Jika parameter ini tidak tersedia atau `NONE`, tidak ada yang dikembalikan.Jenis: String | Tidak | 

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

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

Contoh sintaksis berikut mengasumsikan permintaan ditentukan dalam parameter `ReturnValues` dari `ALL_OLD`; jika tidak, respons hanya memiliki elemen `ConsumedCapacityUnits`.

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

{"Attributes":
	{"AttributeName3":{"S":"AttributeValue3"},
	"AttributeName2":{"SS":"AttributeValue2"},
	"AttributeName1":{"SS":"AttributeValue1"},
	},
"ConsumedCapacityUnits":1
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Attributes  | Nilai atribut sebelum operasi penempatan, tetapi hanya jika parameter `ReturnValues` ditentukan sebagai dalam permintaan `ALL_OLD`.Jenis: Peta pasangan nama-nilai atribut. | 
| ConsumedCapacityUnits | Jumlah unit kapasitas tulis yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Angka | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
|  ConditionalCheckFailedException  | Pemeriksaan bersyarat gagal. Nilai atribut yang diharapkan tidak ditemukan.  | 
| ResourceNotFoundException  | Item atau atribut yang ditentukan tidak ditemukan. | 

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

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

### Permintaan sampel
<a name="API_PutItem_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.PutItem 
content-type: application/x-amz-json-1.0

{"TableName":"comp5",
	"Item":
		{"time":{"N":"300"},
		"feeling":{"S":"not surprised"},
		"user":{"S":"Riley"}
		},
	"Expected":
		{"feeling":{"Value":{"S":"surprised"},"Exists":true}}
	"ReturnValues":"ALL_OLD"
}
```

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

```
HTTP/1.1 200 
x-amzn-RequestId: 8952fa74-71e9-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0
content-length: 84

{"Attributes":
	{"feeling":{"S":"surprised"},
	"time":{"N":"300"},
	"user":{"S":"Riley"}},
"ConsumedCapacityUnits":1
}
```

## Tindakan terkait
<a name="API_PutItem_Related_Actions"></a>
+  [UpdateItem](API_UpdateItem_v20111205.md) 
+  [DeleteItem](API_DeleteItem_v20111205.md) 
+  [GetItem](API_GetItem_v20111205.md) 
+  [BatchGetItem](API_BatchGetItem_v20111205.md) 

# Kueri
<a name="API_Query_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_Query_Description"></a>

Sebuah `Query` operasi mendapatkan nilai dari satu atau lebih item dan atributnya dengan kunci primer (hanya `Query` tersedia untuk tabel kunci hash-and-range primer). Anda harus memberikan `HashKeyValue` spesifik, dan dapat mempersempit ruang lingkup kueri menggunakan operator perbandingan pada `RangeKeyValue` kunci primer. Gunakan parameter `ScanIndexForward` untuk mendapatkan hasil dalam urutan maju atau mundur dengan kunci rentang. 

Kueri yang tidak mengembalikan hasil menggunakan unit kapasitas baca minimum sesuai dengan jenis baca.

**catatan**  
Jika jumlah total item yang memenuhi parameter kueri melampaui batas 1 MB, kueri berhenti dan hasilnya dikembalikan ke pengguna dengan `LastEvaluatedKey` untuk melanjutkan kueri dalam operasi berikutnya. Tidak seperti operasi Scan, operasi Kueri tidak pernah mengembalikan set hasil kosong *dan* sebuah `LastEvaluatedKey`. `LastEvaluatedKey` hanya diberikan jika hasil melampaui 1 MB, atau jika Anda telah menggunakan parameter `Limit`.   
Hasilnya dapat diatur untuk bacaan yang konsisten menggunakan parameter `ConsistentRead`.

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

### Sintaks
<a name="API_Query_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.Query  
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
	"Limit":2,
	"ConsistentRead":true,
	"HashKeyValue":{"S":"AttributeValue1":},
	"RangeKeyCondition": {"AttributeValueList":[{"N":"AttributeValue2"}],"ComparisonOperator":"GT"}
	"ScanIndexForward":true,
	"ExclusiveStartKey":{
		"HashKeyElement":{"S":"AttributeName1"},
		"RangeKeyElement":{"N":"AttributeName2"}
	},
    "AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]},
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang berisi item yang diminta.  Jenis: String  |  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 | 
| Limit  | Jumlah maksimum item untuk dikembalikan (tidak selalu merupakan jumlah item yang cocok). Jika DynamoDB memproses jumlah item hingga batasnya sekaligus mengajukan kueri tabel, layanan ini menghentikan kueri dan mengembalikan nilai-nilai yang cocok hingga titik tersebut, dan `LastEvaluatedKey` untuk diterapkan dalam operasi berikutnya guna melanjutkan kueri. Selain itu, jika ukuran set hasil melampaui 1 MB sebelum DynamoDB mencapai batas ini, layanan ini akan menghentikan kueri dan mengembalikan nilai-nilai yang cocok, serta `LastEvaluatedKey` untuk diterapkan dalam operasi berikutnya guna melanjutkan kueri.Jenis: Angka | Tidak | 
| ConsistentRead  | Jika diatur ke `true`, bacaan yang konsisten akan diterbitkan. Jika tidak, bacaan akhir konsisten akan digunakan.Jenis: Boolean | Tidak | 
| Count  | Jika diatur ke `true`, DynamoDB mengembalikan jumlah total item yang cocok dengan parameter kueri, bukan daftar item yang cocok dan atributnya. Anda dapat menerapkan parameter `Limit` pada kueri hanya-hitung.  Jangan atur `Count` ke `true` saat menyediakan daftar `AttributesToGet`, karena ini membuat DynamoDB mengembalikan kesalahan validasi. Untuk informasi selengkapnya, lihat [Menghitung item dalam hasil](Query.Other.md#Query.Count).Jenis: Boolean | Tidak | 
| HashKeyValue  | Nilai atribut komponen hash dari kunci primer komposit.Jenis: String, Angka, atau Biner | Ya | 
| RangeKeyCondition  | Sebuah kontainer untuk nilai atribut dan operator perbandingan untuk digunakan dalam kueri. Permintaan kueri tidak memerlukan `RangeKeyCondition`. Jika Anda hanya memberikan `HashKeyValue`, DynamoDB mengembalikan semua item dengan nilai elemen kunci hash yang ditentukan.Jenis: Peta | Tidak | 
| RangeKeyCondition:​ AttributeValueList | Nilai atribut yang akan dievaluasi untuk parameter kueri. `AttributeValueList` berisi satu nilai atribut, kecuali jika perbandingan `BETWEEN` ditentukan. Untuk perbandingan `BETWEEN`, `AttributeValueList` berisi dua nilai atribut. Jenis: Peta `AttributeValue` ke `ComparisonOperator`.  | Tidak | 
| RangeKeyCondition:​ ComparisonOperator |  Kriteria untuk mengevaluasi atribut yang disediakan, seperti sama dengan, lebih besar dari, dll. Berikut ini adalah operator perbandingan yang valid untuk operasi Kueri.  Perbandingan nilai string untuk lebih besar dari, sama dengan, atau kurang dari didasarkan pada nilai-nilai kode karakter ASCII. Sebagai contoh, `a` lebih besar dari `A`, dan `aa` lebih besar dari `B`. Untuk daftar nilai kode, lihat [http://en.wikipedia. org/wiki/ASCII](http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters)\$1ASCII\$1printable\$1characters.  Untuk Biner, DynamoDB memperlakukan setiap byte data biner sebagai tidak bertanda ketika membandingkan nilai-nilai biner, contohnya ketika mengevaluasi ekspresi kueri.   Jenis: String atau Biner  | Tidak | 
|   | `EQ`: Sama dengan. Untuk `EQ`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sama dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `LE`: Kurang dari atau sama dengan. Untuk `LE`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `LT`: Kurang dari. Untuk `LT`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `GE`: Lebih besar dari atau sama dengan. Untuk `GE`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `GT`: Lebih besar dari. Untuk `GT`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `BEGINS_WITH`: memeriksa prefiks. Untuk `BEGINS_WITH`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String atau Biner (bukan jenis Angka atau set). Atribut target perbandingan harus berupa String atau Biner (bukan Angka atau set). |   | 
|   | `BETWEEN`: Lebih besar dari, atau sama dengan, nilai pertama dan kurang dari, atau sama dengan, nilai kedua. Untuk `BETWEEN`, `AttributeValueList` harus berisi dua elemen `AttributeValue` berjenis yang sama, baik String, Angka, atau Biner (bukan set). Suatu atribut target cocok jika nilai target lebih besar dari, atau sama dengan, elemen pertama dan kurang dari, atau sama dengan, elemen kedua. Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Misalnya, `{"S":"6"}` tidak sebanding dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
| ScanIndexForward | Menentukan traversal naik atau turun indeks. DynamoDB mengembalikan hasil yang mencerminkan urutan yang diminta, yang ditentukan oleh kunci rentang: Jika jenis data adalah Angka, hasilnya dikembalikan dalam urutan numerik; jika tidak, traversal didasarkan pada nilai kode karakter ASCII.Jenis: BooleanDefault-nya adalah `true` (naik). | Tidak | 
| ExclusiveStartKey | Kunci primer dari item untuk melanjutkan kueri sebelumnya. Kueri sebelumnya mungkin memberikan nilai ini sebagai `LastEvaluatedKey` jika operasi kueri terinterupsi sebelum menyelesaikan kueri; baik karena ukuran set hasil maupun parameter `Limit`. `LastEvaluatedKey` dapat diteruskan kembali dalam permintaan kueri baru untuk melanjutkan operasi dari titik tersebut.Jenis: `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | Tidak | 

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

### Sintaks
<a name="API_Query_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: 308

{"Count":2,"Items":[{
    "AttributeName1":{"S":"AttributeValue1"},
    "AttributeName2":{"N":"AttributeValue2"},
    "AttributeName3":{"S":"AttributeValue3"}
    },{
    "AttributeName1":{"S":"AttributeValue3"},
    "AttributeName2":{"N":"AttributeValue4"},
    "AttributeName3":{"S":"AttributeValue3"},
    "AttributeName5":{"B":"dmFsdWU="}
}],
    "LastEvaluatedKey":{"HashKeyElement":{"AttributeValue3":"S"},
                        "RangeKeyElement":{"AttributeValue4":"N"}
     },
     "ConsumedCapacityUnits":1
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
| Items  | Atribut item yang memenuhi parameter kueri.Jenis: Peta nama atribut serta nilai dan jenis data. | 
| Count  |  Jumlah item dalam respons. Untuk informasi selengkapnya, lihat [Menghitung item dalam hasil](Query.Other.md#Query.Count). Jenis: Angka  | 
| LastEvaluatedKey | Kunci primer dari item di mana operasi kueri berhenti, termasuk set hasil sebelumnya. Gunakan nilai ini untuk memulai operasi baru dengan mengecualikan nilai ini dalam permintaan baru.`LastEvaluatedKey` adalah `null` ketika seluruh set hasil kueri selesai (yaitu operasi memproses “halaman terakhir”). Jenis: `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | 
| ConsumedCapacityUnits | Jumlah unit kapasitas baca yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Angka | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
| ResourceNotFoundException  | Tabel yang ditentukan tidak ditemukan. | 

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

 Untuk contoh menggunakan AWS SDK, lihat[Menanyakan tabel di DynamoDB](Query.md).

### Permintaan sampel
<a name="API_Query_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.Query  
content-type: application/x-amz-json-1.0

{"TableName":"1-hash-rangetable",
	"Limit":2,
	"HashKeyValue":{"S":"John"},
	"ScanIndexForward":false,
	"ExclusiveStartKey":{
		"HashKeyElement":{"S":"John"},
		"RangeKeyElement":{"S":"The Matrix"}
	}
}
```

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

```
HTTP/1.1 200 
x-amzn-RequestId: 3647e778-71eb-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0
content-length: 308

{"Count":2,"Items":[{
	"fans":{"SS":["Jody","Jake"]},
	"name":{"S":"John"},
	"rating":{"S":"***"},
	"title":{"S":"The End"}
	},{
	"fans":{"SS":["Jody","Jake"]},
	"name":{"S":"John"},
	"rating":{"S":"***"},
	"title":{"S":"The Beatles"}
	}],
	"LastEvaluatedKey":{"HashKeyElement":{"S":"John"},"RangeKeyElement":{"S":"The Beatles"}},
"ConsumedCapacityUnits":1
}
```

### Permintaan sampel
<a name="API_Query_Examples_Request2"></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.Query 
content-type: application/x-amz-json-1.0
 
{"TableName":"1-hash-rangetable",
	"Limit":2,
	"HashKeyValue":{"S":"Airplane"},
	"RangeKeyCondition":{"AttributeValueList":[{"N":"1980"}],"ComparisonOperator":"EQ"},
	"ScanIndexForward":false}
```

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

```
HTTP/1.1 200 
x-amzn-RequestId: 8b9ee1ad-774c-11e0-9172-d954e38f553a
content-type: application/x-amz-json-1.0
content-length: 119 
 
{"Count":1,"Items":[{
	"fans":{"SS":["Dave","Aaron"]},
	"name":{"S":"Airplane"},
	"rating":{"S":"***"},
	"year":{"N":"1980"}
	}],
"ConsumedCapacityUnits":1
}
```

## Tindakan terkait
<a name="API_Query_Related_Actions"></a>
+  [Scan](API_Scan_v20111205.md) 

# Scan
<a name="API_Scan_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_Scan_Description"></a>

Operasi `Scan` mengembalikan satu atau beberapa item dan atributnya dengan melakukan pemindaian tabel secara menyeluruh. Berikan `ScanFilter` untuk mendapatkan hasil yang lebih spesifik. 

**catatan**  
Jika jumlah total item yang dipindai melebihi batas 1 MB, pemindaian berhenti dan hasil dikembalikan ke pengguna dengan `LastEvaluatedKey` untuk melanjutkan pemindaian dalam operasi berikutnya. Hasilnya juga mencakup jumlah item yang melampaui batas. Pemindaian dapat mengakibatkan tidak adanya data tabel yang memenuhi kriteria filter.   
Set hasil pada akhirnya konsisten. 

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

### Sintaks
<a name="API_Scan_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.Scan  
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
    "Limit": 2,
    "ScanFilter":{
        "AttributeName1":{"AttributeValueList":[{"S":"AttributeValue"}],"ComparisonOperator":"EQ"}
    },
    "ExclusiveStartKey":{
        "HashKeyElement":{"S":"AttributeName1"},
        "RangeKeyElement":{"N":"AttributeName2"}
    },
    "AttributesToGet":["AttributeName1", "AttributeName2", "AttributeName3"]},
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang berisi item yang diminta. Jenis: String  |  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 | 
| Limit  | Jumlah maksimum item untuk dievaluasi (tidak selalu merupakan jumlah item yang cocok). Jika DynamoDB memproses jumlah item hingga batasnya saat memproses hasilnya, layanan ini berhenti dan mengembalikan nilai-nilai yang cocok hingga titik tersebut, dan `LastEvaluatedKey` untuk diterapkan dalam operasi berikutnya guna melanjutkan pengambilan item. Selain itu, jika ukuran set data yang dipindai melampaui 1 MB sebelum DynamoDB mencapai batas ini, layanan ini menghentikan pemindaian dan mengembalikan nilai-nilai yang cocok hingga batasnya, serta `LastEvaluatedKey` untuk diterapkan dalam operasi berikutnya guna melanjutkan pemindaian.Jenis: Angka | Tidak | 
| Count  | Jika diatur ke `true`, DynamoDB mengembalikan jumlah total item untuk operasi Scan, bahkan jika operasi tidak memiliki item yang cocok untuk filter yang ditetapkan. Anda dapat menerapkan parameter Limit untuk pemindaian hanya-hitung.  Jangan atur `Count` ke `true` saat menyediakan daftar `AttributesToGet`, karena ini membuat DynamoDB mengembalikan kesalahan validasi. Untuk informasi selengkapnya, lihat [Menghitung item dalam hasil](Scan.md#Scan.Count).Jenis: Boolean | Tidak | 
| ScanFilter  | Mengevaluasi hasil pemindaian dan mengembalikan hanya nilai-nilai yang diinginkan. Beberapa syarat diperlakukan sebagai operasi "AND": semua syarat harus dipenuhi agar disertakan dalam hasil. Jenis: Peta nama atribut ke nilai dengan operator perbandingan. | Tidak | 
| ScanFilter:AttributeValueList | Nilai dan syarat untuk mengevaluasi hasil pemindaian untuk filter.Jenis: Peta `AttributeValue` ke `Condition`. | Tidak | 
| ScanFilter:​ ComparisonOperator | Kriteria untuk mengevaluasi atribut yang disediakan, seperti sama dengan, lebih besar dari, dll. Berikut ini adalah operator perbandingan yang valid untuk operasi pemindaian. Perbandingan nilai string untuk lebih besar dari, sama dengan, atau kurang dari didasarkan pada nilai-nilai kode karakter ASCII. Sebagai contoh, `a` lebih besar dari `A`, dan `aa` lebih besar dari `B`. Untuk daftar nilai kode, lihat [http://en.wikipedia. org/wiki/ASCII](http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters)\$1ASCII\$1printable\$1characters. Untuk Biner, DynamoDB memperlakukan setiap byte data biner sebagai tidak bertanda ketika membandingkan nilai-nilai biner, contohnya ketika mengevaluasi ekspresi kueri.   Jenis: String atau Biner  | Tidak | 
|   | `EQ`: Sama dengan. Untuk `EQ`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sama dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `NE`: Tidak sama dengan. Untuk `NE`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sama dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `LE`: Kurang dari atau sama dengan. Untuk `LE`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `LT`: Kurang dari. Untuk `LT`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `GE`: Lebih besar dari atau sama dengan. Untuk `GE`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `GT`: Lebih besar dari. Untuk `GT`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Sebagai contoh, `{"S":"6"}` tidak sama dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
|   | `NOT_NULL`: Atribut ada.  |   | 
|   | `NULL`: Atribut tidak ada.  |   | 
|   | `CONTAINS`: memeriksa urutan berikutnya, atau nilai dalam suatu set. Untuk `CONTAINS`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika atribut target perbandingan berupa String, operasi memeriksa kecocokan substring. Jika atribut target perbandingan berupa Biner, operasi mencari urutan berikutnya dari target yang cocok dengan input. Jika atribut target perbandingan adalah suatu set ("SS", "NS", atau "BS"), operasi memeriksa anggota set tersebut (bukan sebagai substring). |   | 
|   | `NOT_CONTAINS`: memeriksa tidak adanya urutan berikutnya, atau tidak adanya nilai dalam suatu set. Untuk `NOT_CONTAINS`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Jika atribut target perbandingan adalah String, operasi memeriksa tidak adanya kecocokan substring. Jika atribut target perbandingan adalah Biner, operasi mencari tidak adanya urutan berikutnya dari target yang cocok dengan input. Jika atribut target perbandingan adalah suatu set ("SS", "NS", atau "BS"), operasi memeriksa tidak adanya anggota set tersebut (bukan sebagai substring). |   | 
|   | `BEGINS_WITH`: memeriksa prefiks. Untuk `BEGINS_WITH`, `AttributeValueList` hanya dapat berisi satu `AttributeValue` berjenis String atau Biner (bukan jenis Angka atau set). Atribut target perbandingan harus berupa String atau Biner (bukan Angka atau set). |   | 
|   | `IN`: memeriksa kecocokan yang tepat. Untuk `IN`, `AttributeValueList` dapat berisi lebih dari satu `AttributeValue` berjenis String, Angka, atau Biner (bukan jenis set). Atribut target perbandingan harus memiliki jenis yang sama dan nilai persis agar cocok. Sebuah String tidak pernah cocok dengan set String. |   | 
|   | `BETWEEN`: Lebih besar dari, atau sama dengan, nilai pertama dan kurang dari, atau sama dengan, nilai kedua. Untuk `BETWEEN`, `AttributeValueList` harus berisi dua elemen `AttributeValue` berjenis yang sama, baik String, Angka, atau Biner (bukan set). Suatu atribut target cocok jika nilai target lebih besar dari, atau sama dengan, elemen pertama dan kurang dari, atau sama dengan, elemen kedua. Jika item berisi `AttributeValue` dengan jenis berbeda dari yang ditentukan dalam permintaan, nilainya tidak cocok. Misalnya, `{"S":"6"}` tidak sebanding dengan `{"N":"6"}`. Selain itu, `{"N":"6"}` tidak sebanding dengan `{"NS":["6", "2", "1"]}`. |   | 
| ExclusiveStartKey | Kunci primer dari item untuk melanjutkan pemindaian sebelumnya. Pemindaian sebelumnya mungkin memberikan nilai ini jika operasi pemindaian terganggu sebelum memindai seluruh tabel; baik karena ukuran set hasil atau parameter `Limit`. `LastEvaluatedKey` dapat diteruskan kembali dalam permintaan pemindaian baru untuk melanjutkan operasi dari titik tersebut.Jenis: `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | Tidak | 

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

### Sintaks
<a name="API_Scan_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: 229 

{"Count":2,"Items":[{
    "AttributeName1":{"S":"AttributeValue1"},
    "AttributeName2":{"S":"AttributeValue2"},
    "AttributeName3":{"S":"AttributeValue3"}
    },{
    "AttributeName1":{"S":"AttributeValue4"},
    "AttributeName2":{"S":"AttributeValue5"},
    "AttributeName3":{"S":"AttributeValue6"},
    "AttributeName5":{"B":"dmFsdWU="}
    }],
    "LastEvaluatedKey":
        {"HashKeyElement":{"S":"AttributeName1"},
        "RangeKeyElement":{"N":"AttributeName2"},
    "ConsumedCapacityUnits":1,
    "ScannedCount":2}
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
| Items  | Kontainer untuk atribut yang memenuhi parameter operasi.Jenis: Peta nama atribut serta nilai dan jenis data. | 
| Count  |  Jumlah item dalam respons. Untuk informasi selengkapnya, lihat [Menghitung item dalam hasil](Scan.md#Scan.Count). Jenis: Angka  | 
| ScannedCount  | Jumlah item dalam pemindaian lengkap sebelum filter diterapkan. Nilai `ScannedCount` yang tinggi dengan dengan sedikit, atau tanpa hasil, `Count` hasil menunjukkan operasi Scan yang tidak efisien. Untuk informasi selengkapnya, lihat [Menghitung item dalam hasil](Scan.md#Scan.Count).Jenis: Angka | 
| LastEvaluatedKey | Kunci primer item tempat operasi pemindaian berhenti. Masukkan nilai ini dalam operasi pemindaian berikutnya untuk melanjutkan operasi dari titik tersebut.`LastEvaluatedKey` adalah `null` ketika seluruh set hasil pemindaian selesai (yaitu operasi memproses “halaman terakhir”).  | 
| ConsumedCapacityUnits | Jumlah unit kapasitas baca yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Angka | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
| ResourceNotFoundException  | Tabel yang ditentukan tidak ditemukan. | 

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

Untuk contoh menggunakan AWS SDK, lihat[Memindai tabel di DynamoDB](Scan.md).

### Permintaan sampel
<a name="API_Scan_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.Scan 
content-type: application/x-amz-json-1.0

{"TableName":"1-hash-rangetable","ScanFilter":{}}
```

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

```
HTTP/1.1 200
x-amzn-RequestId: 4e8a5fa9-71e7-11e0-a498-71d736f27375 
content-type: application/x-amz-json-1.0 
content-length: 465 

{"Count":4,"Items":[{
	"date":{"S":"1980"},
	"fans":{"SS":["Dave","Aaron"]},
	"name":{"S":"Airplane"},
	"rating":{"S":"***"}
	},{
	"date":{"S":"1999"},
	"fans":{"SS":["Ziggy","Laura","Dean"]},
	"name":{"S":"Matrix"},
	"rating":{"S":"*****"}
	},{
	"date":{"S":"1976"},
	"fans":{"SS":["Riley"]},"
	name":{"S":"The Shaggy D.A."},
	"rating":{"S":"**"}
	},{
	"date":{"S":"1985"},
	"fans":{"SS":["Fox","Lloyd"]},
	"name":{"S":"Back To The Future"},
	"rating":{"S":"****"}
	}],
    "ConsumedCapacityUnits":0.5
	"ScannedCount":4}
```

### Permintaan sampel
<a name="API_Scan_Examples_Request2"></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.Scan 
content-type: application/x-amz-json-1.0
content-length: 125 

{"TableName":"comp5",
	"ScanFilter":
		{"time":
			{"AttributeValueList":[{"N":"400"}],
			"ComparisonOperator":"GT"}
	}
}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: PD1CQK9QCTERLTJP20VALJ60TRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 262
Date: Mon, 15 Aug 2011 16:52:02 GMT

{"Count":2,
	"Items":[
		{"friends":{"SS":["Dave","Ziggy","Barrie"]},
		"status":{"S":"chatting"},
		"time":{"N":"2000"},
		"user":{"S":"Casey"}},
		{"friends":{"SS":["Dave","Ziggy","Barrie"]},
		"status":{"S":"chatting"},
		"time":{"N":"2000"},
		"user":{"S":"Fredy"}
		}],
"ConsumedCapacityUnits":0.5
"ScannedCount":4
}
```

### Permintaan sampel
<a name="API_Scan_Examples_Request3"></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.Scan
content-type: application/x-amz-json-1.0

{"TableName":"comp5",
	"Limit":2,
	"ScanFilter":
		{"time":
			{"AttributeValueList":[{"N":"400"}],
			"ComparisonOperator":"GT"}
	},
	"ExclusiveStartKey":
		{"HashKeyElement":{"S":"Fredy"},"RangeKeyElement":{"N":"2000"}}
}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: PD1CQK9QCTERLTJP20VALJ60TRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 232
Date: Mon, 15 Aug 2011 16:52:02 GMT

{"Count":1,
	"Items":[
		{"friends":{"SS":["Jane","James","John"]},
		"status":{"S":"exercising"},
		"time":{"N":"2200"},
		"user":{"S":"Roger"}}
	],
	"LastEvaluatedKey":{"HashKeyElement":{"S":"Riley"},"RangeKeyElement":{"N":"250"}},
"ConsumedCapacityUnits":0.5
"ScannedCount":2
}
```

## Tindakan terkait
<a name="API_Scan_Related_Actions"></a>
+  [Kueri](API_Query_v20111205.md) 
+  [BatchGetItem](API_BatchGetItem_v20111205.md) 

# UpdateItem
<a name="API_UpdateItem_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_UpdateItem_Description"></a>

Mengedit atribut item yang ada. Anda dapat melakukan pembaruan bersyarat (memasukkan pasangan nama-nilai atribut baru jika tidak ada, atau mengganti pasangan nama-nilai yang ada jika memiliki nilai atribut tertentu yang diharapkan).

**catatan**  
Anda tidak dapat memperbarui atribut kunci utama menggunakan UpdateItem. Sebagai gantinya, hapus item dan gunakan PutItem untuk membuat item baru dengan atribut baru.

 UpdateItem Operasi mencakup `Action` parameter, yang mendefinisikan cara melakukan pembaruan. Anda dapat menempatkan, menghapus, atau menambahkan nilai atribut. 

Nilai atribut tidak boleh null; atribut jenis string dan biner harus memiliki panjang lebih dari nol; dan atribut jenis set tidak boleh kosong. Permintaan dengan nilai kosong akan ditolak dengan `ValidationException`.

Jika item yang ada memiliki kunci primer yang ditentukan: 
+ **PUT—** Menambahkan atribut yang ditentukan. Jika sudah ada, atribut akan digantikan oleh nilai baru. 
+ **DELETE—** Jika tidak ada nilai yang ditentukan, ini akan menghapus atribut dan nilainya. Jika suatu set nilai ditentukan, nilai-nilai dalam set yang ditentukan dihapus dari set lama. Jadi, jika nilai atribut berisi [a,b,c] dan tindakan menghapus berisi [a,c], nilai atribut akhir adalah [b]. Jenis nilai yang ditentukan harus sesuai dengan jenis nilai yang ada. Menentukan suatu set kosong tidak valid.
+ **ADD—** Hanya gunakan tindakan add untuk angka atau jika atribut target adalah suatu set (termasuk set string). ADD tidak berfungsi jika atribut target adalah nilai string tunggal atau nilai biner skalar. Nilai yang ditentukan ditambahkan ke nilai numerik (menambah atau mengurangi nilai numerik yang ada) atau ditambahkan sebagai nilai tambahan dalam suatu set string. Jika suatu set nilai ditentukan, nilai-nilai ditambahkan ke set yang ada. Misalnya jika set asli adalah [1,2] dan nilai yang disediakan adalah [3], maka setelah operasi add, set adalah [1,2,3], bukan [4,5]. Terjadi kesalahan jika tindakan Add ditentukan untuk atribut set dan jenis atribut yang ditentukan tidak cocok dengan jenis set yang ada. 

  Jika Anda menggunakan ADD untuk atribut yang tidak ada, atribut dan nilai-nilainya ditambahkan ke item.

Jika tidak ada item yang cocok dengan kunci primer yang ditentukan: 
+ **PUT** – Membuat item baru dengan kunci primer yang ditentukan. Lalu menambahkan atribut yang ditentukan. 
+ **DELETE—** Tidak ada yang terjadi. 
+ **ADD—** Membuat item dengan kunci primer dan angka (atau set angka) yang disediakan untuk nilai atribut. Tidak berlaku untuk jenis string atau biner. 

**catatan**  
Jika Anda menggunakan `ADD` untuk menambah atau mengurangi nilai angka untuk item yang tidak ada sebelum pembaruan, DynamoDB menggunakan `0` sebagai nilai awal. Selain itu, jika Anda memperbarui item menggunakan `ADD` guna menambah atau mengurangi nilai angka untuk atribut yang tidak ada sebelum pembaruan (tetapi item ada), DynamoDB menggunakan `0` sebagai nilai awal. Sebagai contoh, Anda menggunakan `ADD` untuk menambahkan `+3` ke atribut yang tidak ada sebelum pembaruan. DynamoDB menggunakan `0` sebagai nilai awal, dan nilai setelah pembaruan adalah `3`. 

Untuk informasi lebih lanjut tentang penggunaan operasi ini, lihat [Bekerja dengan item dan atribut di DynamoDB](WorkingWithItems.md). 

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

### Sintaks
<a name="API_UpdateItem_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.UpdateItem
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
    "Key":
        {"HashKeyElement":{"S":"AttributeValue1"},
        "RangeKeyElement":{"N":"AttributeValue2"}},
    "AttributeUpdates":{"AttributeName3":{"Value":{"S":"AttributeValue3_New"},"Action":"PUT"}},
    "Expected":{"AttributeName3":{"Value":{"S":"AttributeValue3_Current"}}},
    "ReturnValues":"ReturnValuesConstant"
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang berisi item untuk diperbarui.  Jenis: String  |  Ya  | 
|  Key  | 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 | 
| AttributeUpdates | Peta nama atribut ke nilai baru dan tindakan baru untuk diperbarui. Nama atribut menentukan atribut untuk dimodifikasi, dan tidak dapat berisi atribut kunci primer apa pun.Jenis: Peta nama atribut, nilai, dan tindakan untuk pembaruan atribut. |  | 
| AttributeUpdates:Action | Menentukan cara melakukan pembaruan. Kemungkinan nilai: `PUT` (default), `ADD` atau `DELETE`. Semantik dijelaskan dalam deskripsi. UpdateItem Tipe: StringDefault: `PUT` | Tidak | 
| Expected  | Menunjuk atribut untuk pembaruan bersyarat. Parameter `Expected` memungkinkan Anda untuk memberikan nama atribut, dan apakah DynamoDB harus memeriksa keberadaan nilai atribut; atau apakah nilai atribut ada dan memiliki nilai tertentu sebelum mengubahnya.Jenis: Peta nama atribut. | Tidak | 
| Expected:AttributeName  | Nama atribut untuk penempatan bersyarat.Jenis: String | Tidak | 
| Expected:AttributeName: ExpectedAttributeValue | Gunakan parameter ini untuk menentukan apakah nilai sudah ada atau belum untuk pasangan nama-nilai atribut. Notasi JSON berikut memperbarui item jika atribut "Warna" tidak ada untuk item tersebut:<pre>"Expected" :<br />	{"Color":{"Exists":false}}</pre>Notasi JSON berikut memeriksa untuk melihat apakah atribut dengan nama "Warna" sudah memiliki nilai "Kuning" sebelum memperbarui item tersebut: <pre>"Expected" : <br />	{"Color":{"Exists":true},{"Value":{"S":"Yellow"}}}</pre>Secara default, jika Anda menggunakan parameter `Expected` dan menyediakan `Value`, DynamoDB mengasumsikan bahwa atribut ada dan memiliki nilai terkini untuk diganti. Jadi Anda tidak perlu menentukan `{"Exists":true}`, karena hal tersebut sudah tersirat. Anda dapat mempersingkat permintaan untuk:<pre>"Expected" : <br />	{"Color":{"Value":{"S":"Yellow"}}}</pre> Jika Anda menentukan `{"Exists":true}` tanpa nilai atribut untuk diperiksa, DynamoDB mengembalikan kesalahan.  | Tidak | 
| ReturnValues  | Gunakan parameter ini jika Anda ingin mendapatkan pasangan nama-nilai atribut sebelum pasangan tersebut diperbarui dengan permintaan `UpdateItem`. Nilai parameter yang memungkinkan adalah `NONE` (default) atau `ALL_OLD`, `UPDATED_OLD`, `ALL_NEW`, atau `UPDATED_NEW`. Jika `ALL_OLD` ditentukan, dan `UpdateItem` menimpa pasangan nama-nilai atribut, isi dari item lama akan dikembalikan. Jika parameter ini tidak tersedia atau `NONE`, tidak ada yang dikembalikan. Jika `ALL_NEW` ditentukan, semua atribut versi baru dari item tersebut akan dikembalikan. Jika `UPDATED_NEW` ditentukan, versi baru dari hanya atribut yang diperbarui akan dikembalikan.Jenis: String | Tidak | 

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

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

Contoh sintaksis berikut mengasumsikan permintaan ditentukan dalam parameter `ReturnValues` dari `ALL_OLD`; jika tidak, respons hanya memiliki elemen `ConsumedCapacityUnits`.

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

{"Attributes":{
	"AttributeName1":{"S":"AttributeValue1"},
	"AttributeName2":{"S":"AttributeValue2"},
	"AttributeName3":{"S":"AttributeValue3"},
	"AttributeName5":{"B":"dmFsdWU="}
	},
"ConsumedCapacityUnits":1
}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Attributes  | Sebuah peta pasangan nama-nilai atribut, tetapi hanya jika parameter `ReturnValues` ditentukan sebagai sesuatu selain `NONE` dalam permintaan.Jenis: Peta pasangan nama-nilai atribut. | 
| ConsumedCapacityUnits | Jumlah unit kapasitas tulis yang digunakan dalam operasi. Nilai ini menunjukkan jumlah yang diterapkan pada throughput yang disediakan. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md). Jenis: Angka | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
|  ConditionalCheckFailedException  | Pemeriksaan bersyarat gagal. Atribut nilai ("\$1 name \$1") adalah ("\$1 value \$1") tetapi diharapkan ("\$1 expValue \$1")  | 
| ResourceNotFoundExceptions  | Item atau atribut yang ditentukan tidak ditemukan. | 

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

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

### Permintaan sampel
<a name="API_UpdateItem_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.UpdateItem
content-type: application/x-amz-json-1.0 

{"TableName":"comp5",
    "Key":
        {"HashKeyElement":{"S":"Julie"},"RangeKeyElement":{"N":"1307654350"}},
    "AttributeUpdates":
        {"status":{"Value":{"S":"online"},
        "Action":"PUT"}},
    "Expected":{"status":{"Value":{"S":"offline"}}},
    "ReturnValues":"ALL_NEW"
}
```

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: 5IMHO7F01Q9P7Q6QMKMMI3R3QRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 121
Date: Fri, 26 Aug 2011 21:05:00 GMT

{"Attributes":
    {"friends":{"SS":["Lynda, Aaron"]},
    "status":{"S":"online"},
    "time":{"N":"1307654350"},
    "user":{"S":"Julie"}},
"ConsumedCapacityUnits":1
}
```

## Tindakan terkait
<a name="API_UpdateItem_Related_Actions"></a>
+  [PutItem](API_PutItem_v20111205.md) 
+  [DeleteItem](API_DeleteItem_v20111205.md) 

# UpdateTable
<a name="API_UpdateTable_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_updatetable_Description"></a>

Memperbarui throughput yang disediakan untuk tabel yang ditentukan. Mengatur throughput untuk tabel membantu Anda mengelola performa dan merupakan bagian dari fitur throughput yang disediakan dalam DynamoDB. Untuk informasi selengkapnya, lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md).

Nilai throughput yang disediakan dapat ditingkatkan atau diturunkan berdasarkan nilai maksimum dan minimum yang tercantum dalam [Kuota di Amazon DynamoDB](ServiceQuotas.md).

Tabel harus dalam `ACTIVE` keadaan agar operasi ini berhasil. UpdateTable adalah operasi asinkron; saat menjalankan operasi, tabel dalam keadaan. `UPDATING` Meskipun berada dalam status `UPDATING`, tabel masih memiliki throughput yang disediakan sejak sebelum panggilan. Pengaturan throughput baru yang disediakan hanya berlaku ketika tabel kembali ke `ACTIVE` status setelah operasi. UpdateTable 

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

### Sintaks
<a name="API_UpdateTable_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.UpdateTable
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
```


****  

|  Nama  |  Deskripsi  |  Wajib | 
| --- | --- | --- | 
|  TableName  |  Nama tabel yang akan diperbarui.  Jenis: String   |  Ya  | 
|  ProvisionedThroughput  | Throughput baru untuk tabel yang ditentukan, yang terdiri dari nilai-nilai untuk `ReadCapacityUnits` dan `WriteCapacityUnits`. Lihat [DynamoDB menyediakan mode kapasitas](provisioned-capacity-mode.md).Jenis: Array  | Ya | 
| ProvisionedThroughput :ReadCapacityUnits |  Menetapkan jumlah minimum `ReadCapacityUnits` yang konsisten digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya.  Operasi bacaan akhir konsisten memerlukan lebih sedikit usaha daripada operasi baca konsisten, jadi pengaturan 50 `ReadCapacityUnits` yang konsisten per detik akan menghasilkan 100 `ReadCapacityUnits` akhir konsisten per detik. Jenis: Angka  | Ya | 
| ProvisionedThroughput :WriteCapacityUnits |  Menetapkan jumlah minimum `WriteCapacityUnits` yang digunakan per detik untuk tabel yang ditentukan sebelum DynamoDB menyeimbangkan beban dengan operasi lainnya. Jenis: Angka  | Ya | 

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
Content-Type: application/json
Content-Length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.321657838135E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}},
    "ProvisionedThroughput":
        {"LastDecreaseDateTime":1.321661704489E9,
        "LastIncreaseDateTime":1.321663607695E9,
        "ReadCapacityUnits":5,
        "WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"UPDATING"}}
```


****  

|  Nama  |  Deskripsi  | 
| --- | --- | 
| CreationDateTime | Tanggal ketika tabel dibuat.Jenis: Angka | 
|  KeySchema  | Struktur kunci primer (sederhana atau komposit) untuk tabel. Pasangan nama-nilai untuk `HashKeyElement` diperlukan, dan pasangan nama-nilai untuk `RangeKeyElement` bersifat opsional (hanya diperlukan untuk kunci primer komposit). Ukuran kunci hash maksimum adalah 2048 byte. Ukuran kunci rentang maksimum adalah 1024 byte. Kedua batas tersebut diberlakukan secara terpisah (yaitu Anda dapat memiliki kombinasi hash \$1 rentang 2048 \$1 1024 kunci). Untuk informasi selengkapnya tentang kunci primer, lihat [Kunci primer](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Jenis: Peta `HashKeyElement`, atau `HashKeyElement` dan `RangeKeyElement` untuk kunci primer komposit. | 
| ProvisionedThroughput | Pengaturan throughput saat ini untuk tabel yang ditentukan, termasuk nilai untuk `LastIncreaseDateTime` (jika berlaku), `LastDecreaseDateTime` (jika berlaku), Jenis: Array  | 
|  TableName  |  Nama tabel yang diperbarui. Jenis: String  | 
|  TableStatus  | Status tabel saat ini (CREATING, ACTIVE, DELETING, atau UPDATING), yang seharusnya UPDATING. Gunakan operasi [DescribeTables](API_DescribeTables_v20111205.md) untuk memeriksa status tabel. Jenis: String | 

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


****  

|  Kesalahan  |  Deskripsi  | 
| --- | --- | 
| ResourceNotFoundException  | Tabel yang ditentukan tidak ditemukan.  | 
| ResourceInUseException | Tabel ini tidak berada dalam status ACTIVE. | 

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

### Permintaan sampel
<a name="API_UpdateTable_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.UpdateTable
content-type: application/x-amz-json-1.0

{"TableName":"comp1",
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
```

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

```
HTTP/1.1 200 OK
content-type: application/x-amz-json-1.0
content-length: 390
Date: Sat, 19 Nov 2011 00:46:47 GMT

{"TableDescription":
    {"CreationDateTime":1.321657838135E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":
        {"LastDecreaseDateTime":1.321661704489E9,
        "LastIncreaseDateTime":1.321663607695E9,
        "ReadCapacityUnits":5,
        "WriteCapacityUnits":10},
    "TableName":"comp1",
    "TableStatus":"UPDATING"}
}
```

## Tindakan terkait
<a name="API_UpdateTable_Related_Actions"></a>
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DescribeTables](API_DescribeTables_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md)