Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan Amazon Textract
Bagian ini menyediakan topik untuk membantu Anda memulai menggunakan Amazon Textract. Jika Anda baru mengenal Amazon Textract, sebaiknya Anda terlebih dahulu meninjau konsep dan terminologi di[Cara Amazon Textract Bekerja](how-it-works.md).
Anda dapat mencoba API dengan menggunakan demonstrasi di konsol Amazon Textract Texact. Untuk informasi selengkapnya, lihat[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/).
**Topics**
+ [Langkah 1: Siapkan Akun AWS dan Buat Pengguna IAM](setting-up.md)
+ [Langkah 2: MenyiapkanAWS CLIdanAWSSDK](setup-awscli-sdk.md)
+ [Langkah 3: Memulai menggunakanAWS CLIdanAWSSDK API](get-started-exercise.md)
# Langkah 1: Siapkan Akun AWS dan Buat Pengguna IAM
Sebelum Anda menggunakan Amazon Textract untuk pertama kali, selesaikan tugas berikut:
1. [Mendaftar ke AWS](#setting-up-signup).
1. [Membuat Pengguna IAM](#setting-up-iam).
## Mendaftar ke AWS
Saat Anda mendaftar untuk Amazon Web Services (AWS), akun AWS Anda secara otomatis terdaftar untuk semua layanan yang dirilis di AWS. Anda hanya akan dikenakan biaya untuk layanan yang digunakan.
Dengan Amazon Textract, Anda hanya membayar untuk sumber daya yang Anda gunakan. Untuk informasi selengkapnya tentang tarif penggunaan Amazon Textract, lihat[Harga Amazon Textract](https://aws.amazon.com/textract/pricing/). Jika Anda adalah pelanggan baru AWS, Anda dapat memulai Amazon Textract secara gratis. Untuk informasi selengkapnya, lihat [Tingkatan Gratis AWS](https://aws.amazon.com/free/).
Jika Anda sudah memiliki akun AWS, lewati ke tugas berikutnya. Jika Anda belum memiliki akun AWS, lakukan langkah-langkah berikut untuk membuatnya.
**Untuk membuat akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Ikuti petunjuk online.
Bagian dari prosedur pendaftaran adalah menerima panggilan telepon dan memasukkan kode verifikasi di keypad telepon.
Catat ID akun AWS Anda, karena Anda akan membutuhkannya nanti.
## Membuat Pengguna IAM
Layanan di AWS, seperti Amazon Textract, mewajibkan Anda memberikan kredensia saat Anda mengaksesnya. Layanan kemudian dapat menentukan apakah Anda memiliki izin untuk mengakses sumber daya yang dimiliki oleh layanan tersebut. Konsol tersebut memerlukan kata sandi Anda. Anda dapat membuat access key untuk akun AWS Anda untuk mengakses AWS CLI atau API. Namun, kami tidak merekomendasikan Anda untuk mengakses AWS dengan menggunakan kredensional untuk akun AWS Anda. Sebagai gantinya, kami merekomendasikan Anda:
+ Gunakan (IAM) AWS Identity and Access Management untuk membuat pengguna IAM.
+ Tambahkan pengguna ke grup IAM dengan izin administratif.
Anda kemudian dapat mengakses AWS menggunakan URL khusus dan kredensial pengguna IAM.
Jika Anda mendaftar ke AWS tetapi belum membuat pengguna IAM untuk Anda sendiri, Anda dapat membuatnya menggunakan konsol IAM. Ikuti prosedur untuk membuat pengguna IAM di akun Anda.
**Untuk membuat pengguna IAM dan masuk ke konsol tersebut**
1. Buat pengguna IAM dengan izin administrator di akun AWS Anda. Untuk instruksi, buka [Membuat Grup Pengguna dan Administrator IAM Pertama Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) di *Panduan Pengguna IAM*.
1. Sebagai pengguna IAM, masuk ke Konsol Manajemen AWS dengan menggunakan URL khusus. Untuk informasi selengkapnya, lihat [Cara Pengguna Masuk ke Akun Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html) dalam *Panduan Pengguna IAM*.
**catatan**
IAM pengguna dengan izin administrator memiliki akses tak terbatas ke layanan AWS di akun Anda. Contoh kode dalam panduan ini mengasumsikan Anda memiliki pengguna dengan`AmazonTextractFullAccess`izin.`AmazonS3ReadOnlyAccess`Diperlukan untuk contoh yang mengakses dokumen yang tersimpan di bucket Amazon S3. Tergantung pada persyaratan keamanan, Anda mungkin ingin menggunakan grup IAM yang terbatas pada izin ini. Untuk informasi selengkapnya, lihat [Membuat Grup IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html).
Untuk informasi selengkapnya tentang IAM, lihat hal berikut:
+ [AWS Identity and Access Management(IAM)](https://aws.amazon.com/iam/)
+ [Memulai](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)
## Langkah Selanjutnya
[Langkah 2: MenyiapkanAWS CLIdanAWSSDK](setup-awscli-sdk.md)
# Langkah 2: MenyiapkanAWS CLIdanAWSSDK
Langkah-langkah berikut menunjukkan cara menginstal SDK AWS Command Line Interface (AWS CLI) dan AWS yang menggunakan contoh dalam dokumentasi ini.
Ada sejumlah cara yang berbeda untuk mengautentikasi panggilan SDK AWS. Contoh dalam panduan ini menganggap bahwa Anda menggunakan profil kredensial default untuk menelepon perintah operasi API SDK AWS CLI dan AWS. Kredensyal default Anda akan berfungsi di seluruh layanan, jadi jika Anda telah mengonfigurasi kredensyal Anda, Anda tidak perlu melakukannya lagi. Namun, jika Anda ingin membuat set kredensyal lain untuk layanan ini, Anda dapat membuat profil nama. Untuk informasi lebih lanjut tentang membuat profil,[lihat Profil Bernama.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
Untuk daftar lengkap Wilayah AWS, lihat [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html) dalam *Referensi Umum Amazon Web Services*.
**Untuk mengatur SDK AWS CLI dan AWS**
1. Unduh dan instal SDK AWS CLI dan AWS yang ingin Anda gunakan. Panduan ini memberikan contoh untukAWS CLI, Java, dan Python. Untuk informasi tentang AWS SDK lainnya, lihat [Alat untuk Amazon Web Services](https://aws.amazon.com/tools/).
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)
+ [AWS SDK untuk Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
+ [AWS SDK untuk Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
1. Buat access key untuk pengguna yang Anda buat di[Membuat Pengguna IAM](setting-up.md#setting-up-iam).
1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di panel navigasi, pilih **Pengguna**.
1. Pilih nama pengguna yang Anda buat di[Membuat Pengguna IAM](setting-up.md#setting-up-iam).
1. Pilih tab **Kredensial keamanan**.
1. Pilih **Buat access key**. Lalu pilih **Unduh file .csv** untuk menyimpan access key ID dan secret access key ke file CSV dalam komputer Anda. Simpan file di lokasi aman. Anda tidak akan memiliki akses ke secret access key lagi setelah menutup kotak dialog ini. Setelah mengunduh file CSV, pilih**tutup**.
1. Tetapkan kredensyal dalam file profil kredensyal AWS di sistem lokal Anda, yang terletak di:
+ `~/.aws/credentials`di Linux, macOS, atau Unix.
+ `C:\Users\USERNAME\.aws\credentials`di Windows.
Parameter`.aws`folder tidak ada sebelum konfigurasi awal pertama Anda dari instans AWS Anda. Pertama kali Anda mengkonfigurasi kredensyal Anda dengan CLI, folder ini akan dibuat. Untuk informasi selengkapnya tentang kredensial AWS, lihat[Konfigurasi dan Pengaturan File Kredenal.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
File ini harus berisi baris dalam format berikut:
```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```
Ganti access key ID dan secret access key Anda dengan *your\$1access\$1key\$1id* dan *your\$1secret\$1access\$1key*.
1. Mengatur Wilayah AWS default di AWS`config`file di sistem lokal Anda, terletak di:
+ `~/.aws/config`di Linux, macOS, atau Unix.
+ `C:\Users\USERNAME\.aws\config`di Windows.
Parameter`.aws`folder tidak ada sebelum konfigurasi awal pertama Anda dari instans AWS Anda. Pertama kali Anda mengkonfigurasi kredensyal Anda dengan CLI, folder ini akan dibuat. Untuk informasi selengkapnya tentang kredensial AWS, lihat[Konfigurasi dan Pengaturan File Kredenal.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
File ini harus berisi baris berikut:
```
[default]
region = your_aws_region
```
Ganti Wilayah AWS (misalnya, “us-west-2") untuk*your\$1aws\$1region*.
**catatan**
Jika Anda tidak memilih Wilayah, maka us-east-1 digunakan secara default.
## Langkah Selanjutnya
[Langkah 3: Memulai menggunakanAWS CLIdanAWSSDK API](get-started-exercise.md)
# Langkah 3: Memulai menggunakanAWS CLIdanAWSSDK API
Setelah Anda mengaturAWS CLIdanAWSSDK yang ingin Anda gunakan, Anda dapat membangun aplikasi yang menggunakan Amazon Textract. Topik-topik berikut ini akan menunjukkan kepada Anda cara memulai Amazon Textract.
+ [Menganalisis Teks Dokumen dengan Amazon Textract](analyzing-document-text.md)
## FormatAWS CLIContoh
Contoh AWS CLI dalam panduan ini diformat untuk sistem operasi Linux. Untuk menggunakan sampel dengan Microsoft Windows, Anda perlu mengubah format parameter `--document` JSON, dan mengubah jeda baris dari garis miring terbalik (\$1) menjadi tanda sisipan (^). Untuk informasi selengkapnya tentang pemformatan JSON, lihat [Penentuan Nilai Parameter untuk Antarmuka Baris Perintah AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html).