

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

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