本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon Textract 入門
<a name="getting-started"></a>

本節主題可協助您開始使用 Amazon Textract。如果您是 Amazon Textract 新手，建議您先回顧[Amazon Textract 工作方式](how-it-works.md)。

您可以通過使用 Amazon Textract 控制台中的演示來嘗試 API。如需詳細資訊，請參閱「」[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/)。

**Topics**
+ [步驟 1：設定 AWS 帳户並建立 IAM 使用者](setting-up.md)
+ [步驟 2：設定AWS CLI和AWS開發套件](setup-awscli-sdk.md)
+ [步驟 3：使用入門AWS CLI和AWS軟件開發工具包 API](get-started-exercise.md)

# 步驟 1：設定 AWS 帳户並建立 IAM 使用者
<a name="setting-up"></a>

初次使用 Amazon Textract 之前，請先完成以下任務：

1. [註冊 AWS 帳號：](#setting-up-signup).

1. [建立 IAM 使用者](#setting-up-iam).

## 註冊 AWS 帳號：
<a name="setting-up-signup"></a>

註冊 Amazon Web Services (AWS) 時，您的 AWS 帳户會自動註冊 AWS 的所有已發佈服務。您只需針對所使用的服務付費。

使用 Amazon Textract 時，您僅需按使用的資源量付費。如需 Amazon Textract 使用費率的詳細資訊，請參[Amazon Textract 定價](https://aws.amazon.com/textract/pricing/)。如果您是 AWS 新客户，可免費開始使用 Amazon Textract。如需詳細資訊，請參閱 [AWS 免費用量方案](https://aws.amazon.com/free/)。

若您已有 AWS 帳戶，請跳至下一個任務。如果您沒有 AWS 帳戶，請執行下列程序中的步驟建立一個帳戶。

**建立 AWS 帳戶**

1. 開啟 [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)。

1. 請遵循線上指示進行。

   部分註冊程序需接收來電，並在電話鍵盤輸入驗證碼。

請記下您的 AWS 帳戶 ID，因為您下一個任務會需要此 ID。

## 建立 IAM 使用者
<a name="setting-up-iam"></a>

AWS 服務，例如 Amazon Textract，會在您進行存取時，要求您提供登入資料。這樣服務可以確定您是否有權存取該服務所擁有的資源。主控台需要您的密碼。您可以建立 AWS 帳戶的存取金鑰，用以存取 AWS CLI 或 API。不過，不建議您透過使用 AWS 帳戶的登入資料來存取 AWS。我們建議您改進行下列動作：
+ 使用AWS Identity and Access Management(IAM) 來建立 IAM 使用者。
+ 新增使用者到具備管理許可的 IAM 羣組.

您可以使用特殊 URL 與該 IAM 使用者的登入資料來存取 AWS。

如果您已註冊 AWS，但是尚未為自己建立 IAM 使用者，可以使用 IAM 主控台加以建立。請遵循程序在您的帳戶中建立 IAM 使用者。



**建立 IAM 使用者並登入主控台**

1. 在您的 AWS 帳戶中建立一個擁有管理員權限的 IAM 使用者。如需說明，請參閱「」[建立您的第一個 IAM 使用者和管理員組](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html)中的*IAM User Guide*。

1. 做為 IAM 使用者，請使用特殊 URL 登入 AWS 管理主控台。如需詳細資訊，請參閱「」[使用者如何登入您的帳戶](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html)中的*IAM User Guide*。

**注意**  
具有管理員許可的 IAM 使用者可以不受限制地存取AWS服務在您的帳户中。本指南中的代碼範例假設您有一個使用者`AmazonTextractFullAccess`許可。`AmazonS3ReadOnlyAccess`是存取存放在 Amazon S3 存儲體中的檔案的範例所必需的。根據您的安全要求，您可能希望使用限於這些許可的 IAM 羣組。如需詳細資訊，請參閱「」[建立 IAM 羣組](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html)。



如需 IAM 的詳細資訊，請參閱下列各項：
+ [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/)
+ [入門](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [IAM 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/)

## 後續步驟
<a name="setting-up-next-step-2"></a>

[步驟 2：設定AWS CLI和AWS開發套件](setup-awscli-sdk.md)

# 步驟 2：設定AWS CLI和AWS開發套件
<a name="setup-awscli-sdk"></a>

以下步驟說明如何安裝本文件中使用的範例的 AWS Command Line Interface (AWS CLI) 和 AWS 開發套件。

有幾種不同的方式來驗證 AWS 開發套件呼叫。本指南中的範例假設您使用預設的登入資料設定檔來呼叫 AWS CLI 命令和 AWS 開發套件 API 操作。您的默認憑據將跨服務運行，因此，如果您已配置憑據，則無需再次配置此操作。但是，如果要為此服務創建另一組憑據，則可以創建名稱配置文件。如需建立檔的詳細資訊，[請參命名設定檔。](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)

如需可用的AWS區域，請參閲[區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)中的*Amazon Web Services 一般參考*。

**設定 AWS CLI 和 AWS 開發套件**

1. 下載並安裝您要使用的 AWS CLI 和 AWS 開發套件。本指南提供AWS CLI、Java 和 Python。如需其他 AWS 開發套件的相關資訊，請參閱[適用於 Amazon Web Services 的工具](https://aws.amazon.com/tools/)。
   + [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)
   + [適用於 Java 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
   + [適用於 Python (Boto3) 的 AWS SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)

1. 為您在[建立 IAM 使用者](setting-up.md#setting-up-iam)。

   1. 登入 AWS 管理主控台，並開啟位於 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 的 IAM 主控台。

   1. 在導覽窗格中，選擇 **Users** (使用者)。

   1. 選擇您在[建立 IAM 使用者](setting-up.md#setting-up-iam)。

   1. 選擇 **Security credentials** (安全憑證) 索引標籤。

   1. 選擇** Create access key (建立新的存取金鑰)**。然後選擇 **Download .csv file** (下載 .csv 檔案)，將存取金鑰 ID 和私密存取金鑰儲存至電腦上的 CSV 檔案。將檔案存放在安全位置。在關閉此對話方塊後，您將無法再次存取該私密存取金鑰。在您下載 CSV 檔後，選擇**Close (關閉)**。

1. 在您本機系統的 AWS 登入資料設定檔中設定登入資料，該設定檔位置於：
   + `~/.aws/credentials`在 Linux、macOS 或 Unix。
   + `C:\Users\USERNAME\.aws\credentials`Windows 上的。

   所以此`.aws`文件夾在您的 AWS 實例的第一次初始配置之前不存在。首次使用 CLI 配置憑據時，將創建此文件夾。如需 AWS 登入資料的詳細資訊，請參[組態與登入資料檔案設定。](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)

   此檔案應該包含下列格式的行：

   ```
   [default]
   aws_access_key_id = your_access_key_id
   aws_secret_access_key = your_secret_access_key
   ```

   替換您的存取金鑰 ID 和私密存取金鑰*您的訪問密鑰 ID*和*您的祕密訪問密鑰*。

1. 在 AWS 中設定預設 AWS 區域`config`檔案，該檔案位於：
   + `~/.aws/config`在 Linux、macOS 或 Unix。
   + `C:\Users\USERNAME\.aws\config`Windows 上的。

   所以此`.aws`文件夾在您的 AWS 實例的第一次初始配置之前不存在。首次使用 CLI 配置憑據時，將創建此文件夾。如需 AWS 登入資料的詳細資訊，請參[組態與登入資料檔案設定。](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)

   此檔案應該包含下列行：

   ```
   [default]
   region = your_aws_region
   ```

   替換您想要的 AWS 區域 (例如，「us-west-2")*您的區域*。
**注意**  
如果您不選擇區域，則預設使用 us-east-1。

## 後續步驟
<a name="setting-up-next-step-3"></a>

[步驟 3：使用入門AWS CLI和AWS軟件開發工具包 API](get-started-exercise.md)

# 步驟 3：使用入門AWS CLI和AWS軟件開發工具包 API
<a name="get-started-exercise"></a>

在您設置AWS CLI和AWS您可以建置使用 Amazon Textract 的應用程式。下列主題説明如何開始使用 Amazon Textract。
+ [使用 Amazon Textract 分析文檔文本](analyzing-document-text.md)

## 將 AWS CLI 範例格式化
<a name="format-cli"></a>

本指南中的 AWS CLI 範例已格式化為 Linux 作業系統。若要搭配 Microsoft Windows 使用範例，您需要變更 `--document` 參數的 JSON 格式，並將換行符號從反斜線 (\$1) 變更為插入號 (^)。如需 JSON 格式的詳細資訊，請參閱[指定 AWS 命令列界面的參數值](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html)。