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

# 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)